Terminologie

Termeni

Termen	Ce înseamnă
POS	Sistemul din restaurant care preia și gestionează comenzile. În documentație, „tu“.
Middleware de integrare	Sistemul descris aici, care stă între platforma de comenzi și POS-ul tău.
Portal	Interfața web unde îți administrezi contul, magazinele, cheile și endpoint-urile.
Brand	Gruparea de nivel superior. Un brand are una sau mai multe locații.
Locație / magazin	Un punct de lucru fizic, cu adresa lui. Primește comenzi independent.
Marketplace	Magazin la care livrarea o face restaurantul, nu curierul platformei.
Endpoint POS	Un URL de-al tău, înregistrat în portal, pe care îți trimitem notificări.
Cheie API	Valoarea trimisă pe Authorization, în ambele sensuri ale integrării.

Identificatori

partner_name

Numele soluției tale POS, alocat la înregistrarea contului. Se folosește un singur partner_name per soluție POS, chiar dacă deservești mai mulți clienți.

Conține doar litere și cifre.

store_id (LID)

Identifică unic o locație. Formatul complet este:

partner_name__store_id
     │             │
     │             └── îl alegi tu la crearea locației în portal
     └──────────────── ți-l alocăm noi la înregistrare

Exemplu: pentru partner_name = gi20 și un magazin pe care îl numești 001, identificatorul complet este gi20__001. Separatorul este format din două caractere underscore.

Îl primești în fiecare comandă, pe câmpul store_id, și îl trimiți în fiecare operație pe magazin.

Mențiune

Partea aleasă de tine poate fi orice șir alfanumeric, cu condiția să fie unică în sistemul tău. Mulți integratori folosesc direct codul locației din propriul lor sistem.

order_code

Codul alfanumeric al comenzii, tipărit și pe bon. Acesta este identificatorul după care cauți o comandă în trasabilitate și pe care ni-l dai când ne scrii despre un caz.

order_id

Identificatorul numeric intern al comenzii. Util pentru operațiile de ciclu de viață, dar nu este cheia de căutare.

Sume și date

Convenție	Detaliu
Sume	Întotdeauna întregi, în subunitatea monedei. 5700 înseamnă 57,00 RON.
Date în comenzi	yyyy-MM-dd HH:mm:ss, în ora locală a magazinului.
Date în trasabilitate	Momentele înregistrate de noi sunt în UTC și afișate convertite în ora României.
Date în închiderea temporară	ISO-8601 cu offset, de exemplu 2026-12-20T10:00:00+02:00.