Códigos de estado y error de KSeF explicados
Cuando KSeF, el sistema nacional de facturación electrónica de Polonia, no acepta una factura, le asigna un código de estado, como 440 o 450, o responde a la solicitud con un código de error, como 21405. Busca tu código más abajo para ver qué significa, cuál es la causa habitual y qué cambiar antes de volver a enviar la factura.
En resumen
Qué significan los códigos de estado y error de KSeF, como 440, 450 o 21405, por qué el sistema polaco no aceptó la factura y qué cambiar.
Esta lista incluye 32 códigos de los documentos oficiales indicados abajo. 5 tienen su propia página; 27 se explican solo en la tabla, ya que son estados del sistema o del transporte sin corrección posible en la factura.
Fuera de esta lista: 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, por pertenecer a un proceso distinto del envío de una factura.
Códigos de estado de factura
| Código | Qué significa |
|---|---|
| 405 | Procesamiento cancelado por un error de la sesión KSeF, estado de factura 405: se canceló el procesamiento de la factura por un error en la sesión en la que se envió. Corrige lo que indique el estado de la sesión y vuelve a enviar la factura en una sesión nueva. |
| 410 | Sin permiso para emitir esta factura |
| 415 | Factura con archivo adjunto no aceptada |
| 430 | El archivo de la factura no superó la comprobación |
| 435 | No se pudo descifrar el archivo de la factura KSeF, estado de factura 435: KSeF no pudo descifrar el archivo de la factura. Pide al proveedor de tu programa que revise el cifrado y vuelve a enviar la factura. |
| 440 | Factura duplicada |
| 450 | El contenido de la factura no superó las comprobaciones |
| 500 | Error desconocido KSeF, estado 500: se produjo un error desconocido mientras KSeF procesaba la factura o la sesión. Vuelve a consultar el estado pasado un rato. Si sigue en 500, contacta con el soporte de KSeF indicando el número de referencia antes de decidir si vuelves a enviar la factura. |
| 550 | Operación cancelada por el sistema KSeF, estado 550: el sistema canceló la operación. Inténtalo de nuevo, como aconseja la documentación de KSeF. |
Códigos de estado de sesión
| Código | Qué significa |
|---|---|
| 405 | El paquete del lote no superó la comprobación KSeF, estado de sesión 405: los elementos del paquete del lote no superaron la comprobación de KSeF. Pide al proveedor de tu programa que revise cómo se construye y se declara el paquete, y envíalo en una sesión por lotes nueva. |
| 415 | No se pudo descifrar la clave de la sesión KSeF, estado de sesión 415: KSeF no pudo descifrar la clave que recibió. Pide al proveedor de tu programa que revise el cifrado de la clave y la clave pública que usa; después abre una sesión nueva y vuelve a enviar las facturas. |
| 420 | Demasiadas facturas en la sesión KSeF, estado de sesión 420: la sesión superó su límite de facturas. Reparte las facturas en varias sesiones y vuelve a enviarlas. |
| 430 | No se pudo descomprimir el archivo del lote KSeF, estado de sesión 430: KSeF no pudo descomprimir el archivo ZIP original del lote. Pide al proveedor de tu programa que vuelva a crear el paquete y envíalo en una nueva sesión por lotes. |
| 435 | No se pudieron descifrar las partes del archivo KSeF, estado de sesión 435: KSeF no pudo descifrar las partes cifradas del archivo del lote. Pide al proveedor de tu programa que revise el cifrado de las partes y envía el paquete en una nueva sesión por lotes. |
| 440 | Sesión cancelada KSeF, estado de sesión 440: la sesión se canceló. Abre una nueva sesión y envía las facturas dentro del plazo permitido. |
| 445 | No hay facturas válidas en la sesión KSeF, estado de sesión 445: la comprobación no encontró ninguna factura válida en la sesión. Corrige los errores que se indiquen en cada factura, comprueba que incluyes facturas válidas y vuelve a enviarlas. |
Códigos de error al enviar
| Código | Qué significa |
|---|---|
| 21001 | Contenido ilegible KSeF, error 21001: KSeF no pudo leer el contenido de la solicitud. Pide al proveedor de tu programa que revise la solicitud según ese detalle y que la envíe de nuevo. |
| 21155 | Demasiadas facturas en la sesión KSeF, error 21155: la sesión ha alcanzado el número de facturas que permite. Cierra la sesión y envía las facturas que faltan en una nueva. |
| 21157 | Tamaño incorrecto de una parte del paquete KSeF, error 21157: el tamaño de una parte del paquete del lote no es válido. Vuelve a crear el paquete para que cada parte respete el límite y coincida con su tamaño declarado. Después envíalo en una nueva sesión por lotes. |
| 21161 | Demasiadas partes en el paquete KSeF, error 21161: el paquete del lote tiene más partes de las que KSeF permite. Reparte las facturas en varias sesiones por lotes y vuelve a enviarlas. |
| 21166 | Corrección técnica no disponible KSeF, error 21166: no se puede enviar una corrección técnica, porque la factura ya tiene una corrección técnica que KSeF procesó correctamente. Comprueba el estado de la corrección técnica anterior en lugar de enviar otra. |
| 21167 | El estado de la factura no admite corrección técnica KSeF, error 21167: se envió una corrección técnica para una factura que KSeF procesó correctamente. Comprueba que hashOfCorrectedInvoice contiene el hash de la factura offline rechazada, no el de una factura aceptada. |
| 21173 | Sesión no encontrada KSeF, error 21173: no existe ninguna sesión con el número de referencia indicado. Usa el número de referencia de sesión correcto y vuelve a enviar la solicitud. |
| 21178 | UPO no encontrado KSeF, error 21178: KSeF no encontró ningún UPO, el justificante oficial de recepción, con los criterios indicados. Corrige los números y solicita de nuevo el UPO. |
| 21180 | El estado de la sesión no permite la operación KSeF 21180 significa que el estado de la sesión no permite la operación, por ejemplo enviar facturas o cerrarla. Comprueba el estado de la sesión y abre una sesión nueva para enviar más facturas. |
| 21184 | Sesión no disponible temporalmente KSeF 21184 significa que la sesión no está disponible temporalmente por trabajos de mantenimiento. Inténtalo de nuevo más tarde o abre una sesión nueva para enviar más facturas, según indiquen los detalles del error. |
| 21205 | Paquete vacío, falta una parte por enviar KSeF 21205 significa que el paquete no puede estar vacío: no se envió una de las partes declaradas. Envía la parte que indican los detalles y comprueba que se hayan enviado todas las partes declaradas. |
| 21208 | Se agotó el tiempo para enviar KSeF 21208 significa que se agotó el tiempo permitido para las solicitudes upload o finish y que la sesión se canceló. Abre una nueva sesión por lotes y envía las partes dentro del tiempo permitido. |
| 21402 | Tamaño de archivo incorrecto KSeF 21402 significa que la longitud del contenido enviado no coincide con el tamaño de archivo declarado. Pide al proveedor de tu programa de contabilidad que compruebe que el tamaño declarado es el del archivo enviado y vuelve a enviarlo. |
| 21403 | Hash del archivo incorrecto KSeF 21403 significa que el hash (la huella digital) del contenido enviado no coincide con el hash declarado del archivo. Pide al proveedor de tu programa de contabilidad que compruebe que el hash declarado se calcula a partir del archivo enviado y vuelve a enviarlo. |
| 21405 | Los datos de la solicitud no pasan la comprobación KSeF 21405 significa que los datos de la solicitud no han pasado la comprobación. Corrige lo que indican los detalles y envía la solicitud de nuevo. |
| 21470 | Clave desconocida o retirada KSeF 21470 significa que el identificador de clave enviado es desconocido o apunta a una clave retirada. Pide al proveedor de tu programa de contabilidad que use un identificador de clave admitido y envía la solicitud de nuevo. |
Leer el documento oficial
- KSeF API 2.0, specyfikacja OpenAPI (open-api.json) Fuente: KSeF API 2.0, specyfikacja OpenAPI (open-api.json), versión 2.9.0, publicado por Ministerstwo Finansów, consultado el 8 de noviembre de 2026. Texto oficial en su idioma original, de Ministerstwo Finansów, KSeF 2.0 Przewodnik dla Integratorów (github.com/CIRFMF/ksef-api), Copyright (c) 2025 Ministerstwo Finansów, bajo licencia MIT License.
- Weryfikacja faktury Fuente: Weryfikacja faktury, versión 09.04.2026, publicado por Ministerstwo Finansów, consultado el 8 de noviembre de 2026. Texto oficial en su idioma original, de Ministerstwo Finansów, KSeF 2.0 Przewodnik dla Integratorów (github.com/CIRFMF/ksef-api), Copyright (c) 2025 Ministerstwo Finansów, bajo licencia MIT License.
Preguntas frecuentes
¿Dónde veo el estado de una factura en KSeF?
Tu programa de facturación lo lee de KSeF después del envío: cada factura de una sesión recibe un código de estado, una descripción y, cuando KSeF los da, detalles. El estado 200 indica que todo ha ido bien, y los estados 100 y 150 indican que KSeF aún está procesando la factura.
¿Por qué aparece el mismo número dos veces?
KSeF usa los mismos números para el estado de una factura y para el estado de una sesión, con significados distintos. Para una factura, 440 es un duplicado; para una sesión, significa que la sesión se canceló. Comprueba cuál de los dos muestra tu programa.
¿Qué códigos no aparecen aquí?
Los estados que informan de avance o de éxito, y los códigos de error de inicio de sesión, certificados, tokens, permisos y descarga de facturas, que corresponden a un proceso distinto del envío de una factura.
¿De dónde salen los códigos?
De la documentación de la API KSeF 2.0 del Ministerio de Finanzas de Polonia, publicada con licencia MIT. Cada página de código cita el texto oficial en polaco y enlaza a la fuente.