Błąd wysyłki JPK lub e-Deklaracji

Błąd wysyłki JPK lub e-Deklaracji potrafi zablokować firmę tuż przed terminem złożenia dokumentu do urzędu skarbowego, co grozi konsekwencjami finansowymi. Najczęściej problem dotyczy podpisu elektronicznego, struktury pliku XML lub certyfikatu bezpieczeństwa. Komunikat wyświetlany przez program księgowy nie zawsze jasno wskazuje przyczynę, dlatego ważne jest ustalenie, na którym etapie wysyłka została przerwana.

Jednolity Plik Kontrolny i e-Deklaracje wysyłane są z programu księgowo-magazynowego bezpośrednio na bramkę Ministerstwa Finansów, co wymaga poprawnej struktury pliku XML zgodnej z aktualnym schematem oraz ważnego podpisu – kwalifikowanego, danymi autoryzującymi lub profilem zaufanym. Błąd na dowolnym z tych etapów przerywa wysyłkę i zwraca komunikat, który dla laika bywa niezrozumiały.

W praktyce nie każda nieudana próba oznacza błąd w samym dokumencie. Przyczyną może być również nieaktualny program, brak odpowiedniego komponentu systemowego, problem z dostępem do internetu, nieprawidłowa data i godzina na komputerze albo konflikt pomiędzy aplikacją księgową a oprogramowaniem do obsługi podpisu elektronicznego. Dlatego diagnozę najlepiej przeprowadzać krok po kroku, zachowując komunikat błędu i potwierdzenie każdej wykonanej próby.

Najczęstsze przyczyny nieudanej wysyłki

Poniżej sytuacje odpowiedzialne za większość zgłoszeń dotyczących błędów JPK i e-Deklaracji.

Wygasły lub uszkodzony certyfikat kwalifikowanego podpisu elektronicznego.
Nieaktualna wersja schematu XML w programie po zmianie przepisów przez Ministerstwo Finansów.
Błędne dane autoryzujące, na przykład niezgodna kwota przychodu z zeznania za poprzedni rok.
Przerwa w działaniu bramki Ministerstwa Finansów lub problem z certyfikatem SSL po stronie serwera.
Brak aktualizacji programu firmowego do wersji obsługującej bieżącą strukturę JPK.
Nieprawidłowo zainstalowane sterowniki czytnika lub aplikacji obsługującej podpis elektroniczny.
Brak uprawnień użytkownika do uruchomienia programu, sterownika albo magazynu certyfikatów.
Niepoprawne dane podatnika, adres, numer identyfikacyjny lub oznaczenie okresu rozliczeniowego.

Problemy z podpisem elektronicznym

Podpis elektroniczny jest jednym z najczęstszych punktów awarii. Certyfikat może utracić ważność, zostać odwołany albo nie być widoczny w programie, z którego wysyłany jest dokument. W przypadku podpisu zapisanego na karcie kryptograficznej należy dodatkowo sprawdzić działanie czytnika, przewód USB oraz oprogramowanie dostarczone do obsługi karty. Jeżeli używany jest podpis zapisany w chmurze, przyczyną może być brak prawidłowego logowania lub nieaktualna aplikacja pomocnicza.

Warto pamiętać, że sam fakt wykrycia certyfikatu przez system nie oznacza jeszcze, że może on zostać wykorzystany do wysyłki. Program księgowy może wymagać określonego typu certyfikatu, dostępu do klucza prywatnego albo dodatkowego modułu integracyjnego. Błąd pojawia się również wtedy, gdy użytkownik wybierze certyfikat należący do innej osoby lub nieposiadający odpowiednich uprawnień do podpisywania dokumentów firmy.

Nieaktualny schemat JPK lub e-Deklaracji

Dokument XML musi odpowiadać strukturze wymaganej przez bramkę Ministerstwa Finansów. Jeżeli program korzysta ze starego schematu, plik może zostać odrzucony jeszcze przed sprawdzeniem podpisu. W komunikacie pojawiają się wtedy określenia takie jak niezgodność elementu, brak wymaganego pola, nieprawidłowa wartość albo błąd walidacji struktury.

Aktualizacja nie zawsze ogranicza się do kliknięcia jednego przycisku. Czasami konieczne jest pobranie nowej wersji programu, zainstalowanie dodatkowego modułu, odświeżenie listy struktur lub ponowne skonfigurowanie połączenia z usługą wysyłkową. Przed aktualizacją należy wykonać kopię zapasową danych firmy i sprawdzić, czy program jest zgodny z używanym systemem operacyjnym.

