KSeF działa

Kody błędów KSeF — znaczenie i naprawa

Wpisz kod (np. 450) albo wklej treść komunikatu. Ten sam numer może znaczyć co innego przy wysyłce faktury, przy logowaniu i w API — pokazujemy wszystkie znaczenia.

Najczęstsze:450 Błąd semantyki440 Duplikat faktury401 Brak autoryzacji415 Brak uprawnień„Wystąpił nieoczekiwany błąd”

Wszystkie kody i komunikaty

Status faktury po wysyłce

100Uwierzytelnianie w toku
170Sesja interaktywna zamknięta
200Przetworzono poprawnie
400Wniosek odrzucony
405Anulowano z powodu błędu sesji
410Nieprawidłowy zakres uprawnień · HTTP 410 Gone
430Weryfikacja pliku faktury nie powiodła się
435Odszyfrowanie pliku nie powiodło się
440Duplikat faktury · Sesja anulowana
445Błąd weryfikacji, brak poprawnych faktur
450Błąd weryfikacji semantyki dokumentu faktury · Uwierzytelnianie zakończone niepowodzeniem z powodu błędnego tokenu
500Nieznany błąd · Nieznany błąd ({statusCode})
550Operacja została anulowana przez system
9101Nieprawidłowy dokument
9102Brak podpisu
9103Przekroczona liczba dozwolonych podpisów
9105Nieprawidłowy podpis
—Faktura odrzucona

Status sesji

150trwa przetwarzanie
420Przekroczony limit faktur w sesji

Logowanie / uwierzytelnienie

415brak uprawnień · Brak możliwości wysłania faktury z załącznikiem · Błąd odszyfrowania dostarczonego klucza
425uwierzytelnienie unieważnione
460Uwierzytelnianie zakończone niepowodzeniem z powodu błędu certyfikatu
470Uwierzytelnianie zakończone niepowodzeniem
480Uwierzytelnienie zablokowane
—Błąd uwierzytelnienia

Pobieranie (eksport) faktur

210Eksport faktur wygasł i nie jest już dostępny do pobrania
21165Faktura o podanym numerze KSeF nie jest jeszcze dostępna
21181Nieprawidłowe żądanie eksportu faktur
21182Osiągnięto limit trwających eksportów.

Odpowiedź API (wyjątek)

21001Nieczytelna treść
21111Nieprawidłowe wyzwanie autoryzacyjne
21115Nieprawidłowy certyfikat
21117Nieprawidłowy identyfikator podmiotu dla wskazanego typu kontekstu
21155Przekroczono dozwoloną liczbę faktur w sesji
21157Nieprawidłowy rozmiar części pakietu
21161Przekroczono dozwoloną liczbę części pakietu
21164Faktura o podanym identyfikatorze nie istnieje
21166Korekta techniczna niedostępna.
21167Status faktury nie pozwala na korektę techniczną.
21173Brak sesji o wskazanym numerze referencyjnym
21175Wynik zapytania o podanym identyfikatorze nie istnieje
21178Nie znaleziono UPO dla podanych kryteriów
21180Status sesji nie pozwala na wykonanie operacji
21183Zakres filtrowania wykracza poza dostępny zakres danych
21184Sesja tymczasowo niedostępna
21205Pakiet nie może być pusty
21208Czas oczekiwania na requesty upload lub finish został przekroczony
21217Nieprawidłowe kodowanie znaków
21301Brak autoryzacji
21304Brak uwierzytelnienia
21308Próba wykorzystania metod autoryzacyjnych osoby zmarłej
21402Nieprawidłowy rozmiar pliku
21403Nieprawidłowy skrót pliku
21405Błąd walidacji danych wejściowych
21406Konflikt podpisu i typu uwierzytelnienia
21418Przekazany token kontynuacji ma nieprawidłowy format
21470Przesłany identyfikator klucza jest nieznany lub wskazuje na wycofany klucz
25001Brak możliwości pobrania danych do CSR dla wykorzystanego sposobu uwierzytelnienia
25002Brak możliwości złożenia wniosku certyfikacyjnego dla wykorzystanego sposobu uwierzytelnienia
25003Dane w CSR nie zgadzają się z danymi w użytym wektorze uwierzytelniającym
25004Niepoprawny format CSR lub niepoprawny podpis CSR
25005Wniosek certyfikacyjny o podanym numerze referencyjnym nie istnieje
25006Osiągnięto limit możliwych do złożenia wniosków certyfikacyjnych
25007Osiągnięto limit dopuszczalnej liczby posiadanych certyfikatów
25008Certyfikat o podanym numerze seryjnym nie istnieje
25009Nie można odwołać wskazanego certyfikatu, ponieważ jest już odwołany, zablokowany lub nieważny
25010Nieprawidłowy typ lub długość klucza
25011Nieprawidłowy algorytm podpisu CSR
26001Nie można nadać tokenowi uprawnień których nie posiadasz
26002Nie można wygenerować tokena dla obecnego typu kontekstu
30001Podmiot lub uprawnienie już istnieje
71001Faktura o podanym identyfikatorze nie istnieje
71002Faktura jest już przypisana do maksymalnej liczby Identyfikatorów Zbiorczych
71004Faktury mają różnych sprzedawców
71005Powtórzony numer KSeF w żądaniu

