Kody statusów i błędów KSeF: co oznaczają

KSeF: status faktury 405 oznacza, że przetwarzanie faktury zostało anulowane z powodu błędu w sesji, w której ją wysłano. Usuń przyczynę wskazaną w statusie sesji, a potem wyślij fakturę ponownie w nowej sesji.

Przetwarzanie anulowane z powodu błędu sesji

Nieprawidłowy zakres uprawnień

Brak możliwości wysyłania faktury z załącznikiem

Błąd weryfikacji pliku faktury

KSeF: status faktury 435 oznacza, że KSeF nie mógł odszyfrować pliku faktury. Poproś dostawcę programu o sprawdzenie szyfrowania, a potem wyślij fakturę ponownie.

Błąd odszyfrowania pliku

Duplikat faktury

Błąd weryfikacji semantyki dokumentu faktury

KSeF: status 500 oznacza nieznany błąd, który wystąpił podczas przetwarzania faktury lub sesji. Sprawdź status ponownie po jakimś czasie. Jeśli nadal wynosi 500, skontaktuj się z pomocą techniczną KSeF, podając numer referencyjny, zanim zdecydujesz, czy wysłać fakturę jeszcze raz.

Nieznany błąd ({statusCode})

KSeF: status 550 oznacza, że system anulował operację. Spróbuj jeszcze raz, zgodnie z zaleceniem w dokumentacji KSeF.

Operacja została anulowana przez system

KSeF: status sesji 405 oznacza, że elementy paczki wsadowej nie przeszły weryfikacji w KSeF. Poproś dostawcę programu o sprawdzenie, jak paczka jest budowana i deklarowana, a potem wyślij ją w nowej sesji wsadowej.

Błąd weryfikacji poprawności dostarczonych elementów paczki

KSeF: status sesji 415 oznacza, że KSeF nie mógł odszyfrować przesłanego klucza. Poproś dostawcę programu o sprawdzenie szyfrowania klucza i używanego klucza publicznego, a potem otwórz nową sesję i wyślij faktury ponownie.

Błąd odszyfrowania dostarczonego klucza

KSeF: status sesji 420 oznacza, że w sesji przekroczono limit faktur. Podziel faktury na kilka sesji i wyślij je ponownie.

Przekroczony limit faktur w sesji

KSeF: status sesji 430 oznacza, że nie udało się zdekompresować pierwotnego archiwum ZIP wysyłki wsadowej. Poproś dostawcę programu o ponowne przygotowanie pakietu i prześlij go w nowej sesji wsadowej.

Błąd dekompresji pierwotnego archiwum

KSeF: status sesji 435 oznacza, że nie udało się odszyfrować zaszyfrowanych części archiwum wysyłki wsadowej. Poproś dostawcę programu o sprawdzenie szyfrowania części, a potem prześlij pakiet w nowej sesji wsadowej.

Błąd odszyfrowania zaszyfrowanych części archiwum

KSeF: status sesji 440 oznacza, że sesja została anulowana. Otwórz nową sesję i wyślij faktury w dozwolonym czasie.

Sesja anulowana

KSeF: status sesji 445 oznacza, że weryfikacja nie znalazła w sesji żadnej poprawnej faktury. Popraw zgłoszone błędy faktur, upewnij się, że w sesji są poprawne faktury, i wyślij je ponownie.

Błąd weryfikacji, brak poprawnych faktur

KSeF: błąd 21001 oznacza, że nie udało się odczytać treści żądania wysłanego do KSeF. Poproś dostawcę programu o sprawdzenie żądania na podstawie tych szczegółów, a potem wyślij je ponownie.

Nieczytelna treść.

KSeF: błąd 21155 oznacza, że w sesji przekroczono dozwoloną liczbę faktur. Zamknij sesję i wyślij pozostałe faktury w nowej sesji.

Przekroczono dozwoloną liczbę faktur w sesji.

