Walidator KSeF – Sprawdź plik XML FA(3) przed wysłaniem do systemu

Walidator KSeF to narzędzie, które analizuje plik XML faktury ustrukturyzowanej i weryfikuje jego zgodność ze schematem FA(3) Ministerstwa Finansów – zanim wyślesz go do Krajowego Systemu e-Faktur. W przeciwieństwie do płatnych rozwiązań, nasz darmowy walidator KSeF na SystemFaktur.pl działa w 100% w Twojej przeglądarce: żadne dane nie opuszczają Twojego komputera, nie wymagamy rejestracji ani logowania. Sprawdzamy ponad 100 reguł walidacji, w tym format NIP, kody GTU, oznaczenia MPP, strukturę pozycji fakturowych i zgodność kwot netto/brutto/VAT.

Faktura w KSeF to nie PDF ani skan. To ściśle sformatowany plik XML zgodny ze strukturą logiczną FA(3) – obowiązującą od 1 lutego 2026 roku. Każde pole musi być wypełnione dokładnie tak, jak określa schemat XSD opublikowany przez MF. Jeden błąd w formacie NIP, jeden nieprawidłowy kod GTU albo brakujące pole – i KSeF odrzuca cały dokument.

Dlaczego walidacja jest absolutnie konieczna w 2026 r.?

W Polsce od 1 kwietnia 2026 roku KSeF jest obowiązkowy dla wszystkich przedsiębiorców (dla największych firm obowiązek startował 1 lutego 2026). Oznacza to, że każda faktura B2B musi przejść przez system rządowy.

Konsekwencje odrzucenia faktury przez KSeF są poważne:

• •Nabywca traci prawo do odliczenia VAT – bo faktura bez numeru KSeF i UPO nie jest podstawą do odliczenia
• •Opóźnienie płatności – kontrahent, który nie ma poprawnej faktury, może wstrzymać płatność
• •Ryzyko kary finansowej – za przekroczenie terminu przesłania faktury w trybie awaryjnym (100% kwoty VAT za każdy dzień zwłoki)
• •Komplikacje w rozliczeniu VAT – niezaakceptowana faktura nie trafia do ewidencji sprzedaży w systemie MF
• •Czas na poprawki – znalezienie błędu po fakcie, gdy faktura już powinna być w systemie, kosztuje czas i nerwy

Co dokładnie sprawdza walidator KSeF FA(3)?

Schemat FA(3) jest rozbudowany – zawiera setki pól, z których 37 jest obowiązkowych (o 11 więcej niż w FA(2)). Walidator KSeF sprawdza następujące warstwy:

Struktura XML i przestrzenie nazw

Plik musi być poprawnym dokumentem XML z prawidłowymi przestrzeniami nazw (namespace) zgodnymi ze schematem FA(3). Błędne zagnieżdżenie elementów, brakujące tagi zamykające czy nieprawidłowe namespace powodują natychmiastowe odrzucenie.

Pola obowiązkowe w FA(3)

Walidator sprawdza obecność wszystkich 37 pól obowiązkowych. Główne sekcje faktury:

• •Nagłówek (P_1–P_6) – data wystawienia, numer faktury, waluta (obowiązkowe)
• •Podmiot1 (Sprzedawca) – NIP, nazwa, adres AdresL1/AdresL2 (obowiązkowe)
• •Podmiot2 (Nabywca) – NIP lub PESEL, nazwa, adres (obowiązkowe)
• •Fa (wiersze faktury) – nazwa towaru/usługi, ilość, cena netto, stawka VAT, PKWiU (obowiązkowe)
• •Rozliczenie (sumy VAT) – kwoty netto, VAT i brutto per stawka (obowiązkowe)
• •Platnosc – termin płatności, forma, numer rachunku (do 10 kont) – opcjonalne/kontekstowe
• •Kody GTU – GTU_01 do GTU_13 dla towarów objętych obowiązkiem – opcjonalne/kontekstowe
• •FakturaZaliczkowa – numer KSeF faktury zaliczkowej, do 100 pozycji (fakultatywne)
• •DodatkowyOpis – opisy do 512 znaków (fakultatywne)

Formaty danych – tu ginie najwięcej faktur

