Co oznacza kod 120 w JPK? Weryfikacja i problemy z przetwarzaniem

Co oznacza kod 120 w JPK?

Status 120 oznacza, że sesja przesyłania pliku JPK zakończyła się pomyślnie i dane zostały zapisane po stronie nadawcy. Plik JPK_VAT został przyjęty do dalszej weryfikacji przez Ministerstwo Finansów, a kod 120 sygnalizuje, że dokument jest w trakcie przetwarzania. Innymi słowy, plik oczekuje na formalną i merytoryczną kontrolę, ale sam status nie potwierdza poprawności jego treści ani struktury. To jedynie informacja o zakończeniu sesji i pomyślnym zapisaniu danych.

Przeczytaj teżBłąd 413 przy wysyłce dokumentu z certyfikatem — co zrobić i jak naprawić?

Status 120 może się utrzymywać do momentu wygenerowania Urzędowego Poświadczenia Odbioru (UPO) — to dopiero UPO oznacza zamknięcie całego procesu. Po pojawieniu się tego kodu numer referencyjny i stan wysyłki pozostają w ewidencji nadawcy. Kolejne komunikaty z systemu Ministerstwa Finansów będą informować o wyniku weryfikacji.

Czy status 120 wskazuje na problem z przetwarzaniem?

Status 120 nie zawsze oznacza awarię. Jeśli jednak utrzymuje się dłużej niż 24 godziny, może to sugerować problemy po stronie Ministerstwa Finansów — na przykład opóźnienia w przetwarzaniu. Zazwyczaj procedura zajmuje kilka godzin; wydłużenie do 24–72 godzin bywa spowodowane różnymi czynnikami, takimi jak przeciążenie lub tymczasowa awaria systemu, błędy wychwycone w zwrotnych komunikatach czy problem z certyfikatem podpisu (np. przeterminowanym lub unieważnionym).

Aby poradzić sobie z taką sytuacją, postępuj według poniższych wskazówek:

1. Nie wysyłaj ponownie tego samego pliku w czasie, gdy ma status 120 — powtórna wysyłka może tylko skomplikować sytuację.
2. Sprawdź zwrotne komunikaty w systemie i zwróć uwagę na błędy przetwarzania oraz dodatkowe kody, które mogą wskazywać przyczynę.
3. Zweryfikuj ważność certyfikatu użytego do podpisu; jeśli jest nieważny lub wygasł, zaktualizuj go przed kolejną próbą.
4. Odczekaj 48–72 godziny. Jeśli po tym czasie status się nie zmieni, zgłoś problem do pomocy technicznej Ministerstwa Finansów, podając numer referencyjny wysyłki.
5. W ostateczności wyeksportuj plik ponownie i wykonaj nową wysyłkę po usunięciu wykrytych błędów lub po aktualizacji certyfikatu.

Ministerstwo Finansów rekomenduje stałe monitorowanie komunikatów systemowych i unikanie powtarzania wysyłek podczas trwającej weryfikacji — duplikaty mogą generować kolejne problemy w przetwarzaniu.

Co oznacza komunikat o duplikacie 120?

Komunikat o duplikacie oznacza, że system rozpoznał przesłanie pliku identycznego z wcześniej zarejestrowanym — na podstawie tych samych danych, identyfikatora pierwotnego dokumentu lub numeru referencyjnego. W praktyce nowy plik zostaje powiązany z wcześniejszym zgłoszeniem, nie uruchamia oddzielnego procesu przetwarzania ani nie generuje osobnego UPO.

Najczęściej duplikaty pojawiają się z powodu:

• ponownej wysyłki tego samego pliku — na przykład po awarii transmisji,
• oprogramowania automatycznie podpisującego i wysyłającego pliki,
• wysyłki korekty bez zmiany numeru referencyjnego lub identyfikatora podatkowego w nagłówku JPK,
• przypadkowego kilkukrotnego klikania „wyślij” w trakcie trwającej sesji.

Po otrzymaniu komunikatu warto od razu sprawdzić identyfikator pierwotnego dokumentu i numer referencyjny, porównać je z danymi w nagłówku przesłanego pliku oraz upewnić się, że nie wysyła się tej samej wersji pliku ponownie. Jeśli konieczna jest korekta, plik powinien być przygotowany zgodnie z procedurą MF — to oznacza zmianę wymaganych pól identyfikacyjnych i weryfikację ustawień automatycznego podpisywania. Należy także wyłączyć lub poprawić mechanizmy, które powodują wielokrotne wysyłki.

Przeczytaj teżGdzie wysyłamy JPK_VAT? Poradnik krok po kroku

Konsekwencją duplikatu jest brak nowego UPO — sprawa zostaje odnotowana przy pierwotnym zgłoszeniu. Gdy pierwotne zgłoszenie zawierało błąd, zamiast ponownej wysyłki tej samej wersji trzeba złożyć korektę z właściwymi identyfikatorami.

Aby zmniejszyć ryzyko duplikatów, stosuj:

