Walidacja przed wysyłką
Niezgodność ze schemą XSD lepiej zobaczyć u siebie niż w odpowiedzi bramki.
Walidacja XSD to porównanie wygenerowanego pliku z oficjalną schemą Ministerstwa Finansów: czy są wszystkie wymagane elementy, w wymaganej kolejności, w wymaganym formacie i w obowiązującej wersji struktury. SimplyTax robi to przed wysyłką i pokazuje wynik na ekranie razem z podglądem XML — a nie po fakcie, w komunikacie zwrotnym.
Co walidacja dowodzi, a czego nie
Walidacja względem XSD dowodzi jednej rzeczy: struktura pliku jest zgodna ze schemą. To dużo, bo odsiewa całą klasę odrzuceń, których przyczyna leży w pliku. I jednocześnie mało, bo o przyjęciu przesyłki przez bramkę decyduje również to, kto ją podpisał i czy miał do tego prawo. To dwa niezależne warunki i pokazujemy je osobno, zamiast obiecywać wynik.
Nie jest to zastrzeżenie na wszelki wypadek. Zakres pełnomocnictwa zmienił się w połowie 2026 roku, i to jest właśnie ten drugi warunek:
Od 16 czerwca 2026 r. pełnomocnictwo UPL-1 do podpisywania deklaracji składanych elektronicznie obejmuje również upoważnienie do podpisywania plików JPK_KR_PD i JPK_ST_KR.
Dlatego zgodność ze schemą nie przesądza o przyjęciu pliku: uprawnienie do wysyłki jest odrębnym warunkiem.
Sprawdzone 6 sierpnia 2026 · Ministerstwo Finansów, Aktualizacja broszury informacyjnej JPK_ST_KR(1) – aktualna od 01.07.2026 r.
Wersja schemy: przyczyna, o której najłatwiej zapomnieć
Numer wersji nie jest szczegółem technicznym. Plik zbudowany według wycofanej wersji nie przejdzie walidacji, a jeżeli nikt nie sprawdza tego u siebie, informacja przychodzi dopiero z bramki. Struktury nie zmieniają się przy tym równo: jedna dostała nową wersję, druga została na poprzedniej. Ta asymetria jest realnym źródłem pomyłek.
JPK_KR_PD(1), wersjaSchemy 1-1
Zmieniła się wartość atrybutu wersjaSchemy; samo wydanie struktury pozostaje bez zmian.
Sprawdzone 6 sierpnia 2026 · Ministerstwo Finansów, Aktualizacja broszury informacyjnej JPK_KR_PD(1) – aktualna od 01.07.2026 r., sekcja B
JPK_ST_KR(1), wersjaSchemy 1-0
Wersje obu struktur są różne: JPK_KR_PD podniesiono do 1-1, JPK_ST_KR pozostał w 1-0. Ta asymetria jest myląca i łatwo o pomyłkę.
Sprawdzone 6 sierpnia 2026 · Ministerstwo Finansów, Broszura informacyjna dotycząca struktury JPK_ST_KR(1)
JPK_V7M(3) – crd.gov.pl/wzor/2025/12/19/14089/; JPK_V7K(3) – crd.gov.pl/wzor/2025/12/19/14090/
Korekty za okresy sprzed lutego 2026 r. składa się nadal w poprzedniej wersji struktury.
Sprawdzone 6 sierpnia 2026 · Ministerstwo Finansów, Portal podatkowy – JPK_VAT z deklaracją, Pliki do pobrania
wersja systemu 5.5.1, wersja dokumentu 5.5.1.v2, 05.08.2026
Sprawdzone 6 sierpnia 2026 · Ministerstwo Finansów, Portal podatkowy – Pliki do pobrania JPK_PD
Cała różnica bywa na dwóch znakach
Poniżej fragment nagłówka JPK_KR_PD w dwóch wersjach. Zawartość merytoryczna pliku jest w obu identyczna — dziennik, księga główna i zestawienie obrotów i sald są te same. Walidator zatrzymuje się na atrybucie wersjaSchemy.
<Naglowek>
<KodFormularza wersjaSchemy="1-0">JPK_KR_PD</KodFormularza>
<WariantFormularza>1</WariantFormularza>
</Naglowek>Wartość, która obowiązywała wcześniej. Reszta pliku może być bez zarzutu i nie ma to znaczenia — walidacja kończy się tutaj.
<Naglowek>
<KodFormularza wersjaSchemy="1-1">JPK_KR_PD</KodFormularza>
<WariantFormularza>1</WariantFormularza>
</Naglowek>Struktura pozostaje w wydaniu (1) — zmienia się sam atrybut. Plik przechodzi walidację strukturalną i może iść dalej: do podpisu i do bramki.
Jak to wygląda u nas
Sprawdzenie jest osobnym przyciskiem obok generowania, więc plik można zwalidować, zanim ktokolwiek pomyśli o wysyłce. Wynik i podgląd XML stoją na jednym ekranie.
JPK_KR_PD
księgi rachunkowe / podatek dochodowy<class="text-brand-text">JPK xmlns="http://crd.gov.pl/wzor/2024/…"> <class="text-brand-text">Naglowek> <class="text-brand-text">KodFormularza wersjaSchemy="1-1">JPK_KR_PD</class="text-brand-text">KodFormularza> <class="text-brand-text">WariantFormularza>1</class="text-brand-text">WariantFormularza> <class="text-brand-text">CelZlozenia>1</class="text-brand-text">CelZlozenia> </class="text-brand-text">Naglowek> <class="text-brand-text">Podmiot1> <class="text-brand-text">IdentyfikatorPodmiotu> <class="text-brand-text">NIP>1234567890</class="text-brand-text">NIP> </class="text-brand-text">IdentyfikatorPodmiotu> </class="text-brand-text">Podmiot1></class="text-brand-text">JPK>Sześć przyczyn, które wracają najczęściej
Żadna z nich nie jest błędem księgowym. Wszystkie powstają na styku systemu źródłowego z formatem, którego ten system nigdy nie miał produkować.
Wycofana wersja struktury
Ministerstwo podnosi wersję schemy, generator zostaje przy poprzedniej. Plik bywa poprawny w każdym innym wymiarze i mimo to nie przechodzi.
Brak wymaganego elementu
Schema określa, które węzły muszą wystąpić i ile razy. Pole puste w systemie źródłowym zamienia się po drodze w element, którego w pliku nie ma.
Kolejność węzłów
Schema opisuje sekwencję, nie zbiór. Elementy poprawne, ale zamienione miejscami, są błędem dokładnie tak samo jak brakujące.
Format identyfikatora
NIP z myślnikami, ze spacją albo z przedrostkiem kraju. Wartość jest prawdziwa, tylko nie pasuje do wzorca zapisanego w schemie.
Wartość spoza słownika
Kod urzędu, kod kraju, kod waluty. Schema dopuszcza zamkniętą listę, a system źródłowy potrafi oddać dowolny ciąg znaków.
Kodowanie i znaki sterujące
Plik zapisany w innym kodowaniu, niż deklaruje, znacznik BOM na początku albo znak sterujący przeniesiony z opisu operacji. Parser zatrzymuje się na pierwszym bajcie, którego nie rozumie.
Gdzie w tym jesteśmy my
Walidator XSD sam w sobie nie jest niczym wyjątkowym — Ministerstwo udostępnia schemy, a sprawdzić plik potrafi każde porządne narzędzie. Różnica jest w momencie i w tym, co widać na ekranie.
- Krok 1
Sprawdzenie przed wysyłką
Plik jest porównywany z oficjalną schemą MF zanim opuści platformę. Wynik jest stanem pliku w historii, a nie jednorazowym komunikatem, który zniknie po odświeżeniu.
- Krok 2
Podgląd XML w miejscu błędu
Komunikat walidatora bez pliku obok niego jest wskazówką, nie odpowiedzią. Podgląd XML pokazuje fragment, którego dotyczy błąd, więc pytanie „co konkretnie jest nie tak” zamyka się na jednym ekranie.
- Krok 3
Powtórka bez konsekwencji
Poprawiony plik można wygenerować i sprawdzić ponownie, a cały cykl razem z wysyłką przejść wcześniej na bramce testowej Ministerstwa. Pierwsza wysyłka nie musi być pierwszą wysyłką.
Czego walidacja nie sprawdzi
Zgodności danych z księgami. Plik idealnie zgodny ze schemą, w którym saldo nie zgadza się z zestawieniem obrotów i sald, przejdzie walidację bez jednej uwagi — schema opisuje format, nie treść. To jest pytanie do uzgodnienia danych po stronie źródła, a nie do walidatora, i nikt nie powinien sprzedawać Państwu tego inaczej.
Nie sprawdzi też uprawnień do wysyłki. Zgodność ze schemą i prawo do podpisania pliku to dwa osobne warunki i spełnienie pierwszego nie mówi nic o drugim.
Jeżeli składają Państwo jeden plik rocznie z jednej spółki, bezpłatny Klient JPK_WEB Ministerstwa również waliduje i wysyła. Nie będziemy udawać, że jest inaczej.
Walidacja to połowa drogi
Zgodny plik trzeba jeszcze wysłać, odebrać numer referencyjny, sprawdzić status i pobrać UPO — bo to UPO, a nie XML, jest dokumentem, o który pyta kontrola. Najszybszy sposób, żeby sprawdzić, gdzie w tym łańcuchu jest Państwa spółka, to wziąć już wygenerowany plik i puścić go przez walidację.