KSeF nie działa? Co zrobić i jak sprawdzić awarię

Gdy KSeF nie działa, zacznij od sprawdzenia statusu systemu i zachowania informacji o ostatniej próbie wysyłki. Nie wysyłaj tej samej faktury ponownie, dopóki nie ustalisz, czy została przyjęta. Następnie rozpoznaj problem: dostępność KSeF, aplikacja, logowanie, uprawnienia, limit zapytań albo dane dokumentu.

Bieżący stan sprawdzisz w monitorze statusu KSeF, a zakres i czas zdarzenia w komunikatach Ministerstwa Finansów. Ten poradnik prowadzi przez działania dla małej firmy i biura rachunkowego. Nie ogłasza, że KSeF ma teraz awarię.

Jeśli musisz wystawić fakturę podczas problemów, wybierz właściwy tryb i zapisz termin dosłania. Planowana niedostępność, awaria, awaria całkowita i offline24 mają różne zasady. Szkic w aplikacji pozwala zachować pracę, ale sam nie oznacza wystawienia faktury w którymkolwiek z tych trybów.

1. Zapisz numer faktury, firmę, godzinę błędu, komunikat oraz referencję operacji, jeśli ją otrzymałeś. Zachowaj przygotowany dokument. Nie zmieniaj numeru tylko po to, by ponowić próbę.

2. Sprawdź status i czas jego aktualizacji. Przeczytaj komunikaty techniczne MF, zwracając uwagę na produkcję, test lub demo oraz nazwę usługi objętej problemem.

3. Ustal zakres: nie działa cały program, samo logowanie, wszystkie wysyłki czy tylko jedna faktura? Skorzystaj z tabeli diagnostycznej poniżej.

4. Dla rozpoczętej wysyłki sprawdź status tej samej faktury lub sesji. Rozdziel dokumenty przyjęte, odrzucone i te, których wynik pozostaje nieznany.

5. Jeśli wystawienie nie może czekać, ustal właściwy tryb, wymagane dane i sposób udostępnienia nabywcy. Wyznacz osobę odpowiedzialną za dosłanie oraz jego termin.

6. Po przywróceniu pracy wróć do listy dokumentów. Zweryfikuj wcześniejsze próby, wyślij tylko właściwe pozycje i sprawdź numery KSeF oraz UPO.

1. Jak rozpoznać przyczynę problemu

2. Jak czytać status i komunikaty MF

3. Problemy z logowaniem i limitami API

4. Tryby wystawiania i terminy dosłania

5. Lista dokumentów i zasady ponawiania

6. Komunikacja z klientem i wsparciem

7. Przykład dla biura rachunkowego

8. Jak wykorzystać KSeFGPT

9. Co sprawdzić po przywróceniu działania

10. Najczęściej zadawane pytania

Ten sam komunikat „KSeF nie działa” może opisywać różne sytuacje. Zielony status nie wyklucza problemu z konkretną usługą, a pojedynczy błąd połączenia nie jest ogłoszeniem awarii w rozumieniu przepisów. Rozpoznaj objaw przed zmianą ustawień i kolejną wysyłką.

Otwórz status KSeF. Monitor KSeFGPT korzysta z danych Latarni MF, odświeża je co 60 sekund, pozwala odświeżyć ręcznie i pokazuje czas ostatniego skutecznego odczytu. Rozróżnia stany Dostępny, Planowana przerwa, Awaria i Awaria całkowita.

Jeśli pierwszy odczyt się nie powiedzie, status może pozostać nieznany. Jeśli błąd wystąpi po wcześniejszym odczycie, monitor może pokazać ostatnio pobrany stan z ostrzeżeniem. Sprawdzaj godzinę i komunikat o błędzie, nie tylko kolor. Monitor nie gwarantuje natychmiastowego wykrycia każdego problemu.

Przeczytaj również oficjalne komunikaty techniczne KSeF. Przerwa w Profilu Zaufanym, Aplikacji Podatnika albo środowisku testowym nie musi oznaczać niedostępności całego produkcyjnego KSeF. Zwróć uwagę na początek, koniec, środowisko i opis zdarzenia.

Awarię i niedostępność MF komunikuje w BIP oraz oprogramowaniu interfejsowym; awaria całkowita jest ogłaszana w środkach społecznego przekazu. Sam wpis użytkownika w mediach społecznościowych nie zastępuje takiego ogłoszenia. Monitor jest publiczny, nie wymaga konta i nie jest historycznym rejestrem wszystkich przerw.

Przy błędzie logowania ustal, z jakiej metody korzystasz. Jeśli problem dotyczy Profilu Zaufanego lub Węzła Krajowego, sprawdź komunikat dotyczący tej usługi. Przy tokenie albo certyfikacie sprawdź jego stan, właściwe środowisko i uprawnienia do firmy. Nie odnawiaj certyfikatu ani nie zmieniaj konfiguracji bez rozpoznania błędu.

