Latarnia, czyli publiczne API Ministerstwa Finansów do ogłaszania przerw i awarii KSeF, nie pokazała utrudnień w pobieraniu faktur zapowiedzianych na noc z 16 na 17 października, więc program księgowy, który sprawdza tylko ją, nie dostał żadnego ostrzeżenia. Brak wpisu użytkownicy zgłosili 14 października w repozytorium Latarni na GitHubie, prowadzonym przez CIRF, to samo konto, z którego ministerstwo publikuje dokumentację API KSeF. Do soboty 17 października, godz. 11, nikt z ministerstwa tam nie odpowiedział. Dla firmy ważniejsze jest to, że prawo do trybu awaryjnego i 7 dni roboczych na wysłanie faktury daje dopiero komunikat MF, że trwa awaria KSeF, a takiego komunikatu tej nocy nie było.
Latarnia KSeF nie pokazała utrudnień z 16 i 17 października
Ministerstwo zapowiedziało je 13 października w komunikacie technicznym na ksef.podatki.gov.pl i w komunikacie KAS nr 179 na gov.pl. Treść jest taka sama: od 16 października od 22:00 do 17 października do 3:00 “mogą występować przejściowe utrudnienia w działaniu API KSeF 2.0 w zakresie pobierania faktur”. Kłopot mógł dotyczyć wyświetlania list faktur i pobierania ich w programach połączonych z KSeF. MF zapewniło, że “proces wysyłki faktur będzie działać prawidłowo i bez zakłóceń”. Okno KSeF było jednym z kilku w tamten weekend, które zebraliśmy w zestawieniu przerw w e-usługach od 16 do 19 października.
Dzień później w repozytorium Latarni pojawiło się zgłoszenie nr 38: “Dlaczego w Latarni nie ma informacji o planowanym niedziałaniu!?”. W komentarzach jeden z użytkowników odpisał, że skoro wysyłka działa, firmy dotrzymają terminów i nie muszą przechodzić na tryb offline. Inny zauważył, że ustawa nie przewiduje stanu “utrudnienia”. Autor zgłoszenia odpowiedział, że nie da się wtedy pobrać faktury ani skutecznie przekazać jej nabywcy, i zaproponował osobny typ komunikatu. 15 października sprawę opisał portal pit.pl, cytując Dawida Najgiebauera, programistę systemu ERP: “Latarnia nie monitoruje dostępności API KSeF przez użytkowników, a jedynie działanie samych serwerów API KSeF”.
Latarnię odpytaliśmy sami 17 października o 11:03. Status brzmiał AVAILABLE, a lista komunikatów była pusta. Według dokumentacji API komunikaty o awariach i przerwach są widoczne jeszcze 30 dni po zakończeniu. Jeśli API działa zgodnie z tym opisem, przez ostatni miesiąc Latarnia nie podała żadnego komunikatu. Nie wiemy natomiast, czy zapowiedziane utrudnienia w ogóle wystąpiły i ile trwały. Do publikacji nie znaleźliśmy też nowego komunikatu MF ani odpowiedzi ministerstwa w zgłoszeniu.
Czym jest Latarnia KSeF i czego nie pokaże
Latarnia KSeF to bezpłatne API Ministerstwa Finansów, które podaje programom aktualny status KSeF i komunikaty o planowanych przerwach oraz awariach. Według opisu w repozytorium MF służy “do publikowania ustrukturyzowanej informacji na temat planowanych niedostępności oraz zaistniałych awarii KSeF zgodnie z art. 106ne” ustawy o VAT. Nie wymaga logowania. Jej adresy ministerstwo podaje na stronie KAS o API KSeF, obok adresów samego systemu.
Latarnia zna cztery stany: pełną dostępność, planowaną niedostępność, awarię i awarię całkowitą. Kategorii “utrudnienia” w niej nie ma. Komunikat z 13 października nie miał więc w Latarni swojego typu, bo MF nie zapowiedziało ani przerwy, ani awarii. Podobnie było 25 września: komunikatu KAS nr 178 o utrudnieniach w Aplikacji Podatnika KSeF 2.0 też w Latarni nie było, co użytkownicy zgłosili w wątku nr 37.
Do tego sama Latarnia bywała niedostępna. Według zgłoszeń użytkowników 3 marca zwracała błąd 504, 10 kwietnia przez kilka godzin błąd 502, a 2 czerwca część programów dostawała odmowę z systemu zabezpieczeń. Gdy odpowiada prawidłowo, Latarnia informuje o zdarzeniach ogłoszonych przez MF na podstawie ustawy, a to, czy KSeF działa w twoim programie, widać dopiero w samym programie.
Czy KSeF działa? Jak sprawdzić awarię KSeF dzisiaj
Status KSeF sprawdzisz w trzech oficjalnych miejscach, a przy kłopotach z logowaniem dochodzi czwarte:
- Otwórz w przeglądarce adres
https://api-latarnia.ksef.mf.gov.pl/status. Odpowiedź{"status":"AVAILABLE"}oznacza, że MF nie ogłosiło teraz ani przerwy, ani awarii. Wiele programów do faktur pokazuje ten sam status u siebie. - Przejrzyj listę komunikatów technicznych na ksef.podatki.gov.pl. Tu MF pisze także o utrudnieniach, których Latarnia nie zna.
- Sprawdź listę komunikatów KAS na gov.pl. Tam trafił komunikat nr 179 o nocy z 16 na 17 października.
- Jeśli nie możesz się zalogować profilem zaufanym, poszukaj komunikatu o samym profilu zaufanym. To osobna usługa: w maju KAS ogłaszała planowaną przerwę, utrudnienia i przywrócenie dostępu do niego w komunikatach nr 173–175.
Jeśli żadne z tych miejsc nic nie podaje, a KSeF nie działa tylko u ciebie, zacznij od własnego łącza i programu, a potem od dostawcy oprogramowania. W sieci działają też nieoficjalne strony z monitoringiem KSeF. Mogą podpowiedzieć, czy problem mają inni, ale prawa do trybu awaryjnego nie dają.
Od 1 stycznia 2027 roku status KSeF będzie sprawdzać więcej firm. Znika limit 10 tys. zł, dzięki któremu część jednoosobowych firm wystawia jeszcze faktury poza systemem, a paragon z NIP przestaje być fakturą.
Agenci AI · Kodożercy
Twoje przepływy w n8n mogą podejmować decyzje
Kurs Agenci AI od Kodożerców pokazuje, jak dołożyć do n8n warstwę, która czyta dokumenty, dobiera kolejny krok i pyta o zgodę, zanim zrobi coś nieodwracalnego. Budujesz to na własnych integracjach, moduł po module.
Sprawdź, jak to zbudować →
Awaria KSeF, niedostępność i awaria całkowita w ustawie o VAT
Ustawa o VAT zna trzy zdarzenia, które zmieniają zasady wystawiania faktur, i każde zaczyna się od komunikatu ministra finansów. Według art. 106ne ust. 1 to komunikaty o wystąpieniu i zakończeniu awarii “wyznaczają okres trwania tej awarii”. Minister publikuje je w Biuletynie Informacji Publicznej i przez oprogramowanie interfejsowe. Z przepisu wynika, że bez takiego komunikatu nie ma awarii w rozumieniu ustawy, nawet gdy system działa wolno, a program zgłasza błędy.
| Zdarzenie | Przepis | Kto ogłasza i gdzie | Co robi firma | Termin wysłania do KSeF |
|---|---|---|---|---|
| Planowana niedostępność (przerwa serwisowa) | art. 106ne ust. 4, art. 106nh | minister finansów w BIP; w Latarni jako MAINTENANCE | wystawia faktury elektroniczne według wzoru FA(3) w trybie offline | najpóźniej następnego dnia roboczego po końcu przerwy |
| Awaria KSeF | art. 106ne ust. 1, art. 106nf | minister finansów w BIP i w oprogramowaniu interfejsowym; w Latarni FAILURE | wystawia faktury elektroniczne według wzoru FA(3) w trybie awaryjnym, nabywcy przekazuje je w uzgodniony sposób | 7 dni roboczych od dnia zakończenia awarii wskazanego w komunikacie |
| Awaria całkowita | art. 106ne ust. 3, art. 106ng | minister finansów w telewizji, radiu, prasie i internecie, gdy nie da się opublikować komunikatu w BIP; w Latarni TOTAL_FAILURE | wystawia faktury papierowe albo elektroniczne, bez obowiązku wzoru | nie wysyła ich do KSeF |
Awaria całkowita to według MF sytuacja nadzwyczajna, na przykład zagrożenie kraju albo jego infrastruktury. Ustawa przewiduje ten tryb na sytuację, w której minister nie może zamieścić komunikatu o awarii w BIP, i daje na nią najprostsze zasady.
Tryb awaryjny KSeF: 7 dni roboczych od końca awarii
Tryb awaryjny stosujesz tylko w czasie awarii ogłoszonej przez MF. Na stronie o trybie awaryjnym ministerstwo wymienia, co wtedy robi podatnik:
- stosuje obowiązujący wzór struktury logicznej, od 1 lutego 2026 roku FA(3),
- wystawia fakturę w postaci elektronicznej,
- przesyła ją do KSeF nie później niż w ciągu 7 dni roboczych od dnia zakończenia awarii, żeby dostała numer KSeF,
- udostępnia ją nabywcy w uzgodniony sposób.
Jeśli w tych 7 dniach MF ogłosi kolejną awarię, termin liczy się od końca tej następnej. Jeśli w trakcie ogłosi awarię całkowitą, faktur do KSeF się nie dosyła. Fakturę przekazaną nabywcy przed wysłaniem do systemu oznacza się dwoma kodami QR, z napisami “OFFLINE” i “CERTYFIKAT”. Do drugiego kodu potrzebny jest certyfikat KSeF typu 2, więc pobierz go, zanim zdarzy się awaria.
Jak policzyć 7 dni roboczych
Ustawa o VAT nie definiuje dnia roboczego. W przykładzie liczymy dni od poniedziałku do piątku bez świąt ustawowych. Dnia, w którym awaria się skończyła, nie wliczamy, bo tak każe art. 12 § 1 Ordynacji podatkowej. Jeśli komunikat MF poda koniec awarii w piątek 6 listopada 2026 roku, pierwszym dniem terminu jest poniedziałek 9 listopada. Środa 11 listopada to święto, więc siódmym dniem roboczym jest środa 18 listopada. Przy terminie na styku ze świętem bezpieczniej wysłać faktury dzień wcześniej.
Utrudnienia w KSeF bez komunikatu o awarii: co z fakturą
Gdy MF pisze o utrudnieniach, ale nie ogłasza awarii, obowiązują zwykłe zasady i trybu awaryjnego nie ma. Tak było w nocy z 16 na 17 października. MF zapowiadało kłopoty z pobieraniem faktur i zapewniało, że wysyłka będzie działać, choć nie wiemy, czy każda faktura dostała wtedy numer bez opóźnień. Gdy system nadał numer, nabywca z NIP otrzymał fakturę w dniu jego nadania, nawet jeśli jego program pobrał ją dopiero rano. Tak stanowi art. 106na ust. 3 ustawy o VAT.
Inaczej jest, gdy to ty nie możesz wysłać faktury, na przykład przez awarię łącza. Wtedy możesz wystawić ją w trybie offline24. Według MF może z niego skorzystać każdy podatnik i nie potrzeba żadnego komunikatu. Termin jest jednak krótki: fakturę trzeba wysłać do KSeF najpóźniej następnego dnia roboczego po jej wystawieniu. Offline24 nie daje 7 dni. Te przysługują dopiero wtedy, gdy przed wysłaniem faktury MF ogłosi awarię.
Jak automatycznie sprawdzać status KSeF przez API Latarni
Programista może odpytywać Latarnię bez klucza i bez logowania. Ma dwa adresy: /status zwraca jeden bieżący stan, a /messages listę komunikatów, także zapowiedzi przerw.
Przykład w curl
Sprawdzenie z wiersza poleceń, wynik z 17 października 2026 roku, godz. 11:03:
curl -s https://api-latarnia.ksef.mf.gov.pl/status
{"status":"AVAILABLE"}
curl -s https://api-latarnia.ksef.mf.gov.pl/messages
[]
Pole status przyjmuje wartości AVAILABLE, MAINTENANCE, FAILURE albo TOTAL_FAILURE. Gdy trwają dwa zdarzenia naraz, wygrywa poważniejsze: awaria całkowita przed zwykłą, a zwykła przed przerwą. Pola start i end w komunikatach podają czas UTC, a treść komunikatu godzinę polską. Przy trwającej awarii pola end nie ma.
Trzy rzeczy warto zaprogramować od razu. Błąd 403, 502 albo 504 z Latarni traktuj jako brak informacji o stanie KSeF, bo takie błędy zdarzały się przy działającym systemie. Środowisko testowe api-latarnia-test.ksef.mf.gov.pl zwraca na stałe przykładowe komunikaty ze stycznia, 17 października ze statusem TOTAL_FAILURE. Nadaje się do sprawdzenia, czy alarm działa, ale nigdy do produkcji. Seria błędów przy pobieraniu faktur z API KSeF to sygnał wart osobnego alarmu, nawet gdy Latarnia milczy.
Prosty przepływ w n8n
W n8n wystarczą trzy węzły i jedno ustawienie obsługi błędów:
- Schedule Trigger z interwałem w minutach. W polu “Minutes Between Triggers” wpisz na przykład 10.
- HTTP Request z metodą GET na adres
https://api-latarnia.ksef.mf.gov.pl/status. W jego ustawieniach w polu “On Error” wybierz “Continue (using error output)” i podłącz to wyjście do tego samego alarmu. Bez tego błąd samej Latarni zatrzyma przepływ i nikt się o nim nie dowie. - If z warunkiem: pole
status“is not equal to”AVAILABLE. Do gałęzi “true” podłącz wysyłkę maila albo wiadomości na komunikator.
Przepływ trzeba zapisać i opublikować, inaczej harmonogram nie ruszy. Drugi taki przepływ może raz dziennie czytać /messages i ostrzegać o zapowiedzianych przerwach MAINTENANCE_ANNOUNCEMENT.
{ integracje systemów }Sklep, księgowość i CRM nie rozmawiają ze sobą?
Łączymy systemy, których używasz na co dzień, z KSeF, Allegro i BaseLinkerem, żeby dane przestały krążyć w arkuszach i mailach. Zaczynamy od połączenia, które dziś zabiera najwięcej czasu.
Najczęstsze pytania
Czy awaria profilu zaufanego to awaria KSeF?
Nie, dopóki MF nie ogłosi awarii KSeF. Profil zaufany to osobna usługa. Według podręcznika KSeF 2.0 ministerstwa do systemu można się uwierzytelnić także podpisem kwalifikowanym, pieczęcią kwalifikowaną (firmy), tokenem do końca 2026 roku albo certyfikatem KSeF. Certyfikat warto więc wygenerować wcześniej, póki logowanie działa.
Gdzie MF ogłasza awarię całkowitą KSeF?
W środkach społecznego przekazu: telewizji, radiu, prasie i internecie. Ta droga jest przewidziana na sytuację, w której ministerstwo nie może opublikować komunikatu w BIP. W Latarni taka awaria ma status TOTAL_FAILURE, ale ustawa wiąże skutek z komunikatem w mediach.
Czy można przejść na tryb awaryjny, gdy nie działa Latarnia?
Nie. Ustawa wiąże tryb awaryjny z komunikatem o awarii, a niedziałająca Latarnia takim komunikatem nie jest. Gdy Latarnia nie odpowiada, sprawdź komunikaty na ksef.podatki.gov.pl i na gov.pl. Jeśli nie ma tam ogłoszonej awarii, a nie możesz wysłać faktury, możesz skorzystać z trybu offline24.
Podsumowanie
Ustawowa awaria KSeF zaczyna się i kończy komunikatem ministra finansów w BIP, a Latarnia to jedno z miejsc, gdzie ten komunikat ma się pojawić. W nocy z 16 na 17 października MF zapowiedziało tylko utrudnienia w pobieraniu faktur. Latarnia ich nie pokazała, bo nie ma takiej kategorii, a wysyłka według zapowiedzi ministerstwa miała działać. Status sprawdzaj więc w trzech miejscach: w Latarni, w komunikatach technicznych na ksef.podatki.gov.pl i w komunikatach KAS na gov.pl. Tryb awaryjny daje 7 dni roboczych od końca awarii wskazanego w komunikacie. Z trybu offline24 można skorzystać bez komunikatu MF, ale fakturę trzeba wtedy wysłać najpóźniej następnego dnia roboczego. Programista może odpytywać /status co kilka minut, pamiętając, że błąd samej Latarni nie jest awarią KSeF. Do 17 października ministerstwo nie odpowiedziało na pytanie o brak wpisu w Latarni.
Newsletter · DevstockAcademy & Kodożercy
Bądź na bieżąco ze światem IT, AI i automatyzacji
Co wtorek: newsy z branży, praktyczne tipy i narzędzia które warto znać. Zero spamu.
