Walidator KSeF FA(3)

Wszystkie błędy i rozwiązania

Ta strona oczekuje jeszcze na weryfikację przez rodzimego użytkownika języka.

„No matching global declaration available” — błąd przestrzeni nazw w fakturze FA(3)

Sprawdzono względem zestawu reguł fa3-1-0EAktualizacja: 12 lipca 2026

Jak wygląda ten błąd?

Element '{...}Faktura': No matching global declaration available for the validation root.

Komunikat oznacza: walidator nie rozpoznaje korzenia dokumentu. Element główny nazywa się wprawdzie Faktura, ale jest zadeklarowany w innej przestrzeni nazw (xmlns) niż ta, którą definiuje schemat FA(3) — dla walidatora to zupełnie inny dokument.

Najczęstsze przyczyny

Plik został wygenerowany w starszej strukturze (np. FA(2)) — po zmianie wzoru zmienia się także adres przestrzeni nazw, więc stare pliki są odrzucane już na poziomie korzenia. Rzadziej: ktoś ręcznie edytował nagłówek XML, skopiował xmlns z przykładu innej struktury albo dodał literówkę (brakujący ukośnik na końcu adresu też jest błędem — adres musi się zgadzać co do znaku).

Poprawne wartości dla FA(3)

<!-- synthetic example -->
<Faktura xmlns="http://crd.gov.pl/wzor/2025/06/25/13775/">
  <Naglowek>
    <KodFormularza kodSystemowy="FA (3)" wersjaSchemy="1-0E">FA</KodFormularza>
    <WariantFormularza>3</WariantFormularza>
    ...

Trzy wartości są ustalone przez schemat i muszą brzmieć dokładnie tak: xmlns="http://crd.gov.pl/wzor/2025/06/25/13775/", kodSystemowy="FA (3)" (ze spacją przed nawiasem) oraz wersjaSchemy="1-0E". Wartości kodSystemowy i wersjaSchemy są w schemacie zdefiniowane jako stałe — każda inna wartość to błąd walidacji.

Jak naprawić

  1. Nie poprawiaj xmlns ręcznie w starym pliku — stara struktura różni się nie tylko nagłówkiem. Wygeneruj fakturę ponownie w programie wspierającym FA(3).
  2. Jeśli plik pochodzi z integracji/API, sprawdź, czy generator ma ustawiony aktualny wzór dokumentu.
  3. Zweryfikuj poprawiony plik ponownie — jeśli namespace się zgadza, ewentualne dalsze błędy będą już zwykłymi błędami struktury (zobacz: jak czytać błędy XSD).

Częste pytania

Czy wielkość liter w adresie ma znaczenie? Tak — adres przestrzeni nazw porównywany jest jako ciąg znaków, dokładnie co do znaku, łącznie z końcowym ukośnikiem.

Plik ma dobry namespace, a błąd dalej występuje? Sprawdź, czy element główny to na pewno Faktura i czy deklaracja xmlns stoi przy nim (a nie tylko przy elemencie zagnieżdżonym).

Sprawdź plik bezpłatnie