Walidator

Zły namespace w fakturze: xmlns dla FA(3)

Co oznacza ten błąd

Element Faktura nie ma przestrzeni nazw FA(3), więc schemat nie rozpoznaje pliku jako faktury FA(3). Atrybut xmlns w tym elemencie musi mieć dokładnie wartość http://crd.gov.pl/wzor/2025/06/25/13775/.

Przestrzeń nazw (namespace) to identyfikator wersji wzoru. Po nim walidator wybiera schemat, którym sprawdzi plik. KSeF też sprawdza fakturę ze schematem, a od 1 lutego 2026 obowiązującym wzorem faktury jest FA(3). Dopóki adres się nie zgadza, walidator nie sprawdza niczego więcej: dostajesz tylko ten jeden komunikat, przy elemencie Faktura. Po poprawce sprawdzi cały plik, więc mogą pojawić się nowe błędy.

Skąd się bierze najczęściej

Adres musi się zgadzać co do znaku. Schemat FA(3) deklaruje go jako przestrzeń docelową (targetNamespace). Broszura MF podaje ten sam adres z https://, ale jako stronę, na której MF publikuje schemat; w xmlns wpisujesz wersję z http://.

Schemat XSD FA(3)
  • Przestrzeń nazw FA(2), http://crd.gov.pl/wzor/2023/06/29/12648/, ze starego szablonu albo kodu sprzed lutego 2026.
  • Brak xmlns. W elemencie są tylko deklaracje xmlns:etd i xmlns:xsi, a domyślnej przestrzeni nazw nie ma. Te dwie deklaracje mogą zostać, nie przeszkadzają.
  • Drobna różnica w adresie: https:// zamiast http:// (na przykład adres skopiowany z broszury), brak ukośnika na końcu, przestawione cyfry w dacie.
  • Prefiks bez użycia. Plik deklaruje xmlns:fa="http://crd.gov.pl/wzor/2025/06/25/13775/", ale elementy nie mają prefiksu (<Faktura> zamiast <fa:Faktura>). Wtedy nie należą do tej przestrzeni nazw. Schemat przyjmie prefiks użyty konsekwentnie przy każdym elemencie, ale najprościej zadeklarować przestrzeń domyślną, bez prefiksu.
<!-- ❌ Przestrzeń nazw FA(2) -->
<Faktura xmlns="http://crd.gov.pl/wzor/2023/06/29/12648/">
<!-- ❌ Brak domyślnej przestrzeni nazw -->
<Faktura xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<!-- ❌ https i brak ukośnika na końcu -->
<Faktura xmlns="https://crd.gov.pl/wzor/2025/06/25/13775">
<!-- ❌ Prefiks zadeklarowany, ale nieużyty -->
<Faktura xmlns:fa="http://crd.gov.pl/wzor/2025/06/25/13775/">
<!-- ✅ FA(3) -->
<Faktura xmlns="http://crd.gov.pl/wzor/2025/06/25/13775/">

Ten komunikat pokazujemy tylko wtedy, gdy element główny nazywa się Faktura. Inna nazwa elementu głównego daje ogólny błąd schematu.

Jak to naprawić

  1. Otwórz plik i znajdź otwierający znacznik <Faktura, zwykle w pierwszej lub drugiej linii.
  2. Wpisz albo popraw atrybut xmlns="http://crd.gov.pl/wzor/2025/06/25/13775/". Najbezpieczniej go skopiować.
  3. Jeśli plik był w formacie FA(2), sama przestrzeń nazw nie wystarczy: zmieniają się też nagłówek i pola w Podmiot2. Pełną listę podajemy w porównaniu FA(2) i FA(3).

Jeśli fakturę generuje program, adres jest zwykle wpisany na stałe w szablonie eksportu. Popraw go tam, a nie w każdym pliku. Potem sprawdź fakturę ponownie.

Sprawdź swoją fakturę

Wrzuć plik XML, a pokażemy, co trzeba poprawić. Twój plik nie opuszcza przeglądarki.

Otwórz walidator