KSeF działa

Wyjątek 21405 KSeF — błąd walidacji danych wejściowych

Żądanie wysłane do API KSeF ma niepoprawne dane.

Odpowiedź API (wyjątek)Opis z dokumentacji MF

21405 · Błąd walidacji danych wejściowych

Co to znaczy

Uniwersalny kod walidacji: parametry lub treść żądania nie spełniają wymagań API.

Najczęstsze przyczyny

  • Brak wymaganego pola w żądaniu.
  • Zły format daty, NIP lub numeru.
  • Nieaktualna wersja programu po zmianach w API.

Jak naprawić

  1. Przeczytaj szczegóły (pole details) w odpowiedzi.
  2. Zaktualizuj program do faktur.
  3. Jeśli to Twoja integracja — porównaj żądanie z dokumentacją OpenAPI.

Inny kod lub komunikat?

Jak uniknąć błędu 21405 w przyszłości

Aby zminimalizować ryzyko wystąpienia błędu walidacji danych wejściowych, upewnij się, że wszystkie wymagane pola w żądaniu są wypełnione poprawnie. Sprawdzaj format dat, NIP oraz numerów, aby były zgodne z wymaganiami API. Regularnie aktualizuj oprogramowanie do faktur, aby dostosować je do zmian w API. W przypadku korzystania z własnej integracji, porównaj swoje żądania z dokumentacją OpenAPI, aby upewnić się, że są zgodne z wymaganiami systemu.

Kiedy ten komunikat pojawia się najczęściej

Komunikat o błędzie 21405 najczęściej pojawia się podczas próby przesyłania danych do KSeF, gdy brakuje wymaganych informacji lub gdy dane są w nieprawidłowym formacie. Często zdarza się to po aktualizacji oprogramowania lub zmianach w API, które mogą wpłynąć na sposób, w jaki dane są przesyłane. Warto zwracać uwagę na szczegóły w odpowiedzi API, aby szybko zidentyfikować problem.

Najczęstsze pytania

Co oznacza błąd walidacji danych wejściowych?
Błąd walidacji danych wejściowych oznacza, że parametry lub treść żądania nie spełniają wymagań API, co uniemożliwia dalsze przetwarzanie.
Jakie są najczęstsze przyczyny wystąpienia błędu 21405?
Najczęstsze przyczyny to brak wymaganego pola w żądaniu, zły format daty, NIP lub numeru oraz nieaktualna wersja programu.
Co zrobić, gdy otrzymam ten błąd?
Należy sprawdzić szczegóły w odpowiedzi API, zaktualizować oprogramowanie do faktur oraz, w przypadku własnej integracji, porównać żądanie z dokumentacją OpenAPI.

Potrzebujesz pomocy księgowego?

Zostaw krótki opis problemu i kontakt — przekażemy zgłoszenie biuru rachunkowemu, które pomaga przy KSeF.

Źródła

Aktualizacja: 31 października 2026 r. · Jak weryfikujemy dane