Skip to content

Skanowanie 26 oficjalnych przykładów XML FA(3)

Ministerstwo Finansów publikuje 26 przykładowych plików XML wraz z dokumentacją schematu FA(3). Każdy z 26 plików jest poprawny pod względem XSD. Przeskanowaliśmy je za pomocą KSeF Guard z parametrami --reference-date 2026-05-12 i --all-rules, aby pokazać, co walidacja merytoryczna wykrywa poza kontrolami schematu.

Skanowanie 26 oficjalnych przykładów XML FA(3)

Czym są oficjalne przykłady FA(3)?

Ministerstwo Finansów publikuje 26 plików XML z nazwami takimi jak FA_3_Przykład_N.xml (N=1–26) jako część dokumentacji schematu FA(3) (CRWDE 13775). Obejmują one faktury standardowe, korekty, waluty obce, zwolnienia z VAT, marże, zaliczki, samofakturowanie i różne typy specjalne.

Wszystkie 26 plików przechodzi walidację schematu XSD. Są to oficjalne pliki przykładowe dla wybranych scenariuszy FA(3). Nie są szablonami do użytku produkcyjnego; wiele z nich zawiera ustalone daty scenariuszy z 2026 r. i dane testowe, które uruchamiają reguły wrażliwe na datę przy walidacji względem bieżącej daty referencyjnej.

Poprawność XSD to nie pełna zgodność

Walidacja schematu XSD sprawdza strukturę dokumentu: nazwy elementów, kolejność, typy danych, wymagane pola. Nie sprawdza logiki biznesowej, spójności arytmetycznej, ograniczeń czasowych ani zależności między polami.

Plik może przejść walidację XSD i nadal wykazywać ustalenia merytoryczne. KSeF Guard sprawdza obie warstwy: najpierw XSD, potem 128 aktywnych reguł walidacji obejmujących wymagania Ustawy o VAT, wytyczne Ministerstwa, heurystyczne wykrywanie anomalii i kontrole bezpieczeństwa.

Co znalazł KSeF Guard

W 26 plikach: 1 czystych (bez ustaleń), 31 ustaleń o wadze błędu, 35 ustaleń o wadze ostrzeżenia, 8 różnych uruchomionych reguł. Data referencyjna: 2026-05-12.

# XSD Błędy Ostrzeżenia Uruchomione reguły
1 PASS 1 2 BUS-300, BUS-197, BUS-198
2 PASS 2 2 BUS-300, BUS-302, BUS-197, BUS-198
3 PASS 2 2 BUS-300, BUS-302, BUS-197, BUS-198
4 PASS 1 2 BUS-300, BUS-197, BUS-198
5 PASS 0 0 —
6 PASS 2 0 BUS-030, BUS-300
7 PASS 2 0 BUS-030, BUS-300
8 PASS 2 0 BUS-194, BUS-300
9 PASS 1 1 BUS-300, BUS-197
10 PASS 0 1 BUS-197
11 PASS 0 1 BUS-197
12 PASS 1 0 BUS-300
13 PASS 1 0 BUS-300
14 PASS 2 2 BUS-030, BUS-300, BUS-198, BUS-303
15 PASS 1 2 BUS-300, BUS-197, BUS-198
16 PASS 1 2 BUS-300, BUS-197, BUS-198
17 PASS 2 2 BUS-030, BUS-300, BUS-198, BUS-303
18 PASS 1 1 BUS-030, BUS-198
19 PASS 1 2 BUS-300, BUS-197, BUS-198
20 PASS 1 2 BUS-300, BUS-197, BUS-198
21 PASS 1 2 BUS-300, BUS-197, BUS-198
22 PASS 1 2 BUS-300, BUS-197, BUS-198
23 PASS 3 1 BUS-030, BUS-168, BUS-300, BUS-198
24 PASS 1 2 BUS-300, BUS-197, BUS-198
25 PASS 1 2 BUS-300, BUS-197, BUS-198
26 PASS 0 2 BUS-197, BUS-198

Reguły wrażliwe na datę: BUS-030, BUS-168 i BUS-194 zależą od daty referencyjnej. Oficjalne przykłady używają ustalonych dat scenariuszy z 2026 r. Przy ewaluacji względem --reference-date 2026-05-12 niektóre daty wypadają poza dozwolone okno. To oczekiwany artefakt ustalonych danych testowych, nie wada przykładów.

Reguły wsadowe: BUS-300, BUS-302 i BUS-303 aktywują się przy walidacji wielu plików jednocześnie. Uruchomienie każdego pliku osobno nie uruchomiłoby tych reguł.

Wyjaśnienie ustaleń

KSEF-BUS-030 błąd GOV_MANDATED

Co wykrył KSeF Guard: Data wystawienia faktury (P_1 — data wystawienia) jest ustawiona w przyszłości poza dozwolonym oknem (maks. 30 dni do przodu).

Jak interpretować lub naprawić: Sprawdź datę wystawienia faktury — powinna być datą bieżącą lub nie przekraczać 30 dni do przodu.

Źródło: Art. 106na ust. 1 Ustawy o VAT (LOGICAL_INFERENCE)

Uruchomione w przykładach: #6, #7, #14, #17, #18, #23

KSEF-BUS-194 błąd GOV_MANDATED