Jeśli widzisz faktury, ale nie możesz ich wysyłać, sprawdź uprawnienie do wystawiania. Odczyt dokumentów i wystawianie to różne operacje. W aplikacji komercyjnej znaczenie mogą mieć również uprawnienia pracownika nadane wewnątrz organizacji.

Inną aplikację lub metodę dostępu możesz wykorzystać, jeżeli została prawidłowo przygotowana dla tej firmy. Nie rozpoczynaj jednak drugiej wysyłki dokumentu, który nadal jest przetwarzany w pierwszym programie. Dla problemów ograniczonych do telefonu zobacz poradnik aplikacja mobilna KSeF nie działa.

Komunikat HTTP 429 oznacza zbyt wiele żądań do API. Według dokumentacji KSeF czas blokady jest dynamiczny, a odpowiedź podaje go w nagłówku Retry-After w sekundach. Kolejne przekroczenia mogą wydłużyć blokadę. Wielokrotne klikanie Odśwież lub Wyślij nie rozwiązuje tego problemu.

Jeżeli pracujesz w programie, odczekaj wskazany czas i przekaż administratorowi komunikat. Przy własnej integracji zaplanuj ponowienie po wymaganej przerwie, zmniejsz równoległość operacji i częstotliwość odpytywania statusów. Nie zakładaj jednej stałej liczby prób dla wszystkich operacji.

Przerwa po limicie nie zwalnia z ustalenia wyniku poprzedniej wysyłki. Najpierw sprawdź, czy dokument ma już numer KSeF. Dopiero potem zdecyduj, czy potrzebna jest nowa próba, czy jedynie pobranie potwierdzenia.

Poniższe zasady wynikają z materiałów MF sprawdzonych 18 września 2026 r. Termin zależy od trybu i zdarzenia. Nie licz automatycznie 7 dni roboczych od każdego błędu programu.

Samo zapisanie PDF lub szkicu nie oznacza zastosowania trybu offline. Narzędzie i procedura muszą obsługiwać wymagany format, datę wystawienia, oznaczenia, przekazanie nabywcy i późniejsze przesłanie. Datą wystawienia w offline24, niedostępności i trybie awaryjnym jest data wskazana na fakturze w polu P_1.

W trybie awaryjnym faktura udostępniana poza KSeF przed przesłaniem do systemu wymaga dwóch kodów QR z oznaczeniami OFFLINE i CERTYFIKAT. Drugi wymaga certyfikatu KSeF typu 2. Przy offline24 i niedostępności sposób udostępnienia zależy także od rodzaju nabywcy; nie zakładaj, że każdemu krajowemu klientowi wystarczy przesłać zwykły PDF. Skorzystaj z odpowiedniej instrukcji MF podlinkowanej w tabeli.

Przy nakładających się zdarzeniach sprawdź ponownie termin. MF przewiduje osobne zasady, gdy po wystawieniu w offline24 lub podczas niedostępności pojawia się awaria, gdy następuje kolejna awaria lub gdy ogłoszono awarię całkowitą. W tej ostatniej sytuacji obowiązek dosłania może odpaść również dla dokumentów oczekujących. Nie przeliczaj tego wyłącznie na podstawie koloru monitora.

Prowadź jedną listę dla każdej firmy. Oddziel robocze szkice od faktur już wystawionych w odpowiednim trybie oraz od dokumentów, których wysyłka została rozpoczęta. Taki podział pozwala wrócić do pracy bez zgadywania, co można wysłać.

Jeśli nie rozpoczęto wysyłki, dokument pozostaje do obsłużenia według właściwej procedury. Jeśli wysyłka ruszyła, ale połączenie się urwało, wynik jest nieznany. Najpierw sprawdź status pierwotnej operacji. Po jednoznacznym odrzuceniu popraw wskazaną przyczynę. Po akceptacji nie wysyłaj faktury ponownie tylko dlatego, że nie masz jeszcze UPO.

Ponawiaj z przerwą odpowiednią do komunikatu, a nie w niekończącej się pętli. Nie zmieniaj numeru faktury, żeby ominąć wykrywanie duplikatu. Przy częściowo przyjętej partii ustal wynik każdego dokumentu i nie uruchamiaj od nowa całej paczki.

Zachowaj źródłowy XML, otrzymane odpowiedzi, komunikaty MF istotne dla wybranego trybu i dostępne potwierdzenia. Pliki przechowuj w firmowym miejscu z kontrolą dostępu oraz kopią zapasową. Katalog dokumentów roboczych oddziel od plików przyjętych przez KSeF. Sama kopia lokalna nie potwierdza przyjęcia faktury.

Klientowi podaj ustalony stan sprawy i termin kolejnej informacji. Nie obiecuj konkretnej godziny naprawy MF. Jeśli wynik wysyłki pozostaje nieznany, możesz użyć takiego komunikatu: „Weryfikujemy wynik przekazania faktury nr [numer] do KSeF. Sprawdzamy status tej samej operacji, aby nie wystawić dokumentu ponownie. Kolejną informację przekażemy do [uzgodniona godzina]”. Uzupełnij go rzeczywistymi danymi.

