Jak sprawdzić status faktury w przypadku awarii? - praktyczny przewodnik po KSeF, gdy system odmawia posłuszeństwa

Awaria KSeF - co się naprawdę dzieje z Twoją fakturą?

AITekst opracowany z wykorzystaniem sztucznej inteligencji. Zasady i ograniczenia

Status faktury w KSeF stanowi kluczowy element obrotu gospodarczego, determinujący moment wprowadzenia dokumentu do obrotu prawnego zgodnie z art. 106na ust. 1 ustawy o VAT. Awaria KSeF może wystąpić zarówno po stronie rządowej platformy teleinformatycznej, jak i lokalnie, po stronie infrastruktury informatycznej podatnika. Dane gromadzone w centralnym repozytorium charakteryzują się wysoką trwałością, gdyż KSeF przechowuje faktury przez okres 10 lat, co gwarantuje, że chwilowa niedostępność interfejsu nie powoduje utraty przesłanych danych. Statystyki techniczne wskazują, że awarie Profilu Zaufanego wykazują najwyższą intensywność w godzinach porannych, zazwyczaj między 9:30 a 11:00, co koreluje z momentem rozpoczęcia pracy przez działy księgowe.

Analiza incydentów z dnia 24 stycznia 2025 r. wykazała, że błędy logowania wzrosły o 24%, jednakże nie oznaczało to paraliżu całego systemu. Często mamy do czynienia z sytuacją, w której Aplikacja Podatnika wykazuje błędy modułu podglądu graficznego, podczas gdy silnik weryfikacji statusu dokumentów pozostaje w pełni operacyjny. W takim przypadku status można pobrać bez ponownej autoryzacji nawet 30 dni po wystawieniu faktury, o ile sesja interaktywna została prawidłowo zainicjowana przed wystąpieniem usterki. Należy pamiętać, że data wystawienia to data umieszczona na fakturze, a dla rozliczeń podatkowych kluczowa jest właśnie ona oraz data dostawy towarów lub wykonania usługi, a nie sam moment technicznego przetworzenia pliku XML przez serwer MF.

W obliczu problemów technicznych warto wstrzymać się z masowym odpytywaniem systemu w godzinach szczytu i przenieść aktywność na godziny 14:00-16:00, kiedy obciążenie infrastruktury gwałtownie spada. Zapisanie unikalnego numeru identyfikacyjnego KSeF pozwala na późniejszą, zautomatyzowaną weryfikację w dowolnym momencie, nawet gdy interfejs przeglądarkowy jest niedostępny. Afaktury inwestuje w najnowsze technologie zabezpieczeń i zapewnia integrację z KSeF, co pozwala na stabilne operowanie dokumentami nawet w okresach zwiększonej niestabilności rządowych węzłów komunikacyjnych.

• Profil Zaufany - statystyczna dostępność na poziomie 97%, jednak w okresach spiętrzeń czas odpowiedzi serwera przekracza 15 s.
• API KSeF - charakteryzuje się brakiem timeout'ów przy niskim obciążeniu, lecz przy awariach liczba błędów typu 422 (Unprocessable Entity) wykazuje tendencję wzrostową.
• Aplikacja Podatnika - najczęstsze usterki dotyczą warstwy prezentacji danych (Frontend), co nie wpływa na integralność warstwy bazodanowej faktur.

4 alternatywne drogi sprawdzenia statusu, gdy główna brama nie działa

Moduł Centralnego Uwierzytelniania (MCU) to centralne narzędzie w Krajowym Systemie e-Faktur (KSeF) 2.0, które zostało zaprojektowane jako niezależny węzeł dostępowy. Od 1 listopada 2025 r. system ten jest dostępny dla testów, a od 1 lutego 2026 r. staje się obowiązkowy dla największych przedsiębiorstw, których próg sprzedaży przekroczył 200 mln zł. Centralne Repozytorium Certyfikatów Ministerstwa Finansów, dostępne pod adresem ksef.podatki.gov.pl/mcu, pozwala na zarządzanie uprawnieniami i certyfikatami KSeF nawet w sytuacjach, gdy standardowe logowanie przez Profil Zaufany jest niemożliwe. MCU działa na osobnym VLAN-ie, co separuje ruch uwierzytelniający od ogólnodostępnych usług administracji publicznej.

