Každý prechod vieme poslať ako webhook.
Odchádzajúca faktúra
PENDING→VALIDATING→READY→ACCEPTED
READY znamená, že faktúra prešla validáciou a čaká na odoslanie cez AS4 —
samotné odosielanie sa v stave faktúry samostatne nesleduje. ACCEPTED
nastane, keď protistrana potvrdí prevzatie kladnou MLS správou; vtedy sa
odpočíta rezervovaný kredit. Daňové hlásenie beží súbežne a stav odchádzajúcej
faktúry cez Peppol neovplyvňuje — ak ho finančná správa odmietne, faktúra
zostane ACCEPTED a hlásenie sa pošle znova.
Domáci tok mimo Peppolu
PENDING→VALIDATING→READY→DELIVERED_NON_PEPPOL
Pre odberateľa 0245:9970300001 (domáca náhrada mimo siete Peppol) sa
dokument cez AS4 vôbec neodosiela — ide iba daňové hlásenie na finančnú
správu. Po jeho prijatí faktúra prejde rovno do DELIVERED_NON_PEPPOL a
kredit sa odpočíta okamžite, bez čakania na doručenie cez Peppol.
Prichádzajúca faktúra
RECEIVED→VALIDATED→DELIVERED→ACKNOWLEDGED
Prijatie do systému nastaví RECEIVED. Po validácii prejde na VALIDATED
(alebo na VALIDATION_FAILED, ak zlyhá) — vtedy zároveň odosielateľovi
pošleme pozitívnu, alebo negatívnu MLS správu. DELIVERED potvrdzuje, že sme
dokument prevzali. ACKNOWLEDGED nenastáva automaticky — nastaví ho až
explicitné volanie POST /sapi/document/receive/{id}/acknowledge.
Neúspešné konce
VALIDATION_FAILEDUNDELIVERABLEFAILEDUNCONFIRMEDREJECTEDCANCELLED
| Stav | Čo sa stalo a čo s tým |
|---|
VALIDATION_FAILED | Prijatý dokument neprešiel validáciou. Odosielateľovi sme automaticky poslali zápornú MLS správu s dôvodom; daňové hlásenie sa negeneruje. Týka sa to len prichádzajúcich dokumentov — vaša vlastná odchádzajúca faktúra, ktorá neprejde validáciou, skončí ako REJECTED nižšie. |
UNDELIVERABLE | Príjemcu sa nepodarilo nájsť v smerovacom registri (SMP). Odoslanie sme trikrát zopakovali (5 s, 30 s, 15 min) a potom sme ho vzdali; rezervovaný kredit sa vrátil. Overte si odberateľovo Peppol ID — najčastejšou príčinou je preklep alebo firma, ktorá do siete Peppol ešte nevstúpila. |
FAILED | Odberateľa sme našli, ale samotný prenos zlyhal — jeho prístupový bod bol nedostupný alebo odmietol spojenie. Rovnaké tri pokusy, rovnaké vrátenie kreditu. Na rozdiel od UNDELIVERABLE nie je chyba na vašej strane: skúste faktúru poslať znova s novým idempotenčným kľúčom neskôr, a ak sa to opakuje, ozvite sa podpore. |
UNCONFIRMED | Dokument z nášho systému odišiel a protistrana ho na úrovni prenosu prevzala, ale potvrdenie o doručení (MLS) nedorazilo v očakávanom čase. Nie je to zlyhanie odoslania — faktúra je s najväčšou pravdepodobnosťou doručená, len to nevieme potvrdiť. Kredit je odpočítaný. Ak protistrana tvrdí, že faktúru nemá, ozvite sa podpore. |
REJECTED | Vaša odchádzajúca faktúra vôbec neprešla validáciou a do siete sa nedostala, alebo ju protistrana odmietla zápornou MLS správou. Pri príjemcovi mimo siete Peppol nastáva aj vtedy, keď daňové hlásenie odmietne finančná správa. Ak je faktúra prevzatá cez Peppol a zamietne sa len daňové hlásenie, stav zostáva ACCEPTED a hlásenie sa posiela znova. Rezervovaný kredit sa uvoľní. Pri validácii opravte XML a pošlite ho znova s novým idempotenčným kľúčom; pri obchodnom odmietnutí je technicky všetko v poriadku, riešte to s protistranou. |
CANCELLED | Zrušili ste ju sami, kým bola ešte PENDING alebo VALIDATING — neskôr už zrušenie nie je možné. |
Every transition can be delivered as a webhook.
Outbound invoice
PENDING→VALIDATING→READY→ACCEPTED
READY means the invoice passed validation and is queued for AS4 delivery —
the send itself is not tracked as a separate invoice state. ACCEPTED is set
once the other side confirms receipt with a positive MLS message; the reserved
credit is deducted at that point. Tax reporting runs in parallel and does not
affect the state of an outgoing Peppol invoice — if the tax authority rejects
the report, the invoice stays ACCEPTED and the report is resubmitted.
Non-Peppol domestic flow
PENDING→VALIDATING→READY→DELIVERED_NON_PEPPOL
For the receiver 0245:9970300001 (the domestic substitute outside the
Peppol network), the document is never sent over AS4 at all — only the tax
report goes to the tax authority. Once it is accepted, the invoice moves
straight to DELIVERED_NON_PEPPOL and credit is deducted immediately,
without waiting for delivery over Peppol.
Inbound invoice
RECEIVED→VALIDATED→DELIVERED→ACKNOWLEDGED
Receipt sets RECEIVED. After validation it moves to VALIDATED (or to
VALIDATION_FAILED on failure) — at that point we also send the sender a
positive or negative MLS message. DELIVERED confirms that we took the
document. ACKNOWLEDGED does not happen
automatically — it is only set by an explicit call to
POST /sapi/document/receive/{id}/acknowledge.
Failure states
VALIDATION_FAILEDUNDELIVERABLEFAILEDUNCONFIRMEDREJECTEDCANCELLED
| State | What happened, and what to do |
|---|
VALIDATION_FAILED | A received document failed validation. We automatically sent the sender a negative MLS message with the reason; no tax report is generated. This applies only to inbound documents — your own outbound invoice failing validation ends up as REJECTED below instead. |
UNDELIVERABLE | The recipient could not be found in the routing registry (SMP). We retried three times (5 s, 30 s, 15 min) and then gave up; the reserved credit was returned. Check the buyer’s Peppol ID — a typo, or a company that has not joined the Peppol network yet, is the usual cause. |
FAILED | We found the buyer, but the transfer itself failed — their access point was unreachable or refused the connection. Same three attempts, same credit refund. Unlike UNDELIVERABLE this is not something on your side: resend the invoice later with a new idempotency key, and contact support if it keeps happening. |
UNCONFIRMED | The document left our system and the other side took it at the transport level, but the delivery confirmation (MLS) did not arrive in the expected time. This is not a send failure — the invoice was most likely delivered, we just cannot confirm it. The credit is deducted. If the other party says they do not have the invoice, contact support. |
REJECTED | Your outbound invoice failed validation outright and never entered the network, or the other side rejected it with a negative MLS message. For a recipient outside the Peppol network it also happens when the tax authority rejects the tax report. If the invoice was taken over Peppol and only the tax report is rejected, the status stays ACCEPTED and the report is resubmitted. Reserved credit is released. For a validation failure, fix the XML and resend with a new idempotency key; for a commercial rejection, nothing technically failed — resolve it with the other party. |
CANCELLED | You cancelled it yourself while it was still PENDING or VALIDATING — cancellation is not possible afterwards. |