KSeF-Fehler in verständlicher Sprache lesen: Code, Ursache, Feld, Lösung

KSeF-Fehlermeldungen sind die häufigste UX-Beschwerde im Markt nach dem Start. Das System liefert numerische Fehlercodes (21401, 21405, 21301, 440) mit Beschreibungen auf Entwicklerniveau wie "Dokument nie jest zgodny ze schemą XSD". Kein polnischer Anbieter liefert eine Erklärung in verständlicher Sprache. Die Codes sind deterministisch, was sie ideal für quellenfundierte Übersetzung macht: Jeder Code bildet auf eine Ursache, ein fehlerhaftes Feld und eine Lösung ab.

Der Decoder

21401: "Dokument nie jest zgodny ze schemą XSD"

Verständlich: Ihr Rechnungs-XML entspricht nicht dem FA(3)-Schema. Die Struktur ist falsch.

Ursache: Das XML wurde aus einer veralteten Vorlage erzeugt (FA(2) statt FA(3)), enthält ungültige Zeichen (BOM-Bytes), hat Elemente in falscher Reihenfolge oder es fehlen Pflichtelemente.

Fehlerhaftes Feld: Die Fehlerantwort enthält den XPath zum fehlerhaften Element. Suchen Sie den Feldpfad in der Antwort.

Lösung: Erzeugen Sie die Rechnung aus einer aktuellen FA(3)-Vorlage neu. Aktualisieren Sie Ihre Rechnungssoftware auf die neueste Version. Bearbeiten Sie XML nicht von Hand.

21405: Eingabevalidierungsfehler

Verständlich: Ein bestimmtes Feld enthält Daten im falschen Format. Die XML-Struktur ist korrekt, aber der Inhalt eines Feldes fällt durch die Validierung.

Ursache: NIP mit Bindestrichen oder Leerzeichen, Datum im falschen Format, Zahlenfeld mit Komma statt Punkt oder KursWaluty mit weniger als 6 Dezimalstellen.

Fehlerhaftes Feld: Die Fehlerantwort nennt das konkrete Feld. Häufige Verursacher: NIP (Käufer oder Verkäufer), P_1 (Ausstellungsdatum), KursWaluty.

Lösung: Korrigieren Sie die Quelldaten in Ihrer Kundenkarte oder im Rechnungsformular. Bei NIP: alle Bindestriche, Leerzeichen und "PL"-Präfixe entfernen. Bei Daten: YYYY-MM-DD verwenden. Bei Dezimalzahlen: Punkt statt Komma. Erneut senden.

21301: "brak autoryzacji"

Verständlich: Sie haben keine Berechtigung, Rechnungen für die NIP im Rechnungskopf auszustellen.

Ursache: Ihr Token ist abgelaufen, wurde für eine andere NIP ausgestellt, oder Ihre Berechtigungen umfassen keine Ausstellungsrechte für diese Gesellschaft.

Fehlerhaftes Feld: NIP im Rechnungskopf gegenüber NIP auf dem Token.

Lösung: Erzeugen Sie das Token mit den korrekten Berechtigungen für die ausstellende NIP neu. Bei persönlicher Anmeldung (Profil Zaufany): zur Token-basierten Authentifizierung wechseln. Sind Sie ein Buchhaltungsbüro, prüfen Sie, ob der Mandant Ihnen Ausstellungsrechte für seine NIP erteilt hat.

440: Duplikat

Verständlich: Eine Rechnung mit derselben Nummer desselben Ausstellers existiert bereits in KSeF.

Ursache: Sie haben eine Rechnung erneut gesendet, die bereits erfolgreich übermittelt wurde. Die erste Übermittlung war erfolgreich, aber Sie haben den Status vor dem erneuten Senden nicht geprüft.

Fehlerhaftes Feld: Rechnungsnummer (NrFaktury).

