Po co lokalna walidacja XSD?
Bramka Ministerstwa Finansów zwraca często lakoniczne komunikaty błędów, bez wskazania, które pole jest źle wypełnione.
Pre-walidacja XSD sprawdza strukturę pliku w panelu, zanim zostanie zapisany i wysłany. Dostajesz komunikat z nazwą pola i numerem linii — od razu widzisz, co poprawić.
Które dokumenty są sprawdzane
| Dokument | Wariant | Kiedy |
|---|---|---|
| JPK_V7M / V7K | (2) / (3) wg okresu | przy Generuj — przy błędzie plik nie powstaje |
| JPK_EWP | (1) / (3) / (4) wg roku | przy generowaniu |
| JPK_PKPIR | (1) / (2) / (3) wg roku | przy generowaniu |
| JPK_ST | (1) | przy generowaniu |
| PIT-28 | (25) | przed wysyłką |
| PIT-36 | (32) | przed wysyłką |
| PIT-36L | (21) | przed wysyłką |
| VAT-UE, VAT-UEK | (5) | przy zapisie formularza |
| VAT-8 | (11) / (12) wg okresu | przy zapisie formularza |
| VAT-9M | (10) / (11) wg okresu | przy zapisie formularza |
| VIU-DO (OSS), VII-DO (IOSS) | (2) | przed wysyłką |
| VIU-R | (4) | przy zapisie zgłoszenia |
| KEDU (ZUS) | 5.3 | przy eksporcie |
Wyjątki
- JPK_FA(4) (eksport z listy dokumentów) — sprawdzany jest tylko pierwszy plik, a błędy trafiają wyłącznie do dziennika serwera. Nie blokują pobrania i nie są pokazywane na ekranie.
- JPK_MAG(2) — plik nie jest sprawdzany schematem.
- Załącznik PIT/B jest dołączany do pliku PIT-36 i PIT-36L; PIT-28/B nie jest dołączany do wysyłanego pliku PIT-28.
Wariant dobiera się sam — wg okresu rozliczenia
Nie wybierasz wersji struktury — panel ustala ją z roku (lub miesiąca), którego dotyczy dokument:
| Dokument | Kiedy który wariant |
|---|---|
| JPK_EWP | od 2026 → (4); 2022–2025 → (3); wcześniej → (1) |
| JPK_PKPIR | od 2026 → (3); 2017–2025 → (2); wcześniej → (1) |
| JPK_V7M / V7K | od lutego 2026 → (3); wcześniej → (2) |
| VAT-8 / VAT-9M | od marca 2025 → (12) / (11); wcześniej → (11) / (10) |
Dzięki temu korekta za stary okres idzie na strukturze obowiązującej wtedy, a bieżące rozliczenie na najnowszej.
Skąd są schematy
Oficjalne schematy XSD pochodzą z Centralnego Repozytorium Wzorów Dokumentów (crd.gov.pl) i są przechowywane w panelu, więc sprawdzenie trwa chwilę i nie zależy od dostępności serwerów MF.
Co dostajesz w razie błędu?
Komunikat w formie:
Plik PIT-28 nie przeszedł walidacji XSD:
Element '{http://crd.gov.pl/wzor/2023/02/06/12109/}KodUrzedu':
[facet 'enumeration'] The value '0000' is not an element of the set
{'0202', '0203', '0204', ...} (linia 8)
Czytasz: pole KodUrzedu, wartość 0000 nie jest dozwolona — musi być kodem urzędu z listy MF. Ustawiasz go w Ustawienia → Dane sprzedawcy, sekcja Dane do e-deklaracji (albo w polu Urząd Skarbowy formularza JPK).
Najczęstsze błędy
KodUrzedu ‘0000’ — nie wybrano urzędu skarbowego. Uzupełnij go w Ustawienia → Dane sprzedawcy.
NIP w złym formacie — musi mieć 10 cyfr. Sprawdź, czy w NIP-ie firmy lub kontrahenta nie ma litery wpisanej przez pomyłkę.
Błędna data urodzenia — uzupełnij datę urodzenia w danych do e-deklaracji.
Brak wpisów (JPK_EWP, JPK_PKPIR) — schemat wymaga co najmniej jednego wiersza. Przy pustym okresie panel nie generuje pliku i pokazuje komunikat „Brak wpisów w …”.
Czy mogę wyłączyć walidację?
Nie — to zabezpieczenie przed wysłaniem błędnego pliku do urzędu.