Sari la conținut

Introducere

Middleware-ul de integrare leagă sistemul tău POS de platforma de comenzi.

Operație Direcție Ce înseamnă
Primirea comenzilor noi → tine Expui un endpoint HTTP pe care îți trimitem fiecare comandă nouă, în format JSON.
Actualizarea meniului tine → noi Ne trimiți meniul magazinului ca JSON, ori de câte ori se schimbă — maximum 5 actualizări complete pe zi, per magazin.
Ciclul de viață al comenzii tine → noi Confirmi din POS acceptarea comenzii, cu un timp de pregătire, și apoi tranzițiile ei.

Acestea trei sunt minimul pentru o integrare funcțională. Fără primirea comenzilor nu ai ce procesa; fără actualizarea meniului, clientul comandă din altceva decât vinzi; fără raportarea ciclului de viață, curierul este trimis pe estimări greșite și statisticile magazinului se deteriorează.

Operație Când îți trebuie
Modificări individuale de produse și atribute Schimbi des prețuri sau disponibilitate și nu vrei să retrimiți tot meniul.
Închidere temporară Închizi punctual un magazin (aprovizionare, avarie, sărbătoare).
Notificarea de comandă anulată Vrei să afli în POS când o comandă a fost anulată.
  • Livrare cu reîncercare. Dacă endpointul tău nu răspunde, reîncercăm după o politică pe care ți-o alegi singur.
  • Trasabilitate completă. Pentru fiecare comandă păstrăm ce ți-am trimis, ce ne-ai răspuns, cât a durat și ce erori au apărut. Le cauți singur în portal.
  • Un store de test, pe care ți-l aloci singur, ca să verifici integrarea cap-coadă înainte de magazine reale.
  • Un portal unde îți administrezi brand-urile, locațiile, cheile și endpoint-urile.

Documentația aceasta descrie mediul de producție. Nu există un mediu de test separat cu date proprii: testarea se face pe infrastructura reală, printr-un store de test plasat într-o zonă dedicată, unde comenzile sunt comenzi de test și nu ajung la clienți reali.

Adresele complete ale mediilor sunt în Medii și adrese.