Krajowy System e-Faktur (KSeF) to centralny system informatyczny Ministerstwa Finansów służący do wystawiania, przechowywania i udostępniania faktur ustrukturyzowanych. Obowiązek korzystania z KSeF wchodzi etapowo: od 1 lutego 2026 r. dla firm o sprzedaży powyżej 200 mln zł, od 1 kwietnia 2026 r. dla pozostałych podatników VAT.

Gdy Ministerstwo Finansów ogłosi awarię KSeF, możesz wystawiać faktury w trybie awaryjnym (art. 106nf ustawy o VAT) — poza systemem, w formie elektronicznej. Po zakończeniu awarii masz 7 dni roboczych na przesłanie tych faktur do KSeF. Informacje o awariach publikowane są w BIP Ministerstwa Finansów.

Ustawa przewiduje kilka trybów: (1) Tryb awaryjny (art. 106nf) — awaria KSeF ogłoszona przez MF, masz 7 dni roboczych na dosłanie faktur. (2) Tryb offline24 (art. 106nda) — brak internetu po Twojej stronie, musisz dosłać faktury najpóźniej następnego dnia roboczego. (3) Niedostępność (art. 106nh) — planowane prace serwisowe, dosłanie następnego dnia roboczego. (4) Awaria całkowita (art. 106ng) — faktur nie trzeba dosyłać do KSeF wcale.

Tryb offline24 (art. 106nda) dotyczy sytuacji, gdy to Ty nie masz dostępu do internetu — np. awaria sieci po Twojej stronie. Możesz wtedy wystawić fakturę elektroniczną poza KSeF, ale musisz ją przesłać do systemu najpóźniej następnego dnia roboczego. To nie to samo co tryb awaryjny, który dotyczy awarii samego KSeF.

Status jest sprawdzany co 30 sekund po stronie serwera. Dashboard odświeża dane co 60 sekund. Korzystamy również z oficjalnego API Latarnia Ministerstwa Finansów.

Sprawny (zielony) — system działa prawidłowo, czas odpowiedzi poniżej 2s. Problemy (żółty) — system odpowiada, ale z opóźnieniami lub portal jest niedostępny. Awaria (czerwony) — brak odpowiedzi lub błędy serwera. Przerwa techniczna (niebieski) — planowana przerwa zgłoszona przez MF.

Dane pochodzą z dwóch źródeł: (1) Oficjalne API Latarnia udostępniane przez Ministerstwo Finansów — dostarcza komunikaty o incydentach i przerwach technicznych. (2) Własne sprawdzenia HTTP — co 30 sekund sprawdzamy dostępność i czas odpowiedzi każdego endpointa KSeF.

API Latarnia to oficjalny endpoint statusu udostępniany przez Ministerstwo Finansów. Dostarcza informacje o stanie systemu KSeF oraz komunikaty o incydentach i przerwach technicznych.

Profil Zaufany (login.gov.pl) to rządowy system uwierzytelniania, który jest wymagany do logowania w KSeF. Nawet jeśli sam KSeF działa prawidłowo, awaria Profilu Zaufanego uniemożliwia zalogowanie się do systemu. Dlatego monitorujemy oba serwisy — KSeF i Profil Zaufany — aby dać pełny obraz dostępności.

Tak! Użyj endpointu /api/widget?env=prod w tagu iframe. Możesz również użyć badge SVG: /api/badge/prod. Dostępny jest także feed RSS pod /api/rss.