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.
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?
- Prześlij plik XML FA(3). Klarbon rozpoznaje FA(3) po zawartości, niezależnie od nazwy pliku.
- 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.
- 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
- Ministerstwo Finansów, KSeF: Struktura logiczna FA(3) ksef.podatki.gov.pl
- Centralne Repozytorium Wzorów Dokumentów Elektronicznych, schemat FA(3) (XSD) crd.gov.pl
- Ministerstwo Finansów, KSeF: Faktura ustrukturyzowana i struktura logiczna FA ksef.podatki.gov.pl
Powiązane
- Otwórz dowolną e-fakturę. Sprawdź ją. Skonwertuj ją.
- Centrum pomocy Klarbon
- Czym jest KSeF FA(3)?
- Faktura elektroniczna w Polsce
- Wizualizacja faktury KSeF w XML: otwórz i odczytaj
- Weryfikacja e-faktury
- Prosty cennik dla faktur i wyciągów
- Co się dzieje z moimi plikami?
- Narzędzia do e-faktur
- Darmowy walidator KSeF: które narzędzie sprawdzi plik FA(3)?
- Podgląd e-faktury: otwórz i odczytaj plik XML
- Utwórz e-fakturę
- Numer KSeF w tytule przelewu: sprawdź wyciąg
- Otwórz i odczytaj XRechnung
- Otwórz fakturę ZUGFeRD