taxmachine.pl

JPK — generowanie i wysyłka plików kontrolnych

Moduł JPK w TaxMachine: generowanie JPK_V7M/V7K, JPK_KR, JPK_FA, JPK_PKPIR i JPK_EWP z ewidencji księgowych, import, scalanie, weryfikacja XSD i wysyłka do bramki MF.

Opublikowano

Co potrafi (TL;DR)

Moduł JPK generuje pliki Jednolitego Pliku Kontrolnego z rejestrów VAT, KPiR, ryczałtu, ksiąg rachunkowych i faktur sprzedaży. Każdy plik można zweryfikować na zgodność ze schematem XSD, podpisać (kwalifikowanym certyfikatem, Profilem Zaufanym, danymi autoryzacyjnymi z PIT), wysłać do bramki MF i odebrać UPO. Program importuje też pliki JPK od kontrahenta lub z innej bazy, scala je i księguje zawartość w rejestrach VAT i KPiR/ryczałcie.

Wspierane typy JPK

Poniższe warianty mają działający generator. Numery wersji odpowiadają wartości atrybutu kodSystemowy w nagłówku JPK i nazwie schematu XSD.

Typ plikuWspierane wersje (kodSystemowy)
JPK_VAT (do września 2020)JPK_VAT (1), (2), (3)
JPK_V7M (VAT z deklaracją, miesięczny)JPK_V7M (1), (2), (3)
JPK_V7K (VAT z deklaracją, kwartalny)JPK_V7K (1), (2), (3)
JPK_FA (faktury)JPK_FA (1), (2), (3), (4)
JPK_PKPIR (księga podatkowa)JPK_PKPIR (1), (2), (3)
JPK_EWP (ewidencja przychodów / ryczałt)JPK_EWP (1), (2), (3)
JPK_KR (księgi rachunkowe)JPK_KR (1)

Program wczytuje też dodatkowe schematy XSD:

  • JPK_KR_PD(1)_v1-1 — używany do ładowania słowników znaczników kont JPK_KR_PD; sam plik JPK_KR_PD nie jest jeszcze generowany — program generuje klasyczne JPK_KR (1).
  • JPK_ST(1)_v1-2 — JPK środków trwałych. Funkcja w trakcie wdrożenia — obecnie dostępna wyłącznie w trybie deweloperskim (debug build) do celów testowych. Pełna wersja użytkowa planowana w jednym z kolejnych wydań, równolegle z refactorem modułu Środków Trwałych.
  • JPK_ST_KR(1)_v1-0 — schemat referencyjny (JPK_ST dla pełnej księgowości), bez własnego generatora.
  • JPK_MAG(1)_v1-0 — schemat referencyjny (JPK magazynowy), bez własnego generatora.

Generowanie JPK_V7 (M/K)

Wariant M vs K wybierany jest na podstawie ustawienia "VAT-7 kwartalny" podatnika. Plik tworzy się tak samo jak inne e-Dokumenty: w węźle Dokumenty firmy klika się Dodaj, wskazuje typ JPK i klika Wybierz, albo używa przycisku Utwórz JPK z menu nad listą dokumentów księgowych. W oknie pliku JPK wybiera się rok i miesiąc i klika Generuj plik — program buduje XML i pokazuje go w zakładce XML wraz z widokami tabelarycznymi w zakładkach Gridy i Arkusze.

Plik JPK_V7 ma dwie części: ewidencyjną (pozycje rejestrów VAT z oznaczeniami GTU, procedurami, typami dokumentów — RO, WEW, FP, MK itd.) oraz deklaracyjną (odpowiednik VAT-7/VAT-7K). Zakładka Deklaracja VAT-7 pokazuje formularz z polami P_10–P_69; większość pól wylicza się z części ewidencyjnej, ręcznie można zmienić zwrot podatku, przeksięgowanie zwrotu, zwrot z kas fiskalnych i nadwyżkę VAT naliczonego z poprzedniej deklaracji.