FA(3) wymaga ściśle określonych formatów:

• •NIP: 10 cyfr bez kresek (np. 1234567890, nie 123-456-78-90)
• •Daty: format ISO 8601 – RRRR-MM-DD (np. 2026-04-01, nie 01.04.2026)
• •Kwoty: bez separatorów tysięcy, z kropką jako separatorem dziesiętnym (np. 1234.56, nie 1 234,56)
• •Kodowanie: wyłącznie UTF-8 – polskie znaki diakrytyczne muszą być poprawnie zakodowane
• •Długość pól tekstowych: do 256 znaków co do zasady; Nazwa, AdresL1/L2, P_7 – do 512 znaków

Reguły biznesowe

• •Suma kwot VAT z wierszy musi zgadzać się z podsumowaniem w sekcji Rozliczenie
• •Data wystawienia nie może być wcześniejsza niż data przesłania do KSeF (zakaz daty wstecznej od 1.02.2026)
• •Kod GTU musi być zgodny z listą GTU_01–GTU_13 i stosowany dla odpowiednich grup towarowych
• •PKWiU obowiązkowy dla towarów objętych kodami GTU (transakcje powyżej określonego progu)

Najtrudniejsze pola w FA(3) – gdzie najczęściej są błędy

Na podstawie praktyki użytkowników SystemFaktur.pl wyróżniamy pola generujące najwięcej błędów walidacji:

NIP – numer 1 przyczyna odrzuceń

Systemy księgowe eksportują NIP z myślnikami lub spacjami. FA(3) akceptuje wyłącznie 10 cyfr bez separatorów. Walidator KSeF natychmiast wykryje format 123-456-78-90 zamiast 1234567890.

Kody GTU – kiedy są obowiązkowe?

GTU (Grupy Towarowo-Usługowe) obowiązują dla określonych kategorii towarów i usług. Najczęstsze grupy:

• •GTU_01 – napoje alkoholowe
• •GTU_02 – paliwa do napędu samochodów
• •GTU_03 – olej opałowy, oleje smarowe
• •GTU_07 – pojazdy samochodowe i naczepy
• •GTU_10 – budynki, budowle lub ich części
• •GTU_12 – usługi niematerialne (doradztwo, prawne, IT)
• •GTU_13 – transport i gospodarka magazynowa

PKWiU – nowa pułapka FA(3)

W FA(3) kod PKWiU stał się obowiązkowy dla towarów i usług objętych GTU oraz przy transakcjach przekraczających 100 000 zł. Brak kodu PKWiU skutkuje odmową nadania numeru KSeF.

Sumy kontrolne

Kwota brutto = kwota netto + VAT. Oczywiste, ale systemy z zaokrągleniami po każdej pozycji mogą generować różnicę 1 grosza w podsumowaniu. Walidator KSeF wykryje taką niespójność.

.

Najczęstsze błędy i kody odrzucenia – lista z przykładami

KSeF zwraca kody błędów przy odrzuceniu pliku. Oto najczęściej spotykane:

• •INVALID_NIP – NIP zawiera myślniki, spacje lub ma złą liczbę cyfr. Poprawny format: 10 cyfr bez separatorów.
• •INVALID_DATE – data w formacie DD.MM.RRRR zamiast RRRR-MM-DD.
• •MISSING_FIELD – pominięto jedno z 37 pól wymaganych w FA(3). Najczęściej: brak PKWiU lub kodu GTU.
• •INVALID_GTU – kod GTU nie należy do listy GTU_01–GTU_13 albo jest wymagany, a go brakuje.
• •AMOUNT_MISMATCH – suma kwot netto z pozycji nie zgadza się z podsumowaniem (błąd zaokrągleń).
• •ENCODING_ERROR – plik nie jest w UTF-8, polskie znaki zakodowane błędnie (np. ISO-8859-2).
• •INVALID_VAT_RATE – użyto wartości spoza dozwolonego zbioru: 23, 8, 5, 0, zw, np, oo.
• •NAMESPACE_ERROR – plik zawiera namespace FA(2) zamiast FA(3) lub przestrzeń nazw pominięta.
• •FILE_TOO_LARGE – plik bez załączników przekracza 1 MB. Z załącznikami (FA(3)) – limit 3 MB.