Wykorzystanie certyfikatów KSeF jest szczególnie uzasadnione przy potrzebie automatyzacji procesów. Certyfikat KSeF to elektroniczny klucz dostępu, który jednoznacznie identyfikuje podatnika w systemie. W przeciwieństwie do uprawnień, które definiują zakres dozwolonych czynności, certyfikat stanowi cyfrową pieczęć przypisaną do NIP podmiotu. Dzięki niemu integracja z oprogramowaniem zewnętrznym, takim jak serwis Afaktury, pozwala na pobieranie statusów dokumentów z pominięciem interfejsu graficznego MF. API KSeF umożliwia realizację do 1000 zapytań na minutę z jednego adresu IP, co zapewnia wysoką przepustowość dla procesów weryfikacyjnych.

1. Zaloguj się do MCU wykorzystując e-dowód lub podpis kwalifikowany, co pozwala ominąć przeciążone serwery Profilu Zaufanego.
2. Wybierz funkcję "Status dokumentu" i wprowadź numer KSeF faktury w celu pobrania aktualnych danych o procesowaniu.
3. Pobierz dokument PDF z naniesioną pieczęcią czasową, który stanowi formalny dowód statusu faktury w przypadku ewentualnego sporu z organami skarbowymi.

Zgodnie z art. 12 ustawy o KSeF, system wyróżnia pięć metod uwierzytelnienia, w tym wykorzystanie tokenów uwierzytelniających. Użycie tokena w nagłówku zapytania HTTP (np. X-Client-Id) pozwala na bezpośrednią komunikację z serwerem. W przypadku całkowitej awarii systemów informatycznych, podatnicy mogą skorzystać z infolinii Krajowej Administracji Skarbowej pod numerem 22 330 0 330, gdzie średni czas oczekiwania na połączenie wynosi około 4 minuty.

Scenariusz awaryjny krok po kroku - checklista dla księgowego

Rozpoznanie zakresu problemu technicznego jest pierwszym etapem procedury awaryjnej. Weryfikacja dostępności powinna zacząć się od monitoringu kanałów informacyjnych Ministerstwa Finansów, w tym profilu na platformie X oraz portalu status.podatki.gov.pl. Wysłanie kontrolnego zapytania (ping) na adres api.ksef.gov.pl pozwala szybko ustalić, czy problem leży w łączności sieciowej, czy w warstwie autoryzacji. W sytuacji, gdy API zwraca błędy z rodziny 5xx (Server Error), konieczne jest przejście do trybu pracy z wykorzystaniem MCU lub wdrożenie procedury offline przewidzianej w przepisach prawa podatkowego.

Zgodnie z art. 106gb ust. 4 ustawy o VAT, w przypadku awarii KSeF potwierdzonej komunikatem w Biuletynie Informacji Publicznej (BIP), podatnik wystawia faktury w formacie zgodnym z KSeF (XML), ale przekazuje je nabywcy w sposób uzgodniony (np. PDF lub wydruk). Taka faktura musi zawierać Kod QR z oznaczaniem "OFFLINE". Po przywróceniu sprawności systemu, podatnik ma 7 dni roboczych na przesłanie wszystkich dokumentów do bazy centralnej. Jeśli przerwa techniczna nie jest ogłoszona jako oficjalna awaria w BIP (np. prace serwisowe), termin na dosyłkę faktur ulega skróceniu do 1 dnia roboczego od momentu ustania utrudnień.