Co wykrył KSeF Guard: Data wystawienia faktury (P_1) przekracza termin ustawowy — fakturę należy wystawić najpóźniej do 15. dnia miesiąca następującego po miesiącu dostawy (P_6, data dostawy/wykonania usługi).

Jak interpretować lub naprawić: Sprawdź datę wystawienia — zgodnie z art. 106i ustawy o VAT, faktura powinna być wystawiona do 15. dnia miesiąca po dostawie. Popraw datę wystawienia lub datę dostawy.

Źródło: Art. 106i ust. 1 Ustawy o VAT

Uruchomione w przykładach: #8

KSEF-BUS-300 błąd GOV_MANDATED

Co wykrył KSeF Guard: W partii faktur wykryto zduplikowany numer faktury (P_2 — numer faktury). Dwa dokumenty w partii mają identyczny numer.

Jak interpretować lub naprawić: Sprawdź numerację faktur w partii — każda faktura musi mieć unikalny numer (P_2). Skoryguj numer zduplikowanego dokumentu.

Źródło: UoVAT, Art. 106e ust. 1 pkt 2 (kolejny numer jednoznacznie identyfikujący fakturę); KSeF — empiryczne odrzucenie duplikatów w sesji

Uruchomione w przykładach: #1, #2, #3, #4, #6, #7, #8, #9, #12, #13, #14, #15, #16, #17, #19, #20, #21, #22, #23, #24, #25

KSEF-BUS-302 błąd BATCH_CHECK

Co wykrył KSeF Guard: Guard wykrył regresję daty wystawienia (P_1) w sekwencji numerów faktur — faktura z wyższym numerem ma wcześniejszą datę. Heurystyka partii — nie jest wymuszana przez KSeF, ale może wskazywać na błąd w numeracji lub datowaniu.

Jak interpretować lub naprawić: Sprawdź kolejność dat i numerów faktur w partii — faktura z wyższym numerem nie powinna mieć wcześniejszej daty wystawienia.

Źródło: KSeF Guard batch heuristic (chronological monotonicity of P_1 within sequential P_2 series)

Uruchomione w przykładach: #2, #3

KSEF-BUS-168 ostrzeżenie HEURISTIC

Co wykrył KSeF Guard: Data wystawienia faktury (P_1 — data wystawienia) jest ponad 60 dni w przyszłości — prawdopodobnie błędna. Tak odległa data może wskazywać na pomyłkę w roku lub miesiącu.

Jak interpretować lub naprawić: Sprawdź datę wystawienia faktury — upewnij się, że rok, miesiąc i dzień są prawidłowe. Faktura z datą odległą w przyszłości wymaga weryfikacji.

Źródło: UoVAT, Art. 106i ust. 7; Broszura FA(3) P_1, P_6

Uruchomione w przykładach: #23

KSEF-BUS-197 ostrzeżenie HEURISTIC

Co wykrył KSeF Guard: Faktura ma datę wystawienia (P_1) w weekend (sobota lub niedziela). Wystawienie faktury w weekend jest rzadkie i może wskazywać na błąd daty lub zautomatyzowany proces.

Jak interpretować lub naprawić: Sprawdź datę wystawienia faktury — zwykle faktury są wystawiane w dni robocze. Jeśli data jest poprawna, może to być uzasadnione specjalnym procesem biznesowym.

Źródło: KSeF Guard heuristic (weekend invoice issuance — gateway validation practice)

Uruchomione w przykładach: #1, #2, #3, #4, #9, #10, #11, #15, #16, #19, #20, #21, #22, #24, #25, #26

KSEF-BUS-198 ostrzeżenie HEURISTIC

Co wykrył KSeF Guard: Faktura ma znacznik czasu wytworzenia (DataWytworzeniaFa) w godzinach nocnych (22:00-05:59). Utworzenie faktury w nocy jest rzadkie i może wskazywać na błąd systemowy lub zautomatyzowany proces.

Jak interpretować lub naprawić: Sprawdź godzinę utworzenia faktury — typowo faktury są generowane w godzinach roboczych. Jeśli godzina jest prawidłowa, może to być uzasadnione specjalnym procesem biznesowym (np. obsługa międzynarodowa).

Źródło: KSeF Guard heuristic (22:00-05:59 night-window invoice creation — gateway validation practice)

Uruchomione w przykładach: #1, #2, #3, #4, #14, #15, #16, #17, #18, #19, #20, #21, #22, #23, #24, #25, #26

KSEF-BUS-303 ostrzeżenie HEURISTIC

Co wykrył KSeF Guard: Kwota na fakturze rozliczeniowej (ROZ) przekracza sumę powiązanych faktur zaliczkowych (ZAL) w partii. Może to wskazywać na brak powiązania z zaliczkami lub scenariusz zaliczki częściowej (Art. 106f).

Jak interpretować lub naprawić: Zweryfikuj powiązania między fakturami zaliczkowymi i rozliczeniowymi. Reguła jest heurystyką Guard — scenariusz zaliczki częściowej per Art. 106f jest prawidłowy i może generować ten alert.

Źródło: UoVAT, Art. 106f ust. 3 (faktury zaliczkowe i rozliczeniowe)

Uruchomione w przykładach: #14, #17

Dowiedz się więcej

Zwaliduj własne faktury wobec 128 aktywnych reguł — offline, na swoim komputerze, z identyfikowalnością źródeł.

Pobierz KSeF Guard