KSeF PL Guide

Efektywna pomoc w kwestiach związanych z KSeF

Walidator XML faktur KSeF

Zwaliduj strukturę XML faktury KSeF FA(3) zgodnie z wymaganiami Ministerstwa Finansów. Wgraj lub wklej XML — uzyskaj natychmiastowe wyniki.

Kiedy warto skorzystać: Catch missing sections and line-item fields before you push files to KSeF APIs or hand them to integration QA.

KSeF Invoice XML Validator

Validate your KSeF invoice XML structure against required schema rules

Jak używać

1

Wgraj lub wklej XML

Wgraj plik .xml lub wklej zawartość XML faktury KSeF bezpośrednio w pole tekstowe.

2

Kliknij Waliduj XML

Narzędzie parsuje XML i sprawdza go pod kątem wymagań schematu FA(3).

3

Sprawdź wyniki walidacji

Każda reguła pokazuje status pozytywny/negatywny. Niespełnione reguły zawierają szczegóły o brakujących lub nieprawidłowych elementach.

Jak to działa

Polski system KSeF wymaga, aby wszystkie faktury były przesyłane w ustrukturyzowanym formacie XML opartym na schemacie FA(3) zdefiniowanym przez Ministerstwo Finansów. Schemat ten określa obowiązkowe elementy, w tym dane sprzedawcy (Podmiot1), dane nabywcy (Podmiot2), nagłówek faktury (Fa) i pozycje (FaWiersze).

Ten walidator sprawdza XML pod kątem 7 kluczowych reguł strukturalnych: poprawna składnia XML, obecność elementu głównego Faktura, wymagane elementy podrzędne (Podmiot1, Podmiot2, Fa), pola NIP w danych identyfikacyjnych sprzedawcy/nabywcy, kod waluty i data faktury w nagłówku, co najmniej jedna pozycja oraz wymagane pola (P_7, P_8B, P_9A, P_12) w każdej pozycji.

Walidacja odbywa się całkowicie w przeglądarce za pomocą API DOMParser. Żadne dane XML nie są przesyłane na serwer. Dzięki temu można bezpiecznie walidować faktury zawierające poufne informacje biznesowe.

Najczęściej zadawane pytania

Co to jest schemat FA(3)?
FA(3) to najnowszy standard schematu XML opublikowany przez Ministerstwo Finansów dla ustrukturyzowanych e-faktur w systemie KSeF. Definiuje wszystkie wymagane pola danych, ich strukturę i reguły walidacji.
Czy ten walidator sprawdza wszystkie reguły FA(3)?
To narzędzie sprawdza najważniejsze wymagania strukturalne — element główny, wymagane sekcje, kluczowe pola i kompletność pozycji. Pełna walidacja schematu, w tym typów danych i reguł biznesowych, wymaga użycia oficjalnego środowiska testowego KSeF.
Czy mogę walidować faktury z przestrzeniami nazw?
Tak. Walidator obsługuje dokumenty XML z prefiksami przestrzeni nazw lub bez nich. Używa dopasowania nazw tagów do znajdowania elementów niezależnie od deklaracji przestrzeni nazw.
Co zrobić, jeśli walidacja nie przejdzie?
Przejrzyj dokładnie każdą niespełnioną regułę. Narzędzie pokazuje dokładnie, który element lub pole jest brakujące. Typowe problemy to brak NIP w danych sprzedawcy/nabywcy, brak kodu waluty (KodWaluty) lub niekompletne pola pozycji.

Bezpieczeństwo danych

  • XML jest parsowany lokalnie w przeglądarce — nigdy nie jest przesyłany
  • Bezpieczne dla faktur z poufnymi danymi biznesowymi
  • Brak przetwarzania ani przechowywania po stronie serwera

Stworzone przez ekspertów

Stworzone przez programistów specjalizujących się w polskich systemach e-fakturowania. Nasze reguły walidacji opierają się na oficjalnej dokumentacji schematu FA(3) opublikowanej przez Ministerstwo Finansów.

Ostatnia aktualizacja: 2025-07