Order Response | eConnect

Keď ako dodávateľ prijmete objednávku, zmenu alebo stornovanie, odošlete Order Response, aby kupujúci vedel, čo s objednávkou robíte. Order Response je kľúčovou súčasťou profilu Peppol Advanced Ordering.

Endpoint

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

{partyId} je Peppol identifikátor dodávateľa. {documentId} je ID prijatej objednávky, na ktorú reagujete.

Stavové kódy

Order Response obsahuje stavový kód, ktorý udáva, čo s objednávkou robíte:

Kód

Názov

Kedy použiť

Acknowledged

Objednávku ste prijali a je čitateľná. Použite to ako predbežné potvrdenie, kým objednávku ešte posudzujete.

Accepted

Objednávku akceptujete v plnom rozsahu a budete ju vykonávať.

Conditionally Accepted

Objednávku akceptujete, ale so zmenami (napríklad upravený termín dodania alebo množstvá). K response pridajte upravené riadky objednávky.

Rejected

Objednávku zamietate. Kupujúci musí podať novú objednávku, ak má zákazka pokračovať.

Tip: Pre jednu objednávku môžete odoslať viacero responses. Začnite napríklad AB (potvrdenie prijatia) a neskôr odošlite AP (akceptované), keď je objednávka interne schválená.

Príklad flow

Typický scenár Advanced Ordering vyzerá takto:

Kupujúci odošle objednávku cez POST /{partyId}/purchaseOrder/send
Dodávateľ prijme objednávku cez webhook OrderReceived
Dodávateľ stiahne objednávku cez GET /{partyId}/salesOrder/{documentId}/download
Dodávateľ odošle AB response (potvrdenie prijatia)
Dodávateľ interne posúdi objednávku
Dodávateľ odošle AP response (objednávka akceptovaná)
Kupujúci obdrží response cez webhook OrderResponseReceived

Podmienečné akceptovanie (CA)

Pri CA response (Conditionally Accepted) udávate, že objednávku akceptujete, ale s úpravami. Response potom obsahuje upravenú verziu riadkov objednávky. Kupujúci sa na základe toho môže rozhodnúť, či je upravená objednávka prijateľná.

Možné dôvody pre CA response sú okrem iného upravený termín dodania, zmenené množstvo (obmedzené zásoby) alebo náhradné položky.

Webhook topics

Topic

Smer

Kedy

OrderResponseSent

Dodávateľ

Response bol úspešne odoslaný kupujúcemu

OrderResponseReceived

Kupujúci

Response od dodávateľa bol prijatý

Telo požiadavky

Response sa odosiela ako UBL OrderResponse XML dokument v tele požiadavky s content-type application/xml. Dokument musí obsahovať správny odkaz na pôvodnú objednávku.

Pozrite si Swagger dokumentáciu na psb.econnect.eu pre presnú XML štruktúru a povinné polia.

Často kladené otázky

Kedy použijem AB, AP, CA alebo RE v Order Response?

AB znamená, že objednávka bola prijatá a je čitateľná, často ako medzikrok. AP je úplné prijatie a vykonanie. CA je prijatie so zmenami; pridáte upravené riadky objednávky. RE objednávku zamieta; kupujúci musí potom podať novú objednávku, ak má nákup pokračovať.

Môžem odoslať viacero Order Response pre tú istú objednávku?

Áno. Môžete napríklad najprv odoslať AB po prijatí objednávky a neskôr AP po dokončení interného schválenia. To zodpovedá typickému reťazcu Advanced Ordering s webhookom OrderResponseReceived na strane kupujúceho.

Ako technicky zavolám endpoint Order Response?

Použite POST /api/v1/{partyId}/salesOrder/{documentId}/response s {partyId} ako Peppol identifikátorom dodávateľa a {documentId} ako ID prijatej objednávky. Telo je UBL OrderResponse XML s Content-Type: application/xml a správnym odkazom na pôvodnú objednávku.

Pozrite si kompletnú API špecifikáciu na psb.econnect.eu pre vzorové payloady a chybové hlásenia.

Otvoriť API referenciu

Súvisiace