Lösung: Fragen Sie KSeF mit Ihrer eigenen Rechnungsnummer ab. War die erste Übermittlung erfolgreich (Status 200), verwenden Sie die vorhandene KSeF-Nummer. Erzeugen Sie kein Duplikat. War die erste Übermittlung wirklich fehlgeschlagen, beheben Sie den Fehler und senden Sie mit derselben Rechnungsnummer erneut.

Status 100 oder 150: Kein Fehler

Verständlich: Ihre Rechnung wird verarbeitet. Warten Sie.

Ursache: KSeF hat die Rechnung erhalten und verarbeitet sie. Die Verarbeitungszeit schwankt unter Last zwischen Sekunden und Stunden.

Lösung: Dieselbe Sitzung abfragen. Nicht erneut senden. Erneutes Senden erzeugt ein Duplikat.

HTTP 500, 503, 429: Serverfehler

Verständlich: KSeF ist überlastet oder begrenzt Ihre Anfragerate.

Ursache: Verkehr in der Startphase, vorübergehende Infrastrukturprobleme oder zu viele Anfragen in kurzer Zeit.

Lösung: Mit Backoff wiederholen. Hält der Fehler an, in den Offline24-Modus wechseln. Rechnung lokal ausstellen und bis zum nächsten Werktag übermitteln.

Warum das kein Anbieter liefert

Die Fehlercodes sind deterministisch. Sie bilden auf feste Ursachen und Lösungen ab. Eine Erklärungsengine ist technisch einfach: eine Nachschlagetabelle von Code zu Ursache-Feld-Lösung, mit Zitaten aus der offiziellen Dokumentation.

Kein polnischer Anbieter liefert sie, weil die etablierten Produkte vor KSeF gebaut wurden und Fehlerbehandlung als nachträglichen Gedanken betrachten. Ihre Fehlermeldungen sind rohe API-Antworten in einer dünnen Oberfläche. Der Nutzer sieht "21401" und muss im Netz nach einer Erklärung suchen, wo er Content-Farm-Artikel mit erfundenen Codes findet.

Die Chance: Die Erklärungsengine als kostenloses, wirklich nützliches Werkzeug ausliefern. Jeder Fehlercode der echten Taxonomie, abgebildet auf verständliche Sprache, mit Zitaten aus der offiziellen OpenAPI-Dokumentation. Keine erfundenen Codes. Keine erfundenen Verfahren. Der Nutzer sucht nach "błąd 21401 KSeF" und findet eine Seite, die sagt: "Ihr XML entspricht nicht dem FA(3)-Schema. Hier der Grund. Hier das zu korrigierende Feld. Hier die Lösung."

Diese Seite rankt. Sie rankt, weil sie korrekt, belegt und nützlich ist. Sie rankt, weil jede Content-Farm-Alternative falsch ist. Die Korrektheit ist der Burggraben.

AI-Act-Konformität

Nutzt die Erklärungsengine KI (etwa ein Sprachmodell, das aus Code und Kontext den verständlichen Text erzeugt), verlangt Art. 50 AI Act die Offenlegung, dass der Nutzer mit einem KI-System interagiert, sowie maschinenlesbare Kennzeichnung KI-generierter Inhalte. Ab dem 2. August 2026 ist das Pflicht.

Das sicherere Design: eine deterministische Nachschlagetabelle statt eines Sprachmodells. Die Codes sind fest. Die Ursachen sind fest. Die Lösungen sind fest. Eine Nachschlagetabelle ist genauer, schneller und von den AI-Act-Transparenzpflichten befreit. Nutzen Sie KI für das, was von Schlussfolgerung profitiert (Parametervorschläge, Entwürfe). Nutzen Sie eine Nachschlagetabelle für das, was deterministisch ist (Fehlercodes).

Dieser Text dient der allgemeinen Information und stellt keine Rechts- oder Steuerberatung dar. Prüfen Sie im Einzelfall die aktuellen Regeln oder wenden Sie sich an einen Steuerberater.