Przejdź do głównej treści
KSeF 2.0 · uwierzytelnianie

Statusy uwierzytelniania KSeF: 415, 425, 450, 470 i 480

Logowanie do KSeF kończy się statusem, który sprawdza się osobno od samej wysyłki. Poza błędami certyfikatu (kod 460) są statusy, które mówią o uprawnieniach, unieważnionej sesji, tokenie i blokadzie. Kod 450 występuje tu w innym znaczeniu niż przy fakturze (450 faktury).

FlexigoTech · Odpowiada: Víctor Gómez · Aktualizacja: 5 listopada 2026

Najważniejsze

Moduł
KSeF 2.0
Wersje
Odoo 17, 18, 19 i 20
Sprawdzone
w kodzie źródłowym modułu, wersja 20.0 · w źródłach podanych na końcu
Czas czytania
2 min

Co oznacza każdy status

415
„Uwierzytelnianie zakończone niepowodzeniem”, details „Brak przypisanych uprawnień”: osoba albo podmiot z certyfikatu nie ma żadnych uprawnień w kontekście tego NIP.
425
„Uwierzytelnienie unieważnione”, details „Uwierzytelnienie i powiązane refresh tokeny zostały unieważnione przez użytkownika”: ktoś zamknął tę sesję logowania.
450
„Uwierzytelnianie zakończone niepowodzeniem z powodu błędnego tokenu”, z details takimi jak „Token unieważniony”, „Token nieaktywny”, „Nieprawidłowy czas tokena” albo „Token nie może być użyty w kontekście {contextIdentifier}”: dotyczy logowania tokenem KSeF.
470
„Uwierzytelnianie zakończone niepowodzeniem”, details „Próba wykorzystania metod autoryzacyjnych osoby zmarłej”.
480
„Uwierzytelnienie zablokowane”, details „Podejrzenie incydentu bezpieczeństwa. Skontaktuj się z Ministerstwem Finansów przez formularz zgłoszeniowy.”.
500 i 550
„Nieznany błąd” oraz „Operacja została anulowana przez system”, z details „Przetwarzanie zostało przerwane z przyczyn wewnętrznych systemu. Spróbuj ponownie”.
Karta statusów uwierzytelniania KSeF
Status 415 z opisem z API i pozostałe statusy logowania: 425, 450, 470 i 480, oraz kody 21301 i 21304.

Token KSeF a Odoo

Odoo 18, 19 i 20 ma w kodzie funkcję logowania tokenem KSeF, ale nic jej nie wywołuje: loguje się tylko certyfikatem. Status 450 przy logowaniu nie przyjdzie więc z Odoo. Jeśli go widzisz, pochodzi z innego programu, który używa tokenu, na przykład biura rachunkowego. Tokeny KSeF są unieważniane automatycznie, gdy ich właściciel traci uprawnienia.

Przy pozostałych statusach Odoo pokazuje „KSeF Authentication failed with status …: …” z opisem, bez details (w 18 i 19 po polsku: „Uwierzytelnianie KSeF nie powiodło się z kodem błędu …: …”). Przy 415 i 470 opis jest ten sam, więc rozróżnia je dopiero pole details.

Tokeny dostępu, odświeżanie i kody 21301 i 21304

ElementKSeFOdoo 18, 19 i 20
accessTokenWażny kilkanaście minut (pole exp)Po HTTP 401 odświeża go i powtarza zapytanie jeden raz.
refreshTokenDo 7 dniZaplanowana akcja „Refresh KSeF tokens” co 6 dni loguje się od nowa certyfikatem.
21301 „Brak autoryzacji.”Przy odbiorze i odświeżaniu tokenów, np. „Token KSeF został unieważniony.”Widzisz „Failed to refresh KSeF access token. You may need to re-authenticate manually. Error: 400 Client Error…”, bez kodu.
21304 „Brak uwierzytelnienia.”„Operacja uwierzytelniania o numerze referencyjnym {referenceNumber} nie została znaleziona.”Tak samo: kod nie trafia na ekran.
Schemat: co zwraca KSeF przy statusach logowania 415-480 i co pokazuje Odoo 20
Schemat na podstawie kodu l10n_pl_edi z Odoo 20 i specyfikacji API KSeF 2.9.0; skreślone jest to, czego Odoo nie zapisuje albo nie robi.

Co zrobić

  • 415 albo 21301 po odebraniu uprawnień: właściciel firmy nadaje w KSeF uprawnienia osobie z certyfikatu, a Ty zapisujesz certyfikat w ustawieniach Odoo jeszcze raz.
  • 425: ktoś unieważnił sesję logowania; zapisz certyfikat ponownie, żeby Odoo zalogowało się od nowa.
  • 480: postępuj jak mówi KSeF i skontaktuj się z Ministerstwem Finansów przez formularz zgłoszeniowy; ponawianie logowania nic nie da.
  • 500 albo 550: spróbuj ponownie.

Nasz moduł, Poland KSeF 2.0 Validator, prowadzi listę certyfikatów i tokenów KSeF z datami ważności, ale nie loguje się do KSeF i nie widzi tych statusów.

Czytaj dalej

Logowanie certyfikatem do KSeF: kod 460 i błędy podpisu XAdESKod 460 KSeF i wyjątki 9101-9105, 21111, 21115, 21117, 21217, 21401 i 21406 przy logowaniu certyfikatem. Czego Odoo 18, 19 i 20 nie pokazuje i co sprawdzić.Kod 450 w KSeF: „Błąd weryfikacji semantyki dokumentu faktury”Kod 450 oznacza, że KSeF odrzucił fakturę FA(3) po sprawdzeniu treści. Gdzie jest prawdziwa przyczyna, czego nie pokazuje Odoo 18, 19 i 20 i jak wysłać fakturę ponownie.Kody 410 i 415 w KSeF: uprawnienia sprzedawcy i załącznikiKod 410 „Nieprawidłowy zakres uprawnień” i 415 „Brak możliwości wysyłania faktury z załącznikiem”: co je wywołuje według testów MF i co sprawdzić w Odoo 18, 19 i 20.
Sprawdzone w kodzie źródłowym modułu (wersja 20.0) i w podlinkowanych źródłach

Źródła