KSeF nie działa — awarie i problemy z logowaniem

Awarię KSeF w rozumieniu przepisów ogłasza Ministerstwo Finansów. Dopiero takie ogłoszenie uruchamia tryb awaryjny; błąd programu lub wolne działanie systemu nie wystarczą.¹
Jak odróżnić te sytuacje i co zrobić z fakturami, gdy KSeF nie działa?² Ogłoszenie awarii reguluje art. 106ne ust. 1 ustawy o VAT. Z kolei art. 106nf ust. 1 pozwala wtedy wystawiać faktury w trybie awaryjnym³.

Czym jest KSeF i co oznaczają jego błędy?

KSeF, czyli Krajowy System e-Faktur, obsługuje faktury ustrukturyzowane. Ich format pozwala automatycznie odczytać zapisane dane. Komunikat o błędzie oznacza, że konkretna czynność się nie udała; jego treść pomaga ustalić, czy zawiódł dostęp, uprawnienia czy sam dokument.
Przed ponowieniem operacji przeczytaj komunikat. Nie każde niepowodzenie ma tę samą przyczynę. Od 1 lutego 2026 r. obowiązuje wzór struktury logicznej faktury ustrukturyzowanej FA(3)⁴.

Co oznacza komunikat błędu w KSeF?

Komunikat błędu pokazuje, na którym etapie operacja w KSeF się nie powiodła. Może chodzić o uwierzytelnienie użytkownika albo przyjęcie faktury. Uwierzytelnienie potwierdza tożsamość osoby lub podmiotu, a uprawnienia określają, jakie czynności wolno mu wykonać.
Dane dokumentu, a nie dane logowania, sprawdź, gdy komunikat dotyczy faktury. Odpowiedź HTTP 403 Forbidden może oznaczać brak uprawnień potrzebnych do wykonania operacji⁵.

Jakie bezpłatne programy i narzędzia są dostępne do obsługi KSeF?

Ministerstwo Finansów udostępnia bezpłatną Aplikację Podatnika KSeF 2.0. Można w niej pracować z fakturami bez komercyjnego programu do fakturowania. Inną drogą jest API KSeF, czyli interfejs łączący program z systemem.
Sam dostęp do API nie mówi, ile kosztuje program ani jego integracja z KSeF. Produkcyjna wersja bezpłatnej Aplikacji Podatnika KSeF 2.0 jest dostępna od 1 lutego 2026 r.⁴

Awaria KSeF czy problem z logowaniem – jak ustalić przyczynę?

Status usługi pomaga odróżnić awarię KSeF od problemu z logowaniem. Porównaj go z próbą dostępu z innego konta lub urządzenia. Latarnia KSeF przekazuje programom status systemu oraz komunikaty o planowanych przerwach i ogłoszonych awariach; nie wyróżnia osobnej kategorii „utrudnienia”.¹
Sprawdź też, czy niepowodzenie dotyczy tylko uwierzytelnienia, czy również innych czynności. Latarnia zwraca cztery statusy: AVAILABLE (pełna dostępność), MAINTENANCE (planowana niedostępność), FAILURE (awaria) i TOTAL_FAILURE (awaria całkowita)⁶.

Jak sprawdzić, czy awaria KSeF dotyczy całej usługi?

To, czy awaria KSeF dotyczy całej usługi, sprawdzisz, porównując status systemu i komunikaty Ministerstwa Finansów. Wynik logowania porównaj z próbą wykonania innej czynności, gdy możesz wejść do KSeF. Poproś też osobę korzystającą z odrębnego konta, by sprawdziła dostęp.
Błąd Latarni KSeF nie przesądza o awarii systemu. Brak komunikatu w Latarni również nie wyklucza utrudnień.¹ Odpowiedź HTTP 503 Service Unavailable może oznaczać czasową niedostępność operacji API, ale sama nie potwierdza ogłoszonej awarii KSeF⁷.

Awaria usługi, konto czy urządzenie – gdzie leży przyczyna braku dostępu?

Zasięg niepowodzenia podpowiada, gdzie szukać przyczyny. Porównaj dostęp z innych kont i urządzeń, zanim uznasz problem za awarię usługi.

Tabela zestawia możliwe przyczyny braku dostępu, próby porównawcze i kolejne czynności diagnostyczne.

Pojedyncza nieudana próba wskazuje kierunek dalszego sprawdzania. Bez porównania z inną próbą nie potwierdza przyczyny.

Jakie komunikaty mogą wskazywać, że KSeF nie działa?

Komunikat sugerujący, że KSeF nie działa, może dotyczyć całej usługi albo konkretnej operacji. Przeczytaj jego treść. Ustal, czy problem wiąże się z połączeniem z API KSeF, uwierzytelnieniem czy fakturą.
„Uwierzytelnienie nie powiodło się” opisuje nieudaną próbę dostępu, nie stan całego systemu. Odpowiedź HTTP 401 Unauthorized dotyczy uwierzytelnienia żądania API. Nie oznacza tego samego co brak uprawnień sygnalizowany kodem 403⁵.

Co sprawdzić, gdy logowanie do KSeF się nie udaje?

