Zgłaszanie awarii i problemów technicznych do Ministerstwa Finansów - instrukcja krok po kroku

Kiedy i jak szybko zgłosić awarię do KAS

AITekst opracowany z wykorzystaniem sztucznej inteligencji. Zasady i ograniczenia

Ustalenie obowiązku raportowania problemów technicznych jest kluczowe dla zachowania ciągłości obrotu gospodarczego i bezpieczeństwa prawnego podatnika. Zgodnie z art. 106ng ustawy o podatku od towarów i usług z dnia 11 marca 2004 r. (t.j. Dz.U. 2024 poz. 361), procedura postępowania w przypadku awarii całkowitej precyzuje kroki, jakie musi podjąć wystawca faktury. W sytuacji niedostępności systemu, podatnik wystawiający fakturę w okresie awarii KSeF musi ją wystawić w postaci papierowej lub jako fakturę elektroniczną i przekazać nabywcy w sposób uzgodniony, na przykład mailem lub osobiście. Przepisy te wchodzą w życie z dniem 1 lutego 2026 r., co obliguje podmioty do dostosowania wewnętrznych procedur ERP do nowych wymogów komunikacyjnych.

Relacja na linii podatnik-organ podatkowy opiera się na ścisłych zależnościach proceduralnych, gdzie brak zgłoszenia awarii generuje wymierne ryzyka. Logika operacyjna wskazuje, że jeśli podatnik nie zgłasza błędu, następuje utrata możliwości korygowania faktur w trybie systemowym, co bezpośrednio prowadzi do ryzyka nałożenia sankcji karno-skarbowych. Warto podkreślić, że Krajowa Administracja Skarbowa uznaje awarię całkowitą za sytuację nadzwyczajną, dotyczącą zagrożenia infrastruktury kraju, a komunikaty o takim zdarzeniu publikowane są w mediach masowych, takich jak telewizja, radio oraz prasa. W przypadku awarii lokalnej po stronie podatnika, to na wystawcy spoczywa ciężar dowodowy wykazania braku możliwości połączenia z API KSeF.

• Obowiązek zgłoszenia niedostępności systemu ciąży bezpośrednio na wystawcy dokumentu.
• Zwłoka przekraczająca 24 godziny może zablokować możliwość późniejszej korekty dokumentów w systemie KSeF.
• Brak formalnego zgłoszenia poprzez PUESC oznacza brak dowodu wystąpienia awarii podczas ewentualnej kontroli skarbowej.

Terminowość obsługi zgłoszeń przez Centralne Biuro Techniczne PUESC jest ściśle zdefiniowana w dokumentacji serwisowej Ministerstwa Finansów, która obecnie występuje w wersji 5.0. Krajowa Administracja Skarbowa deklaruje potwierdzenie otrzymania zgłoszenia w czasie nieprzekraczającym 4 godzin dla incydentów o charakterze standardowym. W sprawach o wysokim stopniu skomplikowania, wymagających analizy logów systemowych przez architektów oprogramowania, czas rozwiązania problemu może zostać wydłużony do 20 dni roboczych. Podatnicy powinni każdorazowo zachowywać potwierdzenie wysłania zgłoszenia wraz z unikalnym timestampem generowanym przez system PUESC oraz wykonywać zrzuty ekranu z widocznym kodem błędu, co znacząco przyspiesza proces weryfikacji po stronie organu.

Kanały zgłoszeniowe - PUESC, e-mail, infolinia

Głównym kanałem komunikacji technicznej z organami skarbowymi jest Portal Usług Elektronicznych Skarbowo-Celnych, dostępny pod adresem puesc.gov.pl. Ministerstwo Finansów, zlokalizowane przy ul. Świętokrzyskiej 12 w Warszawie (NIP 5260250274, REGON 000002217), zapewnia pełną cyfryzację procesu raportowania błędów. Użytkownik po zalogowaniu do Online Customer Account z wykorzystaniem Profilu Zaufanego lub e-dowodu uzyskuje dostęp do usługi „Zgłoś nieprawidłowość”. Aktualizacja dokumentacji z dnia 1 lipca 2024 r. wprowadziła ujednolicony interfejs zgłoszeniowy w wersji 5.0, który pozwala na precyzyjne kategoryzowanie problemów technicznych związanych z JPK_VAT oraz fakturami ustrukturyzowanymi.

1. Zaloguj się na portal PUESC wykorzystując bezpieczne metody autoryzacji (Profil Zaufany, e-dowód lub certyfikat kwalifikowany).
2. Wybierz sekcję „Zgłoś nieprawidłowość”, a następnie podkategorię „Awaria systemu”.
3. Wypełnij formularz techniczny i załącz niezbędne pliki diagnostyczne, takie jak .xml, .log lub .png, pamiętając o limicie wielkości pojedynczego załącznika wynoszącym 10 MB.

Alternatywne drogi kontaktu obejmują dedykowane adresy e-mail oraz infolinie tematyczne, które funkcjonują jako wsparcie drugiego poziomu. Centralne Biuro Techniczne obsługuje zapytania przesyłane na adres cmt@mf.gov.pl. W sprawach technicznych dotyczących aplikacji e-mikrofirma należy pisać na jpk.helpdesk@mf.gov.pl, natomiast kwestie związane z JPK_PD wymagają kontaktu z adresem jpkPD.helpdesk@mf.gov.pl. Centrum Kontaktu Klientów ZUS oraz Krajowa Informacja Skarbowa zapewniają wsparcie telefoniczne - KIS dostępna jest pod numerami 801 055 055 oraz 22 330 03 30. Należy jednak pamiętać, że zgłoszenia przesyłane poza systemem PUESC są traktowane jako zapytania ogólne, co może skutkować wydłużeniem czasu reakcji poza standardowe parametry SLA.