Dla JPK_V7K generuje się trzy pliki za kolejne miesiące kwartału; część deklaracyjna jest tylko w pliku za ostatni miesiąc i wyliczana z części ewidencyjnych wszystkich trzech miesięcy (program bierze zawsze najnowszą wersję pliku, także niewysłane jeszcze korekty).

Generowanie JPK_KR

JPK_KR jest dla podatników na pełnej księgowości. Konta planu kont mają trzy pola znaczników z JPK_KR_PD: dwa znaczniki ogólne oraz znacznik PD. Słownik dopuszczalnych wartości (m.in. mapy znaczników dla banków, ubezpieczycieli, domów maklerskich, instytucji finansowych, funduszy emerytalnych, SKOK-ów, pozostałych jednostek i kont PD) ładuje się ze schematu JPK_KR_PD(1)_v1-1.xsd. Znaczniki ustawia się w oknie edycji planu kont (grupa Znaczniki JPK_KR_PD).

Generowanie pozostałych JPK

  • JPK_FA — z faktur sprzedaży. FA(3) i FA(4) wymagają nowego systemu fakturowania, obsługują faktury walutowe (kurs z dnia poprzedzającego wystawienie).
  • JPK_PKPIR — z pozycji KPiR.
  • JPK_EWP — z ewidencji przychodów ryczałtu.
  • JPK_VAT — stara struktura bez deklaracji, obowiązywała do września 2020; obecna dla importu starszych plików.

JPK_PKPIR, JPK_EWP, JPK_FA i JPK_KR składa się tylko na żądanie (kontrola); JPK_V7 obowiązkowo co miesiąc/kwartał.

Wysyłanie do bramki MF

Wysyłka działa z przycisku Wyślij e-Dokument — otwiera okno wysyłki dokumentu. Połączenie z bramką realizowane jest SOAP/HTTPS z wymuszonym TLS 1.2 na adres https://bramka.e-deklaracje.mf.gov.pl/uslugi/dokumenty.

Metody podpisu:

  • certyfikat kwalifikowany z magazynu osobistego Windows (program sprawdza daty ważności certyfikatu),
  • Profil Zaufany przez moj.gov.pl — program zapisuje plik metadanych na dysku, użytkownik podpisuje go w przeglądarce, a program automatycznie wczytuje podpisany plik z domyślnych katalogów (pulpit, pobrane, dokumenty),
  • dane autoryzujące (przychód z PIT za rok bieżący − 2) — dla osób fizycznych podatników VAT; kwota wczytywana automatycznie z zeznania PIT zapisanego w bazie.

Dla biur rachunkowych dostępna jest wysyłka masowa wielu plików jedną akcją (Profil Zaufany wymaga jednak ręcznej akcji w przeglądarce — masowo wysyłane są tylko dokumenty podpisane certyfikatem lub danymi autoryzacyjnymi). UPO pobiera się przyciskiem Poświadczenie odbioru w oknie pliku albo masowo Pobierz UPO z głównego okna programu.

Import JPK

Okno importu JPK wczytuje pliki JPK_VAT, JPK_V7 i JPK_FA z dysku do ewidencji księgowych (menu Narzędzia w widoku Dokumenty księgowe). Identyfikacja typu i wersji jest automatyczna — na podstawie atrybutu kodSystemowy z nagłówka XML. W oknie importu obsługiwane są pliki JPK_VAT i JPK_FA; pozostałe typy (JPK_KR, JPK_PKPIR, JPK_EWP) są dostępne w trybie import/scalanie z samego okna pliku JPK.

Okno daje kontrolę nad zakresem importu: wybór rejestrów VAT docelowych (sprzedaż krajowa, eksport, WDT, NP, NPUE, zakup, zakup ST), ograniczenie do dostaw/nabyć, księgowanie tylko VAT bez wpisu do KPiR, wybór kolumny KPiR dla zakupów, opisy dokumentów, nadawanie oznaczeń GTU_01–GTU_13, MPP, MR_T, MR_UZ, EE, SW, TP, TT_WNT/TT_D, I_42, I_63, B_SPV, B_SPV_DOSTAWA, B_MPV_PROWIZJA, IMP, WSTO_EE, IED i typu dokumentu (FP itp.), filtr dokumentów po prefiksie/sufiksie numeru, pobieranie adresów kontrahentów z JPK_V7 i stosowanie kursów walut z dat sprzedaży.

