Zmena objednávky

Potrebujete objednávku upraviť po jej odoslaní? Pomocou Order Change môže kupujúci zmeniť existujúcu objednávku, napríklad upraviť množstvá, pridať riadky objednávky alebo nahradiť položky. Order Changes sú súčasťou profilu Peppol Advanced Ordering.

Ako funguje Order Change?

Order Change je v podstate úplne nový UBL Order dokument, ktorý odkazuje na pôvodnú objednávku. Pôvodnú objednávku úplne nahrádza. Dodávateľ prijme zmenený dokument a môže na neho reagovať Order Response (akceptovať, zamietnuť alebo akceptovať s podmienkami).

Flow vyzerá nasledovne:

Kupujúci odošle Order Change s odkazom na pôvodnú objednávku
Dodávateľ prijme zmenu cez webhook OrderChangeReceived
Dodávateľ stiahne zmenenú objednávku a porovná s originálom
Dodávateľ odošle Order Response (AB, AP, CA alebo RE)

Endpoint (kupujúci)

Kupujúci odošle Order Change nahraním nového UBL Order dokumentu cez štandardný endpoint:

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

Dokument obsahuje odkaz na pôvodnú objednávku v elemente OrderReference UBL súboru. PSB automaticky rozpozná, že ide o zmenu.

Prijatie ako dodávateľ

Nastavte webhook na topic OrderChangeReceived:

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

Následne stiahnite zmenený dokument cez:

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

Tip: Porovnajte prijatý dokument s pôvodnou objednávkou na určenie, čo sa zmenilo. PSB neposkytuje funkciu diff; Váš systém musí zmeny detekovať sám.

Webhook topics

Topic

Smer

Kedy

OrderChangeSent

Kupujúci

Zmena bola úspešne doručená

OrderChangeReceived

Dodávateľ

Zmena bola prijatá

OrderResponseReceived

Kupujúci

Dodávateľ reagoval na zmenu

Reagovanie na Order Change

Ako dodávateľ reagujete na Order Change cez Order Response endpoint, rovnako ako pri bežnej objednávke. Dostupné stavové kódy sú rovnaké: AB (prijaté), AP (akceptované), CA (akceptované s podmienkami) a RE (zamietnuté).

Často kladené otázky

Ako PSB rozpozná, že moja správa je Order Change a nie nová objednávka?

Zmenenú UBL objednávku odošlete cez rovnaký endpoint ako novú objednávku: POST /api/v1/{partyId}/purchaseOrder/send. V UBL dokumente umiestnite odkaz na pôvodnú objednávku do elementu OrderReference. PSB na základe toho rozpozná, že ide o zmenu.

Nahrádza Order Change predchádzajúcu objednávku úplne?

Áno. Order Change je úplne nový UBL Order dokument, ktorý odkazuje na pôvodnú objednávku a nahrádza predchádzajúcu verziu. Dodávateľ si dokument stiahne a musí sám určiť rozdiely oproti predchádzajúcemu dokumentu; PSB neponúka funkciu porovnávania.

Aký integračný vzor dodávateľ dodržiava po `OrderChangeReceived`?

Nastavte webhook na OrderChangeReceived, stiahnite cez GET /api/v1/{partyId}/salesOrder/{documentId}/download a porovnajte s predchádzajúcou objednávkou. Potom odpovedzte pomocou Order Response (AB, AP, CA alebo RE). Kupujúci sleduje priebeh okrem iného cez OrderChangeSent a OrderResponseReceived.

Pozrite si kompletnú API špecifikáciu na psb.econnect.eu pre presnú UBL štruktúru Order Change.

Zobraziť API dokumentáciu

Súvisiace