Narzędzie · Faktury KSeF
Walidator KSeF XML FA(3)
Wgraj fakturę XML i sprawdź czy jest zgodna ze schematem FA(3). Odczytaj dane kontrahentów, kwoty i pozycje. Plik nie jest wysyłany na żaden serwer.
Przeciągnij plik XML lub wybierz z dysku
Maksymalnie 2 MB
Jak działa walidator KSeF XML FA(3)?
Narzędzie wczytuje plik XML faktury ustrukturyzowanej KSeF (schemat FA(3)) i sprawdza go lokalnie w przeglądarce — plik nie jest wysyłany na żaden serwer. Walidator weryfikuje: przestrzeń nazw (namespace) schematu, obecność i wypełnienie obowiązkowych bloków (Naglowek, Podmiot1, Podmiot2, Fa), pola identyfikacyjne kontrahentów (NIP), daty wystawienia i sprzedaży, numer faktury, waluty, stawki VAT oraz co najmniej jedną pozycję (FaWiersz). Wyniki prezentowane są w trzech zakładkach: dane faktury, lista walidacji i podgląd XML.
Jak interpretować wynik?
Walidator sprawdza zgodność ze schematem FA(3) na poziomie wymaganych pól i wartości — nie wykonuje pełnej walidacji XSD (tę robi bramka KSeF MF po wysyłce). Wynik "brak błędów" oznacza, że plik ma wymagane pola FA(3) wypełnione poprawnymi wartościami, ale nie gwarantuje przyjęcia przez bramkę KSeF. Ostrzeżenia wskazują na potencjalne problemy, które warto sprawdzić przed wysyłką.
Przykład użycia
Faktura FV/2026/001: sprzedawca NIP 1234563218, nabywca NIP 5260001293, data wystawienia 2026-01-15, wartość netto 2 500 PLN, VAT 23% = 575 PLN, brutto 3 075 PLN. Walidator wyciągnie te dane z pól Fa/P_13_1, P_14_1, P_15 i pokaże je jako karty w zakładce "Dane". Przy błędzie w NIP sprzedawcy (zła suma kontrolna) zostanie wyświetlony błąd krytyczny.
Założenia i ograniczenia
Walidator obsługuje schemat FA(3) (przestrzeń nazw 2023/06/29/12648). Pliki FA(1) i FA(2) są rozpoznawane, ale nie w pełni walidowane. Plik FA(4) (gdy schemat zostanie wydany przez MF) zostanie zasygnalizowany ostrzeżeniem o nieznanym wariancie. Walidator nie sprawdza sumy kontrolnej NIP kontrahentów w rejestrze MF ani nie weryfikuje statusu VAT.
Źródła / podstawa
Schemat FA(3): Ministerstwo Finansów, publikacja na podatki.gov.pl/ksef — namespace http://crd.gov.pl/wzor/2023/06/29/12648/. Specyfikacja logiczna FA(3): dokumentacja techniczna KSeF dostępna w Portalu Podatkowym MF.
FAQ
Czym różni się FA(1), FA(2) i FA(3)?
FA(1), FA(2) i FA(3) to kolejne wersje schematu faktury ustrukturyzowanej KSeF. FA(1) wprowadzono w 2021 r., FA(2) — aktualizacja 2022 r., FA(3) — obowiązuje od 2023 r. Wersja schematu zakodowana jest w przestrzeni nazw XML (namespace). Walidator wykrywa wersję automatycznie na podstawie namespace w pliku XML.
Jak sprawdzić, czy mój plik XML ma schemat FA(3)?
Otwórz plik XML w notatniku lub edytorze tekstowym. W elemencie root Faktura sprawdź atrybut xmlns — dla FA(3) powinno być: xmlns="http://crd.gov.pl/wzor/2023/06/29/12648/". Walidator wyświetli wykrytą wersję schematu w podsumowaniu.
Czy plik XML jest wysyłany na serwer?
Nie — cały proces walidacji odbywa się lokalnie w przeglądarce z użyciem DOMParser. Plik nie opuszcza Twojego urządzenia. Możesz sprawdzić to w DevTools → Network: po kliknięciu "Zwaliduj" nie pojawi się żadne żądanie sieciowe związane z plikiem XML.
Jak dostać informację o zmianie schematu FA(3) na FA(4)?
Ministerstwo Finansów publikuje zmiany schematu KSeF na podatki.gov.pl/ksef (zakładka "Dokumentacja techniczna"). Ustaw Alert Google na "KSeF FA(4)" lub "KSeF nowy schemat". Alternatywnie: subskrybuj newsletter Portalu Podatkowego MF. Sam plik XML faktury będzie miał pole WariantFormularza=4 i inny namespace — walidator to wykryje i wyświetli ostrzeżenie.
Co zrobić gdy walidator zgłasza błąd "brak przestrzeni nazw FA(3)"?
Sprawdź atrybut xmlns w elemencie root Faktura. Może to być: FA(1) lub FA(2) (starszy schemat — bramka KSeF może odrzucić), błędny namespace (literówka w URI), albo plik nie jest fakturą KSeF. Upewnij się, że system ERP eksportuje XML z aktualnym schematem FA(3).
Ostatnia weryfikacja: września 2026