/ docs
ProduktZnalostiVývojáři
Platforma Control
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 sekundUdálost na pokusHookSentRetryUdálost po definitním selháníHookSentError
Č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

Související

Přehled PSB: architektura a možnosti
Zpracování chyb a logika opakování
Idempotence: zabránění duplicitnímu odesílání
PreviousZpracování chyb
NextNastavení webhooků