Prijatie objednávky

Keď zákazník odošle nákupnú objednávku Vašej organizácii cez Peppol, prijmete ju ako predajnú objednávku v PSB. Cez webhook ste okamžite informovaní a následne môžete objednávku stiahnuť a spracovať.

Krok 1: Nastavenie webhooku

Zaregistrujte webhook na topic OrderReceived, aby Vás PSB notifikovala pri príchode objednávky:

{
  "action": "https://jouw-endpoint.nl/orders",
  "topics": ["OrderReceived"],
  "secret": "jouw-geheime-sleutel"
}

Webhook payload obsahuje okrem iného documentId a senderPartyId, takže viete, aká objednávka od akého odosielateľa prišla.

Krok 2: Stiahnutie objednávky

Použite documentId z webhook payloadu na stiahnutie objednávky:

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

Odpoveď obsahuje UBL Order XML dokument. Štandardne obdržíte dokument vo formáte, v ktorom bol odoslaný. Chcete ho v inom formáte? Použite query parameter targetDocumentTypeId na automatickú transformáciu do požadovaného formátu.

Pozor: Prijaté dokumenty sa uchovávajú v PSB 90 dní. Po stiahnutí zostáva dokument ešte 7 dní k dispozícii. Sťahujte preto objednávky včas a ukladajte ich vo vlastnom systéme.

Krok 3: Spracovanie objednávky

Po stiahnutí spracujete objednávku vo vlastnom systéme. Pri profile Advanced Ordering sa od Vás očakáva, že odošlete Order Response kupujúcemu. Možné stavy sú:

Kód

Význam

Acknowledged, objednávka prijatá a čitateľná

Accepted, objednávka akceptovaná

Conditionally Accepted, objednávka akceptovaná so zmenami

Rejected, objednávka zamietnutá

Response odošlite cez Order Response endpoint.

Webhook topics

Okrem OrderReceived sú relevantné aj ďalšie topics pri prijímaní objednávok:

Topic

Kedy

OrderReceived

Nová objednávka prijatá

OrderChangeReceived

Kupujúci odoslal zmenu objednávky

OrderCancellationReceived

Kupujúci chce objednávku stornovať

Odstránenie dokumentu

Chcete prijatú objednávku manuálne odstrániť z PSB? To je možné cez:

DELETE /api/v1/{partyId}/salesOrder/{documentId}

Často kladené otázky

Ako prepojím webhook so sťahovaním prichádzajúcej objednávky?

Zaregistrujte webhook na topic OrderReceived. Payload obsahuje okrem iného documentId a senderPartyId. S týmto documentId zavolajte GET /api/v1/{partyId}/salesOrder/{documentId}/download na stiahnutie UBL Order XML a jeho spracovanie vo vlastnom systéme.

Prečo musím pri Advanced Ordering odoslať Order Response?

Pri profile Advanced Ordering kupujúci očakáva, že ako dodávateľ odpoviete pomocou Order Response. Používajú sa kódy AB (prijaté a čitateľné), AP (akceptované), CA (podmienečne akceptované) alebo RE (zamietnuté). Bez tejto odpovede nie je proces podľa profilu ukončený.

Ako dlho zostávajú prijaté objednávky v PSB dostupné?

Prijaté dokumenty sa v PSB uchovávajú 90 dní. Po stiahnutí zostáva dokument dostupný ešte 7 dní. Preto si objednávky včas uložte vo vlastnom prostredí a naplánujte si integráciu podľa toho.

Pozrite si kompletnú API špecifikáciu na psb.econnect.eu pre všetky parametre a štruktúry odpovedí.

Otvoriť API referenciu