Logowanie i uprawnienia

Nie mogę zalogować się do KSeF: przyczyny, „Uwierzytelnienie nie powiodło się” i błędy 401/403

W skrócie

Jeśli nie możesz zalogować się do KSeF, najczęściej wybrałeś zły kontekst (NIP), nie masz w nim uprawnień, używasz podpisu bez NIP i PESEL bez zgłoszonego odcisku palca albo nieważnego tokena lub certyfikatu. Komunikat „Uwierzytelnienie nie powiodło się” oznacza właśnie, że KSeF nie wpuścił cię w wybranym kontekście. W programach ten sam problem ma kod 415, 450 lub 460, a błędy HTTP 401, 403 i 429 oznaczają kolejno: brak ważnego logowania, brak uprawnienia do operacji i przekroczony limit zapytań.

Spis treści
  1. Problem z logowaniem do KSeF – co sprawdzić po kolei?
  2. Dlaczego KSeF odrzuca logowanie, skoro Profil Zaufany zadziałał?
  3. Co znaczą szczegóły pod komunikatem w Aplikacji Podatnika?
  4. Jakie kody błędów logowania pokazują programy?
  5. Co znaczą błędy 401, 403 i 429?
  6. „Zaktualizuj swoją przeglądarkę” – co zrobić?
  7. Sesja wygasła – dlaczego KSeF cię wylogował?
  8. Co przekazać dostawcy programu lub infolinii?

Jeśli nie możesz zalogować się do KSeF, najczęściej system nie widzi twoich uprawnień w firmie, której NIP wpisałeś: nikt ci ich nie nadał, pomyliłeś numer lub rodzaj identyfikatora, dodałeś niewłaściwy podpisany plik albo twój podpis, token lub certyfikat nie jest już ważny. Aplikacja Podatnika pokazuje wtedy komunikat „Uwierzytelnienie nie powiodło się”, a program do faktur – kod błędu.

Pod komunikatem aplikacja radzi sprawdzić dane logowania w połączeniu z wybranym kontekstem i spróbować jeszcze raz albo inną metodą. Zacznij od listy poniżej, a szczegóły znajdziesz w kolejnych sekcjach. Samo logowanie krok po kroku – profilem zaufanym, przez bank, mObywatelem czy podpisem – opisujemy w artykule logowanie do KSeF.

Problem z logowaniem do KSeF – co sprawdzić po kolei?

  1. Wersję aplikacji. Produkcyjną Aplikację Podatnika otwierasz pod adresem ap.ksef.mf.gov.pl. Wersje testowa i przedprodukcyjna (Demo) to osobne środowiska z osobnymi danymi: w testowej poświadczenia są symulowane, w Demo działają prawdziwe. Wersja testowa przy logowaniu ostrzega, że wchodzisz do ogólnodostępnego środowiska testowego. W programie sprawdź, czy łączy się z produkcją, a nie z adresem testowym.
  2. Kontekst. Wybierz właściwy rodzaj identyfikatora i wpisz NIP firmy, w której imieniu działasz. Jeśli pracujesz dla klienta – jego NIP, nie swój. Jeśli prowadzisz JDG i jesteś też członkiem zarządu spółki, to dwa różne konteksty.
  3. Metodę logowania. Aplikacja Podatnika przyjmuje logowanie przez login.gov.pl (profil zaufany, bank, mObywatel, e-dowód) albo kwalifikowanym podpisem lub pieczęcią, a program do faktur – tokenem lub certyfikatem KSeF. Gdy jedna metoda zawodzi, np. twojego banku nie ma na login.gov.pl, wybierz inną. Dlaczego profil zaufany członka zarządu nie wystarcza spółce, wyjaśniamy w artykule o logowaniu do KSeF.
  4. Uprawnienia. Właściciel JDG ma je automatycznie. Spółka loguje się pieczęcią ze swoim NIP albo przez osobę wskazaną w ZAW-FA, ale dopiero gdy urząd przeniesie dane z ZAW-FA do systemu (dostaniesz wtedy e-mail). Pracownik i księgowa potrzebują uprawnienia od osoby, która zarządza uprawnieniami w firmie. Jak je nadać: uprawnienia w KSeF.
  5. Podpis lub pieczęć bez NIP i PESEL. Taki certyfikat zadziała dopiero po zgłoszeniu jego odcisku palca (64 znaki) – w ZAW-FA albo elektronicznie – i po przetworzeniu zgłoszenia. Odcisk pobierzesz na ekranie logowania funkcją Pobierz odcisk palca. Nowy certyfikat ma nowy odcisk, więc po wymianie podpisu zgłoszenie trzeba powtórzyć.
  6. Ważność tokena i certyfikatu KSeF. Token zadziała wyłącznie w tej firmie (kontekście), dla której powstał. Unieważniony token nie zadziała, a token, z którego odebrano wszystkie uprawnienia, formalnie pozostaje aktywny, ale nie pozwoli się zalogować. Certyfikat KSeF nie zadziała przed datą początku ważności, po jej upływie (najwyżej 2 lata) ani po unieważnieniu, a certyfikat typu offline w ogóle nie służy do logowania. Tokeny z KSeF 1.0 nie działają w KSeF 2.0. Szczegóły: certyfikat KSeF i token.
  7. Zegar i przeglądarkę. Ustaw automatyczny czas w systemie i zaktualizuj przeglądarkę – więcej niżej.
  8. Komunikaty MF. Zajrzyj do komunikatów technicznych MF – w 2026 r. były tam m.in. przerwy w Profilu Zaufanym. Jeśli nie możesz wysłać faktury, wystaw ją w trybie offline.

