Přijetí objednávky

Když zákazník odešle nákupní objednávku Vaší organizaci přes Peppol, přijmete ji jako prodejní objednávku v PSB. Přes webhook jste okamžitě informováni a následně můžete objednávku stáhnout a zpracovat.

Krok 1: Nastavení webhooku

Zaregistrujte webhook na topic OrderReceived, aby Vás PSB notifikovala při příchodu objednávky:

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

Webhook payload obsahuje mimo jiné documentId a senderPartyId, takže víte, jaká objednávka od jakého odesílatele přišla.

Krok 2: Stažení objednávky

Použijte documentId z webhook payloadu pro stažení objednávky:

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

Odpověď obsahuje UBL Order XML dokument. Standardně obdržíte dokument ve formátu, ve kterém byl odeslán. Chcete ho v jiném formátu? Použijte query parametr targetDocumentTypeId pro automatickou transformaci do požadovaného formátu.

Pozor: Přijaté dokumenty se uchovávají v PSB 90 dní. Po stažení zůstává dokument ještě 7 dní k dispozici. Stahujte proto objednávky včas a ukládejte je ve vlastním systému.

Krok 3: Zpracování objednávky

Po stažení zpracujete objednávku ve vlastním systému. U profilu Advanced Ordering se od Vás očekává, že odešlete Order Response kupujícímu. Možné stavy jsou:

Kód

Význam

Acknowledged, objednávka přijata a čitelná

Accepted, objednávka akceptována

Conditionally Accepted, objednávka akceptována se změnami

Rejected, objednávka zamítnuta

Response odešlete přes Order Response endpoint.

Webhook topics

Kromě OrderReceived jsou relevantní i další topics při přijímání objednávek:

Topic

Kdy

OrderReceived

Nová objednávka přijata

OrderChangeReceived

Kupující odeslal změnu objednávky

OrderCancellationReceived

Kupující chce objednávku stornovat

Odstranění dokumentu

Chcete přijatou objednávku manuálně odstranit z PSB? To je možné přes:

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

Často kladené otázky

Jak propojím webhook se stahováním příchozí objednávky?

Zaregistrujte webhook na topic OrderReceived. Payload obsahuje mimo jiné documentId a senderPartyId. S tímto documentId zavolejte GET /api/v1/{partyId}/salesOrder/{documentId}/download pro stažení UBL Order XML a jeho zpracování ve vlastním systému.

Proč musím při Advanced Ordering odeslat Order Response?

Při profilu Advanced Ordering kupující očekává, že jako dodavatel odpovíte pomocí Order Response. Používají se kódy AB (přijato a čitelné), AP (akceptováno), CA (podmíněně akceptováno) nebo RE (zamítnuto). Bez této odpovědi není proces podle profilu dokončen.

Jak dlouho zůstávají přijaté objednávky v PSB dostupné?

Přijaté dokumenty se v PSB uchovávají 90 dní. Po stažení zůstává dokument dostupný ještě 7 dní. Proto si objednávky včas uložte ve vlastním prostředí a naplánujte si integraci podle toho.

Podívejte se na kompletní API specifikaci na psb.econnect.eu pro všechny parametry a struktury odpovědí.

Otevřít API referenci