Excepciones de KSeF al enviar una factura: 21405, 21180, 21184 y el resto

Cómo verlos en Odoo

Cuando KSeF rechaza la petición, l10n_pl_edi en Odoo 18, 19 y 20 enseña en la factura «Error when sending invoices to the KSeF» y, debajo, «KSeF API Error: » con la respuesta tal como llegó, exceptionCode incluido. En la 18 y la 19 en polaco: «Podczas wysyłania faktur do KSeF wystąpił błąd» y «Błąd API KSeF: …». Si KSeF se niega ya al abrir la sesión, el mensaje empieza por «Failed to open KSeF session: ». La factura no recibe estado KSeF, así que, una vez corregida, la envías igual que antes.

Códigos, textos y qué hacer

La sesión en Odoo

Odoo guarda el número de la sesión interactiva en la empresa. Antes de enviar pregunta a KSeF por su estado: si es 100, sesión abierta, la sigue usando; si no, abre otra con el formulario FA (3) 1-0E. Por eso el 21180 suele desaparecer en el intento siguiente. Con el 21173 es distinto: en el envío siguiente Odoo pregunta por esa misma sesión, recibe el mismo error («Failed to check KSeF session: …») y no abre otra. La sesión guardada solo se borra quitando el certificado KSeF en los ajustes y guardando, y volviendo a añadir el certificado después. Esto sale del código de Odoo; no lo hemos probado contra KSeF. Ante un 21184, KSeF sugiere una sesión nueva, pero Odoo solo la abre cuando la guardada deja de tener el estado 100; si el error se repite, espera, como aconseja el mensaje.

Los códigos 21402 y 21403 van de cálculos que hace el propio programa que envía: Odoo calcula la huella y el tamaño de la factura antes y después de cifrarla. Con un Odoo estándar no salen de los datos de la factura. Odoo no envía correcciones técnicas de facturas offline, así que el 21166 y el 21167 vienen de otro programa.

Antes de avisar del problema

• Copia el mensaje entero de Odoo, con el JSON que sigue a «KSeF API Error:».
• Apunta el código y el texto de details.
• Mira si el error afecta a una factura o a todas las que se están enviando.
• Mira si pasa en producción o en el entorno de pruebas.

Estados de la propia sesión: 440 y 445

La sesión interactiva también tiene estado. El 440 «Sesja anulowana» (sesión anulada) con details «Nie przesłano faktur» significa que en la sesión no se envió ninguna factura, y el 445 «Błąd weryfikacji, brak poprawnych faktur», que ninguna pasó la verificación. Odoo solo mira si la sesión tiene el estado 100, así que no los enseñará; busca la causa en los estados de las facturas, como el 450.

Nuestro módulo, Poland KSeF 2.0 Validator, no envía facturas ni ve estos códigos; con la suscripción a FlexigoTech Cloud, si pulsas «Validate FA(3) (FlexigoTech Cloud)» antes de enviar la factura, revisa el fichero FA(3) contra el esquema. Ese resultado no frena el envío de l10n_pl_edi: una factura «Not valid» sale igual si la envías.

Sigue leyendo