Kod HTTP

401HTTP 401 Unauthorized
403HTTP 403 Forbidden
429HTTP 429 Too Many Requests
503HTTP 503 Service Unavailable

Aplikacja Podatnika / program do faktur

—Wystąpił nieoczekiwany błąd

Najważniejsze w skrócie

  • Gdy weryfikacja faktury jest negatywna, KSeF nie nadaje numeru KSeF — faktura nie zostaje wystawiona w KSeF.
  • Faktura może zostać odrzucona m.in. wtedy, gdy data w polu P_1 jest późniejsza niż data przesłania pliku do KSeF.

Jak czytać kody błędów KSeF?

Kody błędów KSeF są kluczowe do zrozumienia, dlaczego faktura nie została przyjęta. Każdy kod błędu może oznaczać różne problemy w zależności od kontekstu, np. przy wysyłce faktury, logowaniu czy w API. Warto korzystać z narzędzia na stronie, aby uzyskać szczegółowe informacje na temat konkretnego kodu, np. błąd 450.

Różnica między statusem faktury a statusem sesji

Status faktury odnosi się do jej aktualnego stanu w KSeF, np. czy została wystawiona, zaakceptowana czy odrzucona. Z kolei status sesji dotyczy samego procesu przesyłania danych do systemu. Ważne jest, aby śledzić oba statusy, ponieważ problemy z sesją mogą prowadzić do błędów w przesyłaniu faktur, co może skutkować ich odrzuceniem.

Co robić z odrzuconą fakturą?

W przypadku odrzucenia faktury przez KSeF, należy najpierw zidentyfikować przyczynę błędu. Odrzucona faktura w KSeF nie otrzymuje numeru KSeF, co oznacza, że nie została wystawiona. Należy poprawić błędy w pliku, np. upewnić się, że data w polu P_1 nie jest późniejsza niż data przesłania pliku, a następnie ponownie przesłać fakturę.

Jakie są najczęstsze błędy KSeF?

Wśród najczęstszych błędów KSeF znajdują się m.in. błąd 400, błąd 429 oraz błąd 150. Każdy z tych błędów wskazuje na różne problemy, takie jak błędne dane w pliku czy problemy z serwerem. Dobrze jest znać te kody, aby szybko reagować na problemy z wysyłką do KSeF.

Najczęstsze pytania

Co oznacza błąd 400 w KSeF?
Błąd 400 wskazuje na błędne dane w przesyłanym pliku. Należy sprawdzić, czy wszystkie wymagane pola są poprawnie wypełnione.
Jakie są przyczyny odrzucenia faktury w KSeF?
Faktura może zostać odrzucona z powodu błędnych danych, takich jak nieprawidłowa data w polu P_1 lub brak wymaganych informacji.
Jak można naprawić odrzuconą fakturę?
Aby naprawić odrzuconą fakturę, należy zidentyfikować przyczynę błędu, wprowadzić poprawki i ponownie przesłać plik do KSeF.
Co zrobić, gdy występuje błąd komunikacji z KSeF?
W przypadku błędu komunikacji, warto sprawdzić status serwera KSeF oraz upewnić się, że połączenie internetowe działa prawidłowo.
Jakie są różnice między statusem faktury a statusem sesji?
Status faktury dotyczy jej aktualnego stanu w KSeF, natomiast status sesji odnosi się do procesu przesyłania danych do systemu.

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