Walidator XML faktury KSeF (FA(3))
Wgraj plik XML — sprawdzimy go na serwerze względem oficjalnej schemy FA(3) Ministerstwa Finansów. Pokażemy błędy z numerem linii i podpowiedzią. Plik jest usuwany od razu po sprawdzeniu.
Najważniejsze w skrócie
- Od 1 lutego 2026 r. jedyną strukturą faktur ustrukturyzowanych jest FA(3) — także dla korekt i faktur rozliczających do faktur wystawionych wcześniej w FA(2) lub FA(1).
- FA(3) to plik XML zgodny ze strukturą logiczną opublikowaną w Centralnym Repozytorium Wzorów Dokumentów Elektronicznych (CRWDE) na ePUAP 25 czerwca 2025 r.
- Główne części FA(3): Naglowek, Podmiot1 (sprzedawca), Podmiot2 (nabywca), Podmiot3, PodmiotUpowazniony, Fa (dane faktury), Stopka i opcjonalny Zalacznik.
- Element Zalacznik (załącznik) można stosować dopiero po zgłoszeniu w e-Urzędzie Skarbowym.
- Gdy weryfikacja faktury jest negatywna, KSeF nie nadaje numeru KSeF — faktura nie zostaje wystawiona w KSeF.
- Faktura może zostać odrzucona m.in. wtedy, gdy data w polu P_1 jest późniejsza niż data przesłania pliku do KSeF.
Jak zbudowana jest faktura XML FA(3)?
Faktura XML FA(3) składa się z kilku głównych części:
- Nagłówek - zawiera podstawowe informacje o fakturze.
- Podmiot1 - dane sprzedawcy.
- Podmiot2 - dane nabywcy.
- Podmiot3 - opcjonalne dane dodatkowe.
- PodmiotUpowazniony - dane osoby upoważnionej, jeśli dotyczy.
- Fa - szczegóły dotyczące samej faktury.
- Stopka - dodatkowe informacje końcowe.
- Zalacznik - opcjonalny element, który można stosować po zgłoszeniu w e-Urzędzie Skarbowym.
Struktura XML KSeF musi być zgodna z ksef xml schema, aby faktura mogła zostać prawidłowo zwalidowana.
Jakie są najczęstsze błędy w pliku XML KSeF?
Podczas walidacji pliku XML KSeF mogą wystąpić różne błędy. Oto najczęstsze z nich:
- Przestrzeń nazw - niezgodność z wymaganiami schemy.
- Kodowanie - plik musi być zapisany w odpowiednim formacie.
- Kolejność pól - elementy muszą być w odpowiedniej kolejności.
- Kwoty - błędne wartości w polach dotyczących kwot.
- NIP - nieprawidłowy numer identyfikacji podatkowej.
W przypadku błędów, walidator XML KSeF dostarczy szczegółowe informacje, w tym numer linii błędu.
Czym różni się kontrola schemy od kontroli semantyki?
Kontrola schemy dotyczy zgodności pliku XML z określoną strukturą, czyli sprawdza, czy wszystkie wymagane elementy są obecne i czy są w odpowiedniej kolejności. Weryfikacja ta koncentruje się na formalnych aspektach dokumentu.
Kontrola semantyki natomiast sprawdza, czy wartości w polach mają sens w kontekście przepisów prawa. Na przykład, czy data w polu P_1 nie jest późniejsza niż data przesłania pliku do KSeF. Obie kontrole są kluczowe dla prawidłowego wystawienia faktury.
Jak korzystać z walidatora XML KSeF?
Aby skorzystać z walidatora XML KSeF, wykonaj następujące kroki:
- Wgraj plik XML faktury do walidatora.
- Uruchom proces walidacji.
- Sprawdź wyniki - walidator wyświetli błędy z numerem linii oraz podpowiedzią.
Pamiętaj, że plik jest usuwany po sprawdzeniu, dlatego warto mieć jego kopię. W przypadku błędów, zwróć uwagę na szczegóły, aby poprawić fakturę przed ponownym przesłaniem.
Najczęstsze pytania
Jakie są wymagania dotyczące pliku XML w KSeF?
Co się stanie, jeśli faktura nie przejdzie walidacji?
Jakie błędy mogą wystąpić w pliku XML?
Czy mogę dodać załącznik do faktury XML?
Jakie informacje zawiera nagłówek faktury XML?
Potrzebujesz pomocy księgowego?
Zostaw krótki opis problemu i kontakt — przekażemy zgłoszenie biuru rachunkowemu, które pomaga przy KSeF.
Źródła
Aktualizacja: 31 października 2026 r. · Jak weryfikujemy dane