Typowe scenariusze: przejęcie księgowości z innego programu, łączenie sprzedaży z kilku punktów (scalenie kilku JPK_FA), import dokumentów otrzymanych elektronicznie od kontrahenta.

Walidacja, weryfikacja, scalanie

Przycisk Weryfikuj sprawdza zgodność XML z oficjalnym schematem XSD pobieranym z crd.gov.pl; komunikat wskazuje miejsce błędu.

Przycisk Weryfikuj NIP sprawdza wszystkich kontrahentów z części ewidencyjnej JPK_V7/JPK_VAT na białej liście podatników VAT (krajowi) lub w VIES (kontrahenci UE). Wynik dla każdej pozycji: poprawny / niezarejestrowany / zwolniony / brak danych / błędny NIP.

Scalanie (Importuj z pliku w oknie pliku JPK) działa dla wszystkich generowanych typów (JPK_VAT, JPK_PKPIR, JPK_EWP, JPK_FA, JPK_V7). Pliki muszą być tej samej wersji. Dla JPK_V7 scalana jest tylko część ewidencyjna; deklaracja generuje się od nowa po scaleniu.

Korekty (JPK_V7) i typowe statusy

Korekta to kolejny plik z wartością Cel złożenia = 2 lub wyższą. System MF nie przyjmuje duplikatów — jeżeli korekta dotyczy tylko części ewidencyjnej, przed wysłaniem trzeba skasować część deklaracyjną z pliku; jeżeli tylko deklaracji — usunąć część ewidencyjną. Dla JPK_V7K nie generuje się ponownie niezmienionych części ewidencyjnych za wcześniejsze miesiące kwartału.

Pełna lista statusów: pomoc — kody statusu. Najczęstsze:

  • 120 — sesja zakończona, trwa weryfikacja po stronie MF.
  • 200 — dokument przetworzony, UPO pobrane.
  • 401 — niezgodność ze schematem XSD.
  • 407 — duplikat wysłanego dokumentu (podawany numer referencyjny oryginału).
  • 411 — duplikat części deklaracyjnej w JPK_V7.
  • 419 — błąd w danych autoryzacyjnych (zła kwota przychodu, złe imię/nazwisko).
  • 420 — brak pełnomocnictwa UPL-1.

Wymagania techniczne

  • Windows 10 64-bit lub Windows 11 — starsze systemy nie obsługują pełnego TLS 1.2 wymaganego przez bramki MF.
  • Stałe połączenie z internetem (schematy XSD z crd.gov.pl, weryfikacja NIP, wysyłka i odbiór UPO z bramki MF).
  • Podpis: kwalifikowany certyfikat, Profil Zaufany albo kwota przychodu z PIT za rok bieżący − 2 (tylko osoby fizyczne — podatnicy VAT).
  • Dla biur podpisujących w imieniu klienta — pełnomocnictwo UPL-1 złożone w US (druk dostępny w programie).

Ograniczenia

  • Brak generatora dla JPK_MAG, JPK_ST ani JPK_ST_KR (program zawiera tylko schematy referencyjne tych typów).
  • JPK_KR_PD — schemat służy tylko do ładowania słownika znaczników kont; pełny generator dla JPK_KR_PD nie jest dostępny — generowany jest klasyczny JPK_KR (1).
  • Wysyłka Profilem Zaufanym możliwa tylko z okna pojedynczego pliku — nie działa w trybie wysyłki masowej.
  • Weryfikacja na zgodność z XSD wymaga internetu.
  • Faktury końcowe w JPK_FA mogą wymagać ręcznego sprawdzenia kwoty przychodu po zaksięgowaniu (znany przypadek opisany w pomocy do JPK_FA).

Powiązane