Jeżeli formalnie wystawiasz fakturę w trybie awaryjnym, komunikat organizacyjny nie zastępuje prawidłowego udostępnienia dokumentu nabywcy. Przekaż fakturę w sposób przewidziany dla tego trybu i uzgodniony z odbiorcą.

Zgłoszenie do dostawcy programu lub pomocy KSeF powinno zawierać czas zdarzenia, środowisko, operację, kod i treść błędu oraz referencję. Wskaż, czy dotyczy jednej faktury czy wielu. Nie dołączaj hasła, tokenu ani klucza prywatnego certyfikatu. Dane faktury przekazuj tylko w zakresie potrzebnym do diagnozy, właściwym kanałem wsparcia.

W małej firmie wyznacz osobę, która kontroluje stan wysyłki i listę faktur. Pozostałe osoby mogą przygotowywać dane, ale powinny uzgodnić, kto zatwierdza wysłanie konkretnego dokumentu. Dzięki temu dwie osoby nie ponawiają równocześnie tej samej operacji.

Przykład ilustracyjny: biuro przygotowało 20 faktur dla jednej firmy. Czternaście ma potwierdzoną akceptację, cztery czekają na wynik, a dwie nie zostały wysłane. Po przywróceniu połączenia biuro najpierw sprawdza cztery oczekujące operacje. Nie wysyła ponownie czternastu przyjętych dokumentów. Dwie niewysłane obsługuje według ich faktycznego stanu i trybu wystawienia.

Dla kolejnego klienta prowadź oddzielną listę i ponownie sprawdź NIP. Ustal z klientem, kto akceptuje dane, kto decyduje o trybie wystawienia i kto pilnuje terminu dosłania. Wpis „czekamy na KSeF” bez przypisanej osoby i terminu nie wystarczy do uporządkowania pracy.

Jeśli KSeFGPT i Twoje połączenie internetowe działają, możesz zachować rozpoczęty dokument jako szkic faktury. Sam zapis szkicu nie wymaga tokenu ani certyfikatu KSeF. Nie oznacza jednak prawidłowego wystawienia faktury offline ani gwarancji pracy aplikacji bez internetu.

Dane z PDF możesz przekazywać do kolejki konwersji PDF do XML. Każdy poprawnie przetworzony plik tworzy osobny szkic. Porównaj go ze źródłem przed wysyłką. To kolejka przygotowania dokumentów, a nie automatycznego wysyłania faktur po zakończeniu awarii. Importuj wyłącznie dokumenty, które masz prawo obsługiwać; nie wystawiaj ponownie sprzedaży już udokumentowanej fakturą.

Gotowy plik możesz sprawdzić walidatorem XML KSeF. Publiczne narzędzia wymagają e-maila przed wynikiem i mają wspólny limit 2 użyć w ciągu 24 godzin. Walidacja pomaga wykryć błędy struktury; nie naprawia awarii MF i nie potwierdza przyjęcia faktury.

Czat AI może pomóc wyjaśnić komunikat błędu, gdy masz dostęp do rozmowy. Jego działanie zależy od dostępności aplikacji, uprawnień i połączenia KSeF. Odpowiedź AI nie zastępuje oficjalnego ogłoszenia awarii. Monitor statusu sam nie uruchamia wysyłek ani powiadomień do Twoich kontrahentów.

1. Potwierdź koniec zdarzenia i zakres przywróconej usługi. Sprawdź, czy w międzyczasie nie opublikowano kolejnego komunikatu zmieniającego zasady dosłania.

2. Ustal wynik operacji rozpoczętych przed przerwą. Dla zaakceptowanych faktur odczytaj numer KSeF i pobierz UPO, gdy będzie dostępne.

3. Porównaj listę dokumentów z systemem. Oddziel szkice, odrzucone próby, faktury wymagające dosłania i dokumenty wystawione podczas awarii całkowitej.

4. Wyślij tylko te faktury, które wymagają przesłania, z uwzględnieniem trybu i terminu. Nie zmieniaj daty faktury już wystawionej offline tylko dlatego, że wysyłasz ją później.

5. Sprawdź wynik każdego dokumentu, także w partii. Zapisz identyfikatory, potwierdzenia oraz dalsze działanie dla ewentualnych odrzuceń.

6. Zamknij listę dopiero po rozliczeniu wszystkich pozycji. Przekaż klientowi lub księgowości ustalony wynik oraz potrzebne dokumenty.

Jak sprawdzić status faktury w KSeF pomoże ustalić wynik konkretnej operacji.

Brak UPO w KSeF opisuje postępowanie, gdy nie widzisz potwierdzenia.

Faktura odrzucona przez KSeF prowadzi przez diagnostykę odrzucenia przed ponowną próbą.

Ile czasu na wysłanie faktury do KSeF rozwija zasady terminów w różnych trybach wystawiania.