{
"title": "Bad Request",
"status": 400,
"detail": "Żądanie jest nieprawidłowe.",
"errors": [{
"code": 21405,
"description": "Błąd walidacji danych wejściowych.",
"details": ["Invalid NIP format."]
}]
}Środowisko testowe MF, 11.10.2026. Numery referencyjne skróciliśmy, reszta bez zmian.
Komunikaty, które wywołaliśmy
| Szczegół (details) | Kiedy | Co poprawić |
|---|---|---|
| Invalid NIP format. | Logowanie z NIP-em, który nie ma 10 cyfr. | Wpisz NIP jako 10 cyfr, bez kresek, spacji i „PL”. |
| 'dateRange' must not exceed 100 days. | Lista faktur za okres dłuższy niż 100 dni. | Pobieraj miesiącami albo kwartałami. |
| Wskazany kod formularza nie jest wspierany. | Otwarcie sesji dla nieobsługiwanej struktury. | Używaj FA(3) — FA(2) nie jest przyjmowana od 1.02.2026. |
Jak czytać błędy 400 z KSeF
KSeF 2.0 opisuje błędy zapytań w formacie „problem details”: status to kod HTTP (400), a lista errors zawiera kody wyjątków KSeF (np. 21405, 21164, 21180) z opisem. Sam kod 400 mówi tylko „coś jest nie tak z zapytaniem” — znaczenie ma kod wyjątku i jego szczegół.
21405 dotyczy zapytania, które przygotował program (logowanie, wyszukiwanie faktur, otwarcie sesji), a nie treści faktury. Błędy w danych faktury KSeF zgłasza inaczej — statusem 450 przy konkretnej fakturze.
Co zrobić
- Jeśli szczegół wskazuje dane, które wpisujesz (NIP, zakres dat) — popraw je w programie.
- Jeśli szczegół dotyczy pola technicznego (np. formularza, klucza, tokena kontynuacji) — to błąd programu. Zaktualizuj go albo zgłoś dostawcy, wklejając pełny komunikat.