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.
Submit → Validate → Transform → Route → Acknowledge → Delivered
↘ Failed
PendingValidated, *ReceivedError při chyběRoutedAcknowledged*Sent, *SentErrorPendingValidatedRoutedDeliveredRejectedFailed*SentError| Událost na pokus | HookSentRetry |
| Událost po definitním selhání | HookSentError |
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.
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.
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.
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