Jak mierzymy status KSeF

Ostatnia aktualizacja: 17 kwietnia 2026

Status KSeF to narzędzie decyzyjne - przedsiębiorca sprawdza tu czy może wystawić fakturę online, czy lepiej zrobić to w trybie offline. Dlatego każdy pomiar musi być powtarzalny, udokumentowany i weryfikowalny. Poniżej dokładnie opisujemy co, skąd i jak zbieramy.

Podstawowe parametry pomiaru

Częstotliwość

co 60 sekund

pomiar przy każdej wizycie, minimum co 2 minuty

Źródła danych

5 kanałów

Latarnia MF + 3 środowiska KSeF + Profil Zaufany

Lokalizacja pomiaru

Warszawa

polski serwer, infrastruktura BinSoft

Historia

30 dni

pełna retencja, incydenty bezterminowo

Źródła danych - co dokładnie odpytujemy

Każdy pomiar to seria zapytań do 5 oficjalnych endpointów Ministerstwa Finansów i systemów powiązanych. Nie zgadujemy - bierzemy dane bezpośrednio ze źródła.

Źródło	Endpoint	Co sprawdzamy
Latarnia KSeF	`api-latarnia.ksef.mf.gov.pl`	Oficjalny status prawny (AVAILABLE / MAINTENANCE / FAILURE)
KSeF Produkcja	`api.ksef.mf.gov.pl`	Health check, wersja API, czas odpowiedzi
KSeF Test	`api-test.ksef.mf.gov.pl`	Health check środowiska testowego (API v2)
KSeF Demo	`api-demo.ksef.mf.gov.pl`	Health check środowiska demonstracyjnego
Profil Zaufany	`login.gov.pl`	Dostępność logowania (wpływa na możliwość autoryzacji)

Dodatkowo raz na 24 godziny weryfikujemy infrastrukturę: certyfikat SSL, wersję TLS, informacje o CDN i wersję specyfikacji OpenAPI. To pozwala wykryć problemy zanim ktoś na nie trafi.

Co oznacza każdy status

Używamy 4 stanów. Każdy ma dokładne kryterium - nie ma subiektywnej oceny.

KSeF działa prawidłowo

Latarnia zwraca AVAILABLE, wszystkie 3 środowiska KSeF odpowiadają status: Healthy.

Wykryto problemy

Latarnia AVAILABLE, ale co najmniej jedno środowisko odpowiada wolno (HTTP 400-499) lub niepoprawnie.

Awaria systemu

Latarnia FAILURE lub TOTAL_FAILURE, lub środowiska zwracają HTTP 5xx / brak odpowiedzi.

Przerwa techniczna

Latarnia zwraca MAINTENANCE - zaplanowane prace serwisowe KSeF.

Jak działa mechanizm odświeżania

Dane są odświeżane automatycznie - nie wymagamy od klientów akcji. Mechanizm:

Odpowiedź natychmiast - gdy ktoś odwiedza stronę, dostaje ostatnie dane z cache (poniżej 1 ms).
Background refresh - jeśli dane są starsze niż 2 minuty, serwer w tle (po zamknięciu połączenia z klientem) odpytuje wszystkie 5 źródeł i aktualizuje cache.
Historia - co 60 sekund tworzony jest wpis historyczny z metrykami każdego środowiska (status, czas odpowiedzi).

To oznacza, że dane są świeże dla każdego, kto odwiedza serwis, a pierwszy użytkownik nigdy nie czeka na pomiar - dostaje dane z poprzedniego cyklu, a jego wizyta zleca nowy pomiar w tle.

Niezależność pomiaru

Nie jesteśmy Ministerstwem Finansów ani organem państwowym. Jesteśmy niezależnym monitorem budowanym przez polską firmę BinSoft Sp. z o.o. - twórcę systemów fakturowania zgodnych z KSeF.

Nasza niezależność oznacza że:

Dane zbieramy z oficjalnych endpointów MF - nikt ich nie filtruje ani nie modyfikuje
Nie mamy wpływu na to co zwraca Latarnia KSeF
Nie pomijamy incydentów - każda awaria jest widoczna w historii
Nie ukrywamy wolniejszych odpowiedzi - każdy pomiar trafia do statystyk

Nasz uptime - monitorujemy też siebie

Jeśli monitorujemy KSeF, to wypadałoby być dostępnym. Poniżej nasze własne parametry:

Hosting

Polski serwer

Warszawa, TLS 1.2/1.3

Odpowiedź API

< 100 ms

średnio z cache (typowo 17 ms)

HTTPS / TLS

TLS 1.2/1.3

Let's Encrypt, odnowienie automatyczne

Dostępność

99.9%

cel - mierzymy od uruchomienia

Status-ksef.net działa na stronie statycznej (HTML + CSS + JS), bez bazy danych. Dzięki temu strona ładuje się błyskawicznie i nie ma krytycznych punktów awarii. API monitoringu ma cache z fallbackiem - nawet gdy serwery MF mają problem, serwujemy ostatnie znane dane z flagą stale. Infrastruktura w Polsce, zgodność z RODO.

Zapisywanie i przechowywanie danych

Każdy pomiar zostawia ślad w historii. Przechowujemy:

Pełna historia 30 dni - każdy pomiar (co 60s), status i czas odpowiedzi każdego środowiska
Agregacje godzinowe (168 godzin) - uptime %, średni ping, najgorszy status w oknie godzinnym
Incydenty (bez limitu czasu) - każde zdarzenie ze statusem innym niż "OK", ze startem, końcem i czasem trwania
Statystyki miesięczne - uptime %, liczba incydentów, łączny czas niedostępności

Dane historyczne są publicznie dostępne przez API w formacie JSON: https://bs-studio.pl/api/ksef-status/. Każdy może je pobrać i zweryfikować.

Limit rekomendowanej częstotliwości: API ma limit 120 zapytań na minutę z jednego IP. To wystarcza do normalnego korzystania. Jeśli potrzebujesz integracji - użyj naszego badge który aktualizuje się automatycznie.

Co NIE monitorujemy

Transparentnie - są rzeczy, których nie sprawdzamy:

Poprawność wystawianych faktur - to zadanie programu księgowego, nie monitora
Status konkretnych dokumentów - nie mamy dostępu do danych podatnika
Jakość odpowiedzi KSeF merytorycznie - jeśli API odpowiada HTTP 200, liczymy to jako sprawne
Kolejki przetwarzania wewnątrz MF - nie mamy dostępu do metryk wewnętrznych

Co zrobić jeśli nasze dane różnią się od Ministerstwa Finansów

Oficjalne źródło to zawsze Ministerstwo Finansów. Jeśli widzisz różnicę między naszym statusem a komunikatem MF, zaufaj MF. Nasze dane mogą być opóźnione o 2 minuty (cache + odświeżanie). Do ważnych decyzji biznesowych sprawdzaj bezpośrednio ksef.podatki.gov.pl.

Kontakt i pytania

Jeśli zauważysz że nasze dane są błędne, że jakiś pomiar nie ma sensu, albo masz pomysł na ulepszenie monitoringu - napisz przez formularz kontaktowy. Poprawimy.

Zobacz również: Regulamin · Polityka Prywatności · Badge do wklejenia