Codes d'état et d'erreur KSeF expliqués
Lorsque KSeF, le système national polonais de facturation électronique, n'accepte pas une facture, il lui attribue un code d'état, par exemple 440 ou 450, ou répond à la demande par un code d'erreur, par exemple 21405. Retrouvez votre code ci-dessous pour voir ce qu'il signifie, sa cause habituelle et ce qu'il faut modifier avant de renvoyer la facture.
En bref
Signification des codes d'état et d'erreur KSeF comme 440, 450 ou 21405, cause habituelle du refus de la facture et correction à apporter.
Cette liste couvre 32 codes figurant dans les documents officiels ci-dessous. Parmi eux, 5 ont leur propre page ; 27 sont expliqués dans le tableau seulement, car il s'agit de statuts système ou de transport sans correction à faire dans la facture.
Hors périmètre : 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, concernant un autre processus que l'envoi d'une facture.
Codes d'état des factures
| Code | Ce que cela signifie |
|---|---|
| 405 | Traitement annulé à cause d'une erreur de session KSeF, statut de facture 405 : le traitement de la facture a été annulé à cause d'une erreur dans la session d'envoi. Corrigez ce que l'état de la session indique, puis renvoyez la facture dans une nouvelle session. |
| 410 | Pas de droit pour émettre cette facture |
| 415 | Facture avec pièce jointe non acceptée |
| 430 | Fichier de facture refusé à la vérification |
| 435 | Fichier de facture impossible à déchiffrer KSeF, statut de facture 435 : KSeF n'a pas pu déchiffrer le fichier de la facture. Demandez à l'éditeur de votre logiciel de vérifier le chiffrement, puis renvoyez la facture. |
| 440 | Facture en double |
| 450 | Échec des contrôles du contenu de la facture |
| 500 | Erreur inconnue KSeF, statut 500 : une erreur inconnue s'est produite pendant que KSeF traitait la facture ou la session. Consultez de nouveau le statut un peu plus tard. S'il reste à 500, contactez l'assistance de KSeF en indiquant le numéro de référence avant de décider de renvoyer ou non la facture. |
| 550 | Opération annulée par le système KSeF, statut 550 : le système a annulé l'opération. Réessayez, comme le conseille la documentation de KSeF. |
Codes d'état des sessions
| Code | Ce que cela signifie |
|---|---|
| 405 | Paquet d'envoi par lot refusé à la vérification KSeF, statut de session 405 : la vérification des éléments du paquet envoyé par lot a échoué. Demandez à l'éditeur de votre logiciel de vérifier la construction et la déclaration du paquet, puis envoyez-le dans une nouvelle session par lot. |
| 415 | Clé de session impossible à déchiffrer KSeF, statut de session 415 : KSeF n'a pas pu déchiffrer la clé fournie. Demandez à l'éditeur de votre logiciel de vérifier le chiffrement de la clé et la clé publique utilisée, puis ouvrez une nouvelle session et renvoyez les factures. |
| 420 | Trop de factures dans la session KSeF, statut de session 420 : la session a dépassé sa limite de factures. Répartissez les factures sur plusieurs sessions et envoyez-les de nouveau. |
| 430 | L'archive du lot n'a pas pu être décompressée KSeF a renvoyé le statut de session 430, ce qui signifie qu'il n'a pas pu décompresser l'archive ZIP d'origine du lot. Demandez à l'éditeur de votre logiciel de reconstituer le paquet, puis envoyez-le dans une nouvelle session d'envoi par lot. |
| 435 | Les parties de l'archive n'ont pas pu être déchiffrées KSeF a renvoyé le statut de session 435, ce qui signifie qu'il n'a pas pu déchiffrer les parties chiffrées de l'archive du lot. Demandez à l'éditeur de votre logiciel de vérifier le chiffrement des parties, puis envoyez le paquet dans une nouvelle session d'envoi par lot. |
| 440 | La session a été annulée KSeF a renvoyé le statut de session 440, ce qui signifie que la session a été annulée. Ouvrez une nouvelle session et envoyez les factures dans le délai prévu. |
| 445 | Aucune facture valide dans la session KSeF a renvoyé le statut de session 445, ce qui signifie que la vérification n'a trouvé aucune facture valide dans la session. Corrigez les erreurs signalées sur les factures, vérifiez que des factures valides sont bien incluses, puis envoyez-les à nouveau. |
Codes d'erreur à l'envoi
| Code | Ce que cela signifie |
|---|---|
| 21001 | Contenu illisible KSeF a renvoyé l'erreur 21001, ce qui signifie qu'il n'a pas pu lire le contenu de la requête. Demandez à l'éditeur de votre logiciel de comparer la requête avec ces détails, puis de l'envoyer à nouveau. |
| 21155 | Trop de factures dans la session KSeF a renvoyé l'erreur 21155, ce qui signifie que la session a atteint le nombre de factures qu'elle autorise. Fermez la session et envoyez les factures restantes dans une nouvelle session. |
| 21157 | Taille incorrecte d'une partie du paquet KSeF a renvoyé l'erreur 21157, ce qui signifie que la taille d'une partie du paquet envoyé par lot n'est pas valide. Reconstituez le paquet pour que chaque partie respecte la limite et corresponde à sa taille déclarée, puis envoyez-le dans une nouvelle session d'envoi par lot. |
| 21161 | Trop de parties dans le paquet KSeF a renvoyé l'erreur 21161, ce qui signifie que le paquet envoyé par lot compte plus de parties que KSeF n'en autorise. Répartissez les factures sur plusieurs sessions d'envoi par lot, puis envoyez-les à nouveau. |
| 21166 | Correction technique non disponible KSeF a renvoyé l'erreur 21166, ce qui signifie qu'une correction technique ne peut pas être envoyée, car la facture a déjà une correction technique que KSeF a traitée correctement. Vérifiez le statut de la correction technique précédente au lieu d'en envoyer une autre. |
| 21167 | Le statut de la facture exclut une correction technique KSeF a renvoyé l'erreur 21167, ce qui signifie qu'une correction technique a été envoyée pour une facture que KSeF a traitée correctement. Vérifiez que hashOfCorrectedInvoice contient l'empreinte de la facture hors ligne rejetée, et non celle d'une facture acceptée. |
| 21173 | Session introuvable KSeF a renvoyé l'erreur 21173, ce qui signifie qu'aucune session ne correspond au numéro de référence indiqué. Utilisez le bon numéro de référence de session, puis renvoyez la requête. |
| 21178 | UPO introuvable KSeF a renvoyé l'erreur 21178, ce qui signifie que KSeF n'a trouvé aucun UPO, l'accusé de réception officiel, pour les critères indiqués. Corrigez les numéros, puis demandez de nouveau l'UPO. |
| 21180 | L'état de la session ne permet pas l'opération KSeF 21180 signifie que l'état de la session ne permet pas d'effectuer l'opération demandée, par exemple envoyer des factures ou fermer la session. Vérifiez l'état de la session, puis ouvrez une nouvelle session pour envoyer les autres factures. |
| 21184 | Session temporairement indisponible KSeF 21184 signifie que la session est temporairement indisponible en raison de travaux de maintenance. Réessayez plus tard, ou ouvrez une nouvelle session pour envoyer les autres factures, comme le conseillent les détails de la réponse. |
| 21205 | Paquet vide KSeF 21205 signifie que le paquet ne peut pas être vide : une partie annoncée n'a pas été envoyée. Envoyez la partie manquante indiquée dans les détails, puis vérifiez que toutes les parties annoncées ont bien été envoyées. |
| 21208 | Délai d'envoi dépassé KSeF 21208 signifie que le délai prévu pour les requêtes upload ou finish est dépassé, et que la session a été annulée. Ouvrez une nouvelle session par lot, puis envoyez les parties dans le délai imparti. |
| 21402 | Taille de fichier incorrecte KSeF 21402 signifie que la longueur du contenu envoyé ne correspond pas à la taille de fichier déclarée. Demandez à l'éditeur de votre logiciel de vérifier que la taille déclarée est bien celle du fichier envoyé, puis envoyez-le de nouveau. |
| 21403 | Empreinte du fichier incorrecte KSeF 21403 signifie que l'empreinte (hash) du contenu envoyé ne correspond pas à l'empreinte déclarée du fichier. Demandez à l'éditeur de votre logiciel de vérifier que l'empreinte déclarée est calculée à partir du fichier envoyé, puis envoyez-le de nouveau. |
| 21405 | Données de la requête refusées à la vérification KSeF 21405 signifie que les données de la requête n'ont pas passé la vérification. Corrigez ce que les détails désignent, puis envoyez de nouveau la requête. |
| 21470 | Clé inconnue ou retirée KSeF 21470 signifie que l'identifiant de clé envoyé est inconnu ou désigne une clé retirée. Demandez à l'éditeur de votre logiciel d'utiliser un identifiant de clé pris en charge, puis envoyez de nouveau la requête. |
Lire le document officiel
- KSeF API 2.0, specyfikacja OpenAPI (open-api.json) Source : KSeF API 2.0, specyfikacja OpenAPI (open-api.json), version 2.9.0, publiée par Ministerstwo Finansów, consultée le 8 novembre 2026. Texte officiel dans sa langue d'origine, extrait de Ministerstwo Finansów, KSeF 2.0 Przewodnik dla Integratorów (github.com/CIRFMF/ksef-api), Copyright (c) 2025 Ministerstwo Finansów, sous licence MIT License.
- Weryfikacja faktury Source : Weryfikacja faktury, version 09.04.2026, publiée par Ministerstwo Finansów, consultée le 8 novembre 2026. Texte officiel dans sa langue d'origine, extrait de Ministerstwo Finansów, KSeF 2.0 Przewodnik dla Integratorów (github.com/CIRFMF/ksef-api), Copyright (c) 2025 Ministerstwo Finansów, sous licence MIT License.
Questions fréquentes
Où voir l'état KSeF d'une facture ?
Votre logiciel de facturation le lit dans KSeF après l'envoi : chaque facture d'une session reçoit un code d'état, une description et, lorsque KSeF les fournit, des détails. Le statut 200 indique un succès, et les statuts 100 et 150 indiquent que KSeF traite encore la facture.
Pourquoi le même numéro apparaît-il deux fois ?
KSeF emploie les mêmes numéros pour l'état d'une facture et pour l'état d'une session, avec des sens différents. Pour une facture, 440 signifie un doublon ; pour une session, il signifie que la session a été annulée. Vérifiez lequel des deux votre logiciel affiche.
Quels codes ne figurent pas dans la liste ?
Les statuts qui indiquent une progression ou un succès, ainsi que les codes d'erreur liés à d'autres processus que l'envoi d'une facture : connexion, certificats, jetons, droits d'accès et téléchargement des factures.
D'où viennent les codes ?
De la documentation de l'API KSeF 2.0 du ministère des Finances, publiée sous licence MIT. Chaque page de code cite le texte officiel en polonais et renvoie à la source.