JPK VAT-7 wzór — poradnik praktyczny 2026 | KluczeSoft

JPK VAT-7 wzór — poradnik praktyczny 2026

Centralny wzór dokumentu JPK_V7M (dla dużych podatników) oraz JPK_V7K (dla małych i średnich podatników, składających deklaracje kwartalnie) został opublikowany w Rozporządzeniu Ministra Finansów z dnia 15 października 2019 r. w sprawie szczegółowego zakresu danych zawartych w deklaracjach podatkowych i w ewidencji w zakresie podatku od towarów i usług (Dz.U. 2019 poz. 1988, z późniejszymi zmianami). Wersja obowiązująca na rok 2026 jest dostępna w Repozytorium Ministerstwa Finansów, które zamieszcza nie tylko tekst jednolity, ale też oficjalne struktury logiczne w formacie XSD oraz pliki przykładowe XML. Przedsiębiorca potrzebuje tego wzoru z kilku powodów: aby dostosować własne oprogramowanie księgowe do generowania plików zgodnych ze schemą, aby sprawdzić poprawność wygenerowanego pliku przed wysyłką do systemu e-Urząd Skarbowy, a także po to, by zrozumieć, które pola są obowiązkowe, a które warunkowe. W niniejszym poradniku omawiamy, gdzie znaleźć oficjalny wzór struktury, jakie błędy najczęściej dyskwalifikują plik, jak rozłożyć nawiasy w części deklaracyjnej oraz jak interpretować najtrudniejsze pola, takie jak oznaczenia GTU, procedury szczególne czy korekty międzynarodowe. Artykuł ma charakter ściśle praktyczny: zaczynamy od pobrania wzoru, potem przechodzimy do logiki pól, a na końcu odpowiadamy na najczęściej wyszukiwane pytania z wyszukiwarki Google.

Gdzie znaleźć oficjalny wzór JPK_VAT-7 i jak go czytać

Podatnicy składają od 1 października 2020 roku dwa typy plików: JPK_V7M za okresy miesięczne oraz JPK_V7K za okresy kwartalne. Wzór, czyli struktura logiczna, został wyrażony w języku XML Schema Definition, a Ministerstwo Finansów udostępnia go w publicznym repozytorium pod adresem www.podatki.gov.pl w zakładce JPK. Pliki XSD opisują, jakie elementy mogą znaleźć się w pliku XML, jaka jest ich kolejność, które są obowiązkowe (minOccurs=1), a które fakultatywne (minOccurs=0). Wzór określa również dopuszczalne wartości dla oznaczeń takich jak MPP, GTU czy typ dokumentu. W roku 2026 schemat został zaktualizowany o nowe pola związane z procedurą SME (szczególna procedura dla małych przedsiębiorstw w handlu transgranicznym) oraz o oznaczenie "WSTO_EE" dla magazynów typu call-off stock – obie zmiany weszły w życie wraz z pakietem SLIM VAT 4 z dniem 1 stycznia 2026.

Jak czytać wzór? Plik XSD nie jest dokumentem, który przegląda się wygodnie w Notatniku. Najlepiej otworzyć go w edytorze XML lub w dedykowanych narzędziach, które zamieniają schemę na drzewo graficzne. Kluczowe są trzy przestrzenie robocze: nagłówek (KodFormularza, WariantFormularza, data), część deklaracyjna (pozycje od P_10 do P_69, odzwierciedlające starą deklarację VAT-7) i część ewidencyjna (zakupy i sprzedaż w podziale na znaczniki GTU, procedury, dowody). Osoba odpowiedzialna za przygotowanie pliku musi wiedzieć, że część ewidencyjna to nie są zwykłe sumy księgowe — każdy dokument sprzedaży i zakupu musi być raportowany osobno, ze wskazaniem numeru NIP kontrahenta (lub kodu kraju dla transakcji zagranicznych), numeru dowodu, daty i podstawy opodatkowania. Wzór wymusza, aby pola kwotowe były podawane bez separatora tysięcy, z dwoma miejscami po przecinku i kropką jako separatorem dziesiętnym — to najczęstsza przyczyna odrzucenia pliku już na etapie walidacji technicznej.

Główne bloki logiczne JPK_V7 — części deklaracyjna i ewidencyjna