• unikatowe numery referencyjne dla każdej wysyłki,
• weryfikuj identyfikator podatkowy i nagłówek przed wysłaniem,
• monitoruj logi transmisji oraz statusy systemu podpisującego,
• konfigurację automatycznego podpisywania testuj najpierw w środowisku testowym.

Jeśli mimo to duplikaty będą się pojawiać, zgłoś problem do pomocy technicznej Ministerstwa Finansów, przekazując numer referencyjny, identyfikator podatkowy i identyfikator pierwotnego dokumentu widoczny w komunikacie.

Jak sprawdzić numer referencyjny i status wysyłki?

1. Otwórz aplikację, z której wysłano plik — na przykład program księgowy lub bramkę e‑deklaracji. W sekcji „Historia przesyłek” sprawdź numer referencyjny i bieżący status wysyłki.
2. Zaloguj się na portal Ministerstwa Finansów przez Profil Zaufany lub ePUAP. W zakładce przesyłek upewnij się, czy zgłoszenie w ogóle się pojawiło i jaki ma status przetwarzania; brak wpisu może świadczyć o tym, że przesyłka nie dotarła.
3. Przejrzyj powiadomienia zwrotne (komunikaty XML) — znajdziesz je w systemie nadawczym lub w mailach informacyjnych. Komunikat zwykle zawiera numer referencyjny, opis błędu oraz ewentualny identyfikator pierwotnego dokumentu.
4. Porównaj datę i godzinę sesji, certyfikat podpisu oraz identyfikator podatkowy z nagłówka pliku. Niejednokrotnie różnice w tych polach wyjaśniają brak UPO lub nietypowy status.
5. Jeśli numer referencyjny nie jest widoczny, zajrzyj do logów transmisji w aplikacji i do katalogu z plikami wysyłki. Bywa też, że numer zapisany jest w raporcie wygenerowanym po zakończeniu sesji.
6. Gdy numer jest dostępny, ale status pozostaje na 120 dłużej niż 48–72 godziny, zgłoś sprawę do pomocy technicznej MF. Przekaż numer referencyjny, datę i godzinę sesji, identyfikator podatkowy oraz pełny komunikat XML.
7. Przy kontaktowaniu się z dostawcą oprogramowania dołącz logi transmisji i zrzuty ekranu z historii przesyłek — to znacznie przyspieszy znalezienie przyczyny i właściwego numeru referencyjnego.
8. UPO potwierdza zakończenie procesu, lecz jego brak nie musi od razu oznaczać błędu. Monitoruj status wysyłki aż do otrzymania UPO i zachowaj numer referencyjny oraz zapis sesji bezpośrednio po wysyłce — przydadzą się podczas weryfikacji, analizy komunikatów i kontaktu z pomocą techniczną.

Jak długo trwa weryfikacja przy kodzie 120?

Czas weryfikacji przy statusie 120 zwykle mieści się w przedziale 2–12 godzin. Gdy jednak Ministerstwo Finansów jest mocno obciążone, proces może potrwać dłużej — nawet 12–72 godzin. Jeśli minęły ponad 72 godziny, istnieje spore prawdopodobieństwo problemów przy przetwarzaniu dokumentu. Na wydłużenie weryfikacji wpływają różne czynniki:

• przeciążenie systemu,
• dodatkowe walidacje merytoryczne,
• wykrycie duplikatu,
• kłopoty z podpisem elektronicznym.

Warto wówczas sprawdzić ważność certyfikatu oraz odpowiedzi OCSP/CRL, zwłaszcza gdy status 120 utrzymuje się dłużej niż zwykle. Monitoruj też komunikaty zwrotne i dzienniki wysyłki co 1–4 godziny. Jeżeli po upływie 72 godzin status nie ulegnie zmianie, skontaktuj się z pomocą techniczną Ministerstwa Finansów. Przy zgłoszeniu podaj numer referencyjny, datę i godzinę sesji oraz pełny komunikat XML. Do czasu zakończenia weryfikacji unikaj ponownego przesyłania tej samej wersji pliku.

Kiedy otrzymam UPO przy statusie 120?

UPO pojawi w systemie nadawcy dopiero po zakończeniu pełnej weryfikacji przez Ministerstwo Finansów. Zwykle trwa to od 2 do 12 godzin, choć przy dużym obciążeniu czas oczekiwania może wydłużyć się do 12–72 godzin. Jeżeli status 120 utrzymuje się dłużej niż 48–72 godziny, wykonaj poniższe kroki:

