Chybové kódy — ePostman

Každá chyba SAPI má rovnaký tvar a hovorí vám, či má zmysel skúsiť to znova.

{
  "error": {
    "category": "VALIDATION",
    "code": "SAPI-VAL-003",
    "message": "payload is not well-formed XML",
    "correlation_id": "b1f0c2d4-7e19-4a3c-8f52-6d0e91ab7c33",
    "retryable": false,
    "timestamp": "2026-07-13T09:14:22.310Z"
  }
}

Kód	HTTP	Opakovať	Kedy nastane
`SAPI-AUTH-001`	401	nie	Neplatné prihlasovacie údaje alebo token
`SAPI-AUTH-002`	403	nie	Peppol identifikátor nepatrí vašej organizácii
`SAPI-AUTH-003`	401	nie	Chýba alebo je neplatná hlavička `Authorization`
`SAPI-AUTH-004`	403	nie	Účet je pozastavený alebo ešte nie je schválený
`SAPI-AUTH-005`	423	nie	Účet dočasne zamknutý po opakovaných neúspešných pokusoch
`SAPI-VAL-001`	400	nie	Zlý formát Peppol identifikátora
`SAPI-VAL-002`	400	nie	Chýba povinná hlavička alebo telo požiadavky
`SAPI-VAL-003`	400	nie	Pole `payload` nie je správne utvorené XML
`SAPI-VAL-006`	400	nie	`Idempotency-Key` nie je platné UUID
`SAPI-VAL-008`	400	nie	Poškodený `pageToken`
`SAPI-VAL-009`	409	nie	Ten istý idempotenčný kľúč s iným telom
`SAPI-VAL-010`	413	nie	Dokument je väčší než 10 MB
`SAPI-VAL-020`	400	nie	Token stránkovania expiroval (15 minút)
`SAPI-PROC-003`	502	áno	Dočasná chyba na našej strane
`SAPI-PROC-004`	402	nie	Nedostatočný kredit na odoslanie
`SAPI-PERM-002`	409	nie	Doklad s tým istým číslom, dodávateľom a typom (faktúra/dobropis) sa už spracúva alebo bol odoslaný
`SAPI-PERM-003`	404	nie	Dokument neexistuje
`SAPI-PERM-004`	410	nie	Dokumentu uplynula lehota archivácie
`SAPI-TEMP-001`	503	áno	Autentifikačná služba je dočasne nedostupná
`SAPI-TEMP-002`	429	áno	Prekročený limit požiadaviek — počkajte podľa `Retry-After`

Zlá metóda a neznáma cesta

Zlá HTTP metóda vráti 405 s hlavičkou Allow, ktorá menuje správnu — napríklad GET na /sapi/document/receive/{id}/acknowledge (endpoint je POST) odpovie 405 a Allow: POST. Kód v obálke je SAPI-VAL-002.

Neznáma cesta pod /sapi/ vráti 404 s kódom SAPI-PERM-003. Obe odpovede majú rovnakú chybovú obálku ako tabuľka vyššie.