Dlaczego KSeF odrzuca logowanie, skoro Profil Zaufany zadziałał?

Logowanie do KSeF ma dwa etapy. Najpierw potwierdzasz, kim jesteś: przez login.gov.pl albo kwalifikowanym podpisem bądź pieczęcią, a w programach także certyfikatem KSeF lub tokenem. Potem KSeF sprawdza, czy ta osoba lub firma ma co najmniej jedno aktywne uprawnienie w wybranym kontekście, czyli w NIP albo identyfikatorze wewnętrznym, który wpisałeś. Bez uprawnień nie wejdziesz, nawet jeśli tożsamość potwierdziłeś bez zarzutu.

Stąd typowa sytuacja: Profil Zaufany księgowej działa, a KSeF i tak nie wpuszcza jej do firmy klienta, który nie nadał jej dostępu. Program w takim przypadku dostaje kod 415 z opisem „Brak przypisanych uprawnień”.

Co znaczą szczegóły pod komunikatem w Aplikacji Podatnika?

Co widzisz pod komunikatem Prawdopodobna przyczyna Co zrobić
brak dodatkowych szczegółów brak uprawnień w tym NIP albo literówka w numerze sprawdź NIP; poproś firmę o nadanie uprawnień
nieprawidłowy identyfikator dla wybranego typu kontekstu zły rodzaj identyfikatora (NIP, identyfikator wewnętrzny, identyfikator złożony) albo błędny numer wybierz właściwy typ i wpisz numer jeszcze raz
żądanie niepodpisane albo niewłaściwy plik wgrany plik bez podpisu lub inny niż pobrane żądanie podpisz pobrane żądanie i dodaj plik .xml lub .xades
plik podpisany nieobsługiwanym rodzajem certyfikatu podpis, którego aplikacja nie przyjmuje użyj kwalifikowanego podpisu lub pieczęci
nieprawidłowy czas systemowy zegar komputera lub telefonu odbiega od rzeczywistego włącz automatyczne ustawianie daty i godziny
metoda logowania chwilowo niedostępna przerwa w usłudze, np. w Profilu Zaufanym wybierz inną metodę albo spróbuj później

Jakie kody błędów logowania pokazują programy?

Program łączący się z API KSeF po próbie logowania odpytuje o jej status. Według specyfikacji API wynik może mieć te kody:

