Awaria KSeF - co się dzieje z fakturą w kolejce?
Tekst opracowany z wykorzystaniem sztucznej inteligencji. Zasady i ograniczenia
Proces przesyłania dokumentów do Krajowego Systemu e-Faktur opiera się na asynchronicznym modelu komunikacji przez KSeF API 2.0. W momencie wystąpienia problemów z połączeniem, najczęściej dochodzi do utraty tokena sesyjnego, co skutkuje przerwaniem procesu walidacji dokumentu XML. Jeżeli system księgowy ponowi próbę wysłania faktury bez weryfikacji jej statusu, Ministerstwo Finansów zwróci błąd 440 (duplikat faktury). Dzieje się tak, ponieważ infrastruktura centralna może zarejestrować dokument w buforze, nawet jeśli lokalna baza danych podatnika nie otrzymała jeszcze oficjalnego Urzędowego Poświadczenia Odbioru (UPO).
Powszechnym mitem w działach IT jest założenie, że ponowienie wysyłki („retry”) rozwiąże problem komunikacyjny. W rzeczywistości każda faktura ustrukturyzowana posiada unikalny odcisk palca (hash), a unikalność dokumentu jest sprawdzana w repozytorium przez okres 10 lat. Zgodnie z art. 106aa § 2 Ordynacji podatkowej, w przypadku wystąpienia błędów technicznych uniemożliwiających prawidłowe procesowanie, podatnik jest zobowiązany do weryfikacji statusu poprzez endpoint GET /api/v2/invoices/query przed podjęciem kolejnej próby transmisji. Pozwala to uniknąć błędnego raportowania dubli, które system centralny odrzuci automatycznie.
Stabilność operacyjna przedsiębiorstwa zależy od wdrożenia procedur reagowania dostosowanych do czasu trwania niedostępności systemu. Poniższa tabela przedstawia schemat działań w zależności od zdiagnozowanego objawu technicznego, uwzględniając brak sankcji karnych w okresie przejściowym do 20 lutego 2026 r.
| Czas niedostępności | Objaw techniczny | Pole API / Status | Działanie operacyjne |
|---|---|---|---|
| Do 15 minut | Przekroczenie limitu czasu (Timeout) | HTTP 408 / 504 | Monitorowanie kolejki wysyłkowej, wstrzymanie nowych sesji. |
| Do 2 godzin | Błąd autoryzacji / wygaśnięcie sesji | HTTP 401 / Brak tokena | Odświeżenie certyfikatu MCU, ponowna próba logowania do bramki. |
| Powyżej 24 godzin | Całkowita niedostępność KSeF | Błąd 503 / Tryb awaryjny | Uruchomienie trybu offline24, generowanie faktur z kodem QR. |
Warto podkreślić, że w sytuacjach krytycznych plik PDF nie stanowi e-faktury w rozumieniu przepisów obowiązujących od 1 lutego 2026 r. Dokumentem prawnym jest wyłącznie struktura XML zgodna ze schemą FA(3). Dlatego przedsiębiorstwa powinny wykorzystać okres przed pełnym wdrożeniem na przetestowanie trybu offline24, który umożliwia wystawienie faktury lokalnie i jej późniejsze dosłanie do systemu w ciągu 24 godzin od ustania awarii.
Informatyka śledcza w BCP - jak odzyskać utracone dane KSeF
W sytuacjach spornych lub po wystąpieniu krytycznej awarii infrastruktury IT, niezbędne jest przeprowadzenie procedur z zakresu informatyki śledczej (computer forensics). Głównym celem jest zabezpieczenie integralności danych i odtworzenie ścieżki audytu (audit trail KSeF). Scenariusz, w którym firma traci dane lokalne, inspektor kontroli skarbowej ma wątpliwości co do rzetelności ksiąg, a kontrahent żąda dowodu wystawienia dokumentu, wymaga przedstawienia twardych dowodów cyfrowych. Logi systemowe KSeF stanowią kluczowy dowód w postępowaniach gospodarczych, które w polskich sądach trwają średnio 2-3 lata.
Proces dowodowy opiera się na weryfikacji sum kontrolnych plików XML. Wykorzystanie algorytmu SHA-256 pozwala na jednoznaczne potwierdzenie, że treść faktury nie uległa zmianie od momentu jej wygenerowania. Przykładowy hash 5e884898da28047151d0e56f8dc6292773603d0d6aabbdd62a11ef721d1542d8 służy jako cyfrowy odcisk palca dokumentu, który musi być tożsamy w bazie podatnika oraz w repozytorium Ministerstwa Finansów.
Skuteczna analiza śledcza w ramach BCP wymaga dostępu do następujących źródeł danych:
- Lokalne pliki XML w formacie zgodnym ze strukturą FA(3) przed ich kompresją do pakietów transmisyjnych.
- Kopie zapasowe relacyjnej bazy danych MSSQL lub PostgreSQL zawierające metadane o czasie wysyłki.
- Logi aplikacji Podatnika rejestrujące komunikację z bramką API Ministerstwa Finansów.
- Certyfikaty Pieczęci Elektronicznej lub certyfikaty MCU wykorzystywane do autoryzacji.
- Zarchiwizowane metadane odpowiedzi z KSeF, w tym numery referencyjne sesji.
W związku z tym, że ponad 50% firm obawia się niewypłacalności kontrahenta, posiadanie pełnej dokumentacji technicznej procesu fakturowania jest zabezpieczeniem roszczeń finansowych. Przedsiębiorcy coraz częściej decydują się na rozszerzenie ochrony ubezpieczeniowej o polisy ECC (ubezpieczenie od przestępstw komputerowych) oraz BBB (ochrona przed nieuczciwością pracownika), gdzie warunkiem wypłaty odszkodowania jest posiadanie nienaruszonego dziennika zdarzeń systemowych.
Plan operacyjny: 6 rzeczy do zrobienia przed 1 lutego 2026
Przygotowanie organizacji do obligatoryjnego KSeF wymaga realizacji harmonogramu wdrożenia z uwzględnieniem testów obciążeniowych. Krytyczne pole XML takie jak P_2 (data wystawienia), P_6 (numer identyfikujący nabywcę) oraz P_26 (rodzaj faktury) muszą być mapowane poprawnie z systemów ERP bezpośrednio do struktury FA(3). Firmy, które przeprowadziły minimum 80 godzin testów integracyjnych, wykazują niemal stuprocentową skuteczność wdrożenia w dniu startu systemu. Należy pamiętać, że kary za niesprawne faktury po okresie przejściowym mogą sięgać kwoty 500 tys. zł.
Inwentaryzacja źródeł danych powinna zostać udokumentowana w formie macierzy zgodności, co ułatwia audyt procesów biznesowych.
| Nazwa systemu | Rodzaj faktury | Format wyjściowy | Status FA(3) |
|---|---|---|---|
| ERP Sap/Oracle | Sprzedażowa krajowa | XML / JSON | Zgodny (v3) |
| System bilingowy | Masowa / Usługowa | CSV / Flat File | Wymaga konwertera |
| Portal klienta | Faktura korygująca | XML | Zgodny (v3) |
Kolejnym etapem jest przeprowadzenie testów typu „stress-test” na środowisku sandbox. Zaleca się uruchomienie transmisji na poziomie 1000 faktur na godzinę, a następnie kontrolowane odcięcie dostępu do internetu. Pozwala to na sprawdzenie, czy system automatycznie przełączy się na tryb offline24 i wygeneruje poprawny kod QR. Zgodnie z dokumentacją techniczną Ministerstwa Finansów, kod QR dla faktur wystawianych poza systemem ma długość 114 znaków i zawiera zaszyfrowane dane o wystawcy oraz kwocie należności. Dokumentowanie każdego testu poprzez zrzuty ekranu oraz logi transmisyjne stanowi dowód dopełnienia należytej staranności przed organami nadzorczymi.
Niezwykle istotnym terminem jest 1 listopada 2025 r., kiedy to upływa czas na składanie wniosków o certyfikaty MCU dla dużych podmiotów. Brak certyfikatu uniemożliwi automatyzację wysyłki faktur w dniu wejścia w życie przepisów, czyli 1 lutego 2026 r. dla dużych firm oraz 1 kwietnia 2026 r. dla pozostałych podatników. Najmniejsze podmioty mają czas na adaptację do 1 stycznia 2027 r., jednak zaleca się wcześniejsze wdrożenie struktur XML w celu uniknięcia zatorów wdrożeniowych u dostawców oprogramowania.
To kompleksowa transformacja, która ma na celu uproszczenie obiegu dokumentów, zmniejszenie kosztów administracyjnych oraz skuteczniejszą walkę z wyłudzeniami VAT.
FAQ - najczęstsze pułapki BCP za 5 tygodni przed startem KSeF
Czy PDF przesyłany e-mailem jest nadal uznawany za e-fakturę?
Czy muszę podawać numer KSeF w tytule przelewu bankowego?
Co z fakturami VAT RR po wprowadzeniu KSeF?
Kiedy grożą mi sankcje finansowe za błędy w KSeF?
Co zrobić, jeśli KSeF ma awarię trwającą kilka dni?
Redakcja · wszystkie artykuły