Salta al contingut principal
KSeF 2.0 · estat de la factura

Estats tècnics de la factura a KSeF: 550, 500, 405, 430 i 435

Cinc estats de la factura indiquen un problema en processar-la i no en les dades de la factura. Odoo els tracta de manera diferent: quatre acaben en Rejected i en un enviament nou, i el 550, que Odoo no coneix, deixa la factura en Sent.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 5 de novembre de 2026

L'essencial

Mòdul
KSeF 2.0
Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del mòdul, versió 20.0 · a les fonts enllaçades al final
Lectura
3 min

Què diu KSeF

CodiText de KSeFEstat a Odoo 18, 19 i 20
550«Operacja została anulowana przez system» (anul·lada pel sistema), details «Przetwarzanie zostało przerwane z przyczyn wewnętrznych systemu. Spróbuj ponownie» (interromputa per causes internes; torna-ho a provar)Es queda a Sent (In Progress)
500«Nieznany błąd ({statusCode})» (error desconegut)Rejected, amb la descripció de KSeF
405«Przetwarzanie anulowane z powodu błędu sesji» (procés anul·lat per un error de la sessió)Rejected
430«Błąd weryfikacji pliku faktury» (error en verificar el fitxer de la factura)Rejected
435«Błąd odszyfrowania pliku» (error en desxifrar el fitxer)Rejected
Targeta dels estats tècnics de la factura a KSeF
L'estat 550 amb el seu text de l'API i la resta d'estats tècnics: 500, 405, 430 i 435.

550: la factura es queda encallada a Sent

Odoo només tradueix a els seus estats els codis 100, 150, 200, 405, 410, 415, 430, 435, 440, 450 i 500. Qualsevol altre, també el 550, acaba en el missatge «Unknown status received from KSeF (Code: 550): …» (en polonès a la 18 i la 19: «Otrzymano nieznany status od KSeF (kod: 550): …») i no canvia «KSeF Status». La factura es queda a Sent (In Progress) i Odoo no hi mostra el botó de tornar a esborrany.

KSeF diu «torna-ho a provar», però Odoo no ho pot fer des de la factura: només envia factures sense estat KSeF. El botó «Check Sending» i l'acció programada només tornen a preguntar per l'estat, que continuarà sent 550.

Sortir d'aquest estat exigeix un canvi fora de la interfície d'Odoo, així que avisa el teu partner o qui mantingui el teu Odoo. Això surt del codi d'Odoo 18, 19 i 20; no ho hem provat contra el KSeF de producció.

500, 405, 430 i 435: rebutjades, preparades per reenviar

Amb aquests quatre, Odoo posa l'estat en Rejected. Amb el 500 hi afegeix la descripció de KSeF; amb els altres mostra el seu text fix. La documentació de KSeF no dona una llista de causes per a ells més enllà del que diu el seu nom:

  • 405: es va anul·lar el procés per un error de la sessió en què es va enviar la factura;
  • 430: KSeF no va poder verificar el mateix fitxer de la factura;
  • 435: KSeF no va poder desxifrar el fitxer, que el programa que envia xifra amb AES-256-CBC i la clau que passa en obrir la sessió.

Odoo munta i xifra el fitxer ell mateix, així que un 430 o un 435 que es repeteix apunta al programa que envia, no a les dades de la factura.

Esquema: què retorna KSeF amb l'estat 550 i què mostra Odoo 20
Esquema fet a partir del codi de l10n_pl_edi d'Odoo 20 i de l'especificació de l'API de KSeF 2.9.0; el que està ratllat és el que Odoo no guarda o no fa.

Què fer

  1. Amb el 500, el 405, el 430 i el 435, restableix la factura a esborrany (Odoo esborra aleshores el seu estat i el seu número KSeF), confirma-la i envia-la un altre cop.
  2. Amb el 550, torna a consultar l'estat amb «Check Sending». Si continua en 550, el procés es va interrompre i la factura s'ha d'enviar de nou.
  3. Passa-la aleshores a qui mantingui el teu Odoo perquè l'enviï un altre cop. Si l'envies per un altre canal, a Odoo es quedarà en Sent.

El nostre mòdul, Poland KSeF 2.0 Validator, només pren l'estat de l10n_pl_edi: amb un 550 la factura també es queda en Submitted al mòdul.

Continua llegint

Codi 450 de KSeF: «Błąd weryfikacji semantyki dokumentu faktury»El codi 450 de KSeF rebutja una factura FA(3) després de revisar-ne el contingut. On és el motiu real, què no mostra Odoo 18, 19 i 20 i com tornar-la a enviar.Excepcions de KSeF en enviar una factura: 21405, 21180, 21184 i la restaExcepcions de KSeF en enviar una factura: 21405, 21001, 21155, 21166, 21167, 21173, 21180, 21184, 21402 i 21403. Què signifiquen i com es veuen a Odoo.KSeF HTTP 429, 403 i 401: límits de peticions i accés denegatKSeF 2.0 respon 429 Too Many Requests en superar el límit, 403 amb reasonCode si falta accés i 401 amb el token caducat. Límits i què fan Odoo 18, 19 i 20.
Comprovat al codi del mòdul (versió 20.0) i a les fonts enllaçades

Fonts