Order Response | eConnect

Když jako dodavatel přijmete objednávku, změnu nebo stornování, odešlete Order Response, aby kupující věděl, co s objednávkou děláte. Order Response je klíčovou součástí profilu Peppol Advanced Ordering.

Endpoint

POST /api/v1/{partyId}/salesOrder/{documentId}/response

{partyId} je Peppol identifikátor dodavatele. {documentId} je ID přijaté objednávky, na kterou reagujete.

Stavové kódy

Order Response obsahuje stavový kód, který udává, co s objednávkou děláte:

Kód

Název

Kdy použít

Acknowledged

Objednávku jste přijali a je čitelná. Použijte to jako předběžné potvrzení, zatímco objednávku ještě posuzujete.

Accepted

Objednávku akceptujete v plném rozsahu a budete ji provádět.

Conditionally Accepted

Objednávku akceptujete, ale se změnami (například upravený termín dodání nebo množství). K response přidejte upravené řádky objednávky.

Rejected

Objednávku zamítáte. Kupující musí podat novou objednávku, pokud má zakázka pokračovat.

Tip: Pro jednu objednávku můžete odeslat více responses. Začněte například AB (potvrzení přijetí) a později odešlete AP (akceptováno), když je objednávka interně schválena.

Příklad flow

Typický scénář Advanced Ordering vypadá takto:

Kupující odešle objednávku přes POST /{partyId}/purchaseOrder/send
Dodavatel přijme objednávku přes webhook OrderReceived
Dodavatel stáhne objednávku přes GET /{partyId}/salesOrder/{documentId}/download
Dodavatel odešle AB response (potvrzení přijetí)
Dodavatel interně posoudí objednávku
Dodavatel odešle AP response (objednávka akceptována)
Kupující obdrží response přes webhook OrderResponseReceived

Podmíněné akceptování (CA)

U CA response (Conditionally Accepted) udáváte, že objednávku akceptujete, ale s úpravami. Response pak obsahuje upravenou verzi řádků objednávky. Kupující se na základě toho může rozhodnout, zda je upravená objednávka přijatelná.

Možné důvody pro CA response jsou mimo jiné upravený termín dodání, změněné množství (omezené zásoby) nebo náhradní položky.

Webhook topics

Topic

Směr

Kdy

OrderResponseSent

Dodavatel

Response byl úspěšně odeslán kupujícímu

OrderResponseReceived

Kupující

Response od dodavatele byl přijat

Tělo požadavku

Response se odesílá jako UBL OrderResponse XML dokument v těle požadavku s content-type application/xml. Dokument musí obsahovat správný odkaz na původní objednávku.

Podívejte se do Swagger dokumentace na psb.econnect.eu pro přesnou XML strukturu a povinná pole.

Často kladené otázky

Kdy použiji AB, AP, CA nebo RE v Order Response?

AB znamená, že objednávka byla přijata a je čitelná, často jako mezikrok. AP je úplné přijetí a provedení. CA je přijetí se změnami; přidáte upravené řádky objednávky. RE objednávku zamítá; kupující musí poté podat novou objednávku, pokud má nákup pokračovat.

Mohu odeslat více Order Response pro tutéž objednávku?

Ano. Můžete například nejprve odeslat AB po přijetí objednávky a později AP po dokončení interního schválení. To odpovídá typickému řetězci Advanced Ordering s webhookem OrderResponseReceived na straně kupujícího.

Jak technicky zavolám endpoint Order Response?

Použijte POST /api/v1/{partyId}/salesOrder/{documentId}/response s {partyId} jako Peppol identifikátorem dodavatele a {documentId} jako ID přijaté objednávky. Tělo je UBL OrderResponse XML s Content-Type: application/xml a správným odkazem na původní objednávku.

Podívejte se na kompletní API specifikaci na psb.econnect.eu pro vzorové payloady a chybová hlášení.

Otevřít API referenci

Související