Anulare Comenzi

Introducere

Când o comandă este anulată, notificarea de anulare se trimite către endpoint-urile de tip Notificare comenzi anulate definite în Portalul de integrări.

Pentru configurare → Gestiune Endpoint-uri POS

O SINGURĂ ÎNCERCARE

Notificarea de anulare se trimite o singură dată per endpoint configurat. Nu există reîncercare automată dacă endpoint-ul răspunde cu eroare sau nu răspunde.

Format

Payload-ul este JSON și se transmite verbatim, fără reprocesare. Orice câmp sau valoare nouă ajunge la endpoint neatinsă.

{
  "order_id": "101614832566",
  "store_id": "TEST__111111",
  "cancel_reason": "PRODUCTS_NOT_AVAILABLE",
  "payment_strategy": "PAY_NOTHING"
}

Câmp	Descriere
order_id	Identificatorul comenzii anulate — corespunde câmpului order_id din notificarea originală
store_id	Magazinul comenzii, în format PREFIX__storeId
cancel_reason	Motivul anulării
payment_strategy	Dacă produsele comenzii se plătesc partenerului

Răspuns așteptat

Orice cod 2xx. Conținutul răspunsului nu este citit.

cancel_reason

Valoare	Descriere
PRODUCTS_NOT_AVAILABLE	Produsele nu sunt disponibile în magazin
STORE_CAN_NOT_DELIVER	Comanda nu a putut fi livrată de partener
PARTNER_PRINTER_ISSUE	Anulare din cauza unei probleme cu dispozitivul partenerului
USER_ERROR	Clientul a anulat comanda
ORDER_NOT_FEASIBLE	Cererea clientului nu poate fi îndeplinită
OTHER	Alte motive care nu se încadrează în categoriile de mai sus

VALORI TRIMISE

Valorile trimise pe cancel_reason sunt cele din tabelul de mai sus. STORE_ERROR nu face parte din enumerare.

payment_strategy

Valoare	Descriere
PAY_NOTHING	Produsele comenzii nu se plătesc partenerului
PAY_PRODUCTS	Produsele comenzii se plătesc partenerului
PAY_WASTED_PRODUCTS	Se plătesc produsele deja preparate

Câmpul poate veni și null.

Nu există corespondență fixă între cancel_reason și payment_strategy. Valoarea depinde de momentul anulării și de tipul magazinului.

Enumerări extensibile

STOCARE CA TEXT

Ambele enumerări pot fi extinse cu valori noi.

Recomandarea este stocarea celor două câmpuri ca text, nu ca enum. O deserializare strictă va genera erori la o valoare necunoscută.