Zum Hauptinhalt springen
KSeF 2.0 · Authentifizierung

KSeF-Authentifizierungsstatus: 415, 425, 450, 470 und 480

Die Anmeldung bei KSeF endet mit einem Status, der getrennt vom Versand abgefragt wird. Neben den Zertifikatsfehlern (Code 460) gibt es Status zu Berechtigungen, einer widerrufenen Sitzung, einem Token und einer Sperre. Der Code 450 bedeutet hier etwas anderes als bei einer Rechnung (450 bei der Rechnung).

FlexigoTech · Verantwortlich: Víctor Gómez · Aktualisiert am 5. November 2026

Das Wichtigste

Versionen
Odoo 17, 18, 19 und 20
Geprüft
im Quellcode des Moduls, Version 20.0 · in den Quellen am Ende
Lesezeit
3 Min.

Was jeder Status bedeutet

415
«Uwierzytelnianie zakończone niepowodzeniem» (Authentifizierung fehlgeschlagen), details «Brak przypisanych uprawnień» (keine Berechtigungen zugewiesen): Die Person oder Stelle im Zertifikat hat im Kontext dieser NIP keine Berechtigungen.
425
«Uwierzytelnienie unieważnione» (Authentifizierung widerrufen), details «Uwierzytelnienie i powiązane refresh tokeny zostały unieważnione przez użytkownika»: Jemand hat diese Anmeldesitzung beendet.
450
«Uwierzytelnianie zakończone niepowodzeniem z powodu błędnego tokenu» (wegen eines fehlerhaften Tokens fehlgeschlagen), mit details wie «Token unieważniony», «Token nieaktywny», «Nieprawidłowy czas tokena» oder «Token nie może być użyty w kontekście {contextIdentifier}»: Es geht um die Anmeldung mit einem KSeF-Token.
470
«Uwierzytelnianie zakończone niepowodzeniem», details «Próba wykorzystania metod autoryzacyjnych osoby zmarłej» (Versuch, die Zugangsdaten einer verstorbenen Person zu verwenden).
480
«Uwierzytelnienie zablokowane» (Authentifizierung gesperrt), details «Podejrzenie incydentu bezpieczeństwa. Skontaktuj się z Ministerstwem Finansów przez formularz zgłoszeniowy.» (Verdacht auf einen Sicherheitsvorfall; wenden Sie sich über das Meldeformular an das Finanzministerium).
500 und 550
«Nieznany błąd» (unbekannter Fehler) und «Operacja została anulowana przez system» (vom System abgebrochen), mit details «Przetwarzanie zostało przerwane z przyczyn wewnętrznych systemu. Spróbuj ponownie» (Verarbeitung aus internen Gründen unterbrochen; versuchen Sie es erneut).
Karte der KSeF-Authentifizierungsstatus
Status 415 mit seiner Beschreibung aus der API sowie die übrigen Anmeldestatus: 425, 450, 470 und 480, dazu die Codes 21301 und 21304.

KSeF-Token und Odoo

Odoo 18, 19 und 20 enthalten im Code eine Funktion zur Anmeldung mit einem KSeF-Token, doch sie wird nirgends aufgerufen: Es wird nur mit dem Zertifikat angemeldet. Ein 450 bei der Anmeldung stammt daher nicht von Odoo. Wenn Sie es sehen, kommt es von einem anderen Programm, das ein Token nutzt, etwa dem einer Steuerkanzlei. KSeF widerruft Token automatisch, sobald ihr Inhaber die Berechtigungen verliert.

Bei den übrigen Status zeigt Odoo «KSeF Authentication failed with status …: …» mit der Beschreibung, ohne die details. Bei 415 und 470 ist die Beschreibung dieselbe, daher unterscheidet nur das Feld details beide.

Zugriffstoken, Refresh und die Codes 21301 und 21304

ElementKSeFOdoo 18, 19 und 20
accessTokenGilt einige Minuten («kilkanaście», laut Dokumentation), so wie es im Feld exp angegeben istNach einem HTTP 401 wird es erneuert und die Anfrage einmal wiederholt.
refreshTokenBis zu 7 TageDie geplante Aktion «Refresh KSeF tokens» meldet sich alle 6 Tage mit dem Zertifikat erneut an.
21301 «Brak autoryzacji.» (keine Autorisierung)Beim Einlösen oder Erneuern von Token, zum Beispiel «Token KSeF został unieważniony.» (KSeF-Token widerrufen)Sie sehen «Failed to refresh KSeF access token. You may need to re-authenticate manually. Error: 400 Client Error…», ohne den Code.
21304 «Brak uwierzytelnienia.» (keine Authentifizierung)«Operacja uwierzytelniania o numerze referencyjnym {referenceNumber} nie została znaleziona.»Ebenso: Der Code erreicht den Bildschirm nicht.
Schema: was KSeF bei den Anmeldestatus 415-480 zurückgibt und was Odoo 20 anzeigt
Schema auf Grundlage des Codes von l10n_pl_edi in Odoo 20 und der Spezifikation der KSeF-API 2.9.0; das Durchgestrichene ist, was Odoo nicht speichert oder nicht ausführt.

Was zu tun ist

  • 415, oder 21301 nach dem Entzug von Berechtigungen: Der Inhaber des Unternehmens erteilt der Person im Zertifikat in KSeF Berechtigungen, und Sie speichern das Zertifikat erneut in den Einstellungen von Odoo.
  • 425: Jemand hat die Anmeldesitzung widerrufen; speichern Sie das Zertifikat erneut, damit Odoo sich neu anmeldet.
  • 480: Folgen Sie den Hinweisen von KSeF und wenden Sie sich über das Formular an das Finanzministerium; eine erneute Anmeldung hilft nicht.
  • 500 oder 550: Versuchen Sie es erneut.

Unser Modul Poland KSeF 2.0 Validator führt eine Liste der KSeF-Zertifikate und -Token mit ihren Ablaufdaten, meldet sich aber nicht bei KSeF an und erkennt diese Status nicht.

Weiterlesen

Anmeldung bei KSeF mit Zertifikat: Code 460 und XAdES-SignaturfehlerKSeF-Code 460 und Ausnahmen 9101-9105, 21111, 21115, 21117, 21217, 21401 und 21406 bei der Anmeldung mit Zertifikat. Was Odoo nicht anzeigt und was zu prüfen ist.KSeF-Code 450: «Błąd weryfikacji semantyki dokumentu faktury»KSeF-Code 450 lehnt eine FA(3)-Rechnung nach der Prüfung ihres Inhalts ab. Wo der eigentliche Grund steht, was Odoo nicht anzeigt und wie Sie die Rechnung erneut senden.KSeF-Codes 410 und 415: Verkäuferberechtigungen und AnhängeKSeF 410 «Nieprawidłowy zakres uprawnień» und 415 bei Rechnungen mit Anhang: was sie in den Tests des Ministeriums auslöst und was Sie in Odoo 18, 19 und 20 prüfen.
Geprüft im Quellcode des Moduls (Version 20.0) und in den verlinkten Quellen

Quellen