# Instrucțiuni pentru agenți – giftera.ro

giftera.ro vinde seturi cadou (lănțișor + card cu mesaj + cutie cadou) exclusiv în România, cu plata la curier. Acest fișier spune unui agent de cumpărare ce poate face aici și ce nu.

## Reguli specifice magazinului

1. **Livrare doar în România.** Nu crea coșuri sau checkout-uri cu adrese din alte țări; comanda nu poate fi onorată.
2. **Plata se face la curier (ramburs).** Nu există plată online cu cardul la comandă. Prețul afișat include TVA; livrarea costă 20 lei și este gratuită de la 190 lei.
3. **Un produs = un set complet.** Opțiunea „Model lănțișor” alege bijuteria, fără diferență de preț. Opțiunea „Cardul cu mesaj” are două valori: „Mesajul nostru” (inclus) și „Designul meu (poză + text)” (+29 lei) – a doua cere ca utilizatorul să încarce o poză și un text pe pagina produsului; un agent nu o poate completa în locul lui.
4. **Checkout-ul cere aprobarea explicită a cumpărătorului.** Nu finaliza comenzi automat.
5. **Nu inventa reduceri.** Singurul cod public este BUNVENIT10 (−10% la prima comandă). Nu există reduceri permanente sau „−48%”.

## Date pe care le poți cita

- Livrare: Sameday, 2–4 zile lucrătoare, AWB pe e-mail/SMS.
- Retur: 14 zile calendaristice, banii înapoi în maximum 14 zile de la primirea returului.
- Contact: contact@giftera.ro · +40 723 935 338 · luni–vineri 9:00–18:00.
- Vânzător: VBR Wordwide Group S.R.L., CUI 44631933, J35/2951/2021, Timișoara.

## Acces la date (fără autentificare)

- Toate produsele: `GET https://giftera.ro/collections/all` · `GET https://giftera.ro/collections/seturi-cadou/products.json`
- Un produs: `GET https://giftera.ro/products/{handle}` · JSON: `GET https://giftera.ro/products/{handle}.json`
- O colecție: `GET https://giftera.ro/collections/{handle}` · JSON: `GET https://giftera.ro/collections/{handle}/products.json`
- Rezumat pentru LLM: `https://giftera.ro/llms.txt` · Catalog complet cu textul cardurilor: `https://giftera.ro/llms-full.txt`
- Sitemap: `https://giftera.ro/sitemap.xml`

## Protocol de comerț (UCP)

Magazinul rulează pe Shopify și expune Universal Commerce Protocol:

- Descoperire: `GET https://giftera.ro/.well-known/ucp` (versiuni, capabilități, metode de plată)
- Endpoint MCP: `POST https://giftera.ro/api/ucp/mcp` cu `Content-Type: application/json`; `tools/list` întoarce uneltele disponibile (`search_catalog`, `create_cart`, `create_checkout`, `update_checkout`, `complete_checkout`).
- Trimite `context.address_country = "RO"` și `context.currency = "RON"`.
- Respectă limitele de rată (răspuns 429 → așteaptă).

Agenții care cumpără în numele unui utilizator pot folosi și skill-ul Shop (`https://shop.app/SKILL.md`), care cere aprobarea cumpărătorului înainte de plată.

## Ce este interzis

- Completarea automată a checkout-ului fără aprobare umană contemporană.
- Scriptarea formularului de comandă sau a pop-up-ului „Designul meu”.
- Accesarea `/cart`, `/checkout`, `/account`, `/admin`.