Erori frecvente

Comenzi

„Comanda nu a intrat în POS“

Începe întotdeauna cu căutarea comenzii după order_code.

Ce vezi acolo	Cauza	Ce faci
Nu apare, cod corect	Comanda nu a ajuns niciodată la noi.	Ne scrii cu codul, magazinul și ora.
Verdict „NU a ajuns“, apel cu 4xx	Sistemul tău a respins comanda. Răspunsul tău e afișat.	Citești mesajul; e al tău.
Verdict „NU a ajuns“, eroare de conexiune	Nu am putut ajunge la endpointul tău.	Verifici certificat, DNS, firewall.
Verdict „a plecat“, 2xx, dar la tine lipsește	Am livrat-o; s-a pierdut după recepție.	Cauți la tine, de la momentul din cronologie.
Niciun apel înregistrat	Notificările sunt oprite, sau magazinul nu e activat.	Verifici în portal.

Comenzi duplicate

Fie ai reîncercarea activă și un endpoint lent, fie nu deduplici după order_code.

Soluția e aceeași în ambele cazuri: index unic pe order_code și 200 la duplicat. Vezi primirea comenzilor. Dacă nu poți face asta acum, oprește reîncercarea.

Totalul de pe bon nu se potrivește

Aproape întotdeauna una dintre acestea:

• ai calculat suma din produse în loc să folosești payment_total;
• ai ignorat prețul atributelor, care se adaugă peste prețul produsului;
• ai tratat sumele ca lei, deși sunt în subunitate (5700 = 57,00 RON).

payment_total este suma de încasat. Nu o recalcula — vezi structura JSON.

payment_total este 0

Este o valoare validă: clientul a acoperit integral comanda cu un cod promoțional. Tratează 0 ca zero, nu ca date lipsă, și nu îl înlocui cu o sumă calculată de tine.

Comanda a intrat cu întârziere

Cronologia din căutarea comenzii îți spune unde s-a pierdut timpul:

Unde e diferența	Unde e cauza
Între „creată“ și „primită de noi“	Înainte de noi.
Între „primită“ și „trimisă“, cu încercări multiple	Endpointul tău nu a răspuns prima dată.
Nicăieri — totul sub 2 secunde	La tine, după recepție.

Autentificare

401 la toate apelurile

Cauză	Verificare
Header lipsă	Authorization trebuie trimis pe fiecare cerere.
Cheie greșită	O compari caracter cu caracter cu cea din portal.
Cheie dezactivată	O verifici în portal, la Profil → Chei API.
Spații invizibile	O cheie copiată dintr-un email poate avea spații la capete.

Prefixul Bearer nu e problema — funcționează și cu, și fără.

Noi primim 401 de la endpointul tău

Validezi altă valoare decât cea configurată pe endpoint în portal. Vezi endpoint-uri. Se întâmplă tipic după o rotire de cheie făcută pe jumătate — procedura corectă e în autentificare.

Meniu

LIMIT_EXCEEDED

Ai depășit cele 5 actualizări complete pe zi pentru acel magazin. Pentru prețuri și disponibilitate folosește modificările individuale sau bulk, care nu au limită.

FETCH_MENU_INVALID_PAYLOAD

Payload-ul nu respectă schema. Rulează POST /api/v3/menu/validate — îți dă linia și coloana fiecărei erori și nu consumă din limita zilnică.

NOT_PROCESSED

Configurare greșită a integrării: store_id care nu există, partner_name care nu corespunde, sau magazin neactivat. Verifică-le în portal; dacă toate par corecte, scrie-ne.

Produsele nu au imagini

URL-urile de imagine sunt descărcate din exterior. Cauze uzuale: certificat expirat pe serverul tău de imagini, URL cu http:// în loc de https://, fișier prea mare. Vezi cerințele în structura meniului.

Produsul din comandă nu se potrivește cu nimic din POS

id-ul din comandă este exact cel trimis de tine în meniu. Dacă nu îl mai recunoști, înseamnă că identificatorii tăi se schimbă între sincronizări. Fă-i stabili — vezi structura meniului.

Magazine

Un magazin nou nu primește comenzi

Cauză	Verificare
Nu a fost activat încă	Activarea o face echipa noastră după ce creezi locația.
„Integrare deja activată?“ bifat din greșeală	Nu am fost notificați să o activăm. Vezi brand-uri și locații.
Notificări oprite	Pe brand sau pe locație.
Fără endpoint definit	Ai nevoie de cel puțin unul de tip notificare comenzi.

Magazinul apare închis

Verifică dacă are o închidere temporară activă: GET /api/v3/scheduling/stores/{storeId}/closing. Dacă until nu e null, o poți anula cu DELETE pe aceeași cale.

Când ne scrii

Trimite de la început:

• order_code (nu order_id) sau store_id, după caz;
• ora aproximativă și fusul orar folosit;
• ce ai văzut în căutarea comenzii;
• ce te așteptai să se întâmple.

Cu acestea, răspunsul vine în primul mesaj.