Walidacja lokalna vs. weryfikacja przez KSeF – kluczowe różnice

To rozróżnienie jest bardzo ważne. Wiele osób myśli, że walidacja to jedno – a jest kilka warstw:

Bez walidacji lokalnej

• •Wysyłasz plik prosto do KSeF
• •Czekasz na odpowiedź systemu MF
• •KSeF odrzuca plik z kodem błędu
• •Musisz poprawić i wysłać ponownie
• •Straciłeś czas, faktura spóźniona
• •Ryzyko kar za przekroczenie terminu

Z walidacją lokalną (XSD)

• •Sprawdzasz plik w przeglądarce w sekundy
• •Widzisz dokładnie, które pole jest błędne
• •Poprawiasz przed wysłaniem
• •Wysyłasz do KSeF plik bez błędów strukturalnych
• •Znacznie mniejsze ryzyko odrzucenia
• •Plik nie opuszcza Twojego urządzenia – bezpiecznie

Lokalna walidacja XSD sprawdza: strukturę XML, pola obowiązkowe, formaty danych, namespace i rozmiar pliku. Nie sprawdza: reguł biznesowych KSeF, unikalności numeru faktury, poprawności szyfrowania sesji AES.

Jak krok po kroku zwalidować fakturę FA(3)?

• •Krok 1: Wygeneruj plik XML FA(3) z systemu – upewnij się, że Twój program eksportuje w formacie FA(3), nie FA(2). Sprawdź namespace w nagłówku pliku.
• •Krok 2: Otwórz walidator KSeF w przeglądarce – przejdź na SystemFaktur.pl. Nie musisz się logować ani rejestrować.
• •Krok 3: Wgraj lub wklej plik XML – możesz przeciągnąć plik, kliknąć i wybrać z dysku, albo wkleić zawartość bezpośrednio.
• •Krok 4: Uruchom walidację i przeczytaj raport – każdy błąd zawiera numer linii, nazwę pola i opis z sugestiami poprawki.
• •Krok 5: Popraw błędy w systemie fakturującym – nie edytuj pliku XML ręcznie, ryzykujesz nowe błędy.
• •Krok 6: Powtórz walidację do pierwszego „OK" – dopiero wtedy jesteś gotowy do wysłania.
• •Krok 7: Wyślij plik do KSeF i zachowaj UPO – Urzędowe Poświadczenie Odbioru to dowód przyjęcia.

Schemat FA(3) vs FA(2) – co się zmieniło?

Jeśli Twój system wcześniej generował poprawne pliki FA(2), nie zakładaj automatycznie, że FA(3) też będzie działać bez modyfikacji. Kluczowe zmiany:

• •Pola obowiązkowe: 26 → 37 (+11 nowych)
• •Maks. długość pól tekstowych: 256 → 512 znaków (Nazwa, Adres)
• •Załączniki do faktury: brak → do 5 plików × 10 MB
• •Faktury zaliczkowe: ograniczona obsługa → do 100 pozycji
• •Rachunki bankowe: 1 → do 10 w sekcji Platnosc
• •Wydatki pracownicze: brak → obsługiwane
• •Limit rozmiaru pliku: 1 MB (bez zał.) / 3 MB (z zał.)
• •Szyfrowanie sesji API: brak wymogu → AES obowiązkowe

Kto i od kiedy musi wystawiać faktury w FA(3)?

• •1 lutego 2026 – przedsiębiorcy z obrotem brutto powyżej 200 mln zł w 2025 r. → FA(3) obowiązkowy
• •1 kwietnia 2026 – wszyscy pozostali czynni podatnicy VAT → FA(3) obowiązkowy
• •Od 1.02.2026 – faktury korygujące, niezależnie od daty faktury pierwotnej → FA(3) obowiązkowy

Kto jest zwolniony z KSeF? Podatnicy zwolnieni podmiotowo z VAT (mogą korzystać dobrowolnie), faktury B2C (pod warunkami), faktury rolników ryczałtowych, faktury uproszczone (paragony do 450 zł z NIP) oraz podmioty zagraniczne bez stałego miejsca prowadzenia działalności w Polsce.

.

.

.