KSeF: błąd 21157 oznacza, że rozmiar części pakietu wsadowego jest nieprawidłowy. Przygotuj pakiet ponownie tak, by każda część mieściła się w limicie i zgadzała się z zadeklarowanym rozmiarem, a potem prześlij go w nowej sesji wsadowej.

Nieprawidłowy rozmiar części pakietu.

KSeF: błąd 21161 oznacza, że pakiet wsadowy ma więcej części, niż dopuszcza KSeF. Podziel faktury na kilka sesji wsadowych i wyślij je ponownie.

Przekroczono dozwoloną liczbę części pakietu.

KSeF: błąd 21166 oznacza, że nie można wysłać korekty technicznej, bo do tej faktury istnieje już korekta techniczna, którą KSeF przetworzył poprawnie. Zamiast wysyłać kolejną korektę, sprawdź status wcześniejszej korekty technicznej.

Korekta techniczna niedostępna.

KSeF: błąd 21167 oznacza, że korektę techniczną wysłano do faktury, którą KSeF przetworzył poprawnie. Sprawdź, czy hashOfCorrectedInvoice zawiera skrót (hash) odrzuconej faktury offline, a nie faktury przyjętej.

Status faktury nie pozwala na korektę techniczną.

KSeF: błąd 21173 oznacza, że nie istnieje sesja o podanym numerze referencyjnym. Użyj właściwego numeru referencyjnego sesji i wyślij żądanie ponownie.

Brak sesji o wskazanym numerze referencyjnym.

KSeF: błąd 21178 oznacza, że dla podanych kryteriów nie znaleziono UPO, czyli urzędowego poświadczenia odbioru. Popraw numery i poproś o UPO ponownie.

Nie znaleziono UPO dla podanych kryteriów.

KSeF 21180 oznacza, że obecny status sesji nie pozwala na wykonanie operacji, na przykład wysłania faktur albo zamknięcia sesji. Sprawdź status sesji i otwórz nową sesję, aby wysłać kolejne faktury.

Status sesji nie pozwala na wykonanie operacji.

KSeF 21184 oznacza, że sesja jest tymczasowo niedostępna z powodu prac serwisowych. Spróbuj ponownie później albo otwórz nową sesję, aby wysłać kolejne faktury, zgodnie ze wskazówką w szczegółach błędu.

Sesja tymczasowo niedostępna.

KSeF 21205 oznacza, że pakiet nie może być pusty: nie wysłano jednej z zadeklarowanych części. Wyślij brakującą część wskazaną w szczegółach i sprawdź, czy wysłano każdą zadeklarowaną część.

Pakiet nie może być pusty.

KSeF 21208 oznacza, że minął czas oczekiwania na żądania upload lub finish, a sesja została anulowana. Otwórz nową sesję wsadową i prześlij części w dozwolonym czasie.

Czas oczekiwania na requesty upload lub finish został przekroczony.

KSeF 21402 oznacza, że długość przesłanej treści nie zgadza się z zadeklarowanym rozmiarem pliku. Poproś dostawcę swojego programu o sprawdzenie, czy zadeklarowany rozmiar jest rozmiarem wysyłanego pliku, a potem wyślij plik ponownie.

Nieprawidłowy rozmiar pliku.

KSeF 21403 oznacza, że skrót przesłanej treści nie zgadza się z zadeklarowanym skrótem pliku. Poproś dostawcę swojego programu o sprawdzenie, czy zadeklarowany skrót jest wyliczony z wysyłanego pliku, a potem wyślij plik ponownie.

Nieprawidłowy skrót pliku.

KSeF 21405 oznacza, że dane w żądaniu nie przeszły weryfikacji. Popraw to, co wskazują szczegóły, i wyślij żądanie ponownie.

Błąd walidacji danych wejściowych.

KSeF 21470 oznacza, że przesłany identyfikator klucza jest nieznany lub wskazuje na wycofany klucz. Poproś dostawcę swojego programu o użycie obsługiwanego identyfikatora klucza, a potem wyślij żądanie ponownie.

Przesłany identyfikator klucza jest nieznany lub wskazuje na wycofany klucz.