Tok dokumentu a stavové zprávy

Jak dokument prochází šesti fázemi PSB: od Submit po Delivered nebo Failed, se stavovými zprávami, webhooky a zásadami opakování.

Dokument odeslaný přes PSB prochází pevnou sekvencí fází zpracování — od odeslání po potvrzené doručení nebo definitivní selhání. V každém přechodovém bodě PSB zveřejní stavovou zprávu, kterou lze získat přes stavové API nebo zachytit přes webhook.

Šest fází dokumentu
Submit → Validate → Transform → Route → Acknowledge → Delivered
                                                   ↘ Failed
FázeCo se dějeTypická témataSubmitDokument byl odeslán přes API, hook mailfrom, SFTP pull nebo jinou vstupní metodu.PendingValidatePSB ověřuje dokument podle schématu a obchodních pravidel (např. NLCIUS, Peppol BIS Billing, DICO).Validated, *ReceivedError při chyběTransformVolitelná konverze formátu přes modul Transform. Interní krok.(interní, bez samostatného tématu)RoutePSB určuje cíl: Peppol, e-mail, SFTP nebo jiný kanál.RoutedAcknowledgePotvrzení od přijímacího přístupového bodu nebo kanálu.AcknowledgedDelivered / FailedDoručení je potvrzeno nebo definitně selhalo po vyčerpání všech pokusů.*Sent, *SentError
Stavové kódy
StavVýznamKonečný stav?PendingOdesláno, ověření ještě nezahájenoNeValidatedOvěření úspěšnéNeRoutedCíl určen, připraven k doručeníNeDeliveredDoručení potvrzeno příjemcem nebo kanálemAnoRejectedOdmítnuto příjemcem (např. přes MLS Reject)AnoFailedDoručení definitně selhalo po všech pokusechAno
Zásady opakování pro doručení dokumentů
ParametrHodnotaMaximální počet pokusů8Celková doba opakování~3 dny (cca 72 hodin) od prvního pokusuOpakovatelné kódy5xx a 429Neopakovatelné4xx (kromě 429) — okamžitý *SentErrorBackoffExponenciální
Zásady opakování pro doručení webhooků
ParametrHodnotaMaximální počet pokusů12Celková doba opakování~6 dní (cca 137 hodin) od prvního pokusuBackoffExponenciálníČasový limit na pokus100 sekund

| Událost na pokus | HookSentRetry | | Událost po definitním selhání | HookSentError |

Idempotence v toku

Endpointy Submit podporují idempotenci přes hlavičku X-EConnect-DocumentId. Při duplicitním odeslání vrátí PSB HTTP 409 Conflict. Opakované požadavky, například po síťové chybě, se tak nikdy nezpracují dvakrát. Úplné vysvětlení najdete v Idempotence.

Často kladené otázky
Jak sledovat stav odeslaného dokumentu?

Máte dvě možnosti. Přes stavové API (GET …/salesInvoice/{documentId}/status) získáte aktuální stav. Pro sledování v reálném čase nastavte webhooky na relevantní témata, jako jsou InvoiceSent, InvoiceSentRetry a InvoiceSentError.

Jak dlouho se PSB pokouší doručit dokument?

PSB automaticky opakuje doručení až 8krát po dobu přibližně 3 dnů (72 hodin). Po definitním selhání následuje {DocumentType}SentError a je nutná ruční akce.

Jak dlouho se PSB pokouší doručit webhook?

PSB se pokouší doručit upozornění přes webhook až 12krát, rozložených na přibližně 6 dní (137 hodin). Po definitním selhání následuje událost HookSentError.

Zobrazit interaktivní dokumentaci API