---
name: edin-storefront
description: Construiește un site de comenzi online pentru un restaurant care folosește Edin, prin API-ul magazinului (`/storefront/*`). Folosește-l când scrii finalizarea comenzii, coșul, meniul sau contul clientului unui site legat de Edin, în orice limbaj sau framework.
---

# Site de comenzi pe Edin

API-ul magazinului este descris complet în `openapi.json`, publicat lângă acest fișier. Citește-l
înainte să scrii un client: rutele, câmpurile și erorile de acolo sunt singura sursă. Ghidul,
cu pașii comenzii, este în `llms-full.txt`.

## Regulile obligatorii

1. **Cheia magazinului se păstrează numai pe server.** Fiecare cerere are
   `Authorization: Bearer <cheie>`. Browserul nu primește cheia: browserul trimite cererile la
   serverul site-ului, iar serverul site-ului apelează `https://api.edin.ro`. Cheia se citește dintr-o variabilă de mediu, nu se scrie în cod.
2. **Prețul îl calculează serverul.** Site-ul trimite liniile coșului, fără prețuri, la
   `POST /storefront/quote` și afișează sumele primite. Nu calcula totaluri, reduceri sau TVA pe site.
3. **Banii sunt text zecimal cu monedă**: `{ "amount": "58.50", "currency": "RON" }`. Nu le
   transforma în numere ca să faci calcule.
4. **O comandă, o `idempotencyKey`.** Generează cheia o dată pe coș și trimite-o la fiecare
   încercare a `POST /storefront/orders`. O cerere cu aceeași cheie primește aceeași comandă.
5. **IP-ul vizitatorului în `X-Forwarded-For`**, la fiecare cerere: limitele se aplică pe el.
6. **Un `409` la plasare nu se afișează clientului ca eroare.** `error.details.reason` spune ce s-a schimbat,
   iar `error.details.quote` are prețul actual. Arată noul preț și cere din nou confirmarea.
7. **Ignoră câmpurile necunoscute din răspunsuri.** API-ul se schimbă numai prin adăugare.

## Fluxul

1. `GET /storefront/locations`: punctele de lucru, metodele de plată, ridicarea și programarea.
2. `GET /storefront/menu?location=<id>`: meniul.
3. `GET /storefront/slots?location=<id>`: intervalele, numai pentru comenzi programate.
4. `POST /storefront/address-check`: adresa și punctul pe hartă, la livrare.
5. `POST /storefront/quote`: prețul coșului. Plasează doar când `orderable` este `true`.
6. `POST /storefront/orders`: comanda. La plata online, trimite clientul la `paymentUrl`.
7. `GET /storefront/orders/{id}?token=<accessToken>`: pagina comenzii, fără cont.

## Contul clientului (opțional)

- `POST /storefront/account/code`, apoi `POST /storefront/account/code/verify`: intrarea cu cod.
- `token` din sesiune se trimite în antetul `X-Storefront-Session` și se păstrează pe server
  (cookie `HttpOnly`).
- Cu sesiune, comanda din `POST /storefront/orders` se salvează în contul clientului, iar prețurile
  din `POST /storefront/quote` și `POST /storefront/orders` sunt cele ale grupului clientului.
- `401` cu `error.code` `STOREFRONT_SESSION_INVALID`: scoate clientul din cont.

## Verifică înainte să termini

- Nicio cerere spre `api.edin.ro` din codul care rulează în browser.
- Cheia nu apare în cod, în loguri sau în răspunsurile serverului site-ului.
- Niciun calcul pe sume în site.
- Un dublu clic pe „Plasează comanda” face o singură comandă.
- O cerere care a primit `429` se reîncearcă după `Retry-After`, nu imediat.