Nie możesz zalogować się do KSeF? Sprawdź metodę uwierzytelnienia, uprawnienia do działania w imieniu podatnika oraz dostęp na innym urządzeniu. Awaria Profilu Zaufanego może zablokować logowanie do KSeF, choć dotyczy odrębnej usługi.⁸
Porównaj próbę przez Profil Zaufany z inną dostępną metodą, zanim przypiszesz problem KSeF. Profil Zaufany zachowuje ważność przez 3 lata od potwierdzenia. Można ją przedłużyć o kolejne 3 lata⁹.

Faktury podczas awarii KSeF: wysyłka, wzór i daty

Postępowanie z fakturami podczas awarii KSeF zależy od rodzaju zdarzenia ogłoszonego przez Ministerstwo Finansów. Inne zasady dotyczą awarii, awarii całkowitej i planowanej niedostępności. Fakturę wystawioną podczas planowanej przerwy trzeba wysłać do KSeF najpóźniej 1 dzień roboczy po zakończeniu przerwy.¹
Rodzaj zdarzenia decyduje też o przekazaniu faktury nabywcy i jej późniejszej wysyłce do systemu¹⁰.

Które czynności związane z wysyłką i odbiorem faktur mogą być niedostępne?

Gdy KSeF jest niedostępny, wystawca może nie móc wysłać faktury do systemu. Nabywca z kolei może nie odebrać jej tą drogą. Dokument przekazany poza KSeF nie jest fakturą pobraną z systemu.
Zachowaj dokument i informację o sposobie jego przekazania nabywcy. Ułatwi to ustalenie dalszych czynności po przywróceniu dostępu. Zgodnie z art. 106nf ust. 4 ustawy o VAT fakturę wystawioną podczas ogłoszonej awarii przesyła się do KSeF w ciągu 7 dni roboczych od jej zakończenia³.

Czy awaria KSeF wpływa na wzór faktury?

Ogłoszona awaria KSeF nie zmienia wzoru faktury. Awaria całkowita pozwala natomiast wystawić dokument także na papierze. Tabela porównuje postać faktury, sposób przekazania jej nabywcy i obowiązek dosłania do KSeF¹⁰.
Podczas ogłoszonej awarii fakturę wystawia się elektronicznie według struktury FA(3). Przy awarii całkowitej dopuszczalna jest również faktura papierowa¹¹.

Dane w tabeli: 1

Przy awarii całkowitej można wystawić fakturę papierową i nie trzeba później dosyłać jej do KSeF. To odróżnia ją od zwykłej ogłoszonej awarii¹². Awarii całkowitej dotyczy art. 106ng w związku z art. 106ne ust. 3 ustawy o VAT¹².

Jak ustalić datę faktury wystawionej podczas awarii KSeF?

Datę wystawienia faktury podczas awarii KSeF odczytaj z dokumentu. Datę otrzymania przez nabywcę ustal na podstawie chwili faktycznego przekazania.¹³
Sposób i dzień przekazania zapisz, gdy faktura trafiła do nabywcy poza systemem. Gdy nabywca otrzyma ją dopiero po nadaniu numeru KSeF, datą otrzymania jest dzień nadania numeru.¹⁴ Zasadę faktycznego otrzymania i wyjątek dotyczący wcześniejszego nadania numeru określa art. 106nf ust. 10 ustawy o VAT³.

Co zrobić z fakturą, gdy KSeF nie działa bez oficjalnego komunikatu?

Brak oficjalnego komunikatu o awarii nie musi wstrzymywać wystawiania faktur. Gdy KSeF nie działa, wystawca może skorzystać z trybu offline24, na przykład przy awarii własnego łącza. Taką fakturę trzeba wysłać do KSeF najpóźniej 1 dzień roboczy po wystawieniu.¹
Tryb offline24 obejmuje również problem po stronie wystawcy, który uniemożliwia bieżącą wysyłkę¹⁵.

Komunikaty MF, bezpieczeństwo i usługi powiązane z KSeF

Komunikaty Ministerstwa Finansów pozwalają ustalić, czy ogłoszono awarię KSeF i jaki okres obejmuje. Dokumentacja API Latarni wskazuje, że zakończone komunikaty o awariach i przerwach pozostają tam widoczne przez 30 dni.¹
Oceniając bieżącą sytuację, odróżnij oficjalny komunikat od nieudanego logowania lub błędu usługi powiązanej⁶.

Gdzie sprawdzić, czy dziś zgłoszono awarię KSeF?

Informację o ogłoszonej dziś awarii KSeF znajdziesz w komunikatach Ministerstwa Finansów. Bieżący status możesz porównać z danymi Latarni. Komunikaty o początku i końcu awarii ukazują się w Biuletynie Informacji Publicznej oraz przez oprogramowanie interfejsowe; wyznaczają okres jej trwania.¹
Widok strony statusu pobierającej dane z Latarni Ministerstwa Finansów odświeża się automatycznie co 60 sekund.¹⁶ Samo odświeżanie nie zastępuje treści oficjalnego komunikatu.

Gdzie MF ogłasza całkowitą awarię KSeF?

