Endpoint-uri

Endpoint-urile sunt URL-urile tale pe care îți trimitem notificări. Le definești în portal, la Profil → Endpoint-uri POS.

Alege Creare Endpoint POS.

Câmp	Ce completezi
Nume	Un nume descriptiv.
URL	Adresa completă, cu https://.
Soluție POS	Se completează automat.
Configurare cheie API	Cheia trimisă pe Authorization către acest endpoint.
Cod	Un cod intern pentru endpoint.

Testează înainte de salvare

Butonul Testează endpoint face un apel real și îți arată răspunsul. Un endpoint care nu trece testul nu va primi nici comenzi.

Tipuri de endpoint

Tip	Ce primești
Notificare comenzi	Fiecare comandă nouă. Este singurul tip obligatoriu.
Notificare rezultat menu update	Rezultatul final al unei actualizări de meniu, fără să interoghezi tu statusul.
Notificare comenzi anulate	Comenzile anulate după ce ți-au fost deja trimise.

Notificarea de comandă anulată

Merită implementată dacă bonul se tipărește automat la primirea comenzii: fără ea, bucătăria începe o comandă pe care clientul a anulat-o între timp, iar tu afli abia când nu vine curierul.

Cum se distribuie notificările

Toate comenzile merg la toate endpoint-urile

Fiecare comandă din contul soluției tale POS se trimite către fiecare endpoint definit de tipul respectiv. Nu există rutare pe brand, locație sau client.

Dacă deservești mai mulți clienți, expune un singur endpoint către noi și distribuie intern, la tine, după store_id. Altfel fiecare client primește comenzile tuturor celorlalți.

Cerințe pentru endpoint

Cerință	De ce
HTTPS cu certificat valid	Comenzile conțin date de client. Un certificat expirat oprește livrarea.
Răspuns rapid	Un endpoint lent apare la noi ca eșec și, dacă ai retry activ, poate duce la comenzi dublate.
Răspuns 2xx la succes	Este singura dovadă că ai primit comanda. Vezi căutare comandă.
Idempotent pe order_code	Ne putem repeta. Un index unic pe order_code te scutește de comenzi duble.

Detalii despre ce trebuie să facă efectiv endpointul: primirea comenzilor.