Aplikacja KSeF nie działa? Najczęstsze błędy logowania i sposoby na ich rozwiązanie
Sprawdź, co zrobić, gdy nie możesz zalogować się do KSeF lub aplikacji do faktur. Rozpoznaj problemy z portalem, uprawnieniami, tokenem i certyfikatem.
Spis treści
Nie możesz zalogować się do KSeF, strona zatrzymuje się podczas uwierzytelnienia albo aplikacja nie pobiera faktur? Przyczyna może dotyczyć portalu Ministerstwa Finansów, wybranej metody logowania, uprawnień do firmy, przeglądarki lub połączenia aplikacji z KSeF. Te sytuacje wymagają różnych sprawdzeń, dlatego najpierw ustal, gdzie pojawia się błąd.
Poniżej znajdziesz listę najczęstszych problemów i kroki, które pomogą zawęzić przyczynę bez zakładania, że każda awaria oznacza problem z tokenem.
Dlaczego logowanie do Aplikacji Podatnika KSeF może się nie udać?
Aplikacja Podatnika działa w przeglądarce i korzysta z metod uwierzytelnienia udostępnionych przez KSeF oraz krajowy węzeł identyfikacji. Problemy mogą wystąpić podczas logowania, wyboru kontekstu firmy, weryfikacji uprawnień albo chwilowej niedostępności usługi. Informacje o planowanych pracach i utrudnieniach Ministerstwo Finansów publikuje w komunikatach technicznych.
Sprawdź w szczególności:
- Komunikaty MF — potwierdź, czy nie ma informacji o utrudnieniach lub pracach serwisowych.
- Metodę logowania — sprawdź, czy działa wybrany dostawca tożsamości, podpis lub pieczęć i czy używasz właściwego profilu.
- Kontekst i uprawnienia — po zalogowaniu wybierz właściwy NIP. W spółce upewnij się, że Twoja osoba ma nadane uprawnienia do działania w tym kontekście.
- Przeglądarkę — przy pętli logowania sprawdź aktualność przeglądarki, ustawienia cookies i skryptów, a następnie spróbuj prywatnego okna lub innej przeglądarki.
Najczęstsze błędy i co sprawdzić
Sam kod błędu nie zawsze wskazuje jedną przyczynę. W przypadku komunikatu z programu zintegrowanego z API KSeF sprawdź szczegóły odpowiedzi i instrukcję dostawcy oprogramowania.
| Objaw | Co może oznaczać | Co sprawdzić |
|---|---|---|
| Brak dostępu do firmy | Niewłaściwy kontekst lub brak przypisanych uprawnień. | Wybrany NIP, nadane role i dostęp osoby w KSeF; w spółce także uprawnienie administratora lub ZAW-FA, jeśli wymagane. |
| Błąd uwierzytelnienia w aplikacji | Token mógł zostać unieważniony, metoda może być błędna albo nie mieć potrzebnych uprawnień. | Czy token jest aktywny i został wygenerowany dla właściwego kontekstu oraz czy jego zakres obejmuje daną czynność. |
| Certyfikat nie działa | Certyfikat może być nieważny, unieważniony, źle dodany albo nieobsługiwany przez program. | Typ certyfikatu, termin ważności, jego status i sposób konfiguracji opisany przez dostawcę aplikacji. |
| Strona wraca do logowania | Sesja, cookies, ustawienia przeglądarki lub etap logowania zewnętrznego mogą przerwać proces. | Cookies i skrypty, prywatne okno, inna przeglądarka albo alternatywna metoda uwierzytelnienia. |
| Błąd serwera lub timeout | Możliwy chwilowy problem po stronie usługi, połączenia internetowego lub integracji. | Komunikaty techniczne MF, połączenie sieciowe i komunikat programu; odczekaj i spróbuj ponownie. |
Jak krok po kroku przywrócić dostęp do KSeF?
- Zapisz dokładny komunikat błędu i sprawdź, czy pojawia się w Aplikacji Podatnika, podczas logowania zewnętrznym dostawcą, czy w programie do faktur.
- Otwórz stronę komunikatów technicznych MF i sprawdź, czy opublikowano informację o utrudnieniach w odpowiedniej usłudze lub środowisku.
- Jeśli problem występuje w przeglądarce, odśwież stronę, zaloguj się w prywatnym oknie lub użyj aktualnej innej przeglądarki. Sprawdź, czy cookies i skrypty wymagane do logowania nie są blokowane.
- Jeśli portal otwiera się, ale nie widzisz danych firmy, potwierdź wybrany kontekst NIP i swoje uprawnienia. W razie braku dostępu skontaktuj się z osobą administrującą dostępami w KSeF.
- Jeśli problem dotyczy aplikacji połączonej z KSeF, sprawdź status tokena lub certyfikatu, kontekst i potrzebne uprawnienia. Token do odczytu nie pozwoli wystawić faktury — trzeba wygenerować nowy z uprawnieniem do wystawiania.
- Gdy komunikat nadal występuje, skontaktuj się z pomocą techniczną odpowiedniej usługi lub dostawcą programu. Przekaż treść błędu, czas jego wystąpienia i nazwę używanego środowiska; nie przesyłaj tokena ani prywatnego klucza certyfikatu.
Problemy z tokenem i certyfikatem
Tokeny KSeF 2.0 pozostają dostępne bezterminowo według informacji MF, ale właściciel może je unieważnić. Jeśli token nie działa, sprawdź przede wszystkim jego status, podmiot, dla którego go utworzono, oraz zakres praw. Token zawiera uprawnienia wybrane podczas generowania — nie da się rozszerzyć ich w Faktino. Do wystawiania faktur potrzebny jest token z odpowiednim uprawnieniem.
Certyfikat typu 1 służy do uwierzytelnienia w KSeF, a system sprawdza uprawnienia przypisane osobie lub podmiotowi. Certyfikat jest ważny maksymalnie dwa lata i może zostać unieważniony. Certyfikat typu 2 ma odrębne zastosowanie przy oznaczaniu faktur wystawianych w określonych trybach offline. Upewnij się, że dany program obsługuje typ i sposób użycia certyfikatu, który konfigurujesz.
Więcej informacji znajdziesz w artykule o tokenie i certyfikacie KSeF.
Logowanie do portalu a codzienna praca w aplikacji
Logowanie do Aplikacji Podatnika i połączenie programu z KSeF to dwa różne procesy. W portalu użytkownik uwierzytelnia się wybraną metodą, taką jak Profil Zaufany, podpis lub inny dostępny sposób. W aplikacji zewnętrznej można skonfigurować token lub certyfikat, aby nie potwierdzać tożsamości przy każdym otwarciu dokumentu.
Faktino obsługuje token KSeF oraz certyfikat typu 1. Uwierzytelnienie i pobrane dane pozostają lokalnie na urządzeniu, a aplikacja łączy się bezpośrednio z KSeF. Wcześniej pobrane dane mogą być dostępne lokalnie przy chwilowym braku połączenia, ale pobranie nowych faktur i ich wystawianie wymaga komunikacji z systemem oraz odpowiednich uprawnień. Funkcje synchronizacji i wystawiania działają w okresie próbnym, a później wymagają subskrypcji.
Co zrobić przy niedostępności KSeF?
Najpierw sprawdź, czy komunikat MF dotyczy planowanej niedostępności, awarii, czy problemu z usługą logowania. Dla wybranych sytuacji przepisy przewidują wystawianie faktur w trybie offline, ale tryby te mają różne warunki, oznaczenia i terminy przesłania dokumentu. Nie każdy program je obsługuje. Postępuj według instrukcji dla konkretnego trybu i upewnij się, że używane narzędzie pozwala przygotować oraz później przekazać fakturę zgodnie z wymaganiami.
Najczęściej zadawane pytania
Czy błąd 401 zawsze oznacza wygasły token?
Nie. Znaczenie zależy od miejsca, w którym pojawił się błąd i treści odpowiedzi. Sprawdź, czy token jest aktywny, czy dotyczy właściwego kontekstu i czy ma wymagane uprawnienia. Jeśli błąd wyświetla program, sprawdź jego dokumentację lub skontaktuj się z dostawcą.
Czy token KSeF wygasa po określonym czasie?
Według aktualnej informacji Ministerstwa Finansów tokeny w KSeF 2.0 będą dostępne bezterminowo. Token może jednak zostać unieważniony. Certyfikat KSeF ma ograniczony okres ważności — maksymalnie dwa lata.
Czy Faktino wymaga ponownego logowania Profilem Zaufanym przy każdym użyciu?
Nie. Po skonfigurowaniu tokena lub certyfikatu aplikacja korzysta z wybranej metody połączenia z KSeF. Jeśli token zostanie unieważniony, certyfikat straci ważność albo zabraknie uprawnień, trzeba poprawić konfigurację lub dostęp w KSeF.
Czy przy awarii portalu mogę nadal wystawiać faktury?
To zależy od rodzaju niedostępności i funkcji programu. Przepisy przewidują tryby offline w określonych sytuacjach, ale fakturę trzeba przygotować zgodnie z wymaganiami danego trybu. Sprawdź komunikat MF i dokumentację narzędzia, z którego korzystasz.
Warto zapamiętać
- Najpierw ustal, czy błąd dotyczy portalu MF, metody logowania, uprawnień czy aplikacji zewnętrznej.
- Sprawdź komunikaty techniczne KSeF oraz wybrany kontekst firmy.
- Tokeny pozostają dostępne bezterminowo, ale można je unieważnić; certyfikaty KSeF są ważne maksymalnie dwa lata.
- Token do odczytu nie wystarczy do wystawiania faktur; potrzebny jest token z odpowiednim zakresem lub uprawnienia przypisane do certyfikatu w KSeF.
- Tryby offline mają różne zasady i terminy, a ich obsługa zależy od programu.
Podsumowanie
Gdy aplikacja KSeF nie działa, dokładny komunikat i miejsce wystąpienia błędu pomogą ustalić następny krok. Sprawdź status usług MF, metodę logowania, kontekst firmy, uprawnienia oraz konfigurację tokena lub certyfikatu. Kody błędów traktuj jako wskazówkę, a nie samodzielną diagnozę. W aplikacji zewnętrznej, takiej jak Faktino, codzienne korzystanie z dokumentów nie wymaga ponownego logowania do portalu przy każdym podglądzie.
Zobacz także: jak pobrać fakturę z KSeF bez ciągłego logowania, instrukcja generowania tokena, różnice między tokenem a certyfikatem.
Źródła i przydatne informacje
Chcesz szybciej sprawdzać faktury z KSeF?
Faktino pomaga kontrolować faktury zakupowe i sprzedażowe, terminy płatności oraz statusy dokumentów bez dodatkowego konta i bez reklam. Dane pozostają lokalnie na urządzeniu użytkownika.