Saltar al contenido principal
KSeF 2.0 · autenticación

Estados de autenticación de KSeF: 415, 425, 450, 470 y 480

El inicio de sesión en KSeF acaba con un estado que se consulta aparte del envío. Además de los errores de certificado (código 460) hay estados que hablan de permisos, de una sesión revocada, de un token y de un bloqueo. El código 450 significa aquí otra cosa que en una factura (450 de la factura).

FlexigoTech · Responsable: Víctor Gómez · Actualizado el 5 de noviembre de 2026

Lo esencial

Módulo
KSeF 2.0
Versiones
Odoo 17, 18, 19 y 20
Comprobado
en el código del módulo, versión 20.0 · en las fuentes enlazadas al final
Lectura
3 min

Qué significa cada estado

415
«Uwierzytelnianie zakończone niepowodzeniem» (autenticación fallida), details «Brak przypisanych uprawnień» (sin permisos asignados): la persona o entidad del certificado no tiene ningún permiso en el contexto de ese NIP.
425
«Uwierzytelnienie unieważnione» (autenticación revocada), details «Uwierzytelnienie i powiązane refresh tokeny zostały unieważnione przez użytkownika»: alguien cerró esa sesión.
450
«Uwierzytelnianie zakończone niepowodzeniem z powodu błędnego tokenu» (fallida por un token erróneo), con details como «Token unieważniony», «Token nieaktywny», «Nieprawidłowy czas tokena» o «Token nie może być użyty w kontekście {contextIdentifier}»: va del inicio de sesión con token KSeF.
470
«Uwierzytelnianie zakończone niepowodzeniem», details «Próba wykorzystania metod autoryzacyjnych osoby zmarłej» (intento de usar las credenciales de una persona fallecida).
480
«Uwierzytelnienie zablokowane» (autenticación bloqueada), details «Podejrzenie incydentu bezpieczeństwa. Skontaktuj się z Ministerstwem Finansów przez formularz zgłoszeniowy.» (sospecha de incidente de seguridad; contacta con el Ministerio por su formulario).
500 y 550
«Nieznany błąd» (error desconocido) y «Operacja została anulowana przez system» (anulada por el sistema), con details «Przetwarzanie zostało przerwane z przyczyn wewnętrznych systemu. Spróbuj ponownie» (proceso interrumpido por causas internas; inténtalo de nuevo).
Tarjeta de los estados de autenticación de KSeF
El estado 415 con su descripción de la API y el resto de estados del inicio de sesión: 425, 450, 470 y 480, más los códigos 21301 y 21304.

Tokens KSeF y Odoo

Odoo 18, 19 y 20 tienen en su código una función para iniciar sesión con un token KSeF, pero nada la llama: solo inician sesión con el certificado. Así que un 450 en el inicio de sesión no sale de Odoo. Si lo ves, viene de otro programa que usa un token, como el de una asesoría. KSeF revoca los tokens automáticamente cuando su titular pierde los permisos.

Con los demás estados, Odoo enseña «KSeF Authentication failed with status …: …» con la descripción y sin los details. En el 415 y el 470 la descripción es la misma, así que solo el campo details los distingue.

Tokens de acceso, refresco y códigos 21301 y 21304

ElementoKSeFOdoo 18, 19 y 20
accessTokenVale unos pocos minutos («kilkanaście», dice la documentación), los que marque su campo expTras un HTTP 401 lo refresca y repite la petición una vez.
refreshTokenHasta 7 díasLa acción planificada «Refresh KSeF tokens» vuelve a iniciar sesión con el certificado cada 6 días.
21301 «Brak autoryzacji.» (sin autorización)Al canjear o refrescar tokens, por ejemplo «Token KSeF został unieważniony.» (token KSeF revocado)Ves «Failed to refresh KSeF access token. You may need to re-authenticate manually. Error: 400 Client Error…», sin el código.
21304 «Brak uwierzytelnienia.» (sin autenticación)«Operacja uwierzytelniania o numerze referencyjnym {referenceNumber} nie została znaleziona.»Igual: el código no llega a la pantalla.
Esquema: qué devuelve KSeF con los estados de inicio de sesión 415-480 y qué enseña Odoo 20
Esquema hecho a partir del código de l10n_pl_edi de Odoo 20 y de la especificación de la API de KSeF 2.9.0; lo tachado es lo que Odoo no guarda o no hace.

Qué hacer

  • 415, o 21301 tras retirar permisos: el propietario de la empresa da permisos en KSeF a la persona del certificado y tú vuelves a guardar el certificado en los ajustes de Odoo.
  • 425: alguien revocó la sesión; vuelve a guardar el certificado para que Odoo inicie sesión de nuevo.
  • 480: haz lo que dice KSeF y contacta con el Ministerio de Finanzas por su formulario; repetir el inicio de sesión no sirve.
  • 500 o 550: vuelve a intentarlo.

Nuestro módulo, Poland KSeF 2.0 Validator, lleva una lista de certificados y tokens KSeF con sus fechas de caducidad, pero no inicia sesión en KSeF y no ve estos estados.

Sigue leyendo

Inicio de sesión en KSeF con certificado: código 460 y errores de firma XAdESCódigo 460 de KSeF y excepciones 9101-9105, 21111, 21115, 21117, 21217, 21401 y 21406 al iniciar sesión con certificado. Qué no enseñan Odoo 18, 19 y 20 y qué revisar.Código 450 de KSeF: «Błąd weryfikacji semantyki dokumentu faktury»El código 450 de KSeF rechaza una factura FA(3) tras revisar su contenido. Dónde está el motivo real, qué no enseña Odoo 18, 19 y 20 y cómo volver a enviarla.Códigos 410 y 415 de KSeF: permisos del vendedor y adjuntosKSeF 410 «Nieprawidłowy zakres uprawnień» y 415 de facturas con adjunto: qué los provoca en las pruebas del Ministerio y qué revisar en Odoo 18, 19 y 20.
Comprobado en el código del módulo (versión 20.0) y en las fuentes enlazadas

Fuentes