Actualizare Meniu Store
Introducere
Middleware-ul oferă posibilitatea de a trimite un payload pentru actualizarea completă a unui magazin Glovo, inclusiv suprascrierea configurării vechi cu cea nouă. Această operațiune se realizează prin trimiterea unui payload JSON către ETL-ul middleware, care apoi se sincronizează cu Glovo.
Proces asincron
Operația de actualizare a meniului este asincronă și are loc în două etape:
Trimitere payload — Se trimite JSON-ul către endpoint-ul de actualizare (Upload Menu). Răspunsul de succes înseamnă că payload-ul a fost primit și va fi procesat, nu că store-ul a fost actualizat.
Verificare status — Se apelează endpoint-ul de check status (Check Status) pentru a verifica dacă operația s-a finalizat cu succes.
VERIFICAREA STĂRII SE FACE PRIN INTEROGARE
Starea operației se obține prin interogarea endpoint-ului de check status. Rezultatul actualizării nu se transmite către un endpoint al soluției POS.
transaction_id
Răspunsul de succes la upload conține un transaction_id — un identificator unic per apel, care nu se reutilizează niciodată. Se emite doar dacă meniul trece validarea: dacă upload-ul întoarce 400, nu există transaction_id de interogat.
Statusuri
SUCCESS, PROCESSING, FETCH_MENU_INVALID_PAYLOAD, FETCH_MENU_SERVER_ERROR, FETCH_MENU_UNAUTHORIZED, NOT_PROCESSED, LIMIT_EXCEEDED, GLOVO_ERROR
Un status în afara acestei liste se tratează ca nefinal — se continuă interogarea.
Tranziția din PROCESSING către un status final nu are un termen garantat. Implementați interogarea cu backoff și un timeout propriu, iar la depășirea lui reluați upload-ul.
LIMITĂ DE 5 ACTUALIZĂRI PE ZI
Există o limită de 5 operații de menu update pe zi per store ID. Dacă se depășește, API-ul returnează eroare.
Pentru a evita atingerea limitei, folosiți endpoint-urile de actualizare individuală: