☰ Meniu · Istoric modificări
Altele

Istoric modificări

Ce s-a schimbat în API, cele mai noi primele.

22 noiembrie 2026

  • cashier în POST /v1/transactions, POST /v1/checks/calculate și POST /v1/holds: un șir sau {id, name} care spune cine a emis bonul. Se salvează cu bonul și rezervarea, se întoarce în cashier ș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 și POST /v1/transactions conțin earn_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_id cu bonuri, calcule și rezervări când register_id lipsește sau nu e legat de o locație; răspunsurile conțin location cu matched_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ăspunde redeem_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_type pe bon și pe linii; proprietarul stabilește pentru fiecare tip dacă acumulează și dacă se poate plăti cu cashback, altfel 400 discount_redeem_not_allowed.
  • Cashback ca plată sau ca reducere: în modul reducere fiecare linie are redeem_allocated; modul e în settings.redeem_accounting.
  • Offline: GET /v1/account întoarce în settings câmpurile timeout_seconds, offline_redeem și offline_max_hours. Vedeți Când casa e fără conexiune.
  • Cadouri: POST /v1/checks/calculate răspunde gifts.pending și gifts.unlocks, POST /v1/transactions răspunde gifts.unlocked; marcați un cadou ca predat cu POST /v1/members/{member}/gifts/{gift_id}/give. Evenimente gift.unlocked și gift.given.

5 noiembrie 2026

  • Fiecare tranzacție și POST /v1/checks/calculate au line_items cu ce a acumulat fiecare poziție: amount, cashback_earned, earn_percent, redeemable, quantity_refunded.
  • Returnări după poziții: POST /v1/transactions/{external_id}/refunds acceptă line_items cu 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 în GET /v1/account.
  • Reguli pe produs: proprietarul suprascrie categoria pe un produs, definitiv sau între date; GET /v1/catalog/products le returnează în rules.
  • Cashback-ul poate deveni negativ: o returnare sau o anulare retrage cashback deja cheltuit de oaspete, cashback.balance devine 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}/returns primește line_items returnate ș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: pickup cu location, pickup_at, guest și day_number.
  • Fiecare comandă are payment și history. GET /v1/orders acceptă ?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 /v1 răspund cu JSON 404 endpoint_not_found în loc de pagina site-ului; GET /v1 descrie API-ul.
  • Erorile de validare spun ce trebuie trimis, de exemplu că amount este 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 în settings.
  • Rezervări: POST /v1/holds, confirmare cu hold_id, eliberare, expirare automată.
  • POST /v1/checks/calculate arată 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 și available pentru 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 noi transaction.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, permisiunea devices: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.
Întrebări despre integrare: api@loyaltyfy.io. Răspundem în cel mult o zi lucrătoare.