Struktura JPK_V7 dzieli się na cztery zasadnicze bloki: nagłówek, podmiot, deklaracja i ewidencja. Nagłówek zawiera wariant formularza (oznaczenie 7 dla deklaracji miesięcznej, 27 dla kwartalnej) oraz cel złożenia: "1" dla złożenia pierwotnego, "2" dla korekty. Podmiot powtarza dane identyfikacyjne podatnika znane z innych formularzy — NIP, nazwa pełna, adres siedziby. Blok deklaracyjny odwzorowuje wszystkie 69 pozycji znanych z dawnej deklaracji VAT-7, przy czym w JPK_V7M i JPK_V7K numeracja pól jest jednolita — od P_10 do P_69. Różnica polega na tym, że w JPK_V7K (kwartalnym) podatnik wypełnia mniejszy podzbiór pól, zaś niektóre pozycje kwartalne rozbija się na miesiące.

Część ewidencyjna składa się z dwóch zbiorów: EwidencjaSprzedazyWiersz i EwidencjaZakupuWiersz. W każdym wierszu sprzedaży podaje się typ dokumentu, numer NIP nabywcy, pełną nazwę kontrahenta, datę sprzedaży, numer dowodu, podstawę opodatkowania i kwotę podatku według stawek, a także kilkanaście opcjonalnych oznaczeń: GTU_01 do GTU_13 (dostawy towarów wrażliwych, świadczenie usług niematerialnych), MPP (mechanizm podzielonej płatności), SW (dostawa w ramach sprzedaży wysyłkowej), TP (transakcje z podmiotami powiązanymi) oraz strumień procedur szczególnych — I_42, I_63, EE, WSTO_EE, procedura marży. Część zakupowa jest prostsza, ale nadal wymaga precyzyjnego oznaczenia transakcji wewnątrzwspólnotowych, importu usług i odwrotnego obciążenia.

Dla programistów integrujących systemy ERP ze strukturą JPK kluczowe znaczenie ma ograniczenie liczby wierszy w jednym pliku: Ministerstwo zaleca, aby ewidencja sprzedaży nie przekraczała 100 000 wierszy w pojedynczej przesyłce, choć technicznie maksymalny rozmiar to 5 GB. W praktyce firmy z dużą liczbą faktur dzielą pliki na części, a następnie łączą je po stronie bramki e-US. Wzór nie przewiduje mechanizmu dzielenia bezpośrednio w XSD, więc jest to kwestia własnej implementacji przez system wysyłkowy.

Pola warunkowe — oznaczenia procedur, GTU i dowodów

Najwięcej problemów w praktyce sprawiają pola warunkowe, czyli takie, które podatnik wypełnia wyłącznie, gdy zaszły określone okoliczności. Wzór XSD definiuje je jako opcjonalne (minOccurs=0), ale po ich wystąpieniu muszą spełniać dodatkowe restrykcje krzyżowe. Weźmy oznaczenie GTU_07 — dotyczy ono dostaw towarów wymienionych w załączniku nr 15 do ustawy o VAT (paliwa, oleje smarowe, niektóre wyroby stalowe). Jeśli podatnik zaznaczy GTU_07, musi również podać numer dokumentu celnego, numer kontenera albo referencję do specyfikacji ładunku, a w przypadku braku tych danych — pozostawić odpowiednie pole puste, ale nie może go pominąć na poziomie struktury XML, bo plik nie przejdzie walidacji XSD.

Podobne zależności występują dla oznaczeń dotyczących procedur szczególnych. Oznaczenie "EE" stosuje się dla transakcji, w których podatnik korzysta z magazynu procedury zawieszenia akcyzy. Od 2026 roku dodano "WSTO_EE" dla transakcji call-off stock, gdzie towary są przemieszczane do magazynu klienta w innym państwie UE przed ostateczną dostawą. Pole to jest warunkowe i uzależnione od istnienia numeru identyfikacyjnego VAT magazynu. Zestawienie wszystkich 32 oznaczeń (13 GTU, 9 procedur, MPP, SW, TP, TT_WNT, TT_D, I_42, I_63, I_27 itd.) wraz z ich definicjami jest dostępne w tabeli załączonej do broszury MF opublikowanej w grudniu 2025 roku.

Typ dokumentu w części ewidencyjnej to pole ograniczone do zamkniętej listy: faktura, faktura korygująca, paragon z NIP, paragon, dokument zbiorczy, nota korygująca i inne. Wzór nie przewiduje wartości "inny dokument" — pomyłka w tym polu to jeden z pięciu najczęstszych błędów odrzucenia pliku. Jeśli system ERP nie generuje odpowiedniego oznaczenia, trzeba je zmapować w warstwie ETL (extract, transform, load) przed wygenerowaniem XML.

