/ docs
ProduktZnalostiVývojári
Platforma Control
Tok dokumentu a stavové správy

Ako dokument prechádza šiestimi fázami PSB: od Submit po Delivered alebo Failed, so stavovými správami, webhookmi a zásadami opakovania.

Dokument odoslaný cez PSB prechádza pevnou sekvenciou fáz spracovania — od odoslania po potvrdené doručenie alebo definitívne zlyhanie. V každom prechodovom bode PSB zverejní stavovú správu, ktorú možno získať cez stavové API alebo zachytiť cez webhook.

Šesť fáz dokumentu
Submit → Validate → Transform → Route → Acknowledge → Delivered
                                                   ↘ Failed
FázaČo sa dejeTypické témySubmitDokument bol odoslaný cez API, hook mailfrom, SFTP pull alebo inú vstupnú metódu.PendingValidatePSB overuje dokument podľa schémy a obchodných pravidiel (napr. NLCIUS, Peppol BIS Billing, DICO).Validated, *ReceivedError pri chybeTransformVoliteľná konverzia formátu cez modul Transform. Interný krok.(interný, bez samostatnej témy)RoutePSB určuje cieľ: Peppol, e-mail, SFTP alebo iný kanál.RoutedAcknowledgePotvrdenie od prijímacieho prístupového bodu alebo kanálu.AcknowledgedDelivered / FailedDoručenie je potvrdené alebo definitívne zlyhalo po vyčerpaní všetkých pokusov.*Sent, *SentError
Stavové kódy
StavVýznamKonečný stav?PendingOdoslané, overenie ešte nezahájenéNieValidatedOverenie úspešnéNieRoutedCieľ určený, pripravený na doručenieNieDeliveredDoručenie potvrdené príjemcom alebo kanálomÁnoRejectedOdmietnuté príjemcom (napr. cez MLS Reject)ÁnoFailedDoručenie definitívne zlyhalo po všetkých pokusochÁno
Zásady opakovania pre doručenie dokumentov
ParameterHodnotaMaximálny počet pokusov8Celková doba opakovania~3 dni (cca 72 hodín) od prvého pokusuOpakovateľné kódy5xx a 429Neopakovateľné4xx (okrem 429) — okamžitý *SentErrorBackoffExponenciálny
Zásady opakovania pre doručenie webhookov
ParameterHodnotaMaximálny počet pokusov12Celková doba opakovania~6 dní (cca 137 hodín) od prvého pokusuBackoffExponenciálnyČasový limit na pokus100 sekúndUdalosť na pokusHookSentRetryUdalosť po definitívnom zlyhaníHookSentError
Často kladené otázky
Ako sledovať stav odoslaného dokumentu?

Máte dve možnosti. Cez stavové API (GET …/salesInvoice/{documentId}/status) získate aktuálny stav. Pre sledovanie v reálnom čase nastavte webhooki na relevantné témy, ako sú InvoiceSent, InvoiceSentRetry a InvoiceSentError.

Ako dlho sa PSB pokúša doručiť dokument?

PSB automaticky opakuje doručenie až 8-krát po dobu približne 3 dní (72 hodín). Po definitívnom zlyhaní nasleduje {DocumentType}SentError a je potrebná manuálna akcia.

Ako dlho sa PSB pokúša doručiť webhook?

PSB sa pokúša doručiť upozornenie cez webhook až 12-krát, rozložených na približne 6 dní (137 hodín). Po definitívnom zlyhaní nasleduje udalosť HookSentError.

Zobraziť interaktívnu dokumentáciu API

Súvisiace

Prehľad PSB: architektúra a možnosti
Spracovanie chýb a logika opakovania
Idempotencia: zabranie duplicitnému odosielaniu
PreviousSpracovanie chýb
NextNastavenie webhookov