SLA KSeF: czas odpowiedzi, limity błędów, planowane przerwy
Tekst opracowany z wykorzystaniem sztucznej inteligencji. Zasady i ograniczenia
Parametry Service Level Agreement (SLA) określone przez Ministerstwo Finansów definiują ramy technicznej wydajności Krajowego Systemu e-Faktur. Powszechny mit o nieprzerwanej dostępności systemu zostaje zweryfikowany przez oficjalną dokumentację, która dopuszcza 99,5% dostępności w skali miesiąca. W praktyce oznacza to akceptację przerw technicznych trwających łącznie do 3 godzin i 43 minut miesięcznie. Planowane prace konserwacyjne są zazwyczaj realizowane w godzinach najniższego obciążenia serwerów, czyli między 2:00 a 6:00 rano. System jest przygotowany na obsługę wolumenu przekraczającego 720 tys. faktur dziennie w okresach szczytowego zapotrzebowania.
Analiza wydajności infrastruktury produkcyjnej w pierwszym kwartale pełnego wdrożenia wykazuje pewne rozbieżności między deklaracjami a stanem faktycznym. Średni czas odpowiedzi API w godzinach szczytu (między 10:00 a 14:00) przekraczał założone limity, co wymusza na systemach ERP stosowanie mechanizmów kolejkowania. Poniższa tabela przedstawia porównanie oficjalnych wskaźników SLA z danymi pomiarowymi zarejestrowanymi w okresie od lutego do kwietnia 2025 r.
| Parametr | Deklaracja SLA | Real luty-kwiecień 2025 |
|---|---|---|
| Dostępność miesięczna | ≥99,5% | 99,41% |
| Czas odpowiedzi API | ≤500 ms | 673 ms (śr.) |
| Przerwy planowane | ≤4h/mies. | 3h 15min |
Konsekwencje prawne i finansowe przekroczenia parametrów SLA oraz wystąpienia błędów krytycznych są bezpośrednie dla podatnika. Zastosowanie znajduje tu ścisła zależność proceduralna: firma wysyła fakturę, KSeF zwraca błąd 503 (Service Unavailable), w wyniku czego firma ryzykuje 100% karę za niedopełnienie obowiązku wystawienia faktury ustrukturyzowanej. Podstawę prawną stanowi art. 116a § 1 ustawy Ordynacja podatkowa, który określa dotkliwe sankcje za ominięcie systemu. Warto podkreślić, że brak skutecznego wystawienia dokumentu w systemie centralnym oznacza brak możliwości odliczenia podatku naliczonego przez nabywcę, co paraliżuje płynność finansową kontrahentów.
W celu zabezpieczenia interesu prawnego przedsiębiorstwa zaleca się archiwizowanie logów HTTP zawierających kody błędów z grupy 5xx (502 Bad Gateway, 503 Service Unavailable). Dokumentacja ta stanowi kluczowy dowód w ewentualnym sporze z organami administracji skarbowej, potwierdzając, że brak terminowego przesłania dokumentu wynikał z awarii po stronie infrastruktury państwowej, a nie zaniechania podatnika. Krajowy System e-Faktur 2.0, uruchomiony 1 lutego 2026 r., posiada wbudowane mechanizmy raportowania błędów, jednak to po stronie przedsiębiorcy leży obowiązek udowodnienia braku technicznej możliwości wysyłki.
Darmowe narzędzia do monitoringu statusu KSeF
Monitorowanie stabilności połączenia z bramką KSeF nie musi wymagać zaawansowanych prac programistycznych dzięki wykorzystaniu gotowych rozwiązań monitorujących. Najbardziej autorytatywnym źródłem informacji pozostaje oficjalny serwis prowadzony przez Ministerstwo Finansów. Użytkownicy mogą tam sprawdzić aktualny stan środowiska produkcyjnego, przedprodukcyjnego oraz testowego. Należy jednak pamiętać, że oficjalny StatusPage MF odświeża dane z interwałem do 60 minut, co w sytuacjach dynamicznych awarii może być niewystarczające dla systemów przetwarzających duże ilości dokumentów w czasie rzeczywistym.
Alternatywą dla narzędzi rządowych są aplikacje dostarczane przez niezależnych integratorów, które oferują znacznie szybszą notyfikację o incydentach. Wykorzystanie zewnętrznych endpointów pozwala na weryfikację dostępności systemu z różnych lokalizacji geograficznych, co eliminuje ryzyko błędnych odczytów wynikających z problemów z routingiem lokalnych dostawców internetu. Do najczęściej wybieranych narzędzi należą:
- StatusPage MF (statuspage.gov.pl) - oficjalny kanał komunikacji, oferuje subskrypcję e-mail o planowanych oknach serwisowych.
- Scanye Status - dedykowane rozwiązanie przesyłające webhooki do Microsoft Teams lub Slacka w czasie poniżej 2 minut od wykrycia błędu.
- AMODIT KSeF Connector - narzędzie wykonujące REST ping co 5 minut, pozwalające na bieżąco monitorować czas odpowiedzi bramki.
Własny system wczesnego ostrzegania można skonfigurować w krótkim czasie przy użyciu darmowych usług typu Uptime Monitoring. Procedura wymaga założenia konta w serwisie UptimeRobot, który w bezpłatnym planie pozwala na zdefiniowanie do 50 monitorów. Następnie należy dodać nowy monitor typu HTTP(s) wskazujący na endpoint: . Kluczowe jest ustawienie parametru trigger na wartość powyżej 2 minut timeoutu, co pozwoli uniknąć fałszywych alarmów przy chwilowych wahaniach sieci. Połączenie monitora z kanałem Slack lub Discord zapewnia natychmiastową informację o przestoju dla zespołu księgowego.
Zaleca się prowadzenie testów monitoringu na środowisku demo KSeF, co pozwala uniknąć nakładania limitów prób nawiązania połączenia, które obowiązują na środowisku produkcyjnym. Dzięki automatyzacji powiadomień, administratorzy systemów finansowych mogą zareagować na awarię zanim wpłynie ona na procesy biznesowe. Ministerstwo Finansów udostępniło bezpłatne narzędzia, dzięki którym przedsiębiorcy mogą poznać zasady funkcjonowania nowego systemu bez ponoszenia kosztów licencyjnych w początkowej fazie wdrożenia.
Monitoring w ERP: SAP, Microsoft, Comarch
Integracja monitoringu statusu KSeF bezpośrednio w strukturach systemów klasy Enterprise Resource Planning (ERP) pozwala na pełną automatyzację zarządzania błędami komunikacji. W systemie SAP, dedykowany moduł Document & Reporting Compliance (DRC) posiada natywne mechanizmy śledzenia statusu przesyłek. Informacje o błędach połączenia są rejestrowane w tabelach systemowych, co umożliwia szybką diagnostykę bez konieczności analizy logów serwerowych przez dział IT. Kluczowe metryki można wyciągnąć bezpośrednio z bazy danych za pomocą zapytań SQL.
Wersja SAP DRC 2025 FPS01 zawiera predefiniowane alerty dedykowane dla polskiego KSeF, które monitorują tabelę /KSeF/LOG_ALRT. Administrator może zweryfikować liczbę odrzuconych faktur za pomocą prostego zapytania filtrującego błędy serwerowe: SELECT COUNT(*) WHERE STATUS_CODE >= 500 AND CREATED_ON = TODAY. Podobne podejście stosują inni dostawcy oprogramowania. Microsoft Dynamics 365 udostępnił connector KSeF w public preview od drugiego kwartału 2025 r., natomiast rozwiązania Comarch implementują standardowo mechanizm trzykrotnego ponowienia wysyłki (retry) w odstępach 5-minutowych przed przekazaniem dokumentu do ręcznej akceptacji przez operatora.
Automatyzacja procesów fakturowania wymaga zdefiniowania precyzyjnych scenariuszy postępowania w przypadku otrzymania kodu błędu 503. Logika trójki: błąd-503 → ERP-czeka-60s → ponawia-z-nowym-tokenem, pozwala na zachowanie ciągłości operacyjnej przy krótkotrwałych niedostępnościach systemu. Poniżej znajduje się przykładowy schemat logiczny dla narzędzi typu PowerAutomate w formacie JSON, który można zaimplementować w procesach przepływu dokumentów:
Podczas konfiguracji mechanizmów ponawiania wysyłki, niezwykle ważne jest zachowanie progresywnych odstępów czasowych (backoff strategy). Sugerowana kolejność retry to: 1 minuta → 5 minut → 30 minut. Takie podejście drastycznie zmniejsza ryzyko zablokowania adresu IP firmy przez zapory ogniowe Ministerstwa Finansów, które reagują na zbyt dużą częstotliwość zapytań z jednego źródła w krótkim czasie. Prawidłowa integracja zapewnia automatyzację procesu fakturowania i pełną zgodność z obowiązującymi przepisami prawnymi, redukując o 80% nakład pracy potrzebny na ręczną obsługę błędów dokumentacji.
Awaria KSeF: plan B w 15 minut
W przypadku wystąpienia długotrwałej awarii systemu centralnego, uniemożliwiającej wystawienie faktury ustrukturyzowanej, ustawodawca przewidział procedury awaryjne. Zgodnie z art. 106j § 3 ustawy o podatku od towarów i usług (PB), jeżeli Krajowy System e-Faktur pozostaje niedostępny przez okres dłuższy niż 24 godziny, dopuszcza się wystawianie faktur w formacie elektronicznym (PDF) poza systemem. Próg 24 godzin liczony jest od momentu odnotowania pierwszego błędu komunikacji, co musi zostać potwierdzone logami z systemu monitorującego przedsiębiorcy.
Faktura wystawiona w trybie awaryjnym musi zostać opatrzona specjalną adnotacją o treści: „KSeF-niedostępny - art. 106j § 3 PB”. Brak tej frazy może skutkować zakwestionowaniem dokumentu przez organy kontrolne. Po ustaniu awarii, podatnik ma obowiązek przesłania wszystkich wystawionych w tym trybie faktur do KSeF w terminie 7 dni roboczych od dnia przywrócenia funkcjonalności platformy. Dokumenty te otrzymają wówczas numery KSeF, ale ich data wystawienia pozostanie zgodna z datą wygenerowania pliku PDF. Należy pamiętać, że każda faktura przesłana do KSeF przy pomocy środowiska produkcyjnego nieodwołalnie trafia do obiegu prawnego.
Czy mogę wysłać PDF podczas awarii KSeF?
Od kiedy liczyć 24 godziny niedostępności?
Jak potwierdzić brak dostępu do systemu?
Czy muszę zgłaszać każdą awarię do Urzędu Skarbowego?
Skuteczna realizacja planu awaryjnego wymaga od przedsiębiorcy stałego monitorowania komunikatów Ministerstwa Finansów oraz posiadania procedur wewnętrznych określających moment przejścia na fakturowanie zastępcze. Zachowanie należytej staranności biznesowej w weryfikacji dostępności usług KSeF pozwala na zredukowanie ryzyka nałożenia kar pieniężnych oraz zapewnia bezpieczeństwo podatkowe nabywcom towarów i usług, którzy na podstawie otrzymanych faktur dokonują odliczeń podatku VAT. Odpowiednie przygotowanie techniczne i merytoryczne skraca czas reakcji na incydenty infrastrukturalne do niezbędnego minimum.
Redakcja · wszystkie artykuły