Primirea comenzilor

De fiecare dată când se plasează o comandă într-un magazin al tău, o trimitem prin POST către endpoint-urile de tip notificare comenzi definite în portal.

Cererea pe care o primești

POST /webhook-ul-tau HTTP/1.1
Authorization: cheia-configurata-pe-endpoint
Content-Type: application/json

{
  "order_id": "616342127",
  "store_id": "gi20__001",
  "order_code": "ISRQHPPK1",
  "order_time": "2026-05-09 16:16:36",
  ...
}

Structura completă a corpului: structura JSON.

Ce trebuie să facă endpointul tău

1. Verifică headerul Authorization. Trebuie să fie exact valoarea cheii asociate endpointului. Orice altceva se respinge cu 401.
2. Verifică dacă mai ai comanda. Caută după order_code.
3. Salveaz-o, apoi răspunde.

Ce răspunzi

Situație	Răspuns
Ai preluat comanda	200 OK
O aveai deja	200 OK — nu o procesa a doua oară
Header greșit sau lipsă	401 Unauthorized
Payload invalid	400 Bad Request, cu un mesaj în corp
Ai o problemă internă	5xx

Răspunde repede, procesează după

Confirmă cu 200 imediat ce ai salvat comanda și lasă tipărirea bonului, notificările și restul pe un fir separat. Un endpoint care ține conexiunea deschisă cât face toată munca apare la noi ca lent sau eșuat, chiar dacă la tine comanda a intrat.

Comenzi duplicate

Ne putem repeta

În caz de eroare sau timeout, aceeași comandă poate fi trimisă de mai multe ori. Dacă îți activezi reîncercarea, acest lucru devine intenționat și mai frecvent.

Protecția este un index unic pe order_code în baza ta de date. Când inserarea eșuează cu conflict, răspunde tot 200 — ai comanda, iar noi nu mai avem motiv să insistăm.

Nu folosi order_id ca cheie de deduplicare și nu te baza pe ordinea sosirii.

Ce diferă între tipurile de comandă

Livrarea o poate face fie un curier al platformei, fie restaurantul (marketplace). Payload-ul diferă:

Câmp	Livrare cu curier	Marketplace
courier	completat	null pe ambele câmpuri
customer.phone_number	N/A	numărul real
customer.name	prenume + inițială	numele complet
delivery_address	null	adresa cu coordonate
customer_cash_payment_amount	null	suma cu care plătește clientul, la plata cash
bundled_orders	gol	poate conține comenzi livrate împreună

Motivul este simplu: la livrarea cu curier, restaurantul nu are nevoie de datele clientului, deci nu le primește.

Comenzi anulate

O comandă poate fi anulată după ce ți-a fost trimisă. Dacă ai definit un endpoint de tip notificare comenzi anulate, primești și acest eveniment — vezi endpoint-uri.

Fără el, nu ai cum să afli din integrare că o comandă a picat.

Ce faci când ceva nu a ajuns

Nu ne scrie înainte să te uiți: caută comanda după order_code în portal. Vezi acolo dacă am primit-o, dacă ți-am trimis-o, ce anume ți-am trimis și ce ai răspuns.