Actualizare completă

Actualizarea completă înlocuiește tot meniul unui magazin cu ce trimiți tu. Este operația principală de sincronizare și, în același timp, cea mai costisitoare — de aceea are o limită zilnică.

Procesul, în două etape

Operația este asincronă.

1. Trimiți payload-ul

POST /api/v3/menu/upload
Authorization: cheia-ta-api
Content-Type: application/json

{ "store_id": "gi20__001", "partner_name": "gi20", ... }

Primești înapoi un transaction_id.

2. Verifici rezultatul

GET /api/v3/menu/checkstatus/{transaction_id}
Authorization: cheia-ta-api

Status	Ce înseamnă	Ce faci
`SUCCESS`	Meniul a fost actualizat.	Nimic.
`PROCESSING`	Încă se procesează.	Mai aștepți și reinteroghezi.
`FETCH_MENU_INVALID_PAYLOAD`	JSON invalid sau neconform schemei.	Corectezi payload-ul. Validează-l înainte.
`NOT_PROCESSED`	Integrarea este configurată greșit.	Verifici magazinul și `partner_name`; dacă persistă, ne scrii.
`LIMIT_EXCEEDED`	Ai depășit limita zilnică pe acel magazin.	Aștepți sau folosești modificările individuale.
`GLOVO_ERROR`	Eroare în platformă.	Reîncerci mai târziu.

Când statusul indică o eroare, răspunsul conține și detalii despre cauză.

Alternativa: să te anunțăm noi

Dacă definești în portal un endpoint de tip notificare rezultat menu update, primești rezultatul final fără să interoghezi. Vezi endpoint-uri.

Validează înainte de trimitere

POST /api/v3/menu/validate
Authorization: cheia-ta-api
Content-Type: application/json

Verifică payload-ul față de schema JSON și îți întoarce fie „totul e în regulă“, fie lista de erori și avertismente, cu linia și coloana fiecăreia.

Limita zilnică

Limita este pe magazin, nu pe soluție POS. Cinci pe zi este suficient pentru schimbări structurale reale, dar nu pentru sincronizări repetate.

Dacă ai nevoie de schimbări frecvente, nu retrimite tot meniul. Prețurile și disponibilitatea se schimbă prin modificări individuale sau bulk, care nu au această limită.

Tipar recomandat:

Ce s-a schimbat	Ce folosești
Produse noi, categorii, structură, denumiri, imagini	actualizare completă
Preț, disponibilitate	modificare individuală sau bulk

Ce conține payload-ul

Structura ierarhică și regulile de identificatori sunt în structura meniului. Specificația câmpurilor este în referința API.