Korekta JPK — jak wypełnić cel złożenia i pola korekcyjne

W roku 2026 nie ma już odrębnych formularzy korekcyjnych (dawna VAT-7K). Korektę deklaracji i ewidencji wykonuje się poprzez złożenie nowego pliku JPK_V7 z celem złożenia oznaczonym jako "2". Plik ten musi zawierać pełny, poprawny zestaw danych za dany okres — nie tylko zmienione pozycje, ale całość ewidencji i deklaracji. Wynika to bezpośrednio ze struktury logicznej XSD, która nie posiada pól "przed korektą" i "po korekcie" — zastępuje się po prostu poprzedni plik nowym.

Szczególną uwagę należy zwrócić na pole P_ORDZU — uzasadnienie przyczyn złożenia korekty, które stało się obowiązkowe od 1 lipca 2025 roku. Jest to element typu string o długości od 5 do 200 znaków, który przekazuje się w części deklaracyjnej pliku z celem złożenia "2". Brak tego pola lub tekst krótszy niż 5 znaków powoduje odrzucenie pliku na etapie reguł biznesowych, nawet jeśli walidacja techniczna XSD przebiegła pomyślnie.

Praktyczny schemat korekty wygląda następująco: pobierasz pierwotny plik XML, identyfikujesz błędne wiersze ewidencji (np. zły NIP kontrahenta lub nieprawidłowa stawka), modyfikujesz je, a następnie ponownie walidujesz całość i wysyłasz jako nowe złożenie. System e-US porównuje sumy kontrolne i jeśli nowy plik jest identyczny z poprzednim, odrzuca go jako duplikat. Jeżeli korygujesz tylko jedną pozycję w ewidencji sprzedaży, strukturalnie nadal musisz przesłać kompletny blok EwidencjaSprzedazyWiersz ze wszystkimi niezmienionymi fakturami. Logika "korekty wyłącznie zmienionych pól" nie istnieje w architekturze JPK.

Walidacja pliku przed wysyłką — narzędzia Ministerstwa Finansów i reguły biznesowe

Zanim wyślesz plik do systemu e-Urząd Skarbowy, musisz przejść trzy poziomy walidacji: składniową (czy to w ogóle jest XML), schematyczną (zgodność z XSD) oraz biznesową (reguły wyższe, np. suma podstaw opodatkowania w ewidencji musi zgadzać się z sumą w deklaracji). Dwa pierwsze poziomy można sprawdzić lokalnie, korzystając z bezpłatnego narzędzia Klient JPK WEB, które Ministerstwo Finansów udostępnia na stronie www.podatki.gov.pl. Narzędzie to wczytuje plik XML, porównuje go z aktualną wersją schematu i wyświetla listę błędów w czytelnej tabeli.

Reguły biznesowe są trudniejsze, bo nie wynikają wprost z XSD — to osobna warstwa logiki wbudowana w bramkę odbiorczą. Przykład: jeżeli podatnik w części deklaracyjnej nie wykazał sprzedaży ze stawką 23% (pole P_21 równe zero), to w ewidencji sprzedaży nie może pojawić się ani jeden wiersz ze stawką 23%. Nie jest to sprawdzane przez schemę XSD, ale bramka to wykryje. Wzór tego nie opisuje, więc podatnicy dowiadują się o tych regulacjach dopiero po odrzuceniu pliku.

Pełny katalog reguł biznesowych — obecnie zawierający 187 ograniczeń — został opublikowany jako załącznik do specyfikacji technicznej JPK w grudniu 2025 roku i jest dostępny w Repozytorium MF. Najważniejsza rada praktyczna: przed każdą wysyłką uruchom walidację lokalną w Kliencie JPK WEB, zapisz raport w PDF, a następnie porównaj sumy kwot z własnym systemem księgowym. Dopiero przy pełnej zgodności przechodzisz do wysyłki.

Schemat komunikacji z e-US — uwierzytelnianie, podpisywanie i UP

