Błędy logowania do KSeF – przewodnik po komunikatach i kolejnych krokach

Jak korzystać z tego przewodnika

Zapisz dokładny komunikat lub kod błędu (np. widoczny w przeglądarce lub w odpowiedzi API), a następnie przejdź do odpowiedniej sekcji poniżej. Wiele problemów ma podobne przyczyny: przeglądarka, kontekst NIP, uprawnienia albo chwilowa niedostępność usług.

Szybki wybór ścieżki

Sytuacja	Zacznij od
Nie wiem, od czego zacząć	Szybka diagnostyka (checklista)
Chcę zrozumieć rodzaje przyczyn	Kategorie problemów z logowaniem
Problem z plikiem `.p12` / certyfikatem w przeglądarce	Logowanie certyfikatem – przeglądarka i kody
Zapomniane hasło do certyfikatu	Zapomniane hasło – MCU i nowy certyfikat
Pojawia się komunikat o limicie zapytań	Limit zapytań – portal i API
HTTP 401 lub wątpliwości co do tokena / uprawnień	Błąd 401 – uprawnienia, token, kontekst

Metody logowania – co sprawdzić najpierw

Profil Zaufany / ePUAP – sprawdź ważność profilu oraz czy przekierowanie z banku działa poprawnie; upewnij się, że przeglądarka nie blokuje wyskakujących okien.
Certyfikat kwalifikowany – sprawdź datę ważności, zgodność danych z podmiotem oraz aktualność oprogramowania do podpisu.
Certyfikat KSeF – upewnij się, że jest poprawnie zainstalowany w używanej przeglądarce, używasz właściwego środowiska (testowego lub produkcyjnego) oraz znasz hasło do pliku .p12.

Kody i komunikaty (skrót)

Szczegółowe omówienia znajdują się w osobnych artykułach. Najczęściej spotykane sytuacje:

403 – brak odpowiednich uprawnień w KSeF,
400 / 415 – problem z procesem autoryzacji (np. podpisem),
21111 / 21115 / 9103 – błędy związane z wyzwaniem lub podpisem,
429 – przekroczenie limitu zapytań.

Integracja API

Jeżeli problem dotyczy integracji (API), warto sprawdzić:

czy token jest nadal ważny,
czy używany jest właściwy kontekst (np. NIP),
czy nie zostały przekroczone limity zapytań: Limity zapytań do API KSeF.

W takim przypadku problem nie zawsze dotyczy samego „logowania”, ale szerszego kontekstu komunikacji z KSeF.

Walidacja faktury to osobny temat

Odrzucenie dokumentu przy wysyłce zwykle nie jest błędem logowania, tylko wynikiem walidacji technicznej lub reguł systemowych. Zobacz:

Przydatne serwisy

Status KSeF

Pierwszy serwis prezentuje informacje o statusie samego KSeF, drugi – komunikaty techniczne Ministerstwa Finansów.