KSeF błąd 450: błąd weryfikacji semantyki dokumentu faktury i jak go naprawić

Status 450 przy fakturze oznacza „błąd weryfikacji semantyki dokumentu faktury”. Plik dotarł do KSeF, dał się odszyfrować i przeczytać, ale jego treść nie spełnia reguł struktury FA(3). To ważne rozróżnienie: KSeF działa, sesja jest w porządku, a wysyłanie tej samej faktury jeszcze raz da ten sam wynik. Trzeba poprawić dane.

Błąd 450 a inne błędy walidacji faktury

• 21401 (dokument niezgodny ze schemą XSD): plik ma złą budowę, np. brakuje wymaganego elementu albo element jest w złym miejscu.
• 430 (błąd weryfikacji pliku faktury): problem z samym plikiem, zanim KSeF przejdzie do treści.
• 450 (błąd weryfikacji semantyki): budowa jest poprawna, ale wartości nie spełniają reguł, np. format numeru albo zależności między polami.

Uwaga na numer 450 w innym miejscu: przy logowaniu do API oznacza błędny token, co opisałem w tekście o błędzie uwierzytelnienia. Wszystkie statusy i kody wyjątków zebrałem w przeglądzie błędów KSeF.

Jak znaleźć pole, które blokuje fakturę

Odpowiedź KSeF przy statusie 450 zawiera opis szczegółów. Program powinien pokazać go w całości, a nie tylko numer statusu. W wielu programach to „historia komunikacji z KSeF” przy dokumencie. Z opisu zwykle wynika nazwa elementu struktury, np. NrVatUE, i rodzaj problemu, np. niezgodność z wzorcem.

Najczęstsze przyczyny błędu 450 w praktyce

• Numer VAT UE nabywcy w złym formacie: spacje, myślniki albo mała litera w prefiksie kraju. Numer wpisuje się jednym ciągiem, z prefiksem wielkimi literami.
• Wartość za długa albo z niedozwolonym znakiem: nazwy towarów z emoji, znaki sterujące skopiowane z opisu produktu w sklepie.
• Brak danych wymaganych w danym przypadku: pole opcjonalne w schemie bywa obowiązkowe przy określonym rodzaju faktury, np. korekcie.

KSeF sprawdza zgodność danych ze strukturą, a nie merytorykę. Nie oceni, czy stawka VAT pasuje do towaru albo czy rabat policzono dobrze. Za to odpowiada wystawca, więc faktura z numerem KSeF nie musi być poprawna podatkowo. W sklepach typowym źródłem są dwa pierwsze punkty: dane nabywcy wpisane w formularzu zamówienia trafiają do faktury bez żadnego czyszczenia.

Jak nie dopuścić do błędu 450 w sklepie internetowym

Najlepiej walidować dane, zanim faktura opuści sklep: format NIP i numeru VAT UE już w formularzu zamówienia, czyszczenie nazw produktów z niedozwolonych znaków i kontrola długości pól. Integracja, którą buduję dla sklepów, sprawdza fakturę lokalnie według tych samych reguł i zatrzymuje wadliwą, zanim KSeF ją odrzuci. Przy WooCommerce opisuję to szerzej w tekście o KSeF w WooCommerce.

Przykład reguł walidacji w sklepie

• Numer VAT UE: usunięcie spacji i myślników, prefiks kraju wielkimi literami, sprawdzenie w VIES przy pierwszym zamówieniu.
• NIP: sprawdzenie sumy kontrolnej, zanim klient przejdzie do płatności. KSeF sprawdza ją na produkcji i odrzuci błędny numer.
• Nazwy produktów: usunięcie emoji i znaków sterujących przy generowaniu faktury, bez zmiany nazwy w samym sklepie.
• Daty: data wystawienia nigdy późniejsza niż dzień wysyłki do KSeF.

Źródło: weryfikacja faktury w dokumentacji KSeF 2.0.