/ docs
ProduktZnalostiVývojári
Platforma Control
Stornovanie objednávky (Order Cancellation)

Stornovanie existujúcej objednávky cez API: endpoint, flow a reakcia dodávateľa.

Objednávku, ktorá už bola odoslaná, môže kupujúci stornovať pomocou Order Cancellation. Dodávateľ prijme stornovanie a môže ho akceptovať alebo zamietnuť. Order Cancellations sú súčasťou profilu Peppol Advanced Ordering.

Endpoint
POST /api/v1/{partyId}/purchaseOrder/{documentId}/cancel

{partyId} je Peppol identifikátor kupujúceho. {documentId} je ID pôvodnej objednávky, ktorú chcete stornovať. Toto je ID dokumentu, ktoré ste obdržali pri odoslaní objednávky.

Pozor: Stornovanie je žiadosť, nie garancia. Dodávateľ môže stornovanie zamietnuť, napríklad ak je objednávka už vo výrobe. Až po prijatí Order Response so stavovým kódom AP (akceptované) je stornovanie definitívne.

Flow
  1. Kupujúci odošle žiadosť o stornovanie cez cancel endpoint
  2. Dodávateľ prijme stornovanie cez webhook OrderCancellationReceived
  3. Dodávateľ posúdi, či je možné stornovanie vykonať
  4. Dodávateľ odošle Order Response: AP (akceptované) alebo RE (zamietnuté)
  5. Kupujúci obdrží response cez webhook OrderResponseReceived
Prijatie ako dodávateľ

Nastavte webhook na topic OrderCancellationReceived:

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

Stiahnite dokument stornovania na zobrazenie dôvodu stornovania:

GET /api/v1/{partyId}/salesOrder/{documentId}/download
Webhook topics
TopicSmerKedyOrderCancellationSentKupujúciStornovanie bolo úspešne doručenéOrderCancellationReceivedDodávateľStornovanie bolo prijatéOrderResponseReceivedKupujúciDodávateľ reagoval na stornovanieOrderResponseSentDodávateľResponse na stornovanie bol odoslaný
Reagovanie na stornovanie

Ako dodávateľ reagujete na stornovanie cez Order Response endpoint. Relevantné stavové kódy sú:

KódVýznamAPStornovanie akceptované, objednávka sa nebude vykonávaťREStornovanie zamietnuté, objednávka zostáva aktívna
Často kladené otázky
Aké `documentId` použijem v cancel endpointe?

Použite ID dokumentu pôvodnej objednávky, ktoré ste dostali od PSB pri odosielaní (POST .../purchaseOrder/send). Cesta je POST /api/v1/{partyId}/purchaseOrder/{documentId}/cancel, kde {partyId} je Peppol identifikátor kupujúceho.

Je zrušenie okamžite definitívne, keď je požiadavka úspešná?

Nie. Zrušenie je požiadavka. Dodávateľ ju môže odmietnuť, napríklad ak je objednávka už v realizácii. Až keď dostanete Order Response s kódom AP, je zrušenie podľa toku akceptované.

Ako zapadá Order Cancellation do profilu Advanced Ordering?

Order Cancellation patrí k Advanced Ordering: dodávateľ dostane OrderCancellationReceived, môže si stiahnuť dokument o zrušení a odpovie cez Order Response s AP (akceptované) alebo RE (zamietnuté). Kupujúci sleduje výsledok okrem iného cez OrderResponseReceived.

Pozrite si kompletnú API špecifikáciu na psb.econnect.eu pre presnú štruktúru požiadaviek a odpovedí.

Vyskúšajte to v API

PreviousZmena objednávky
NextOrder Response