Aller au contenu principal
KSeF 2.0 · statut de la facture

Statuts techniques de la facture dans KSeF : 550, 500, 405, 430 et 435

Cinq statuts de facture signalent un problème de traitement et non des données de la facture. Odoo les gère différemment : quatre aboutissent à Rejected et à un nouvel envoi, tandis que le 550, qu'Odoo ne reconnaît pas, laisse la facture en Sent.

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 dit KSeF

CodeTexte de KSeFStatut dans Odoo 18, 19 et 20
550« Operacja została anulowana przez system » (annulée par le système), details « Przetwarzanie zostało przerwane z przyczyn wewnętrznych systemu. Spróbuj ponownie » (interrompue pour des raisons internes ; réessayez)Reste en Sent (In Progress)
500« Nieznany błąd ({statusCode}) » (erreur inconnue)Rejected, avec la description de KSeF
405« Przetwarzanie anulowane z powodu błędu sesji » (traitement annulé à cause d'une erreur de session)Rejected
430« Błąd weryfikacji pliku faktury » (erreur de vérification du fichier de la facture)Rejected
435« Błąd odszyfrowania pliku » (erreur de déchiffrement du fichier)Rejected
Carte des statuts techniques de la facture dans KSeF
Le statut 550 avec son texte de l'API et les autres statuts techniques : 500, 405, 430 et 435.

550 : la facture reste bloquée en Sent

Odoo ne traduit en ses propres statuts que les codes 100, 150, 200, 405, 410, 415, 430, 435, 440, 450 et 500. Tout autre code, le 550 compris, aboutit au message « Unknown status received from KSeF (Code: 550): … » (en polonais dans les versions 18 et 19 : « Otrzymano nieznany status od KSeF (kod: 550): … ») et ne modifie pas « KSeF Status ». La facture reste donc en Sent (In Progress), et Odoo n'affiche pas sur elle le bouton de retour en brouillon.

KSeF indique « réessayez », mais Odoo ne peut pas le faire depuis la facture : il n'envoie que les factures sans statut KSeF. Le bouton « Check Sending » et l'action planifiée ne font que redemander le statut, qui restera 550.

Sortir de cet état exige une modification en dehors de l'interface d'Odoo : signalez-le à votre partenaire ou à la personne qui maintient votre Odoo. Cela découle du code d'Odoo 18, 19 et 20 ; nous ne l'avons pas testé contre le KSeF de production.

500, 405, 430 et 435 : rejetées, prêtes à être renvoyées

Pour ces quatre codes, Odoo passe le statut à Rejected. Pour le 500, il ajoute la description de KSeF ; pour les autres, il affiche son texte fixe. La documentation de KSeF ne donne pas de liste de causes pour eux au-delà de ce que dit leur nom :

  • 405 : le traitement a été annulé à cause d'une erreur dans la session où la facture a été envoyée ;
  • 430 : KSeF n'a pas pu vérifier le fichier de la facture lui-même ;
  • 435 : KSeF n'a pas pu déchiffrer le fichier, que le programme d'envoi chiffre en AES-256-CBC avec la clé transmise à l'ouverture de la session.

Odoo construit et chiffre lui-même le fichier, donc un 430 ou un 435 qui se répète désigne le programme d'envoi, et non les données de la facture.

Schéma : ce que renvoie KSeF avec le statut 550 et ce qu'affiche Odoo 20
Schéma réalisé à partir du code de 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

  1. Pour le 500, le 405, le 430 et le 435, remettez la facture en brouillon (Odoo efface alors son statut et son numéro KSeF), confirmez-la et renvoyez-la.
  2. Pour le 550, vérifiez à nouveau le statut avec « Check Sending ». S'il reste 550, le traitement a été interrompu et la facture doit être renvoyée.
  3. Transmettez-la alors à la personne qui maintient votre Odoo pour qu'elle la renvoie. Si vous l'envoyez par un autre canal, elle restera en Sent dans Odoo.

Notre module, Poland KSeF 2.0 Validator, ne reprend que le statut de l10n_pl_edi : avec un 550, la facture reste également en Submitted dans le module.

À lire aussi

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.Exceptions KSeF à l'envoi d'une facture : 21405, 21180, 21184 et le resteExceptions KSeF à l'envoi d'une facture : 21405, 21001, 21155, 21166, 21167, 21173, 21180, 21184, 21402 et 21403. Leur sens et leur affichage dans Odoo.KSeF HTTP 429, 403 et 401 : limites de requêtes et accès refuséKSeF renvoie 429 Too Many Requests au dépassement, 403 avec un reasonCode si l'accès manque et 401 si le jeton a expiré. Limites et réactions d'Odoo.
Vérifié dans le code du module (version 20.0) et dans les sources citées

Sources