1. sprawdź numer referencyjny oraz datę i godzinę sesji w historii wysyłek i w logach transmisji,
2. przeanalizuj zwrotne komunikaty XML oraz opisy błędów — zwróć uwagę na kody sugerujące problemy z przetwarzaniem lub duplikaty,
3. zweryfikuj ważność certyfikatu podpisu oraz odpowiedzi OCSP/CRL. Przeterminowany albo unieważniony certyfikat może uniemożliwić wygenerowanie UPO,
4. nie wysyłaj ponownie tej samej wersji pliku podczas trwającej weryfikacji — duplikaty nie powodują powstania nowego UPO,
5. wyeksportuj i zachowaj logi transmisji, pełny komunikat XML, zrzuty ekranu z aplikacji oraz numer referencyjny — te materiały przyspieszą zgłoszenie do pomocy technicznej,
6. jeśli po 72 godzinach problem nadal występuje, skontaktuj się z pomocą techniczną Ministerstwa Finansów. Przekaż numer referencyjny, datę i godzinę sesji, identyfikator podatkowy oraz pełny komunikat XML. W razie problemów z certyfikatem zaktualizuj go, a następnie wykonaj ponowną wysyłkę, dokumentując przyczynę oraz numer pierwotnej sesji. Monitoruj status co 1–4 godziny, aż UPO pojawi się w systemie nadawczym.

Jak przygotować plik JPK_VAT do wysyłki?

Przed wysyłką pliku JPK_VAT wykonaj siedem kroków, które zmniejszą ryzyko odrzucenia lub błędów:

1. wygeneruj plik JPK w formacie XML zgodnym z wymaganiami Ministerstwa Finansów. Sprawdź poprawność wszystkich pól, dat, schematu XML oraz identyfikatora podatkowego w nagłówku,
2. zweryfikuj księgi i uporządkuj pozycje — usuń duplikaty, pozycje z zerowymi wartościami oraz elementy mogące powodować błędy przetwarzania,
3. przeprowadź walidację schemy XML w narzędziu walidacyjnym i usuń wszystkie zgłoszone błędy przed podpisaniem,
4. nadaj unikalny numer referencyjny w nagłówku; każda wysyłka powinna mieć inny numer. Zachowaj go w dokumentacji i w logach transmisji,
5. sprawdź ważność certyfikatu używanego do podpisu oraz odpowiedzi OCSP/CRL. Jeśli certyfikat został odnowiony, potwierdź to w aplikacji podpisującej,
6. zrób kopię zapasową pliku przed podpisaniem — zapisz ją z czytelną nazwą i datą (np. JPK_VAT_NIP_20250630.xml) i przechowuj wersję przed podpisem,
7. przetestuj automatyczne podpisywanie i wysyłkę w środowisku testowym. Jeśli podpisujesz ręcznie, postępuj według instrukcji dostawcy narzędzia. Przed finalną wysyłką upewnij się, że identyfikator podatkowy zgadza się z rejestrem, numer referencyjny jest unikalny, plik jest poprawnie podpisany, walidacja XML nie wykazuje błędów, a kopia zapasowa została wykonana. Po wysłaniu zachowaj numer referencyjny i logi transmisji — przy problemach z przetwarzaniem znacząco przyspieszy to kontakt z pomocą techniczną.

Jak podpisać plik JPK e-podpisem?

Aby skorzystać z podpisu elektronicznego, potrzebujesz ważnego kwalifikowanego certyfikatu lub Profilu Zaufanego oraz narzędzia podpisującego spełniającego wymogi Ministerstwa Finansów. Masz do wyboru dwa tryby:

• automatyczne — polega na integracji programu księgowego z kluczem prywatnym; konfigurujesz magazyn kluczy w aplikacji, testujesz proces w środowisku testowym i zapisujesz logi transmisji; jako przykłady używanych rozwiązań można wymienić programy księgowe, bramki i dedykowane narzędzia do podpisu XML,
• ręczne — generujesz podpis lokalnie: otwórz narzędzie, wybierz plik JPK (XML), wskaż certyfikat i wygeneruj podpis, a następnie zapisz podpisany plik pod czytelną nazwą.

Zanim podpiszesz dokument, sprawdź ważność certyfikatu oraz odpowiedzi OCSP/CRL — certyfikat przeterminowany lub unieważniony uniemożliwi otrzymanie UPO i grozi pozostaniem statusu 120. Po podpisaniu zweryfikuj podpis lokalnym narzędziem: skontroluj ciąg certyfikatów i zgodność z wymaganym formatem. Następnie wyślij podpisany plik przez aplikację lub bramkę MF, zapisz numer referencyjny, pełny komunikat XML oraz kopię pliku z podpisem. Jeśli pojawi się błąd, odśwież lub zaktualizuj certyfikat, ponownie podpisz plik i prześlij poprawioną wersję po usunięciu przyczyny problemu. W razie trudności skontaktuj się z dostawcą e-podpisu lub pomocą techniczną MF, dołączając numer referencyjny, logi transmisji i podpisany plik.

Przeczytaj teżNieprawidłowy numer referencyjny JPK — co to oznacza i jak uniknąć błędów?

Przykładowe narzędzia to:

• programy księgowe (np. Symfonia, Comarch),
• bramka e-deklaracje,
• narzędzia PKI od wystawcy certyfikatu.

Zachowaj podpisany plik oraz dokumentację do czasu otrzymania UPO i na potrzeby ewentualnych wyjaśnień.