• Sprawdź, czy problem dotyczy wyłącznie Profilu Zaufanego - jeśli tak, zaloguj się przy użyciu e-dowodu lub podpisu kwalifikowanego.
• Zweryfikuj kody odpowiedzi API - błąd 5xx sugeruje przejście na MCU, natomiast błąd 401 oznacza problemy z tokenem uwierzytelniającym.
• Skontroluj logi aktywności - jeśli numer KSeF nie widnieje w rejestrze po stronie serwisu Afaktury lub MCU, bezzwłocznie skontaktuj się z infolinią KAS.

Zabezpieczenie materiału dowodowego w postaci zrzutów ekranu z kodem błędu ułatwia proces ewentualnej reklamacji lub wyjaśnień przed organami kontrolnymi. Średni czas przywrócenia pełnej funkcjonalności systemu w 2024 r. wynosił 2 godziny i 38 minut, a komunikaty o awariach były publikowane średnio po 17 minutach od wystąpienia pierwszych symptomów. Zaleca się regularne śledzenie komunikatów, ponieważ w przypadku wystąpienia kolejnej awarii w trakcie biegu terminu 7 dni, czas na przesłanie dokumentów liczy się od nowa, od zakończenia ostatniej przerwy.

Jak zapobiec paraliżowi w przyszłości - 3 rzeczy, które warto wdrożyć jeszcze dziś

Minimalizacja ryzyka braku dostępu do statusu faktur wymaga wdrożenia redundancji w zakresie metod uwierzytelniania. Posiadanie podwójnej pary kluczy - podpisu kwalifikowanego (koszt ok. 119 zł netto/rok) oraz pieczęci kwalifikowanej (ok. 89 zł netto/rok) - zapewnia ciągłość pracy nawet w przypadku awarii jednego z dostawców usług zaufania. Moduł MCU pozwala na jednoczesną aktywność do 3 certyfikatów, co umożliwia rozdzielenie uprawnień pomiędzy logowanie awaryjne a masowe operacje wykonywane przez API. Warto podkreślić, że certyfikat zapasowy aktywuje się w panelu MCU w czasie zaledwie 4 minut.

Skutecznym rozwiązaniem jest również wdrożenie lokalnego monitoringu SLA (Service Level Agreement). Prosty skrypt automatyzujący odpytywanie bramki MF może powiadomić dział księgowości o problemach zanim zostaną one oficjalnie potwierdzone. Przechowywanie lokalnej kopii plików XML jest kluczowe, gdyż pojedynczy dokument zajmuje średnio jedynie 4 kB, co pozwala na archiwizację 250 tysięcy faktur na 1 GB powierzchni dyskowej. Zapewnia to możliwość natychmiastowego odtworzenia procesów po ustąpieniu awarii.

• Wykorzystaj jeden klucz na fizycznym tokenie USB do ręcznego logowania przez administratora w sytuacjach krytycznych.
• Drugi certyfikat zaimplementuj w module HSM (Hardware Security Module) w chmurze, co umożliwi Afaktury bezobsługowe pobieranie statusów dla tysięcy dokumentów.
• Regularnie testuj procedurę logowania awaryjnego raz w miesiącu, aby uniknąć błędów konfiguracyjnych w okresach spiętrzeń rozliczeniowych.

"Użytkownicy, którzy wygenerowali certyfikaty i zintegrowali KSeF z komercyjnym oprogramowaniem, nie mają problemów z ciągłością operacyjną" - podkreśla ekspertka Zofia Derkowska.

Wdrożenie lokalnej kopii XML w chmurze z funkcją wersjonowania plików pozwala na przywrócenie poprawnej wersji dokumentu w przypadku błędu synchronizacji w ciągu 30 sekund. Serwis Afaktury oferuje ponad 25 rodzajów dokumentów i umożliwia darmowe testowanie integracji z KSeF, co stanowi optymalny poligon doświadczalny dla firm przygotowujących się do obowiązkowego wdrożenia systemu, które dla najmniejszych podmiotów (próg 10 tys. zł miesięcznie) nastąpi 1 stycznia 2027 r.