Wysłanie pliku JPK_V7 do systemu e-US wymaga profilu zaufanego, podpisu kwalifikowanego lub podpisu osobistego. Plik XML nie jest podpisywany bezpośrednio — znakuje się cały komunikat wysyłany do bramki, którego częścią jest plik JPK. Ministerstwo udostępnia interfejs REST API, który akceptuje żądania POST z załącznikiem binarnym oraz tokenem autoryzacyjnym OAuth 2.0. Alternatywnie, dla mniej zaawansowanych użytkowników dostępna jest wysyłka przez formularz webowy w e-US, gdzie plik XML przeciąga się metodą "drag and drop".

Po wysłaniu pliku system generuje Unikalny Numer Referencyjny — UP (dawniej UPO), który jest dowodem złożenia deklaracji. Jeśli nie otrzymałeś UP w ciągu 5 minut, plik trafił do kolejki przetwarzania i może zostać odrzucony w ciągu 24 godzin roboczych. Wzór nie obejmuje mechanizmu statusów "w trakcie przetwarzania", dlatego podatnik musi samodzielnie monitorować stan złożenia przez panel e-US. System nie wysyła powiadomień e-mail o odrzuceniu — to kolejna pułapka, w którą wpada wiele firm.

Znaczniki GTU a odpowiedzialność karno-skarbowa — dlaczego precyzja ma znaczenie

Oznaczenia GTU (od GTU_01 do GTU_13) nie są technicznym szczegółem, który można zignorować "bo program księgowy ustawi domyślnie". Są to znaczniki przypisane do towarów i usług objętych szczególnym nadzorem fiskalnym — od wyrobów stalowych (GTU_07) przez paliwa (GTU_02) po usługi budowlane (GTU_06). Wzór XSD wymusza, aby każde oznaczenie GTU miało wartość logiczną: "true" lub "false", ale wprowadza również ograniczenie, że nie można zaznaczyć GTU_06 jednocześnie z GTU_02 na tym samym wierszu ewidencji (reguła biznesowa nr 114).

Błąd w oznaczeniach GTU — na przykład pominięcie GTU_12 dla dostawy sprzętu elektronicznego do odbiorcy zagranicznego, który podlega procedurze szczególnej — naraża podatnika nie tylko na odrzucenie pliku, ale także na sankcje z Kodeksu karnego skarbowego. W 2025 roku Ministerstwo Finansów zwiększyło częstotliwość kontroli krzyżowych GTU na podstawie analiz big data porównujących deklaracje różnych podatników biorących udział w tym samym łańcuchu dostaw. Dlatego mapowanie towarów z kartoteki magazynowej na oznaczenia GTU powinno być zautomatyzowane i audytowane co najmniej raz na kwartał.

Zmiany w JPK_V7 na rok 2026 — co nowego w schemacie

Rok 2026 przyniósł kilka modyfikacji struktury, które mogą zaskoczyć podatników aktualizujących swoje systemy dopiero teraz:

WSTO_EE — nowe oznaczenie w części ewidencyjnej dla transakcji call-off stock, obowiązkowe dla dostaw z magazynów konsygnacyjnych na terenie UE.
SME — znacznik aktywowany dla podatników korzystających z unijnej procedury szczególnej dla małych przedsiębiorstw, która od stycznia 2026 objęła polskich podatników oferujących usługi cyfrowe odbiorcom z UE.
P_ORDZU — pole uzasadnienia korekty weszło do obowiązkowej walidacji.
KodKrajuNadaniaTIN — nowy element opcjonalny w ewidencji zakupów dla dostaw wewnątrzwspólnotowych, niezależny od istniejącego pola KodKraju.
DT_OD i DT_DO — data obowiązywania deklaracji miesięcznej może teraz obejmować okres krótszy niż pełny miesiąc w przypadku podatników, którzy zakończyli działalność w trakcie miesiąca.

Wszystkie te zmiany zostały uwzględnione w schemacie XSD w wersji 4.2, opublikowanej 15 grudnia 2025 roku. Podatnicy, którzy korzystają z oprogramowania księgowego niezaaktualizowanego do wersji 4.2, powinni wykonać migrację najpóźniej przed pierwszą wysyłką pliku za styczeń 2026.

Częste pytania

1. Czym różni się JPK_V7M od JPK_V7K w warstwie wzoru?

Różnica leży wyłącznie w wariancie formularza (pole WariantFormularza = 7 dla miesięcznego, = 27 dla kwartalnego) oraz w podzbiorze wypełnianych pól w deklaracji — ale schemat XSD jest ten sam. Jest to pojedyncza struktura, a nie dwa oddzielne pliki wzorów.

2. Gdzie dokładnie pobrać plik XSD na rok 2026?

