450 · KSeF API / semantyka
KSeF błąd 450: błąd weryfikacji semantyki faktury
Kod 450 jest ogólnym komunikatem odrzucenia semantycznego po stronie KSeF. Nie wskazuje jednej stałej przyczyny, dlatego diagnozę trzeba zacząć od danych, które najczęściej psują semantykę faktury.
Kod
450
Warstwa
KSeF API / semantyka
Skutek
Odrzucenie przez KSeF
Typowy komunikat GoKSeF
W praktyce błąd 450 bywa skutkiem błędnych danych kontrahenta, identyfikatorów, dat, zbyt długich pól, nietypowych znaków, problemów z kodowaniem UTF-8 albo XML-a, który przechodzi lokalną walidację XSD, ale odpada na pełnej walidacji po stronie KSeF.
Jak to poprawić
- 1 Sprawdź dane sprzedawcy, nabywcy i podmiotów dodatkowych przekazywane przez system źródłowy: NIP, VAT-UE, REGON, kraj oraz - jeżeli są mapowane do XML - adres, e-mail, telefon i techniczne identyfikatory podmiotów używane przez integrację.
- 2 Sprawdź daty w fakturze, zwłaszcza datę wystawienia, datę sprzedaży i przypadki dat przyszłych.
- 3 Zweryfikuj pola opisowe i pozycje faktury: długości tekstu, nietypowe znaki, kodowanie oraz znaki skopiowane z PDF-a lub edytora tekstu.
- 4 Sprawdź prolog XML, deklarację kodowania i realne kodowanie pliku. Dla KSeF bezpiecznym założeniem jest UTF-8.
- 5 Uruchom walidację GoKSeF i usuń najpierw błędy XML, XSD, semantyczne oraz merytoryczne widoczne w raporcie.
- 6 Jeżeli faktura była już wysyłana, nie ponawiaj wysyłki w ciemno. Najpierw sprawdź status dokumentu i czy problem nie przeszedł w duplikat albo rozjazd statusu ERP.
Sprawdź przed ponowną walidacją
- Plik XML przechodzi lokalną walidację GoKSeF bez blokerów.
- Identyfikatory kontrahentów są zapisane w polach właściwych dla FA(3), bez zdublowanych prefiksów i przypadkowych znaków.
- Teksty w pozycjach i opisach mieszczą się w limitach pól.
- Plik jest rzeczywiście zapisany jako UTF-8, a nie tylko tak opisany w prologu.
- Komunikat 450 nie jest mylony z problemem tokenu, certyfikatu albo uprawnień.
FAQ
- Czy błąd 450 mówi dokładnie, które pole jest błędne?
- Nie zawsze. 450 jest komunikatem ogólnym. Najpierw sprawdź dane kontrahentów, identyfikatory, daty, długości pól, kodowanie i błędy raportowane przez lokalną walidację XML/FA(3).
- Czy GoKSeF gwarantuje usunięcie błędu 450?
- Nie. GoKSeF pomaga znaleźć problemy w XML FA(3) przed wysyłką, ale nie gwarantuje przyjęcia faktury przez KSeF.
- Czy 450 to problem tokenu KSeF?
- Zwykle nie. Token, certyfikat i uprawnienia częściej dają błędy autoryzacji lub dostępu. 450 traktuj najpierw jako problem semantyki dokumentu.
- Czy lokalne XSD wystarczy do wykluczenia 450?
- Nie zawsze. Lokalna walidacja XSD jest potrzebna, ale KSeF może wykonywać dodatkowe sprawdzenia semantyczne i techniczne.
Inne częste błędy
Przewodnik · KSeF API / status
Faktura wysłana do KSeF, ale brak numeru KSeF albo UPO
Dokument został przekazany do KSeF, ale numer KSeF albo UPO nie są jeszcze dostępne.
Przewodnik · KSeF API / status
Faktura w trakcie przetwarzania w KSeF — co to znaczy
Status przetwarzania nie musi oznaczać błędu, ale wymaga świadomej kontroli i dalszej diagnostyki.
Przewodnik · KSeF API / status
Brak UPO w KSeF — jak diagnozować problem
Sam brak UPO nie przesądza jeszcze, czy problem dotyczy wysyłki, pobrania potwierdzenia czy synchronizacji statusu.
Przewodnik · ERP / synchronizacja statusu
Faktura jest w KSeF, ale nie widać jej w ERP
Taki objaw zwykle wskazuje na problem integracyjny po stronie systemu lokalnego, a nie na błąd samego XML.
Sprawdź poprawiony plik
Po poprawieniu danych źródłowych wygeneruj XML ponownie i sprawdź nowy plik w GoKSeF.