Kod Opis MF Co zrobić
100 Uwierzytelnianie w toku poczekaj; przy podpisie kwalifikowanym KSeF sprawdza status certyfikatu u jego wystawcy i może to potrwać
415 niepowodzenie – brak przypisanych uprawnień poproś o uprawnienie w tym NIP
425 Uwierzytelnienie unieważnione sesję zamknięto – zaloguj program ponownie
450 niepowodzenie z powodu błędnego tokenu, np. nieprawidłowy, unieważniony, nieaktywny albo nie do użycia w tym kontekście wygeneruj nowy token we właściwym kontekście
460 niepowodzenie z powodu błędu certyfikatu, np. nieważny, odwołany, zawieszony, niezaufany łańcuch sprawdź ważność podpisu lub certyfikatu KSeF; w razie potrzeby wnioskuj o nowy
470 próba użycia metod autoryzacyjnych osoby zmarłej wyjaśnij sprawę z urzędem skarbowym lub infolinią
480 Uwierzytelnienie zablokowane – podejrzenie incydentu bezpieczeństwa opisz sprawę w formularzu zgłoszeniowym MF
500, 550 nieznany błąd albo operacja anulowana przez system spróbuj ponownie; gdy błąd wraca – zgłoś dostawcy

Co znaczą błędy 401, 403 i 429?

To kody HTTP, które program dostaje od API KSeF. Jeśli program pokazuje tylko liczbę, przekaż ją dostawcy razem z opisem.

  • 401 Unauthorized – KSeF nie widzi ważnego logowania. Token dostępowy, którym program podpisuje zapytania, jest ważny krótko (dokumentacja podaje rząd kilkunastu minut), a program odnawia go tokenem odświeżającym ważnym do 7 dni. Gdy oba wygasną albo zostaną unieważnione, program musi zalogować się od nowa.
  • 403 Forbidden – logowanie jest ważne, ale tej operacji wykonać nie możesz. API podaje przyczynę, m.in. brak wymaganych uprawnień w bieżącym kontekście (missing-permissions), inny adres IP niż przy logowaniu (ip-not-allowed), operację niedostępną dla użytej metody logowania (auth-method-not-allowed) albo blokadę przez mechanizmy bezpieczeństwa (security-service-blocked). Typowy przykład: token tylko do przeglądania faktur, a program próbuje je wysyłać.
  • 429 Too Many Requests – przekroczony limit zapytań. Limity liczone są osobno dla każdej pary kontekst i adres IP, a nagłówek Retry-After podaje, po ilu sekundach ponowić próbę. Kolejne przekroczenia wydłużają blokadę, więc program nie powinien ponawiać zapytań w pętli. Wartości limitów dla poszczególnych operacji zebraliśmy w tekście limity KSeF.

„Zaktualizuj swoją przeglądarkę” – co zrobić?

Według podręcznika Aplikacja Podatnika działa w najnowszych stabilnych wersjach Google Chrome, Mozilla Firefox, Microsoft Edge i Safari. Jeśli wersja przeglądarki jest za stara, aplikacja może np. pokazać komunikat „Podgląd faktury niedostępny” z prośbą o aktualizację. Zaktualizuj przeglądarkę w jej ustawieniach albo otwórz aplikację w innej z wymienionych.

Sesja wygasła – dlaczego KSeF cię wylogował?

Po okresie bezczynności Aplikacja Podatnika ostrzega, że wkrótce cię wyloguje, i odlicza czas. Kliknij Przedłuż sesję, inaczej nastąpi automatyczne wylogowanie. Aplikacja wyloguje cię też po zmianie twoich uprawnień, po zmianie adresu IP (np. przy przełączeniu VPN) i gdy zalogujesz się w innej karcie – nowe logowanie zamyka sesję w poprzedniej. W każdym z tych przypadków wybierz Zaloguj się ponownie i pracuj w jednej karcie.

Co przekazać dostawcy programu lub infolinii?

