☰ Meniu · Istoric modificări
Altele
Istoric modificări
Ce s-a schimbat în API, cele mai noi primele.
22 noiembrie 2026
cashierînPOST /v1/transactions,POST /v1/checks/calculateșiPOST /v1/holds: un șir sau{id, name}care spune cine a emis bonul. Se salvează cu bonul și rezervarea, se întoarce încashierși e folosit de semnalele casierilor. Nu schimbă niciodată cashback-ul și nu intră în verificarea de idempotență.
17 noiembrie 2026
- Regula „într-o vizită clientul fie acumulează, fie cheltuie”: un bon cu plată din cashback nu acumulează, iar răspunsurile
POST /v1/checks/calculateșiPOST /v1/transactionsconținearn_blocked: "redeemed". Fără regulă câmpul lipsește.
16 noiembrie 2026
- Locații: proprietarul leagă de locații codurile caselor și codurile magazinelor. Trimiteți
store_idcu bonuri, calcule și rezervări cândregister_idlipsește sau nu e legat de o locație; răspunsurile conținlocationcumatched_by. Vedeți cum se trimit locația și casa. - Regulile locațiilor: procent propriu, acumulare oprită, plata cu cashback interzisă sau limitată pe locație. Un bon sau o rezervare cu cashback acolo unde e interzis este refuzat cu
400 redeem_not_allowed_here, iar calculul răspunderedeem_blocked_reason. Excepții pentru produse și categorii pe locație:GET /v1/catalog/location-rules. - Categorie după nume: localurile cu ordinea detaliată a regulilor acceptă în
line_items[].categoryși numele categoriei, și codul ei. Un nume nu creează niciodată o categorie nouă; câștigă regula cea mai precisă. - Produse la promoție:
line_items[].promo: true; proprietarul decide dacă astfel de linii acumulează și dacă pot fi plătite cu cashback. - Tipuri de reducere:
discount_typepe bon și pe linii; proprietarul stabilește pentru fiecare tip dacă acumulează și dacă se poate plăti cu cashback, altfel400 discount_redeem_not_allowed. - Cashback ca plată sau ca reducere: în modul reducere fiecare linie are
redeem_allocated; modul e însettings.redeem_accounting. - Offline:
GET /v1/accountîntoarce însettingscâmpuriletimeout_seconds,offline_redeemșioffline_max_hours. Vedeți Când casa e fără conexiune. - Cadouri:
POST /v1/checks/calculaterăspundegifts.pendingșigifts.unlocks,POST /v1/transactionsrăspundegifts.unlocked; marcați un cadou ca predat cuPOST /v1/members/{member}/gifts/{gift_id}/give. Evenimentegift.unlockedșigift.given.
5 noiembrie 2026
- Fiecare tranzacție și
POST /v1/checks/calculateauline_itemscu ce a acumulat fiecare poziție:amount,cashback_earned,earn_percent,redeemable,quantity_refunded. - Returnări după poziții:
POST /v1/transactions/{external_id}/refundsacceptăline_itemscu cod și cantitate; cashback-ul urmează ce a acumulat cu adevărat fiecare poziție. - Prefixul numărului de card: proprietarul îl setează în regulile pentru case, cardurile noi încep cu el;
settings.card_prefixînGET /v1/account. - Reguli pe produs: proprietarul suprascrie categoria pe un produs, definitiv sau între date;
GET /v1/catalog/productsle returnează înrules. - Cashback-ul poate deveni negativ: o returnare sau o anulare retrage cashback deja cheltuit de oaspete,
cashback.balancedevine negativ, iar următorul bon acoperă întâi datoria. - Panou: felicitări de ziua de naștere în limba cardului, evenimente și zile de naștere fără imagine (textul se așază peste designul cardului), niveluri de ștampile care se schimbă în momentul strângerii ștampilelor.
- Panou: campanii automate (a cumpărat un produs, a încetat să-l cumpere, program către un segment) cu jurnal de trimiteri; cohorte de cumpărători cu LTV; segmente după produsele cumpărate și după soldul de cashback.
- Returnare pe poziții:
POST /v1/transactions/{external_id}/returnsprimeșteline_itemsreturnate și mută cashback-ul după ce a acumulat fiecare poziție; același motor ca la returnarea cu poziții, ca endpoint separat.
24 octombrie 2026
- Comenzi la pachet:
type: pickupculocation,pickup_at,guestșiday_number. - Fiecare comandă are
paymentșihistory.GET /v1/ordersacceptă?type=și?location=. - Un preparat cu alegere obligatorie adăugat fără ea este refuzat cu
needs_optionsînainte să ajungă la tine.
9 octombrie 2026
- Un bon anulat sau returnat integral nu mai contează ca vizită sau cheltuială, așa că returnările nu urcă nivelul de cashback al clientului.
- Căile necunoscute din
/v1răspund cu JSON404 endpoint_not_foundîn loc de pagina site-ului;GET /v1descrie API-ul. - Erorile de validare spun ce trebuie trimis, de exemplu că
amounteste un număr întreg în unități minime.
7 octombrie 2026
- Regulile localului pentru case: plata cu cashback prin rezervări, numerotarea bonurilor pe fiecare casă, o limită pentru bonurile trimise mai târziu, limite de cashback pe bon și pe zi, scanarea obligatorie a cardului, corecții manuale. Fiecare cheie poate avea valori proprii.
GET /v1/accountîntoarce regulile însettings. - Rezervări:
POST /v1/holds, confirmare cuhold_id, eliberare, expirare automată. POST /v1/checks/calculatearată ce ar face un bon, fără să scrie nimic.- Retururi parțiale:
POST /v1/transactions/{external_id}/refunds. - Catalog: încarci produsele după SKU; proprietarul stabilește pentru fiecare categorie dacă acordă cashback, dacă poate fi plătită cu cashback și procentul ei propriu.
- Membrii afișează
levels,next_level,heldșiavailablepentru cashback. - Fiecare bon, scanare și calcul are
display, cu text gata făcut pentru casier și pentru bon. - Permisiuni noi
members:adjust,catalog:read,catalog:write; evenimente noitransaction.refunded,balance.adjusted.
6 octombrie 2026
- API v1 la
/api/v1, pentru orice tip de program: cashback, ștampile, reduceri pentru vizite, niveluri VIP. - Membri: înscriere cu propriul număr de card, căutare după card, cod de bare, telefon sau id, istoric, acordarea recompenselor.
- Format al codului de bare al cardului pentru fiecare program: QR sau Code 128 cu numărul cardului, ori QR cu seria.
- Tranzacții cu
line_items, anulări, folosirea cashback-ului cu plafoanele programului. - Chioșcuri și scanere:
POST /v1/scans,POST /v1/visits, permisiuneadevices:write. - API pentru meniu, cu SKU-urile tale în
external_id, sincronizare în lot a prețurilor și a stop-listului. - Comenzi de la masă din meniul QR, cu statusuri pentru POS.
- Webhook-uri cu semnături și reîncercări,
Idempotency-Key, paginare cu cursor, permisiuni pentru chei. - API-ul POS anterior, la
/api/pos/v1, continuă să funcționeze.