Salta al contingut principal
KSeF 2.0 · autenticació

Estats d'autenticació de KSeF: 415, 425, 450, 470 i 480

L'inici de sessió a KSeF acaba amb un estat que es consulta a part de l'enviament. A més dels errors de certificat (codi 460) hi ha estats que parlen de permisos, d'una sessió revocada, d'un token i d'un bloqueig. El codi 450 vol dir aquí una altra cosa que en una factura (450 de la factura).

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è vol dir cada estat

415
«Uwierzytelnianie zakończone niepowodzeniem» (autenticació fallida), details «Brak przypisanych uprawnień» (sense permisos assignats): la persona o entitat del certificat no té cap permís en el context d'aquell NIF.
425
«Uwierzytelnienie unieważnione» (autenticació revocada), details «Uwierzytelnienie i powiązane refresh tokeny zostały unieważnione przez użytkownika»: algú va tancar aquella sessió.
450
«Uwierzytelnianie zakończone niepowodzeniem z powodu błędnego tokenu» (fallida per un token erroni), amb details com «Token unieważniony», «Token nieaktywny», «Nieprawidłowy czas tokena» o «Token nie może być użyty w kontekście {contextIdentifier}»: és de l'inici de sessió amb token KSeF.
470
«Uwierzytelnianie zakończone niepowodzeniem», details «Próba wykorzystania metod autoryzacyjnych osoby zmarłej» (intent d'usar les credencials d'una persona morta).
480
«Uwierzytelnienie zablokowane» (autenticació bloquejada), details «Podejrzenie incydentu bezpieczeństwa. Skontaktuj się z Ministerstwem Finansów przez formularz zgłoszeniowy.» (sospita d'incident de seguretat; contacta amb el Ministeri pel seu formulari).
500 i 550
«Nieznany błąd» (error desconegut) i «Operacja została anulowana przez system» (cancel·lada pel sistema), amb details «Przetwarzanie zostało przerwane z przyczyn wewnętrznych systemu. Spróbuj ponownie» (procés interromput per causes internes; torna-ho a provar).
Targeta dels estats d'autenticació de KSeF
L'estat 415 amb la seva descripció de l'API i la resta d'estats de l'inici de sessió: 425, 450, 470 i 480, més els codis 21301 i 21304.

Tokens de KSeF i Odoo

Odoo 18, 19 i 20 tenen al seu codi una funció per iniciar sessió amb un token de KSeF, però ningú la crida: només inicien sessió amb el certificat. Per tant, un 450 a l'inici de sessió no surt d'Odoo. Si el veus, ve d'un altre programa que usa un token, com el d'una assessoria. KSeF revoca els tokens automàticament quan el seu titular perd els permisos.

Amb la resta d'estats, Odoo mostra «KSeF Authentication failed with status …: …» amb la descripció i sense els details. Al 415 i al 470 la descripció és la mateixa, així que només el camp details els distingeix.

Tokens d'accés, de refresc i codis 21301 i 21304

ElementKSeFOdoo 18, 19 i 20
accessTokenVal uns quants minuts («kilkanaście», diu la documentació), els que marqui el seu camp expDesprés d'un HTTP 401 el refresca i repeteix la petició una vegada.
refreshTokenFins a 7 diesLa tasca programada «Refresh KSeF tokens» torna a iniciar sessió amb el certificat cada 6 dies.
21301 «Brak autoryzacji.» (sense autorització)En bescanviar o refrescar tokens, per exemple «Token KSeF został unieważniony.» (token KSeF revocat)Veus «Failed to refresh KSeF access token. You may need to re-authenticate manually. Error: 400 Client Error…», sense el codi.
21304 «Brak uwierzytelnienia.» (sense autenticació)«Operacja uwierzytelniania o numerze referencyjnym {referenceNumber} nie została znaleziona.»Igual: el codi no arriba a la pantalla.
Esquema: què retorna KSeF amb els estats d'inici de sessió 415-480 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

  • 415, o 21301 després de retirar permisos: el propietari de l'empresa dona permisos a KSeF a la persona del certificat i tu tornes a desar el certificat a la configuració d'Odoo.
  • 425: algú va revocar la sessió; torna a desar el certificat perquè Odoo iniciï sessió de nou.
  • 480: fes el que diu KSeF i contacta amb el Ministeri de Finances pel seu formulari; repetir l'inici de sessió no serveix.
  • 500 o 550: torna-ho a intentar.

El nostre mòdul, Poland KSeF 2.0 Validator, porta una llista de certificats i tokens de KSeF amb les seves dates de caducitat, però no inicia sessió a KSeF i no veu aquests estats.

Continua llegint

Inici de sessió a KSeF amb certificat: codi 460 i errors de signatura XAdESCodi 460 de KSeF i excepcions 9101-9105, 21111, 21115, 21117, 21217, 21401 i 21406 en iniciar sessió amb certificat. Què no mostren Odoo 18, 19 i 20 i què revisar.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.Codis 410 i 415 de KSeF: permisos del venedor i adjuntsKSeF 410 «Nieprawidłowy zakres uprawnień» i 415 en factures amb adjunt: què els provoca a les proves del Ministeri i què revisar a Odoo 18, 19 i 20.
Comprovat al codi del mòdul (versió 20.0) i a les fonts enllaçades

Fonts