Co jest sprawdzane
- Schema XSD: pełna walidacja ze strukturą FA(3) (przestrzeń nazw
http://crd.gov.pl/wzor/2025/06/25/13775/) wraz ze schematami bazowymi typów danych i kodów krajów. - Reguły semantyczne: suma kwot z pozycji (P_11) a podsumowanie (P_13_x, P_14_x, P_15), poprawność NIP, zgodność dat (P_1, P_6), kody stawek VAT (P_12), wymagane pola zależne od rodzaju faktury (VAT, KOR, ZAL, ROZ, UPR).
- Kursy walut dla faktur w walucie obcej, opcjonalnie względem tabel NBP.
Plik, który przechodzi walidację tutaj, jest strukturalnie gotowy do wysyłki. Sam KSeF dodatkowo sprawdza uprawnienia podatnika i nadaje numer KSeF po przyjęciu.
Najczęstsze błędy
| Błąd | Znaczenie | Jak naprawić |
|---|---|---|
| cvc-complex-type.2.4.a | Nieoczekiwany element lub zła kolejność elementów | Kolejność pól w FA(3) jest ścisła; sprawdź element wskazany w XPath |
| cvc-pattern-valid | Wartość niezgodna ze wzorcem (np. NIP, data, kwota) | Popraw format: NIP 10 cyfr bez myślników, data RRRR-MM-DD, kwota z kropką |
| Suma P_11 ≠ P_13 | Pozycje nie sumują się do podsumowania | Zaokrąglenia w programie wystawcy |
| Stara schema FA(2) | Plik w strukturze obowiązującej do 31.01.2026 | Zaktualizuj program do FA(3) |
Co walidacja oznacza w praktyce
Plik, który przechodzi walidację XSD i reguły semantyczne, jest strukturalnie gotowy do wysyłki do KSeF. Sam KSeF sprawdza dodatkowo uprawnienia wysyłającego, duplikaty numerów i nadaje numer KSeF po przyjęciu; tych rzeczy nie da się sprawdzić offline. Dla nabywcy walidacja oznacza co innego: faktura pobrana z KSeF jest już przyjęta przez system, ale błędy semantyczne (źle policzony VAT, niezgodna suma P_15, błędny NIP kontrahenta) nadal mogą wymagać korekty u sprzedawcy. Raport z tej strony, z kodem reguły i ścieżką XPath, jest wtedy gotową podstawą do wezwania o fakturę korygującą.
Typowe źródła błędów to ręcznie edytowane szablony XML, programy nieprzystosowane do FA(3) po 1 lutego 2026 oraz eksporty z arkuszy kalkulacyjnych, które psują format dat i kwot.
Dla programistów
Ta sama walidacja jest dostępna jako API HTTP: wyślij plik metodą POST, otrzymasz raport JSON z kodem błędu, komunikatem i ścieżką XPath. Pozwala to wbudować kontrolę w moduł wystawiania faktur przed wysłaniem do bramki KSeF.
Najczęstsze pytania
Czy plik jest gdzieś zapisywany?
Nie. Faktura jest przetwarzana w pamięci serwera i usuwana po odesłaniu raportu. Nic nie trafia do KSeF ani do osób trzecich.
Czy walidacja tutaj jest taka sama jak w KSeF?
Kontrola schematu XSD jest identyczna, bo używamy oficjalnej schemy Ministerstwa Finansów. KSeF dodatkowo weryfikuje uprawnienia, sesję i unikalność numeru faktury, czego z zewnątrz sprawdzić nie można.
Czy obsługujecie faktury korygujące i zaliczkowe?
Tak. Rodzaje VAT, KOR, ZAL, ROZ, UPR, KOR_ZAL i KOR_ROZ są rozpoznawane, a reguły zależne od rodzaju faktury są sprawdzane.
Mam plik FA(2). Czy nadal jest przyjmowany?
Nie. Od 1 lutego 2026 r. obowiązuje wyłącznie FA(3). Pliki w starej strukturze są odrzucane przez KSeF. Narzędzie pokazuje wykrytą wersję schemy.
Dla programistów: ten sam silnik jako API
curl -F file=@invoice.pdf https://einvoicechecker.com/v1/validatecurl -F file=@invoice.xml https://einvoicechecker.com/v1/parsecurl -F file=@invoice.xml "https://einvoicechecker.com/v1/render?lang=pl" -o invoice.html