Ministerstwo Finansów kładzie duży nacisk na merytoryczne przygotowanie zgłoszeń. Sugeruje się stosowanie w tytule wiadomości formatu: „AWARIA - KSeF - NIP [numer]”, co pozwala algorytmom segregującym w Centralnym Biurze Technicznym na szybsze przypisanie sprawy do właściwego zespołu ekspertów. Dołączenie pliku XML z konkretnym komunikatem błędu pozwala na szybką weryfikację struktury dokumentu względem schematu XSD, co często eliminuje błędy leżące po stronie oprogramowania księgowego podatnika jeszcze przed interwencją administratorów rządowych.

Schemat zgłoszenia awarii KSeF - co wpisać w formularzu

Poprawne wypełnienie formularza zgłoszeniowego jest warunkiem koniecznym do uznania zgłoszenia za kompletne zgodnie z Rozporządzeniem Ministra Finansów z dnia 29 grudnia 2022 r. w sprawie korzystania z Krajowego Systemu e-Faktur. Dokument ten określa niezbędne metadane, które muszą zostać przekazane w celu identyfikacji błędu w środowisku produkcyjnym. Od momentu uruchomienia systemu do bazy wpłynęło ponad 50 000 faktur, co wymusza na systemach analitycznych KAS operowanie na precyzyjnych identyfikatorach. Kluczowym elementem jest podanie unikalnego numeru UUID faktury, który składa się z 36 znaków i pozwala na jednoznaczne odnalezienie rekordu w rozproszonej bazie danych Ministerstwa Finansów.

• NIP podatnika - podawany w formacie ciągłym, bez myślników i spacji.
• Dokładna sygnatura czasowa wystąpienia błędu w formacie UTC (zgodnie z ISO 8601).
• Unikalny identyfikator faktury (UUID) dla dokumentów, które zostały już przesłane do systemu.
• Kod statusu odpowiedzi HTTP otrzymany z bramki API (np. 400, 401, 422).
• Pełna treść komunikatu technicznego pobrana z pola "detail" w odpowiedzi serwera.

W procesie diagnostycznym istotne jest rozróżnienie pomiędzy awarią systemu a błędem walidacji dokumentu. Kod 400 zazwyczaj sygnalizuje błąd walidacji względem schematu XSD, co oznacza, że plik .xml jest niezgodny ze strukturą logiczną faktury ustrukturyzowanej. Z kolei kod 401 informuje o braku ważnego tokenu autoryzacyjnego lub wygaśnięciu sesji użytkownika. Przed wysłaniem zgłoszenia zaleca się skorzystanie z ogólnodostępnego walidatora na stronie giif.mofnet.gov.pl/validator. Jeśli błąd dotyczy wyłącznie pojedynczego dokumentu, nie należy kwalifikować go jako „awaria całkowita”, gdyż systemy monitorowania SLA priorytetyzują zgłoszenia wpływające na masową skalę operacji.

Co dzieje się po zgłoszeniu - statusy, eskalacje, SLA

Proces obsługi zgłoszenia po jego zarejestrowaniu w systemie PUESC opiera się na workflow zarządzanym przez narzędzie JIRA w ramach projektu CBT-KSeF. Po wysłaniu formularza, zgłoszenie trafia do Centralnego Biura Technicznego, gdzie następuje jego wstępna klasyfikacja. W strukturze operacyjnej KAS wydzielone są specjalistyczne jednostki, takie jak Zespół Eksploatacji KSeF oraz Zespół Monitorowania SLA, które odpowiadają za dotrzymanie reżimów czasowych odpowiedzi. Każda zmiana statusu zgłoszenia jest odnotowywana w systemie, a podatnik otrzymuje powiadomienie zwrotne o postępach w analizie incydentu.

1. Status „Odebrane” - generowany automatycznie przez system w ciągu 15 minut od poprawnego wysłania formularza.
2. Status „W toku” - oznacza przydzielenie sprawy do analityka w Centralnym Biurze Technicznym (maksymalnie do 4 godzin).
3. Status „Wymaga wiedzy specjalistycznej” - nadawany, gdy problem wymaga zaangażowania deweloperów systemu (termin do 20 dni roboczych).
4. Status „Rozwiązane” - zawiera szczegółowy opis przyczyny (root-cause) oraz rekomendacje dla podatnika w celu uniknięcia problemu w przyszłości.

Systemy Ministerstwa Finansów posiadają wbudowane mechanizmy automatycznej eskalacji. W przypadku braku jakiejkolwiek aktywności ze strony organu w ciągu 8 godzin od zgłoszenia, sprawa jest automatycznie przekazywana do kierownika zmiany w CBT. Przekroczenie progu 48 godzin bez odpowiedzi skutkuje eskalacją do Dyrektora Centralnego Biura Technicznego. Podatnicy mają możliwość skorzystania z adresu eskalacyjnego cmt-esc@mf.gov.pl w sytuacjach krytycznych. Dodanie frazy „BUSINESS-IMPACT” w treści zgłoszenia sugeruje, że problem uniemożliwia realizację kluczowych procesów biznesowych, co według statystyk wewnętrznych może skrócić czas reakcji o około 30%.

Należy pamiętać, że pochopne zamknięcie zgłoszenia przez użytkownika przed pełną weryfikacją rozwiązania po stronie własnego systemu ERP powoduje zresetowanie liczników SLA. Krajowa Administracja Skarbowa, prowadząc działania audytowe, objęła nimi już 164 podmioty w zakresie wydatkowania środków publicznych na systemy IT, co potwierdza rygorystyczne podejście do dokumentowania wszelkich przestojów technicznych w infrastrukturze państwowej.