Ministerstwo Finansów ogłasza całkowitą awarię KSeF w środkach społecznego przekazu. O rodzaju awarii rozstrzyga treść ogłoszenia. Samo zgłoszenie problemów z dostępem nie oznacza jeszcze awarii całkowitej.
Zachowaj komunikat, na podstawie którego ustalasz sposób wystawiania faktur.

Czy awaria KSeF wpływa na bezpieczeństwo danych?

Awaria KSeF dotyczy dostępności lub działania usługi. Nie stanowi potwierdzenia naruszenia bezpieczeństwa danych. Komunikat o niedostępności mówi, czy można korzystać z systemu; komunikat o incydencie bezpieczeństwa dotyczy zagrożenia danych.
Błąd wysyłki faktury lub logowania sam w sobie nie świadczy o wycieku danych.

Czy niedostępność profilu zaufanego oznacza awarię KSeF?

Niedostępność Profilu Zaufanego nie oznacza automatycznie awarii KSeF. Profil Zaufany służy do potwierdzania tożsamości podczas logowania. Jego niedziałanie nie rozstrzyga, czy KSeF przyjmuje faktury od osób korzystających z innej metody dostępu.
Przypisz problem tej usłudze, której niedostępność została potwierdzona.

Awaria KSeF a obowiązki wynikające z ustawy o VAT

Po awarii KSeF ogłoszonej przez Ministerstwo Finansów trzeba przesłać faktury do systemu. Zasady trybu awaryjnego wyznaczają na to 7 dni roboczych od zakończenia awarii wskazanego w komunikacie.¹
Czas na wysyłkę liczy się od zakończenia kolejnej awarii, jeśli Ministerstwo Finansów ogłosi ją przed upływem terminu.^1,2

Jak postępować poza KSeF podczas awarii zgodnie z ustawą o VAT?

Praca poza KSeF podczas ogłoszonej awarii wymaga ustalenia okresu podanego w komunikacie. Wystawione faktury trzeba zachować, a po zakończeniu awarii wysłać do systemu. Lista porządkuje czynności związane z tą wysyłką:

• Komunikat o awarii KSeF wskazuje datę jej zakończenia. Zanotuj ją, by obliczyć termin wysyłki.
• Faktury z trybu awaryjnego wymagają późniejszego przesłania do KSeF. Zachowaj dokumenty oraz informację o wcześniejszym przekazaniu ich nabywcom.
• Kolejna ogłoszona awaria KSeF przed upływem terminu zmienia początek jego biegu. Ustal nowy termin z komunikatu o zakończeniu następnej awarii.

Termin wysyłki zależy od daty zakończenia ostatniej awarii ogłoszonej przed jego upływem.

Kary pieniężne za spóźnione przesłanie faktur z trybu awaryjnego mają, według opisanej obowiązującej ustawy, zacząć obowiązywać 1 stycznia 2027 r. Wskazany projekt rządowy przewiduje przesunięcie tej daty na 1 stycznia 2028 r. Projekt nie jest obowiązującym przepisem.^1,17

Wystawianie i wysyłanie faktur do KSeF w praktyce

Fakturę przekazywaną nabywcy przed wysłaniem do KSeF w trybie awaryjnym oznacza się 2 kodami QR: „OFFLINE” i „CERTYFIKAT”. Według zasad Ministerstwa Finansów drugi kod wymaga certyfikatu KSeF typu 2.¹
Wystawca powinien przygotować certyfikat przed przekazaniem tak oznaczonej faktury nabywcy.

Właściciel firmy powinien wyznaczyć osobę odpowiedzialną za przekazanie faktury nabywcy oraz osobę nadzorującą późniejszą wysyłkę do KSeF. Osoba obsługująca program księgowy powinna ustalić, jak przygotować wymagane oznaczenia. Musi też odróżniać fakturę przekazaną nabywcy od faktury przyjętej przez system.
Taki podział pozwala kontrolować wysyłkę osobno od wystawienia dokumentu.

Najczęściej zadawane pytania

Czy odpowiedź HTTP 503 potwierdza oficjalną awarię KSeF?

Nie. Może oznaczać czasową niedostępność operacji API, ale sama nie potwierdza awarii ogłoszonej przez Ministerstwo Finansów.

Jak długo w Latarni KSeF są widoczne zakończone komunikaty?

Zakończone komunikaty o awariach i przerwach pozostają widoczne przez 30 dni.

Czy status AVAILABLE oznacza, że każda operacja w KSeF musi się udać?

Oznacza pełną dostępność systemu, ale pojedyncza operacja nadal może się nie powieść. Jej komunikat może wskazywać problem z uprawnieniami albo dokumentem.

Czy kody 401 i 403 oznaczają ten sam problem?

Nie. Kod 401 dotyczy uwierzytelnienia żądania, a 403 może wskazywać brak uprawnień do wykonania operacji.

Czy do kodu QR „CERTYFIKAT” można użyć dowolnego certyfikatu KSeF?

Nie. Do tego oznaczenia potrzebny jest certyfikat KSeF typu 2.

Stan prawny na: październik 2026.