Krajowy System e-Faktur (KSeF) to obowiązkowe narzędzie dla przedsiębiorców w Polsce, służące do wystawiania i przesyłania e-faktur. Gdy aplikacja KSeF przestaje działać – z powodu awarii, problemów z logowaniem czy przerw technicznych – nie wpadaj w panikę. W tym artykule wyjaśniamy najczęstsze przyczyny usterek, krok po kroku pokazujemy, jak je naprawić, oraz omawiamy tryby awaryjne i offline, które pozwalają działać zgodnie z prawem nawet bez dostępu do systemu.
Artykuł opiera się na oficjalnych komunikatach Ministerstwa Finansów oraz doświadczeniach użytkowników i ekspertów. Dowiesz się, jak sprawdzić status KSeF, wyczyścić przeglądarkę, skorzystać z alternatyw logowania i udokumentować problemy, by uniknąć sankcji.
Najczęstsze przyczyny, dla których KSeF nie działa
Problemy z KSeF mogą wynikać z usterek po stronie użytkownika, Ministerstwa Finansów lub infrastruktury. Oto główne powody:
- awaria lub prace serwisowe po stronie MF – system bywa przeciążony (np. komunikat o „limicie zapytań”); przerwy techniczne, jak ta w dniach 26–31 stycznia 2026 r. przed wdrożeniem KSeF 2.0, uniemożliwiają dostęp do KSeF 1.0, Aplikacji Podatnika, modułu certyfikatów i integracji z systemami FK/ERP;
- problemy z logowaniem – Profil Zaufany potrafi szwankować, choć inne metody (ePUAP, NRP, podpis kwalifikowany) bywają dostępne;
- usterki przeglądarki – uszkodzony cache i cookies powodują pustą stronę po logowaniu lub błędy sesji w Chrome, Firefox czy Edge;
- brak uprawnień lub błędy konfiguracji – brak nadanych praw do NIP w Aplikacji Podatnika lub problemy z certyfikatem;
- problemy lokalne – brak internetu, awarie serwera czy błędy integracji API nie kwalifikują się jako awaria systemowa i wymagają szybkiej naprawy;
- aplikacja mobilna – potrafi wyświetlać komunikat „usługa niedostępna” podczas awarii.
Na start zawsze sprawdź status na oficjalnych stronach: ksef.podatki.gov.pl/komunikaty-techniczne oraz zewnętrzne agregatory, np. ksef.systems czy ealerty.pl.
Krok po kroku – jak naprawić problemy z logowaniem i dostępem
1. Sprawdź status systemu KSeF
Pierwszy krok – zawsze zweryfikuj, czy problem jest po twojej stronie. Wejdź na ksef.podatki.gov.pl/komunikaty-techniczne oraz serwisy monitorujące (ksef.systems, ealerty.pl). Jeśli trwa przerwa (np. techniczna przed KSeF 2.0), poczekaj na oficjalny komunikat o przywróceniu.
Przykładowy komunikat MF brzmi:
KSeF działa bez zakłóceń.
2. Wypróbuj alternatywne metody logowania
Profil Zaufany nie działa? Nie blokuj pracy. KSeF obsługuje następujące metody logowania:
- Profil Zaufany – wygodny, ale bywa przeciążony w szczycie;
- ePUAP – często dostępny, gdy PZ ma problemy;
- NRP (Narodowe Repozytorium Podpisu) – alternatywna ścieżka weryfikacji;
- podpis kwalifikowany lub certyfikat – zwykle najpewniejsza metoda w czasie awarii.
Przykładowa opinia użytkownika:
Działa bez problemu, ale logowanie tylko podpisem kwalifikowanym.
To najczęstsza przyczyna pustej strony lub błędów sesji. Wykonaj poniższe czynności:
- Chrome/Edge – Ustawienia > Prywatność > Wyczyść dane przeglądania > zaznacz „Pliki cookie” i „Obrazy i pliki w pamięci podręcznej” dla domeny KSeF;
- Firefox – Opcje > Prywatność > Wyczyść dane dla witryny KSeF;
- tryb incognito lub inna przeglądarka – jeśli problem trwa, zaloguj się w trybie prywatnym lub użyj innej przeglądarki (zalecane: Chrome lub Firefox).
4. Sprawdź uprawnienia i konfigurację
Upewnij się, że masz nadane prawa do NIP w Aplikacji Podatnika. W razie problemów z certyfikatem sprawdź ważność i poprawność integracji.
5. Problemy z aplikacją mobilną
Jeśli mobilna wersja pokazuje „usługa niedostępna”, przełącz się na wersję desktopową lub użyj alternatywnej metody logowania. Zwykle awaria dotyczy samego logowania.
Co robić w razie awarii systemowej? Tryb awaryjny i offline
Gdy KSeF całkowicie nie działa (ogłoszona awaria lub przerwa), nie wystawiaj faktur poza systemem – chyba że włączysz tryb awaryjny lub offline. Oto różnice i zasady:
| Sytuacja | Opis | Co robić? | Dokumentacja |
|---|---|---|---|
| Awaria całkowita (ogłoszona przez MF w BIP i interfejsie) | System niedostępny dla wszystkich, np. przerwa techniczna KSeF 1.0/2.0. | Wystawiaj faktury poza KSeF (papierowe lub dotychczasowe metody) i prześlij je po przywróceniu; termin na przesłanie e-faktury jest przedłużony. | Zapisz komunikat MF z linkiem i czasem trwania. |
| Tryb awaryjny (ograniczona niedostępność) | Ogłoszony komunikat o problemach, ale nie całkowita awaria. | Wystawiaj e-faktury lokalnie i prześlij po przywróceniu dostępności (zwykle do 3 dni). | Wykonaj zrzut ekranu komunikatu + krótki opis. |
| Tryb offline24 | Niedostępność do 24h, np. lokalny brak internetu (nie jest to awaria systemowa). | Buforuj i ponawiaj wysyłkę automatycznie (retry w systemie). | Przechowuj logi prób wysyłki. |
| Lokalne problemy (brak internetu, błąd API) | Nie upoważniają do ominięcia KSeF. | Napraw usterkę jak najszybciej. | Brak formalnego trybu. |
Automatyczne mechanizmy w oprogramowaniu – dobry system FK/ERP buforuje faktury i ponawia wysyłkę. Zapisz link do komunikatu MF – to podstawa dokumentacji. W trybie offline faktury wysyłasz po przywróceniu, zachowując ustrukturyzowany format XML.
Przykłady rzeczywistych awarii i jak sobie z nimi radzić
Poniżej znajdziesz krótkie case’y i najskuteczniejsze reakcje:
- pierwsze dni KSeF – problemy z Profilem Zaufanym po starcie; rozwiązanie: użyj alternatywnych metod logowania lub spróbuj ponownie później;
- przerwa styczeń 2026 – wyłączenie KSeF 1.0, Aplikacji Podatnika i MCU do 31.01; działanie: dokumentuj przerwę i wystawiaj faktury w trybie przewidzianym przez komunikat;
- przeciążenie – komunikat „limit zapytań”; działanie: wyczyść cache/cookies i zaloguj się inną metodą.
Jak udokumentować problemy, by uniknąć kar?
Klucz do bezpieczeństwa – zawsze zapisuj dowody. Zgromadź następujące materiały:
- zrzut ekranu komunikatu MF z ksef.podatki.gov.pl,
- logi z systemu (daty i godziny prób wysyłki),
- krótki opis: czas, metoda logowania, treść błędu.
Wskazówki zapobiegawcze dla księgowych i przedsiębiorców
Aby ograniczyć ryzyko przestojów, zastosuj te praktyki:
- testuj regularnie – loguj się co tydzień i sprawdzaj aktualność uprawnień;
- wybierz niezawodne oprogramowanie – z mechanizmami retry i buforowaniem (np. Symfonia, iFirma);
- miej backup logowania – trzymaj pod ręką podpis kwalifikowany jako plan B;
- śledź komunikaty – subskrybuj alerty z ealerty.pl lub ksef.systems.
Jeśli problem się utrzymuje, skontaktuj się ze wsparciem MF przez komunikaty lub forum. KSeF ewoluuje – po KSeF 2.0 awarie powinny być rzadsze, ale warto stale monitorować sytuację.