Błędne dane w dokumencie

Wysyłka może zostać odrzucona również wtedy, gdy sam plik jest technicznie poprawny, ale zawiera niespójne dane. Dotyczy to między innymi numeru NIP, okresu rozliczeniowego, oznaczenia korekty, sum kontrolnych, stawek podatku lub wartości sprzedaży i zakupów. Czasem problem powstaje wskutek ręcznej zmiany danych po wygenerowaniu pliku albo połączenia dokumentu z nieaktualną bazą kontrahentów.

Nie należy poprawiać pojedynczych wartości bez sprawdzenia, skąd zostały pobrane. Jeżeli źródłowe dane w programie księgowym są nieprawidłowe, ponowne wygenerowanie JPK może odtworzyć ten sam błąd. Najpierw trzeba porównać dokument z ewidencją, deklaracją oraz okresem, którego dotyczy wysyłka. Szczególną uwagę należy zwrócić na dokumenty zaksięgowane po zamknięciu okresu i pozycje oznaczone jako korekty.

Jak zdiagnozować konkretny błąd

Kluczowe jest dokładne odczytanie kodu błędu zwróconego przez bramkę – kody takie jak błędy walidacji XML wskazują zwykle na niezgodność struktury pliku, podczas gdy błędy związane z podpisem dotyczą certyfikatu. Warto też sprawdzić, czy program ma zainstalowaną najnowszą aktualizację, ponieważ struktura JPK bywa modyfikowana przez ustawodawcę kilka razy w roku.

Nie warto ograniczać się do ogólnego komunikatu widocznego w głównym oknie programu. W wielu aplikacjach szczegółowe informacje znajdują się w historii wysyłek, raporcie transmisji albo dodatkowym pliku dziennika. Należy zapisać pełną treść komunikatu, godzinę próby, nazwę dokumentu oraz informację, czy błąd wystąpił podczas generowania, podpisywania czy przesyłania pliku.

Sprawdzenie etapu, na którym występuje problem

Pierwszym etapem jest wygenerowanie dokumentu. Jeżeli błąd pojawia się już wtedy, problem najczęściej dotyczy danych w bazie albo reguł tworzenia pliku. Jeżeli dokument powstaje poprawnie, ale nie można go podpisać, należy skupić się na certyfikacie, sterownikach, kodzie PIN i aplikacji podpisującej. Jeżeli podpis przechodzi, a błąd pojawia się dopiero przy wysyłce, trzeba sprawdzić połączenie z bramką, aktualność adresu usługi oraz certyfikaty bezpieczeństwa.

Pomocne jest wykonanie kontrolnej próby na innym użytkowniku tego samego komputera lub na innym stanowisku, o ile procedury firmy na to pozwalają. Jeżeli dokument można podpisać i wysłać na drugim komputerze, przyczyn należy szukać w lokalnej konfiguracji. Gdy identyczny błąd występuje na kilku stanowiskach, bardziej prawdopodobna jest niezgodność danych, wersji programu albo chwilowa niedostępność usługi zewnętrznej.

Podstawowa lista kontrolna

Sprawdź, czy komputer ma stabilne połączenie z internetem.
Zweryfikuj datę i godzinę systemową oraz ustawioną strefę czasową.
Otwórz szczegóły błędu i zapisz jego pełny kod.
Sprawdź ważność certyfikatu oraz możliwość użycia klucza prywatnego.
Odłącz i podłącz ponownie czytnik, jeżeli podpis znajduje się na karcie.
Uruchom program księgowy po zastosowaniu dostępnych aktualizacji.
Wygeneruj dokument ponownie z aktualnych danych, zamiast wielokrotnie wysyłać ten sam uszkodzony plik.
Zachowaj potwierdzenie UPO lub inny komunikat potwierdzający przyjęcie dokumentu.

Różnica między błędem wysyłki a odrzuceniem dokumentu

Ważne jest rozróżnienie problemu technicznego od negatywnego wyniku weryfikacji dokumentu. Błąd wysyłki oznacza, że plik mógł nie dotrzeć do bramki albo transmisja została przerwana. Odrzucenie oznacza natomiast, że dokument został odebrany, ale nie przeszedł kontroli formalnej lub merytorycznej.

