Coduri de stare și de eroare KSeF explicate
Când KSeF, sistemul național polonez de facturare electronică, nu acceptă o factură, îi dă un cod de stare, de exemplu 440 sau 450, sau răspunde la cerere cu un cod de eroare, de exemplu 21405. Găsește mai jos codul tău ca să vezi ce înseamnă, care este cauza obișnuită și ce trebuie să schimbi înainte să trimiți din nou factura.
Pe scurt
Ce înseamnă codurile de stare și de eroare KSeF, precum 440, 450 sau 21405, de ce nu a acceptat sistemul polonez factura și ce trebuie să schimbi.
Lista cuprinde 32 de coduri din documentele oficiale de mai jos. 5 dintre ele au pagina proprie; 27 dintre ele sunt explicate doar în tabel, deoarece sunt statusuri de sistem sau de transport fără nimic de corectat în factură.
Lista nu include 21111, 21115, 21117, 21217, 21301, 21304, 21308, 21401, 21406, 9101, 9102, 9103, 9105, 21164, 21165, 21175, 21181, 21182, 21183, 21418, 25001, 25002, 25003, 25004, 25005, 25006, 25007, 25008, 25009, 25010, 25011, 26001, 26002, 30001, 71001, 71002, 71004, 71005, care vizează un alt proces decât trimiterea unei facturi.
Coduri de stare ale facturii
| Cod | Ce înseamnă |
|---|---|
| 405 | Prelucrare anulată din cauza unei erori de sesiune KSeF: statusul 405 al facturii înseamnă că prelucrarea facturii a fost anulată din cauza unei erori în sesiunea în care a fost trimisă. Remediază ce indică statusul sesiunii, apoi trimite factura din nou într-o sesiune nouă. |
| 410 | Nu ai permisiunea de a emite această factură |
| 415 | Factură cu atașament neacceptată |
| 430 | Fișierul facturii nu a trecut verificarea |
| 435 | Fișierul facturii nu a putut fi decriptat KSeF: statusul 435 al facturii înseamnă că KSeF nu a putut decripta fișierul facturii. Cere firmei care îți oferă programul de facturare să verifice criptarea, apoi trimite factura din nou. |
| 440 | Factură duplicat |
| 450 | Conținutul facturii nu a trecut verificările |
| 500 | Eroare necunoscută KSeF: statusul 500 înseamnă că a apărut o eroare necunoscută în timp ce KSeF prelucra factura sau sesiunea. Verifică statusul din nou mai târziu. Dacă rămâne 500, contactează asistența KSeF cu numărul de referință, înainte să decizi dacă trimiți factura din nou. |
| 550 | Operațiune anulată de sistem KSeF: statusul 550 înseamnă că sistemul a anulat operațiunea. Încearcă din nou, așa cum recomandă documentația KSeF. |
Coduri de stare ale sesiunii
| Cod | Ce înseamnă |
|---|---|
| 405 | Pachetul de facturi nu a trecut verificarea KSeF: statusul 405 al sesiunii înseamnă că elementele pachetului de facturi nu au trecut verificarea KSeF. Cere firmei care îți oferă programul de facturare să verifice cum este construit și declarat pachetul, apoi trimite-l într-o sesiune nouă în lot. |
| 415 | Cheia sesiunii nu a putut fi decriptată KSeF: statusul 415 al sesiunii înseamnă că KSeF nu a putut decripta cheia primită. Cere firmei care îți oferă programul de facturare să verifice criptarea cheii și cheia publică folosită, apoi deschide o sesiune nouă și trimite din nou facturile. |
| 420 | Prea multe facturi în sesiune KSeF: statusul 420 al sesiunii înseamnă că sesiunea a depășit limita de facturi. Împarte facturile în mai multe sesiuni și trimite-le din nou. |
| 430 | Arhiva lotului nu a putut fi decomprimată KSeF 430, la nivel de sesiune, înseamnă că portalul polonez de facturare electronică nu a putut decomprima arhiva ZIP originală a lotului. Cere producătorului programului tău să refacă pachetul, apoi trimite-l într-o sesiune nouă de trimitere în lot. |
| 435 | Părțile arhivei nu au putut fi decriptate KSeF 435, la nivel de sesiune, înseamnă că portalul polonez de facturare electronică nu a putut decripta părțile criptate ale arhivei lotului. Cere producătorului programului tău să verifice criptarea părților, apoi trimite pachetul într-o sesiune nouă de trimitere în lot. |
| 440 | Sesiunea a fost anulată KSeF 440, la nivel de sesiune, înseamnă că sesiunea din portalul polonez de facturare electronică a fost anulată. Deschide o sesiune nouă și trimite facturile în timpul permis. |
| 445 | Nicio factură validă în sesiune KSeF 445, la nivel de sesiune, înseamnă că verificarea nu a găsit nicio factură validă în sesiune. Corectează erorile raportate pentru facturi, verifică dacă sesiunea include facturi valide și trimite din nou facturile. |
Coduri de eroare la trimitere
| Cod | Ce înseamnă |
|---|---|
| 21001 | Conținutul cererii nu poate fi citit KSeF 21001 înseamnă că portalul polonez de facturare electronică nu a putut citi conținutul cererii. Cere producătorului programului tău să verifice cererea în raport cu aceste detalii, apoi trimite-o din nou. |
| 21155 | Prea multe facturi în sesiune KSeF 21155 înseamnă că sesiunea din portalul polonez de facturare electronică a atins numărul de facturi permis. Închide sesiunea și trimite facturile rămase într-una nouă. |
| 21157 | Dimensiune incorectă a unei părți din pachet KSeF 21157 înseamnă că dimensiunea unei părți din pachetul lotului nu este validă. Refă pachetul astfel încât fiecare parte să respecte limita și să corespundă dimensiunii declarate, apoi trimite-l într-o sesiune nouă de trimitere în lot. |
| 21161 | Prea multe părți în pachet KSeF 21161 înseamnă că pachetul lotului are mai multe părți decât permite portalul polonez de facturare electronică. Împarte facturile în mai multe sesiuni de trimitere în lot și trimite-le din nou. |
| 21166 | Corecția tehnică nu este disponibilă KSeF 21166 înseamnă că nu se poate trimite o corecție tehnică, pentru că factura are deja o corecție tehnică pe care KSeF a procesat-o corect. Verifică starea corecției tehnice anterioare, în loc să trimiți alta. |
| 21167 | Starea facturii nu permite corecția tehnică KSeF 21167 înseamnă că a fost trimisă o corecție tehnică pentru o factură pe care KSeF a procesat-o corect. Verifică dacă hashOfCorrectedInvoice conține hash-ul facturii offline respinse, nu al uneia acceptate. |
| 21173 | Sesiunea nu a fost găsită KSeF 21173 înseamnă că în portalul polonez de facturare electronică nu există nicio sesiune cu numărul de referință indicat. Folosește numărul de referință corect al sesiunii și trimite din nou cererea. |
| 21178 | Confirmarea UPO nu a fost găsită KSeF 21178 înseamnă că portalul polonez de facturare electronică nu a găsit nicio confirmare UPO, adică confirmarea oficială de primire, pentru criteriile indicate. Corectează numerele și cere din nou confirmarea UPO. |
| 21180 | Starea sesiunii nu permite operațiunea KSeF 21180 înseamnă că starea sesiunii nu permite operațiunea cerută, de exemplu trimiterea facturilor sau închiderea sesiunii. Verifică starea sesiunii. Pentru a trimite alte facturi, deschide o sesiune nouă. |
| 21184 | Sesiunea este temporar indisponibilă KSeF 21184 înseamnă că sesiunea este temporar indisponibilă din cauza unor lucrări de mentenanță. Încearcă din nou mai târziu sau deschide o sesiune nouă pentru a trimite alte facturi, așa cum indică detaliile erorii. |
| 21205 | Pachet gol: lipsește o parte declarată KSeF 21205 înseamnă că pachetul nu poate fi gol: o parte declarată nu a fost trimisă. Trimite partea lipsă indicată în detalii și verifică dacă toate părțile declarate au fost trimise. |
| 21208 | Timpul pentru trimitere a expirat KSeF 21208 înseamnă că a expirat timpul permis pentru cererile upload sau finish, iar sesiunea a fost anulată. Deschide o sesiune nouă de trimitere în lot și trimite părțile în timpul permis. |
| 21402 | Dimensiunea fișierului nu este corectă KSeF 21402 înseamnă că lungimea conținutului trimis nu corespunde cu dimensiunea declarată a fișierului. Cere furnizorului programului tău de contabilitate să verifice dacă dimensiunea declarată este cea a fișierului trimis, apoi trimite fișierul din nou. |
| 21403 | Amprenta fișierului nu este corectă KSeF 21403 înseamnă că amprenta (hash) conținutului trimis nu corespunde cu amprenta declarată a fișierului. Cere furnizorului programului tău de contabilitate să verifice dacă amprenta declarată este calculată din fișierul trimis, apoi trimite-l din nou. |
| 21405 | Datele din cerere nu au trecut verificarea KSeF 21405 înseamnă că datele din cerere nu au trecut verificarea. Corectează ce indică detaliile și trimite cererea din nou. |
| 21470 | Cheie necunoscută sau retrasă KSeF 21470 înseamnă că identificatorul cheii trimis este necunoscut sau indică o cheie retrasă. Cere furnizorului programului tău de contabilitate să folosească un identificator de cheie acceptat, apoi trimite cererea din nou. |
Citește documentul oficial
- KSeF API 2.0, specyfikacja OpenAPI (open-api.json) Sursa: KSeF API 2.0, specyfikacja OpenAPI (open-api.json), versiunea 2.9.0, publicată de Ministerstwo Finansów, consultată la 8 noiembrie 2026. Text oficial în limba originală, preluat din Ministerstwo Finansów, KSeF 2.0 Przewodnik dla Integratorów (github.com/CIRFMF/ksef-api), Copyright (c) 2025 Ministerstwo Finansów. Licență: MIT License.
- Weryfikacja faktury Sursa: Weryfikacja faktury, versiunea 09.04.2026, publicată de Ministerstwo Finansów, consultată la 8 noiembrie 2026. Text oficial în limba originală, preluat din Ministerstwo Finansów, KSeF 2.0 Przewodnik dla Integratorów (github.com/CIRFMF/ksef-api), Copyright (c) 2025 Ministerstwo Finansów. Licență: MIT License.
Întrebări frecvente
Unde văd statusul KSeF al unei facturi?
Programul tău de facturare îl citește din KSeF după trimitere: fiecare factură dintr-o sesiune primește un cod de stare, o descriere și, când KSeF le oferă, detalii. Statusul 200 înseamnă succes, iar 100 și 150 înseamnă că KSeF încă prelucrează factura.
De ce apare același număr de două ori?
KSeF folosește aceleași numere pentru statusul unei facturi și pentru statusul unei sesiuni, cu înțelesuri diferite. Pentru o factură, 440 înseamnă duplicat, iar pentru o sesiune înseamnă că sesiunea a fost anulată. Verifică pe care dintre cele două îl arată programul tău.
Ce coduri nu sunt listate?
Statusurile care arată progresul sau succesul și codurile de eroare pentru autentificare, certificate, tokenuri, permisiuni și descărcarea facturilor, care țin de alt proces decât trimiterea unei facturi.
De unde provin codurile?
Din documentația API KSeF 2.0 a Ministerului Finanțelor, publicată sub licența MIT. Pagina fiecărui cod citează textul oficial polonez și trimite la sursă.