Oficjalna strona to www.podatki.gov.pl > E-deklaracje > JPK_VAT > Pliki do pobrania. Bezpośredni URL zmienia się przy każdej aktualizacji, dlatego nie podajemy stałego linku. W katalogu zobaczysz plik JPK_V7_v4-2.xsd (aktualny na 2026), a także dokumentację w PDF.

3. Czy mogę wygenerować JPK_V7 z Excela, posługując się wzorem?

Technicznie tak — Excel pozwala zapisać dane jako XML, jeśli zdefiniujesz mapowanie XML na podstawie pobranego pliku XSD. Jest to jednak ryzykowne dla firm z więcej niż 50 fakturami miesięcznie, bo Excel nie sprawdza poprawności reguł biznesowych i łatwo przeoczyć wymagany znacznik GTU.

4. Co zrobić, jeśli plik przechodzi lokalną walidację XSD, ale e-US go odrzuca?

Prawdopodobnie naruszyłeś regułę biznesową spoza schematu. Pobierz raport błędów z panelu e-US i porównaj numery błędów (np. "ERR_JPK_0142") z katalogiem reguł biznesowych opublikowanym przez MF. Najczęstsze przyczyny: niezgodność sum w deklaracji i ewidencji, pominięty NIP kontrahenta dla transakcji krajowej, błąd w oznaczeniu typu dokumentu.

5. Jak długo przechowywać wygenerowany plik JPK_V7 i dowód UP?

Plik JPK_V7 i UP należy przechowywać przez 5 lat, licząc od końca roku kalendarzowego, w którym upłynął termin płatności podatku za dany okres — czyli maksymalnie do 6 lat od złożenia. Kopia pliku w formacie XML jest jedynym akceptowanym dowodem w trakcie kontroli skarbowej.

6. Czy muszę raportować faktury zaliczkowe w osobnych wierszach ewidencji?

Tak. Każda faktura zaliczkowa stanowi osobny wiersz w bloku EwidencjaSprzedazyWiersz. Faktura końcowa nie sumuje zaliczek — podaje się w niej różnicę pomiędzy wartością całkowitą a już zadeklarowanymi zaliczkami. To częsta pułapka przy ręcznej integracji z programem fakturowym.

7. Co oznacza pole "WartoscPln" w kontekście faktur walutowych?

Dla każdej transakcji w walucie obcej należy podać trzy wartości: kwotę w walucie obcej, kwotę w PLN po przeliczeniu według kursu z dnia poprzedzającego dzień powstania obowiązku podatkowego (metoda standardowa NBP) oraz typ kursu (KodWaluty, KursWaluty). Wzór oczekuje KursWaluty jako liczby dziesiętnej z pięcioma miejscami po przecinku.

8. Czy nadal muszę oznaczać paragony do 450 zł jako "RO"?

Nie. Oznaczenie "RO" (dokument zbiorczy dla paragonów) dotyczy wyłącznie sprzedaży paragonowej, gdzie podatnik wystawia jeden dokument zbiorczy na koniec dnia zawierający łączną wartość sprzedaży z paragonów, z których żaden nie przekracza 450 zł i które nie zostały wystawione na rzecz podatnika z NIP.

9. Co to jest pole "LpOd" i "LpDo" w nagłówku ewidencji?

Są to opcjonalne pola określające odpowiedź na pytanie, z którego systemu ERP pochodzi dany zakres wierszy, jeśli ewidencja jest łączona z kilku oddziałów. Nie służą do dzielenia plików na części — to odrębna kwestia techniczna nieopisana w XSD.

10. Gdzie znaleźć pomoc, gdy samodzielna walidacja nie daje rezultatu?

Jeżeli wyczerpałeś ścieżkę Klient JPK WEB → katalog reguł biznesowych → dokumentacja MF, a plik nadal jest odrzucany, warto rozważyć profesjonalny audyt przygotowania JPK. Specjaliści KluczeSoft oferują wsparcie w zakresie dostosowania struktury pliku XML do wymogów fiskalnych roku 2026, obejmujące analizę błędnych wierszy, mapowanie pól systemu ERP na oznaczenia GTU oraz symulację wysyłki testowej przed faktycznym złożeniem do e-US.

Sprawdź też

Potrzebujesz licencji? Microsoft Office — sprawdź ofertę KluczeSoft.pl — legalne klucze, faktura VAT, dostawa e-mail.