Przejdź do treści

Walidacja pliku XML KSeF ze schematem FA(3)

Beta To narzędzie jest w wersji beta. Przetestowaliśmy je na plikach przykładowych, a szczegóły mogą się jeszcze zmienić. Przejrzyj wynik, zanim zaczniesz na nim polegać.

Sprawdź plik XML faktury KSeF FA(3) ze schematem XSD Ministerstwa Finansów i zobacz każdy błąd z numerem wiersza. Tylko schemat, wersja beta, bezpłatnie.

Nie masz pliku pod ręką? Wypróbuj przykładową fakturę

W skrócie

Sprawdź fakturę pod kątem obowiązujących reguł EN 16931 i reguł krajowych. Przeczytaj każdą uwagę i wskazówki, co poprawić. Bezpłatnie, 10 dziennie bez konta.

Co obejmuje weryfikacja

Klarbon sprawdza XML według oficjalnego schematu i reguł biznesowych zestawu reguł dla jego formatu i wersji (lista poniżej), a w przypadku pliku PDF także zgodność z PDF/A-3 i metadane faktury wymagane przez Factur-X i ZUGFeRD. Klarbon nie weryfikuje podpisów elektronicznych, a wynik bez błędów nie oznacza, że sposób opodatkowania jest prawidłowy ani że odbiorca lub platforma przyjmie plik.

Zestawy reguł i wersje

Klarbon dobiera zestaw reguł na podstawie tego, co deklaruje plik.

Specyfikacja Wersja Zakres
KSeF FA(3) 1-0E Tylko oficjalny schemat

Klarbon sprawdza plik XML faktury KSeF FA(3) ze schematem XSD Ministerstwa Finansów i pokazuje każdy błąd z numerem wiersza i kolumny. To wyłącznie kontrola schematu, w wersji beta: Klarbon nie wykonuje kontroli, które KSeF przeprowadza przy przyjęciu faktury, i niczego do KSeF nie wysyła. Bezpłatnie dziesięć plików dziennie, pięćdziesiąt z bezpłatnym kontem.

Co obejmuje walidacja?

Strukturę pliku, tak jak określa ją oficjalny schemat: które elementy muszą wystąpić, w jakiej kolejności i ile razy oraz jaką postać może mieć każda wartość (daty, kwoty, format NIP, listy kodów, na przykład stawki VAT). Schemat FA(3) jest opublikowany w Centralnym Repozytorium Wzorów Dokumentów Elektronicznych (schemat FA(3)), a od 1 lutego 2026 r. FA(3) jest strukturą faktury w KSeF (Ministerstwo Finansów). Klarbon pobiera schemat i importowane przez niego pliki z oficjalnych adresów, sprawdza ich sumy kontrolne i używa ich bez zmian.

Sprawdzane Niesprawdzane
Wymagane elementy, ich kolejność i liczba wystąpień czy numery NIP istnieją i są zarejestrowane
Format wartości i listy kodów zapisane w schemacie czy sumy i kwoty VAT się zgadzają
Limit 10 000 wierszy faktury kontrole KSeF przy przyjęciu, na przykład kto wysyła fakturę

Jak sprawdzić plik KSeF?

  1. Prześlij plik XML FA(3). Klarbon rozpoznaje FA(3) po zawartości, niezależnie od nazwy pliku.
  2. Przeczytaj wynik. Podaje schemat i jego wersję oraz każdy błąd z numerem wiersza i kolumny, prostym wyjaśnieniem najczęstszych błędów i oryginalnym komunikatem walidatora w szczegółach technicznych.
  3. Popraw plik w programie do fakturowania i sprawdź go ponownie.

Brak numeru faktury (P_2) zostanie na przykład zgłoszony jako element, którego schemat oczekiwał i nie znalazł, z numerem wiersza, w którym FA(3) go wymaga.

Czy poprawny plik oznacza, że KSeF przyjmie fakturę?

Nie. Wynik bez błędów oznacza, że plik ma strukturę FA(3). O przyjęciu faktury decyduje KSeF i dopiero wtedy nadaje numer KSeF (Ministerstwo Finansów). Sprawdza też rzeczy, których plik nie pokazuje. Klarbon nie loguje się do KSeF, nie wysyła faktur i nie nadaje numerów.

Co dzieje się z moim plikiem?

Trafia na serwery Klarbon, jest sprawdzany w pamięci i usuwany po zakończeniu żądania. Klarbon nie przechowuje kopii i nie zapisuje treści faktury w logach. Więcej w artykule co dzieje się z moimi plikami. Jeśli chcesz tylko przeczytać fakturę bez przesyłania, użyj wizualizacji faktury KSeF w przeglądarce.

Ile to kosztuje?

Nic: dziesięć sprawdzeń dziennie bez konta, pięćdziesiąt z bezpłatnym kontem, do 2000 dziennie w planach Pro i Księgowa. Szczegóły w cenniku.

Zobacz też

Najczęstsze pytania

Co sprawdza walidacja KSeF w Klarbon?

Zgodność pliku XML z oficjalnym schematem FA(3) opublikowanym przez Ministerstwo Finansów i ze schematami, które on importuje. Każdy błąd ma numer wiersza i kolumny. To wyłącznie kontrola schematu: Klarbon nie wykonuje dodatkowych kontroli, które KSeF przeprowadza przy przyjęciu faktury, i niczego do KSeF nie wysyła.

Czy plik zgodny ze schematem zostanie przyjęty przez KSeF?

Niekoniecznie. Wynik bez błędów oznacza, że plik ma strukturę FA(3). O przyjęciu faktury decyduje KSeF, który sprawdza też rzeczy niewidoczne w pliku, na przykład to, kto ją wysyła.

Czy można sprawdzić plik FA(2)?

Nie. FA(3) zastąpiła FA(2), a Klarbon sprawdza tylko FA(3). Plik FA(2) zostanie odrzucony, nie liczy się do dziennego limitu i nic nie kosztuje.

Czy błędy są wyjaśnione po polsku?

Najczęstsze tak. Brakujący lub źle umieszczony element, wartość w złej postaci, puste pole, wartość spoza listy dozwolonych i zbyt wiele wierszy mają proste wyjaśnienie i wskazówkę, jak je poprawić. Wyjaśnienie podaje nazwę elementu, a przy najczęstszych polach FA(3), takich jak P_2, także to, co zawierają. Rzadsze błędy schematu pojawiają się tak, jak zapisuje je walidator, po angielsku. Oryginalny komunikat walidatora jest zawsze dostępny w szczegółach technicznych.

Ile plików mogę sprawdzić bezpłatnie?

Dziesięć dziennie bez konta i pięćdziesiąt z bezpłatnym kontem. W planach Pro i Księgowa do 2000 sprawdzeń dziennie.

Źródła

Zaktualizowano 21 listopada 2026