Aller au contenu principal
KSeF 2.0 · authentification

États d'authentification KSeF : 415, 425, 450, 470 et 480

La connexion à KSeF se termine par un état qui se consulte séparément de l'envoi. Outre les erreurs de certificat (code 460), il existe des états liés aux droits, à une session révoquée, à un jeton et à un blocage. Le code 450 désigne ici autre chose que sur une facture (450 de la facture).

FlexigoTech · Responsable : Víctor Gómez · Mis à jour le 5 novembre 2026

L'essentiel

Module
KSeF 2.0
Versions
Odoo 17, 18, 19 et 20
Vérifié
dans le code du module, version 20.0 · dans les sources citées à la fin
Lecture
3 min

Ce que signifie chaque état

415
« Uwierzytelnianie zakończone niepowodzeniem » (authentification échouée), details « Brak przypisanych uprawnień » (aucun droit attribué) : la personne ou l'entité du certificat ne dispose d'aucun droit dans le contexte de ce NIP.
425
« Uwierzytelnienie unieważnione » (authentification révoquée), details « Uwierzytelnienie i powiązane refresh tokeny zostały unieważnione przez użytkownika » : quelqu'un a clos cette session.
450
« Uwierzytelnianie zakończone niepowodzeniem z powodu błędnego tokenu » (échec dû à un jeton erroné), avec des details comme « Token unieważniony », « Token nieaktywny », « Nieprawidłowy czas tokena » ou « Token nie może być użyty w kontekście {contextIdentifier} » : il s'agit de la connexion avec un jeton KSeF.
470
« Uwierzytelnianie zakończone niepowodzeniem », details « Próba wykorzystania metod autoryzacyjnych osoby zmarłej » (tentative d'utilisation des identifiants d'une personne décédée).
480
« Uwierzytelnienie zablokowane » (authentification bloquée), details « Podejrzenie incydentu bezpieczeństwa. Skontaktuj się z Ministerstwem Finansów przez formularz zgłoszeniowy. » (incident de sécurité suspecté ; contactez le ministère des Finances via son formulaire).
500 et 550
« Nieznany błąd » (erreur inconnue) et « Operacja została anulowana przez system » (annulée par le système), avec details « Przetwarzanie zostało przerwane z przyczyn wewnętrznych systemu. Spróbuj ponownie » (traitement interrompu pour des raisons internes ; réessayez).
Carte des états d'authentification KSeF
L'état 415 avec sa description dans l'API et les autres états de connexion : 425, 450, 470 et 480, ainsi que les codes 21301 et 21304.

Jetons KSeF et Odoo

Odoo 18, 19 et 20 contiennent dans leur code une fonction de connexion avec un jeton KSeF, mais rien ne l'appelle : ils se connectent uniquement avec le certificat. Un 450 lors de la connexion ne vient donc pas d'Odoo. Si vous en voyez un, il provient d'un autre programme qui utilise un jeton, par exemple celui d'un cabinet comptable. KSeF révoque automatiquement les jetons lorsque leur titulaire perd ses droits.

Pour les autres états, Odoo affiche « KSeF Authentication failed with status …: … » avec la description, sans les details. Pour le 415 et le 470, la description est identique : seul le champ details permet de les distinguer.

Jetons d'accès, de rafraîchissement et codes 21301 et 21304

ÉlémentKSeFOdoo 18, 19 et 20
accessTokenValable quelques minutes (« kilkanaście », selon la documentation), durée indiquée par son champ expAprès un HTTP 401, il le rafraîchit et répète la requête une fois.
refreshTokenJusqu'à 7 joursL'action planifiée « Refresh KSeF tokens » se reconnecte avec le certificat tous les 6 jours.
21301 « Brak autoryzacji. » (absence d'autorisation)Lors de l'échange ou du rafraîchissement des jetons, par exemple « Token KSeF został unieważniony. » (jeton KSeF révoqué)Vous voyez « Failed to refresh KSeF access token. You may need to re-authenticate manually. Error: 400 Client Error… », sans le code.
21304 « Brak uwierzytelnienia. » (absence d'authentification)« Operacja uwierzytelniania o numerze referencyjnym {referenceNumber} nie została znaleziona. »Identique : le code n'atteint pas l'écran.
Schéma : ce que renvoie KSeF pour les états de connexion 415-480 et ce qu'affiche Odoo 20
Schéma réalisé à partir du code l10n_pl_edi d'Odoo 20 et de la spécification de l'API KSeF 2.9.0 ; ce qui est barré correspond à ce qu'Odoo ne conserve pas ou ne fait pas.

Que faire

  • 415, ou 21301 après retrait des droits : le propriétaire de l'entreprise accorde des droits dans KSeF à la personne du certificat, puis vous enregistrez à nouveau le certificat dans les paramètres d'Odoo.
  • 425 : quelqu'un a révoqué la session ; enregistrez à nouveau le certificat pour qu'Odoo se reconnecte.
  • 480 : suivez les instructions de KSeF et contactez le ministère des Finances via son formulaire ; relancer la connexion ne servira à rien.
  • 500 ou 550 : réessayez.

Notre module, Poland KSeF 2.0 Validator, tient une liste des certificats et jetons KSeF avec leurs dates d'expiration, mais il ne se connecte pas à KSeF et ne voit pas ces états.

À lire aussi

Connexion à KSeF par certificat : code 460 et erreurs de signature XAdESCode 460 de KSeF et exceptions 9101-9105, 21111, 21115, 21117, 21217, 21401 et 21406 lors de la connexion par certificat. Ce qu'Odoo n'affiche pas.Code KSeF 450 : « Błąd weryfikacji semantyki dokumentu faktury »Le code 450 de KSeF rejette une facture FA(3) après contrôle de son contenu. Où se trouve la cause réelle, ce qu'Odoo 18, 19 et 20 n'affichent pas et comment la renvoyer.Codes 410 et 415 de KSeF : autorisations du vendeur et pièces jointesLe 410 et le 415 de KSeF : ce qui les déclenche dans les tests du ministère et quoi vérifier dans Odoo 18, 19 et 20.
Vérifié dans le code du module (version 20.0) et dans les sources citées

Sources