Latarnia KSeF – jak automatycznie sprawdzać status systemu
18 lutego 2026
Ministerstwo Finansów uruchomiło publiczne API o nazwie Latarnia KSeF. Pokazuje w czasie rzeczywistym, czy system działa, czy ma przerwę techniczną, czy się zepsuł.
Czym jest Latarnia KSeF?
Latarnia to publiczne API uruchomione przez Ministerstwo Finansów. Pokazuje w czasie rzeczywistym trzy rzeczy:
- Planowane przerwy techniczne – konserwacja systemu zapowiedziana z wyprzedzeniem
- Zwykłe awarie – nieplanowane problemy z KSeF
- Totalne awarie – gdy padnie nawet strona Ministerstwa Finansów
API jest dostępne bez autoryzacji, więc każdy system może automatycznie sprawdzać, czy KSeF działa. Można je znaleźć pod adresem https://www.gov.pl/web/kas/api-krajowego-system-e-faktur
Jak to działa?
Latarnia przez cały czas monitoruje KSeF i publikuje informacje o jego statusie. Działa jak tablica ogłoszeń – gdy coś się dzieje z systemem, Latarnia od razu to pokazuje.
Cel jest prosty: żebyś nie musiał zgadywać, czy KSeF działa. Zamiast sprawdzać ręcznie na stronie Ministerstwa, możesz zajrzeć do Latarni (albo Twój program księgowy może to zrobić za Ciebie). Dostaniesz jasną odpowiedź: działa, ma przerwę, czy jest awaria.
Gdy jest problem, Latarnia pokazuje szczegóły: od której godziny, jakiego typu, kiedy się skończy (jeśli to wiadomo). Wszystko w jednym miejscu, zawsze aktualne.
Rodzaje zdarzeń w Latarni
System rozróżnia trzy typy problemów.
MAINTENANCE – planowana przerwa
Ministerstwo ogłasza z wyprzedzeniem. Komunikat zawiera datę i godzinę rozpoczęcia oraz zakończenia. Zwykle przerwy są nocą lub w weekendy.
FAILURE – awaria
Nieplanowany problem. System wysyła dwa komunikaty: FAILURE_START gdy awaria się zaczyna i FAILURE_END gdy zostaje naprawiona. Na początku nikt nie wie, ile to potrwa, dlatego zakończenie jest ogłaszane osobno.
TOTAL_FAILURE – awaria całkowita
Przestaje działać KSeF i strona Ministerstwa. Informacje są wtedy przekazywane przez telewizję, radio, portale informacyjne.
Dla kogo to jest?
Programiści mogą dodać obsługę Latarni do swoich systemów. API jest publiczne, nie wymaga autoryzacji. Integracja zajmuje kilka godzin. Klienci dostaną automatyczne powiadomienia o problemach z KSeF.
Użytkownicy wybierający program do fakturowania mogą sprawdzić, czy obsługuje Latarnię. Takie programy same informują o awariach. Nie ma ręcznego sprawdzania statusu.
Co dalej?
Jeśli używasz programu księgowego, sprawdź, czy obsługuje Latarnię.
Więcej informacji znajdziesz w dokumentacji na github.com/CIRFMF/ksef-latarnia.
