Změna objednávky

Potřebujete objednávku upravit po jejím odeslání? Pomocí Order Change může kupující změnit existující objednávku, například upravit množství, přidat řádky objednávky nebo nahradit položky. Order Changes jsou součástí profilu Peppol Advanced Ordering.

Jak funguje Order Change?

Order Change je v podstatě zcela nový UBL Order dokument, který odkazuje na původní objednávku. Původní objednávku zcela nahrazuje. Dodavatel přijme změněný dokument a může na něj reagovat Order Response (akceptovat, zamítnout nebo akceptovat s podmínkami).

Flow vypadá následovně:

Kupující odešle Order Change s odkazem na původní objednávku
Dodavatel přijme změnu přes webhook OrderChangeReceived
Dodavatel stáhne změněnou objednávku a porovná s originálem
Dodavatel odešle Order Response (AB, AP, CA nebo RE)

Endpoint (kupující)

Kupující odešle Order Change nahráním nového UBL Order dokumentu přes standardní endpoint:

POST /api/v1/{partyId}/purchaseOrder/send

Dokument obsahuje odkaz na původní objednávku v elementu OrderReference UBL souboru. PSB automaticky rozpozná, že jde o změnu.

Přijetí jako dodavatel

Nastavte webhook na topic OrderChangeReceived:

{
  "action": "https://jouw-endpoint.nl/order-changes",
  "topics": ["OrderChangeReceived"],
  "secret": "jouw-geheime-sleutel"
}

Následně stáhněte změněný dokument přes:

GET /api/v1/{partyId}/salesOrder/{documentId}/download

Tip: Porovnejte přijatý dokument s původní objednávkou k určení, co se změnilo. PSB neposkytuje funkci diff; Váš systém musí změny detekovat sám.

Webhook topics

Topic

Směr

Kdy

OrderChangeSent

Kupující

Změna byla úspěšně doručena

OrderChangeReceived

Dodavatel

Změna byla přijata

OrderResponseReceived

Kupující

Dodavatel reagoval na změnu

Reagování na Order Change

Jako dodavatel reagujete na Order Change přes Order Response endpoint, stejně jako u běžné objednávky. Dostupné stavové kódy jsou stejné: AB (přijato), AP (akceptováno), CA (akceptováno s podmínkami) a RE (zamítnuto).

Často kladené otázky

Jak PSB pozná, že moje zpráva je Order Change a ne nová objednávka?

Změněnou UBL objednávku odešlete přes stejný endpoint jako novou objednávku: POST /api/v1/{partyId}/purchaseOrder/send. V UBL dokumentu umístíte odkaz na původní objednávku do elementu OrderReference. PSB na základě toho pozná, že jde o změnu.

Nahrazuje Order Change předchozí objednávku úplně?

Ano. Order Change je zcela nový UBL Order dokument, který odkazuje na původní objednávku a nahrazuje předchozí verzi. Dodavatel si dokument stáhne a musí sám určit rozdíly oproti předchozímu dokumentu; PSB nenabízí funkci porovnávání.

Jaký integrační vzor dodavatel dodržuje po `OrderChangeReceived`?

Nastavte webhook na OrderChangeReceived, stáhněte přes GET /api/v1/{partyId}/salesOrder/{documentId}/download a porovnejte s předchozí objednávkou. Poté odpovězte pomocí Order Response (AB, AP, CA nebo RE). Kupující sleduje průběh mimo jiné přes OrderChangeSent a OrderResponseReceived.

Podívejte se na kompletní API specifikaci na psb.econnect.eu pro přesnou UBL strukturu Order Change.

Zobrazit API dokumentaci

Související