KSeF: Status- und Fehlercodes einfach erklärt
Wenn das polnische E-Rechnungssystem KSeF eine Rechnung nicht annimmt, vergibt es für die Rechnung einen Statuscode, etwa 440 oder 450, oder beantwortet die Anfrage mit einem Fehlercode, etwa 21405. Suchen Sie unten Ihren Code. Sie sehen, was er bedeutet, was meist dahintersteckt und was Sie ändern sollten, bevor Sie die Rechnung erneut senden.
Kurz gesagt
Was KSeF-Status- und Fehlercodes wie 440, 450 oder 21405 bedeuten, warum die Rechnung nicht angenommen wurde und was Sie ändern sollten.
Diese Liste umfasst 32 Codes aus den unten genannten offiziellen Dokumenten. 5 haben jeweils eine eigene Seite; 27 werden nur in der Tabelle erklärt, weil es sich um System- oder Transportstatus handelt, bei denen Änderungen an der Rechnung nicht helfen.
Nicht abgedeckt: 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, weil es dabei nicht um das Senden einer Rechnung geht.
Statuscodes für Rechnungen
| Code | Bedeutung |
|---|---|
| 405 | Verarbeitung wegen eines Sitzungsfehlers abgebrochen KSeF-Rechnungsstatus 405 bedeutet, dass die Verarbeitung der Rechnung wegen eines Fehlers in der Sitzung abgebrochen wurde, in der sie gesendet wurde. Beheben Sie, worauf der Sitzungsstatus hinweist, und senden Sie die Rechnung dann in einer neuen Sitzung erneut. |
| 410 | Keine Berechtigung zum Ausstellen dieser Rechnung |
| 415 | Rechnung mit Anhang nicht angenommen |
| 430 | Rechnungsdatei hat die Dateiprüfung nicht bestanden |
| 435 | Rechnungsdatei konnte nicht entschlüsselt werden KSeF-Rechnungsstatus 435 bedeutet, dass KSeF die Rechnungsdatei nicht entschlüsseln konnte. Bitten Sie Ihren Softwareanbieter, die Verschlüsselung zu prüfen, und senden Sie die Rechnung dann erneut. |
| 440 | Doppelte Rechnung |
| 450 | Rechnungsinhalt hat die inhaltliche Prüfung nicht bestanden |
| 500 | Unbekannter Fehler KSeF-Status 500 bedeutet, dass bei der Verarbeitung der Rechnung oder der Sitzung durch KSeF ein unbekannter Fehler aufgetreten ist. Rufen Sie den Status später erneut ab. Bleibt er bei 500, wenden Sie sich mit der Referenznummer an den KSeF-Support, bevor Sie entscheiden, ob Sie die Rechnung erneut senden. |
| 550 | Vorgang vom System abgebrochen KSeF-Status 550 bedeutet, dass das System den Vorgang abgebrochen hat. Versuchen Sie es erneut, wie es die KSeF-Dokumentation empfiehlt. |
Statuscodes für Sitzungen
| Code | Bedeutung |
|---|---|
| 405 | Batch-Paket hat die Prüfung nicht bestanden KSeF-Sitzungsstatus 405 bedeutet, dass die Elemente des Batch-Pakets die Prüfung von KSeF nicht bestanden haben. Bitten Sie Ihren Softwareanbieter, zu prüfen, wie das Paket aufgebaut und angegeben wird, und senden Sie es dann in einer neuen Batch-Sitzung. |
| 415 | Sitzungsschlüssel konnte nicht entschlüsselt werden KSeF-Sitzungsstatus 415 bedeutet, dass KSeF den übermittelten Schlüssel nicht entschlüsseln konnte. Bitten Sie Ihren Softwareanbieter, die Schlüsselverschlüsselung und den verwendeten öffentlichen Schlüssel zu prüfen. Öffnen Sie dann eine neue Sitzung und senden Sie die Rechnungen erneut. |
| 420 | Zu viele Rechnungen in der Sitzung KSeF-Sitzungsstatus 420 bedeutet, dass die Sitzung die zulässige Zahl von Rechnungen überschritten hat. Verteilen Sie die Rechnungen auf mehrere Sitzungen und senden Sie sie erneut. |
| 430 | Batch-Archiv konnte nicht entpackt werden KSeF-Sitzungsstatus 430 bedeutet, dass KSeF das ursprüngliche ZIP-Archiv des Batches nicht entpacken konnte. Bitten Sie Ihren Softwareanbieter, das Paket neu zu erstellen, und senden Sie es in einer neuen Batch-Sitzung. |
| 435 | Archivteile konnten nicht entschlüsselt werden KSeF-Sitzungsstatus 435 bedeutet, dass KSeF die verschlüsselten Teile des Batch-Archivs nicht entschlüsseln konnte. Bitten Sie Ihren Softwareanbieter, die Verschlüsselung der Teile zu prüfen, und senden Sie das Paket dann in einer neuen Batch-Sitzung. |
| 440 | Sitzung wurde abgebrochen KSeF-Sitzungsstatus 440 bedeutet, dass die Sitzung abgebrochen wurde. Öffnen Sie eine neue Sitzung und senden Sie die Rechnungen innerhalb der vorgesehenen Zeit. |
| 445 | Keine gültige Rechnung in der Sitzung KSeF-Sitzungsstatus 445 bedeutet, dass die Prüfung in der Sitzung keine gültige Rechnung gefunden hat. Beheben Sie die gemeldeten Fehler in den Rechnungen, stellen Sie sicher, dass gültige Rechnungen enthalten sind, und senden Sie die Rechnungen erneut. |
Fehlercodes beim Senden
| Code | Bedeutung |
|---|---|
| 21001 | Inhalt der Anfrage nicht lesbar KSeF-Fehler 21001 bedeutet, dass KSeF den Inhalt der Anfrage nicht lesen konnte. Bitten Sie Ihren Softwareanbieter, die Anfrage anhand der Details zu prüfen, und senden Sie sie dann erneut. |
| 21155 | Zu viele Rechnungen in der Sitzung KSeF-Fehler 21155 bedeutet, dass die Sitzung die zulässige Anzahl an Rechnungen erreicht hat. Schließen Sie die Sitzung und senden Sie die übrigen Rechnungen in einer neuen Sitzung. |
| 21157 | Falsche Größe eines Paketteils KSeF-Fehler 21157 bedeutet, dass die Größe eines Teils des Batch-Pakets nicht gültig ist. Erstellen Sie das Paket so neu, dass jeder Teil innerhalb der Grenze liegt und zur angegebenen Größe passt, und senden Sie es in einer neuen Batch-Sitzung. |
| 21161 | Zu viele Teile im Paket KSeF-Fehler 21161 bedeutet, dass das Batch-Paket mehr Teile hat, als KSeF zulässt. Verteilen Sie die Rechnungen auf mehrere Batch-Sitzungen und senden Sie sie erneut. |
| 21166 | Technische Korrektur nicht möglich KSeF-Fehler 21166 bedeutet, dass keine technische Korrektur gesendet werden kann, weil die Rechnung bereits eine technische Korrektur hat, die KSeF korrekt verarbeitet hat. Prüfen Sie den Status der früheren technischen Korrektur, statt eine weitere zu senden. |
| 21167 | Rechnungsstatus erlaubt keine technische Korrektur KSeF-Fehler 21167 bedeutet, dass eine technische Korrektur für eine Rechnung gesendet wurde, die KSeF korrekt verarbeitet hat. Prüfen Sie, ob hashOfCorrectedInvoice den Hash der abgelehnten Offline-Rechnung enthält und nicht den einer angenommenen Rechnung. |
| 21173 | Sitzung nicht gefunden KSeF-Fehler 21173 bedeutet, dass es keine Sitzung mit der angegebenen Referenznummer gibt. Verwenden Sie die richtige Referenznummer der Sitzung und senden Sie die Anfrage erneut. |
| 21178 | UPO nicht gefunden KSeF-Fehler 21178 bedeutet, dass KSeF zu den angegebenen Kriterien keine amtliche Empfangsbestätigung (UPO) gefunden hat. Korrigieren Sie die Nummern und fordern Sie das UPO erneut an. |
| 21180 | Status der Sitzung erlaubt den Vorgang nicht KSeF 21180 bedeutet, dass der Status der Sitzung den Vorgang nicht zulässt, zum Beispiel das Senden von Rechnungen oder das Schließen der Sitzung. Prüfen Sie den Status der Sitzung und öffnen Sie eine neue Sitzung, um weitere Rechnungen zu senden. |
| 21184 | Sitzung vorübergehend nicht verfügbar KSeF 21184 bedeutet, dass die Sitzung wegen Wartungsarbeiten vorübergehend nicht verfügbar ist. Versuchen Sie es später erneut oder öffnen Sie eine neue Sitzung, um weitere Rechnungen zu senden, wie es die Details empfehlen. |
| 21205 | Leeres Paket KSeF 21205 bedeutet, dass das Paket nicht leer sein darf: Ein angekündigter Teil wurde nicht gesendet. Senden Sie den in den Details genannten fehlenden Teil. Prüfen Sie, dass alle angekündigten Teile gesendet wurden. |
| 21208 | Zeit für das Senden ist abgelaufen KSeF 21208 bedeutet, dass die erlaubte Zeit für die Anfragen upload oder finish abgelaufen ist und die Sitzung abgebrochen wurde. Öffnen Sie eine neue Batch-Sitzung und senden Sie die Teile innerhalb der erlaubten Zeit. |
| 21402 | Falsche Dateigröße KSeF 21402 bedeutet, dass die Länge des gesendeten Inhalts nicht zur angegebenen Dateigröße passt. Bitten Sie den Anbieter Ihrer Software, zu prüfen, ob die angegebene Größe mit der Größe der gesendeten Datei übereinstimmt. Senden Sie die Datei danach erneut. |
| 21403 | Falscher Hash der Datei KSeF 21403 bedeutet, dass der Hash des gesendeten Inhalts nicht zum angegebenen Hash der Datei passt. Bitten Sie den Anbieter Ihrer Software, zu prüfen, ob der angegebene Hash aus der gesendeten Datei berechnet wird. Senden Sie die Datei danach erneut. |
| 21405 | Eingabedaten bestehen die Prüfung nicht KSeF 21405 bedeutet, dass die Daten der Anfrage die Prüfung nicht bestanden haben. Korrigieren Sie den in den Details genannten Fehler und senden Sie die Anfrage erneut. |
| 21470 | Unbekannter oder zurückgezogener Schlüssel KSeF 21470 bedeutet, dass die gesendete Schlüsselkennung unbekannt ist oder auf einen zurückgezogenen Schlüssel verweist. Bitten Sie den Anbieter Ihrer Software, eine unterstützte Schlüsselkennung zu verwenden. Senden Sie die Anfrage danach erneut. |
Offizielles Dokument lesen
- KSeF API 2.0, specyfikacja OpenAPI (open-api.json) Quelle: KSeF API 2.0, specyfikacja OpenAPI (open-api.json), Version 2.9.0, herausgegeben von Ministerstwo Finansów, abgerufen am 8. November 2026. Offizieller Text in der Originalsprache, aus Ministerstwo Finansów, KSeF 2.0 Przewodnik dla Integratorów (github.com/CIRFMF/ksef-api), Copyright (c) 2025 Ministerstwo Finansów, unter MIT License.
- Weryfikacja faktury Quelle: Weryfikacja faktury, Version 09.04.2026, herausgegeben von Ministerstwo Finansów, abgerufen am 8. November 2026. Offizieller Text in der Originalsprache, aus Ministerstwo Finansów, KSeF 2.0 Przewodnik dla Integratorów (github.com/CIRFMF/ksef-api), Copyright (c) 2025 Ministerstwo Finansów, unter MIT License.
Häufige Fragen
Wo sehe ich den KSeF-Status einer Rechnung?
Ihr Rechnungsprogramm liest ihn nach dem Senden aus KSeF aus. Jede Rechnung einer Sitzung erhält einen Statuscode, eine Beschreibung und, soweit KSeF sie liefert, Details. Status 200 bedeutet Erfolg, 100 und 150 bedeuten, dass KSeF die Rechnung noch verarbeitet.
Warum erscheint dieselbe Nummer zweimal?
KSeF verwendet dieselben Nummern für den Status einer Rechnung und den Status einer Sitzung, jeweils mit anderer Bedeutung. Bei einer Rechnung steht 440 für ein Duplikat, bei einer Sitzung bedeutet es, dass die Sitzung abgebrochen wurde. Prüfen Sie, welchen der beiden Status Ihr Programm anzeigt.
Welche Codes sind nicht aufgeführt?
Status, die Fortschritt oder Erfolg melden, sowie die Fehlercodes für Anmeldung, Zertifikate, Token, Berechtigungen und das Herunterladen von Rechnungen. Diese Fehlercodes betreffen einen anderen Vorgang als das Senden einer Rechnung.
Woher stammen die Codes?
Aus der KSeF-2.0-API-Dokumentation des polnischen Finanzministeriums, veröffentlicht unter der MIT-Lizenz. Jede Codeseite zitiert den offiziellen polnischen Text und verlinkt die Quelle.