Aller au contenu

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.

Przetwarzanie anulowane z powodu błędu sesji

410 Pas de droit pour émettre cette facture

Nieprawidłowy zakres uprawnień

415 Facture avec pièce jointe non acceptée

Brak możliwości wysyłania faktury z załącznikiem

430 Fichier de facture refusé à la vérification

Błąd weryfikacji pliku faktury

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.

Błąd odszyfrowania pliku

440 Facture en double

Duplikat faktury

450 Échec des contrôles du contenu de la facture

Błąd weryfikacji semantyki dokumentu faktury

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.

Nieznany błąd ({statusCode})

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.

Operacja została anulowana przez system

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.

Błąd weryfikacji poprawności dostarczonych elementów paczki

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.

Błąd odszyfrowania dostarczonego klucza

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.

Przekroczony limit faktur w sesji

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.

Błąd dekompresji pierwotnego archiwum

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.

Błąd odszyfrowania zaszyfrowanych części archiwum

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.

Sesja anulowana

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.

Błąd weryfikacji, brak poprawnych faktur

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.

Nieczytelna treść.

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.

Przekroczono dozwoloną liczbę faktur w sesji.

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.

Nieprawidłowy rozmiar części pakietu.

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.

Przekroczono dozwoloną liczbę części pakietu.

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.

Korekta techniczna niedostępna.

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.

Status faktury nie pozwala na korektę techniczną.

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.

Brak sesji o wskazanym numerze referencyjnym.

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.

Nie znaleziono UPO dla podanych kryteriów.

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.

Status sesji nie pozwala na wykonanie operacji.

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.

Sesja tymczasowo niedostępna.

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.

Pakiet nie może być pusty.

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.

Czas oczekiwania na requesty upload lub finish został przekroczony.

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.

Nieprawidłowy rozmiar pliku.

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.

Nieprawidłowy skrót pliku.

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.

Błąd walidacji danych wejściowych.

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.

Przesłany identyfikator klucza jest nieznany lub wskazuje na wycofany klucz.

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.

Mis à jour le 8 novembre 2026