W pierwszym przypadku ponowna próba może być uzasadniona po sprawdzeniu połączenia i konfiguracji. W drugim trzeba poprawić wskazane dane, ponownie wygenerować dokument, podpisać go i wysłać jako właściwy dokument lub korektę zgodnie z procedurą. Sam brak komunikatu o błędzie na ekranie nie jest potwierdzeniem złożenia. Dowodem przyjęcia jest dopiero prawidłowe potwierdzenie z systemu.

Problemy z komputerem, systemem i oprogramowaniem

Niektóre awarie wynikają z lokalnego środowiska pracy. Aktualizacja systemu może zmienić działanie sterownika czytnika, ustawienia zabezpieczeń albo dostęp aplikacji do certyfikatu. Program antywirusowy lub zapora sieciowa może zablokować połączenie z usługą wysyłkową, szczególnie gdy aplikacja korzysta z dodatkowego modułu komunikacyjnego.

Problem może pojawić się także po zmianie komputera, migracji danych lub przywróceniu kopii zapasowej. Certyfikat nie zawsze przenosi się razem z bazą programu, a klucz prywatny może być zapisany wyłącznie na konkretnym urządzeniu lub nośniku. W takiej sytuacji samo skopiowanie pliku XML i instalacja programu nie wystarczy. Konieczne jest odtworzenie bezpiecznej konfiguracji podpisu oraz sprawdzenie uprawnień użytkownika.

Nie należy usuwać certyfikatów, sterowników ani plików konfiguracyjnych bez kopii zapasowej i znajomości ich funkcji. Pochopne zmiany mogą utrudnić późniejszą diagnozę, a w przypadku kluczy kryptograficznych doprowadzić do utraty dostępu. Bezpieczniej jest najpierw zanotować aktualne ustawienia i ustalić, który komponent odpowiada za konkretny etap wysyłki.

Co przygotować do skutecznej diagnozy

Przy zgłoszeniu problemu przydatne są: pełny komunikat błędu, wersja programu księgowego, wersja systemu operacyjnego, rodzaj używanego podpisu, informacja o tym, czy problem dotyczy jednego czy wielu dokumentów, oraz godzina nieudanej próby. Warto również wskazać, czy przed wystąpieniem problemu wykonywano aktualizację, zmieniano komputer, podłączano nowy czytnik albo instalowano dodatkowe zabezpieczenia.

Nie należy przesyłać osobom postronnym haseł, kodów PIN, kluczy prywatnych ani pełnych dokumentów zawierających dane kontrahentów, jeżeli nie jest to konieczne i odpowiednio zabezpieczone. Do wstępnej oceny zwykle wystarcza zanonimizowany zrzut komunikatu oraz opis etapu, na którym pojawia się błąd.

Zabezpieczenie terminowej wysyłki na przyszłość

Aby uniknąć powtórki problemu przy kolejnym okresie rozliczeniowym, warto zaplanować aktualizację programu z wyprzedzeniem przed terminem wysyłki, regularnie sprawdzać datę ważności certyfikatu podpisu elektronicznego oraz wykonać próbną wysyłkę testową kilka dni przed ostatecznym terminem. Serwis IT może skonfigurować przypomnienia o wygasających certyfikatach oraz zweryfikować poprawność ustawień modułu JPK w programie.

Dobrym rozwiązaniem jest stała lista czynności wykonywanych przed wysyłką. Powinna obejmować kopię zapasową bazy, sprawdzenie aktualizacji, weryfikację certyfikatu, kontrolę danych firmy i okresu rozliczeniowego oraz sprawdzenie, gdzie program zapisuje potwierdzenia. Dzięki temu ewentualny problem zostanie wykryty wcześniej, a nie dopiero przy ostatniej próbie przekazania dokumentu.

Warto także ustalić procedurę awaryjną na wypadek niedostępności bramki lub awarii głównego komputera. Powinna ona określać, kto posiada uprawnienia do podpisu, gdzie znajduje się kopia danych i jakie informacje należy zachować z każdej próby wysyłki. Uporządkowana konfiguracja, aktualne oprogramowanie i regularna kontrola podpisu znacząco ułatwiają terminowe przekazywanie JPK oraz e-Deklaracji.

Zgłoszenie naprawy: 22 390 56 49 — telefon czynny całą dobę, siedem dni w tygodniu. Sprzęt odbieramy spod wskazanego adresu w Grodzisku Mazowieckim i okolicy.