Problem z programem zgłoś najpierw jego dostawcy – to on widzi pełną odpowiedź API. W sprawie Aplikacji Podatnika i samego KSeF pomaga Infolinia KAS do spraw KSeF: telefon, formularz kontaktowy i czat na stronie Kontakt. W aplikacji formularz otworzysz przyciskiem Skontaktuj się z nami. Przygotuj:

  • datę i godzinę próby oraz środowisko (produkcja, Demo, test),
  • metodę logowania, rodzaj kontekstu i numer NIP,
  • pełną treść komunikatu i kod (np. 450, 403) razem ze szczegółami,
  • numer referencyjny operacji i identyfikator traceId, jeśli program go pokazuje,
  • zrzut ekranu.

Najczęstsze pytania

Dlaczego nie mogę zalogować się do KSeF?

Najczęściej wpisujesz NIP firmy, w której nie masz uprawnień, mylisz kontekst (np. własna działalność zamiast spółki), używasz podpisu bez NIP i PESEL bez zgłoszonego odcisku palca albo nieważnego tokena lub certyfikatu. Sprawdź też, czy łączysz się z produkcyjną wersją aplikacji i czy MF nie ogłosiło przerwy technicznej.

Co znaczy komunikat „Uwierzytelnienie nie powiodło się” w Aplikacji Podatnika?

KSeF nie potwierdził, że możesz działać w kontekście (NIP), który wpisałeś. Najczęściej nie masz w nim żadnego uprawnienia, pomyliłeś numer lub typ identyfikatora albo dodałeś niewłaściwy podpisany plik. Zacznij od sprawdzenia NIP, a potem uprawnień.

Czym różni się błąd 401 od 403 w KSeF?

401 oznacza, że program nie ma ważnego logowania, np. wygasł mu token dostępowy, i musi uwierzytelnić się ponownie. 403 oznacza, że logowanie jest ważne, ale brakuje uprawnienia do danej operacji albo zapytanie przyszło z innego adresu IP niż przy logowaniu.

Co oznacza błąd 429 w KSeF?

Program wysłał za dużo zapytań w krótkim czasie i KSeF czasowo go blokuje. W nagłówku Retry-After odpowiedzi jest liczba sekund, po których można spróbować ponownie. Kolejne przekroczenia wydłużają blokadę.

Gdzie zgłosić problem z logowaniem do KSeF?

Problem z programem do faktur zgłoś jego dostawcy. W sprawie Aplikacji Podatnika i samego KSeF pomaga infolinia KAS do spraw KSeF – telefonicznie, przez formularz kontaktowy lub czat na stronie ksef.podatki.gov.pl.

Źródła

  1. Podręcznik użytkownika Aplikacji Podatnika KSeF 2.0 (wersja 2.6, sierpień 2026), pkt 2.4 (przycisk „Skontaktuj się z nami”), 3 (przeglądarki), 4.1–4.1.2 (logowanie, odcisk palca, wylogowanie)
  2. Podręcznik KSeF 2.0 cz. I (MF, 06.08.2026), wstęp (infolinia KAS), pkt 2.2–2.3 (podpis i pieczęć bez NIP i PESEL), 2.4.7 (token a uprawnienia), 2.5.3 i 2.5.7 (ważność certyfikatu KSeF)
  3. CIRFMF/ksef-api, „Uwierzytelnianie” – kontekst, weryfikacja uprawnień, OCSP/CRL, ważność accessToken i refreshToken
  4. CIRFMF/ksef-api, specyfikacja OpenAPI – statusy uwierzytelniania (100–550), odpowiedzi 401, 403 (reasonCode) i 429
  5. CIRFMF/ksef-api, „Limity żądań API” (14.09.2026), pkt 1–2 – blokada 429 i nagłówek Retry-After
  6. FAQ KSeF 2.0 (MF), kategoria „Zagadnienia techniczne”, pyt. 7 (środowiska) i 14 (tokeny z KSeF 1.0)

Artykuł ma charakter informacyjny i nie stanowi porady podatkowej. W konkretnej sprawie skonsultuj się z księgowym lub doradcą podatkowym.

Przeczytaj też