Codi 450 de KSeF: «Błąd weryfikacji semantyki dokumentu faktury»

Què retorna KSeF

En l'especificació de l'API de KSeF 2.9.0, l'estat 450 d'una factura en sessió té una descripció fixa, «Błąd weryfikacji semantyki dokumentu faktury» (error de verificació semàntica del document de factura). El que falla en concret l'afegeix KSeF al camp details d'aquest mateix estat. El Ministeri de Finances polonès no publica la llista d'aquests missatges, de manera que no existeix una taula del tipus «450 és sempre aquest fallo».

Sí que hi ha casos que el Ministeri comprova a les proves de la seva pròpia biblioteca ksef-client-csharp i en què espera precisament el codi 450:

• data d'emissió P_1 posada a demà segons l'hora polonesa, perquè KSeF llegeix P_1 a la zona horària de Varsòvia i no admet una data posterior al moment en què rep la factura;
• DataWytworzeniaFa anterior a 2025-09-01T00:00:00Z, el límit inferior d'aquest camp a l'esquema FA(3) 1-0E.

Què veus a Odoo

Les factures arriben a KSeF amb el mòdul l10n_pl_edi d'Odoo, que existeix a Odoo 18, 19 i 20. Quan KSeF respon, posa «KSeF Status» en Rejected i escriu un missatge a l'historial de la factura:

De la resposta de KSeF, Odoo llegeix el codi, la descripció i el número KSeF. No guarda el camp details (només afegeix la descripció de KSeF amb el codi 500), de manera que Odoo per si sol no et diu quina part de la factura ha fallat.

D'on treure el motiu

El text de details arriba a la resposta de KSeF a la consulta de l'estat de la factura. Si envies des d'Odoo, necessites algú que el llegeixi de l'API o una comprovació del fitxer FA(3) abans d'enviar-lo. Odoo 18, 19 i 20 porten una còpia de l'esquema FA(3) dins del mòdul, però fora de les proves res no l'utilitza: el fitxer va a KSeF sense validar-se contra l'esquema.

Dues coses sí que vigila Odoo. No envia una factura amb data posterior a avui a la zona horària de l'usuari («The move was skipped because it is future-dated»). I omple DataWytworzeniaFa amb el moment en què genera el fitxer, en UTC, de manera que el límit de 2025 no hauria de sortir d'una factura emesa a Odoo.

Com tornar-la a enviar

1. Treu el motiu de details o revisa el fitxer FA(3) contra l'esquema.
2. Corregeix les dades a Odoo: data, client, línies.
3. Restableix la factura a esborrany. En una factura rebutjada, Odoo esborra el seu estat, número, referència i sessió de KSeF.
4. Confirma-la i envia-la de nou amb l'opció «by KSeF (e-Faktura)». Odoo només envia factures sense estat KSeF, així que sense el pas 3 no surt res.

Amb el nostre mòdul

Poland KSeF 2.0 Validator no envia factures a KSeF. Amb la subscripció a FlexigoTech Cloud, si prems «Validate FA(3) (FlexigoTech Cloud)» abans d'enviar la factura, valida el fitxer FA(3) contra l'esquema 1-0E i mostra cada error com una línia «[error] XSD (ruta)»: el lloc del fitxer, sense el text del missatge, fins a 100 errors. El resultat no atura l'enviament de l10n_pl_edi: una factura «Not valid» surt igualment si l'envies. No detecta el que KSeF només comprova pel seu costat, com P_1 davant del moment de recepció. Quan l10n_pl_edi envia la factura, la validació anterior passa a Expired i el mòdul revisa el fitxer que va rebre KSeF. A Odoo 17 valida el FA(3) que es puja a la factura.

Continua llegint