Awarie i tryb offline

Kody błędów KSeF (150, 440, 450) – co oznaczają i jak poprawić fakturę

W skrócie

Kod błędu KSeF to numer statusu, który system zwraca po sprawdzeniu faktury, sesji wysyłki albo logowania – w każdej z tych operacji ten sam numer znaczy co innego. Przy fakturze 150 oznacza „Trwa przetwarzanie”, 440 „Duplikat faktury”, a 450 „Błąd weryfikacji semantyki dokumentu faktury”. Odrzucona faktura zostaje bez numeru KSeF, czyli w ogóle nie powstała – poprawiasz dane i ponawiasz wysyłkę, bez korekty.

Spis treści
  1. Skąd się biorą kody KSeF?
  2. Kody statusu faktury – co oznaczają i co zrobić?
  3. Dlaczego faktura nie przechodzi do KSeF? Najczęstsze przyczyny
  4. Błąd 450: co KSeF sprawdza w pliku faktury?
  5. Błąd 440 „Duplikat faktury” – co dalej?
  6. Kody sesji: 440 „Sesja anulowana” i 445
  7. Czy odrzucona faktura jest wystawiona?
  8. Gdzie sprawdzisz status i UPO w Aplikacji Podatnika?

Kod błędu KSeF to numer statusu, który system zwraca po sprawdzeniu wysłanej faktury, całej sesji wysyłki albo logowania – i w każdej z tych operacji ten sam numer znaczy co innego. Przy fakturze 150 to „Trwa przetwarzanie” (żaden błąd), 440 – „Duplikat faktury”, a 450 – „Błąd weryfikacji semantyki dokumentu faktury”, czyli odrzucenie treści pliku.

Faktura odrzucona z kodem błędu zostaje bez numeru KSeF, więc w sensie prawnym nie istnieje. Poprawiasz dane i ponawiasz wysyłkę – korekty nie wystawiasz.

Skąd się biorą kody KSeF?

Program do faktur i Aplikacja Podatnika rozmawiają z KSeF przez API. Liczby, które widzisz, pochodzą z trzech miejsc:

  • status faktury – trzycyfrowy kod po przetworzeniu pliku (tabela niżej),
  • status sesji – kod dla całej wysyłki: pojedynczych faktur (sesja interaktywna) albo paczki (sesja wsadowa),
  • kody HTTP – odpowiedź na samo zapytanie: 400, często z pięciocyfrowym kodem (np. 21405 „Błąd walidacji danych wejściowych”), oraz 401, 403 i 429, związane z logowaniem i limitami. Te ostatnie opisujemy w artykule o błędach uwierzytelnienia w KSeF.

Ważna różnica: gdy program wysyła fakturę, KSeF odpowiada 202 Accepted, co znaczy tylko „przyjąłem plik do sprawdzenia”. O losie faktury przesądza późniejszy status. Dopiero kod 200 oznacza sukces: faktura ma numer KSeF i można pobrać UPO.

Kody statusu faktury – co oznaczają i co zrobić?

Kod Opis w dokumentacji MF Co zrobić
100 Faktura przyjęta do dalszego przetwarzania poczekaj i odśwież status
150 Trwa przetwarzanie to nie błąd – odśwież status za chwilę
200 Sukces faktura wystawiona, ma numer KSeF i UPO
405 Przetwarzanie anulowane z powodu błędu sesji wyślij fakturę ponownie w nowej sesji
410 Nieprawidłowy zakres uprawnień sprawdź, czy osoba, token lub certyfikat ma uprawnienie do wystawiania faktur, i dane sprzedawcy
415 Brak możliwości wysyłania faktury z załącznikiem zgłoś wysyłkę faktur z załącznikami w e-Urzędzie Skarbowym albo wyślij fakturę bez załącznika
430 Błąd weryfikacji pliku faktury plik nie przeszedł kontroli – przekaż szczegóły błędu dostawcy programu
435 Błąd odszyfrowania pliku problem z szyfrowaniem w programie – zgłoś dostawcy
440 Duplikat faktury taka faktura już jest w KSeF – nie wysyłaj jej drugi raz
450 Błąd weryfikacji semantyki dokumentu faktury popraw treść pliku według szczegółów błędu i wyślij ponownie
500 Nieznany błąd spróbuj ponownie; gdy błąd wraca – dostawca lub infolinia
550 Operacja została anulowana przez system ponów wysyłkę

Te same liczby w innych operacjach znaczą coś innego. 450 przy logowaniu programu to błędny token, a przy nadawaniu uprawnień – operacja niedozwolona dla danego identyfikatora. 440 w statusie sesji to „Sesja anulowana”. Zawsze sprawdź, czego dotyczy komunikat.

Dlaczego faktura nie przechodzi do KSeF? Najczęstsze przyczyny

Jeśli nie możesz wysłać faktury do KSeF, przyczyna leży w samym pliku albo poza nim. Faktura odrzucona przez KSeF z powodu treści dostaje kod statusu ze szczegółami. Problem z logowaniem, uprawnieniami czy sesją często zatrzymuje ją wcześniej – wtedy program pokazuje błąd HTTP albo błąd sesji.

Błędy w pliku faktury

Przyczyna Objaw Co zrobić
błąd walidacji: plik niezgodny ze schematem FA(3), np. brak wymaganego pola, zły format daty lub kwoty, BOM 430 lub 450 ze szczegółami popraw według szczegółów – pełna lista kontroli niżej
nagłówek KodFormularza ze starszej struktury – FA(3) ma atrybuty kodSystemowy „FA (3)” i wersjaSchemy „1-0E” jw. zaktualizuj program lub szablon XML
NIP z kreskami, spacjami lub literami albo z błędną sumą kontrolną jw. wpisz same cyfry, sprawdź numer w umowie lub na białej liście
data w P_1 późniejsza niż dzień wysyłki jw. wpisz dzisiejszą datę
ten sam numer, rodzaj faktury i NIP sprzedawcy co w fakturze już przyjętej 440 patrz sekcja o duplikacie niżej
załącznik bez zgłoszenia w e-Urzędzie Skarbowym 415 zgłoś tę funkcję albo wyślij fakturę bez załącznika

Częsta pułapka przy kontrahencie z zagranicy: numer VAT UE wpisany w pole NIP nabywcy. To pole przyjmuje tylko polski NIP – w schemacie dokładnie 10 cyfr – więc numer w rodzaju DE123456789 nie przejdzie walidacji. Nabywcę spoza Polski zapisujesz w Podmiot2 inaczej:

  • KodUE i NrVatUE – podatnik VAT z UE: kod kraju osobno, numer bez prefiksu,
  • NrID, opcjonalnie z KodKraju – firma spoza UE z identyfikatorem podatkowym,
  • BrakID = 1 – gdy identyfikatora nie podajesz.

Szczegóły: faktura zagraniczna w KSeF i faktura bez NIP. Odwrotny błąd – polski NIP w NrVatUE albo NrID – sprawia, że nabywca nie zobaczy faktury w swoim KSeF, nawet jeśli plik zostanie przyjęty (broszura FA(3), pkt 10).

Przyczyny poza plikiem

Przyczyna Objaw Co zrobić
sesja wysyłki zamknięta lub przerwana – sesja interaktywna żyje 12 godzin od otwarcia, wsadowa ma limit czasu wysyłki błąd sesji, np. wsadowa 440 „Przekroczono czas wysyłki”; faktury z przerwanej sesji mają status 405 otwórz nową sesję i wyślij ponownie
wygasło logowanie programu (token dostępowy) HTTP 401 program loguje się od nowa
token lub certyfikat KSeF nieważny albo unieważniony logowanie kończy się kodem 450 lub 460 nowy token lub certyfikat – błędy uwierzytelnienia
brak uprawnienia do wystawiania faktur w tym kontekście, np. token tylko do przeglądania albo logowanie na NIP własnej JDG zamiast spółki HTTP 403 lub faktura 410 poproś o uprawnienie albo zaloguj się w kontekście sprzedawcy – uprawnienia w KSeF
program łączy się ze środowiskiem testowym albo używa tokena z innego środowiska faktura bez mocy prawnej, której nabywca nie widzi, albo nieudane logowanie przełącz program na produkcję
za dużo zapytań w krótkim czasie HTTP 429 odczekaj czas z nagłówka Retry-After – limity API KSeF
awaria lub przerwa techniczna KSeF brak odpowiedzi systemu sprawdź komunikaty techniczne MF i wystaw fakturę offline

Środowisko testowe przyjmuje jeszcze strukturę FA(2), a produkcja tylko FA(3) (Środowiska KSeF API 2.0). Program, który „działał na testach”, może więc na produkcji dostawać odrzucenia z powodu schematu.

Błąd 450: co KSeF sprawdza w pliku faktury?

Dokumentacja MF nie przypisuje konkretnych usterek do kodów 430 i 450. Przyczynę podają szczegóły statusu, które program powinien pokazać razem z kodem. Jak sprawdzić plik schematem XSD przed wysyłką, opisujemy w tekście schemat XSD FA(3), a które pola są wymagane – w tekście pola obowiązkowe faktury w KSeF. Według dokumentu „Weryfikacja faktury” KSeF odrzuca plik, gdy:

  • nie jest poprawnym XML albo nie zgadza się ze schematem zadeklarowanym przy otwarciu sesji (od 1 lutego 2026 r. FA(3)),
  • ma kodowanie inne niż UTF-8 albo UTF-8 ze znakiem BOM,
  • zawiera instrukcje przetwarzania XML lub niedozwolone znaki Unicode,
  • data wystawienia w P_1 jest późniejsza niż dzień przyjęcia pliku przez KSeF,
  • NIP w Podmiot1, Podmiot2, Podmiot3 lub PodmiotUpowazniony ma błędną sumę kontrolną (sprawdzane na produkcji),
  • przekracza 1 MB, a z załącznikami 3 MB.

KSeF nie sprawdza za to rachunków. Faktura ze źle policzonym VAT przejdzie i trzeba ją będzie skorygować.

Błąd 440 „Duplikat faktury” – co dalej?

KSeF uznaje plik za duplikat, gdy w systemie jest już faktura tego samego sprzedawcy (NIP w Podmiot1) o identycznym rodzaju (RodzajFaktury) i numerze (P_2). Sprawdza to 10 lat wstecz. W szczegółach błędu podaje numer KSeF wcześniej przyjętej faktury i numer sesji, w której ją wysłano – Aplikacja Podatnika pokazuje oba.

  • To ta sama faktura wysłana drugi raz? Nic nie rób: pierwsza jest wystawiona, druga nie powstała.
  • To inna faktura z powtórzonym numerem? Nadaj jej nowy numer z twojej serii i wyślij ponownie (numeracja faktur w KSeF). Gdy w imieniu firmy fakturuje kilka oddziałów, uzgodnijcie zasady numeracji.

Nie myl tego z duplikatem faktury w rozumieniu ustawy o VAT – o nim piszemy w tekście duplikat faktury z 2025 r. a KSeF.

Kody sesji: 440 „Sesja anulowana” i 445

Status całej sesji programy pokazują rzadziej, ale warto go znać:

  • 440 „Sesja anulowana” – przekroczono czas wysyłki albo nie przesłano żadnej faktury,
  • 445 „Błąd weryfikacji, brak poprawnych faktur” – w sesji nie było ani jednej poprawnej faktury; sprawdź statusy pojedynczych plików,
  • 420 „Przekroczony limit faktur w sesji” (sesja wsadowa) – jedna sesja mieści najwyżej 10 000 faktur.

Paczka w sesji wsadowej nie przepada w całości: KSeF odrzuca tylko błędne pliki, a pozostałe dostają numery. Jeśli program zgłosi błąd 21184 „Sesja tymczasowo niedostępna”, MF zaleca otworzyć nową sesję i kontynuować wysyłkę.

Czy odrzucona faktura jest wystawiona?

Nie. Po negatywnej weryfikacji KSeF nie nadaje numeru, a to oznacza, że faktura nie została wystawiona (Podręcznik KSeF 2.0 cz. II, pkt 1.6.1). W praktyce:

  • Nie wystawiasz korekty – nie ma czego korygować ani anulować.
  • Numer możesz zachować. W przykładzie z pkt 1.6.7 odrzucona faktura nr 7/02/2026 po poprawieniu trafia do KSeF pod pierwotnym numerem, choć faktury 8/02/2026 i 9/02/2026 przyjęto wcześniej. Zmieniona kolejność nie jest powodem odrzucenia ani korekty.
  • Uważaj na datę. Poprawiony plik wysłany następnego dnia z wcześniejszą datą w P_1 zostanie przyjęty, ale jako faktura w trybie offline24 z datą z P_1 – terminy znajdziesz w artykule o trybach offline. Data z przyszłości oznacza odrzucenie.
  • Faktura offline odrzucona z przyczyn technicznych (np. niezgodność ze schematem, rozmiar, duplikat) wraca do KSeF jako korekta techniczna: w sesji interaktywnej i co do zasady bez zmiany treści faktury. Wyjątkiem jest duplikat: w Aplikacji Mobilnej KSeF przy korekcie technicznej takiej faktury zmienisz tylko numer (P_2) – więcej w tekście o numeracji faktur. Nie dotyczy to odrzucenia z powodu braku uprawnień.

Gdzie sprawdzisz status i UPO w Aplikacji Podatnika?

Po wysłaniu faktury aplikacja pokazuje ekran wysyłki. Gdy przetwarzanie trwa, kliknij Odśwież. Sukces to komunikat z numerem KSeF i przyciskiem Kopiuj. Przy błędzie zobaczysz informację o nieudanej wysyłce i przyciski Popraw fakturę (wraca do formularza z danymi) oraz Wprowadź fakturę (pusty formularz).

Wcześniejsze wysyłki znajdziesz w menu Historia sesji:

  • tabela pokazuje przy każdej sesji liczbę faktur wysłanych i odrzuconych oraz status sesji,
  • po kliknięciu sesji widać faktury z kolumną „Status faktury”,
  • UPO jednej faktury pobierzesz z jej menu, a zbiorcze UPO (XML lub PDF) – tylko dla sesji, która się zakończyła.

Dwa ograniczenia aplikacji łatwo wziąć za błąd KSeF. Formularz przyjmuje wyłącznie dzisiejszą datę wystawienia – jeśli zaczniesz fakturę przed północą, a wyślesz po niej, aplikacja cię o tym poinformuje. Przy wczytywaniu gotowego XML plik może mieć najwyżej 1 MB i nie może zawierać załącznika, a błędy walidacji blokują przycisk Wystaw fakturę do czasu poprawy. Więcej o pracy w aplikacji: Aplikacja Podatnika KSeF.

Najczęstsze pytania

Co oznacza błąd 450 w KSeF?

Przy wysyłce faktury 450 to „Błąd weryfikacji semantyki dokumentu faktury” – KSeF odrzucił treść pliku i nie nadał numeru. Popraw dane według szczegółów błędu i wyślij fakturę ponownie. Przy logowaniu programu ten sam kod oznacza błędny token.

Co oznacza kod 150 w KSeF?

To status „Trwa przetwarzanie”, a nie błąd. KSeF jeszcze sprawdza fakturę lub paczkę faktur. Odśwież status po chwili – o wyniku przesądza dopiero kod 200 (sukces) albo kod błędu.

Czy faktura odrzucona przez KSeF jest wystawiona?

Nie. Bez numeru KSeF faktura nie została wystawiona, więc nie wystawiasz korekty. Poprawiasz plik i wysyłasz go ponownie, nawet z tym samym numerem faktury.

Co zrobić z błędem 440 „Duplikat faktury”?

W KSeF jest już faktura z tym samym NIP sprzedawcy, rodzajem faktury i numerem. Jeśli to ta sama faktura, nie wysyłaj jej ponownie – pierwsza jest wystawiona. Jeśli to inna faktura, nadaj jej nowy numer.

Dlaczego nie mogę wysłać faktury do KSeF?

Albo plik ma błąd, np. niezgodność ze schematem FA(3), numer VAT UE w polu NIP czy powtórzony numer faktury, albo problem leży poza plikiem: wygasła sesja lub logowanie, brak uprawnienia w kontekście sprzedawcy, program podłączony do środowiska testowego albo przekroczony limit zapytań. Kod błędu i jego szczegóły wskazują, którą przyczynę sprawdzić.

Źródła

  1. Podręcznik KSeF 2.0 cz. II (MF, 06.08.2026), pkt 1.4, 1.6.1–1.6.2, 1.6.7, 2.1.1–2.1.2, 3.3.2, 3.4 i 4.2
  2. CIRFMF/ksef-api, specyfikacja OpenAPI – statusy faktury (SessionInvoiceStatusResponse), sesji (SessionStatusResponse), odpowiedzi 202 i 400
  3. CIRFMF/ksef-api, „Weryfikacja faktury” (09.04.2026) – przesłanki odrzucenia i duplikaty
  4. CIRFMF/ksef-api, „Sesja – sprawdzenie stanu i pobranie UPO” (20.04.2026), pkt 2–7
  5. Podręcznik użytkownika Aplikacji Podatnika KSeF 2.0 (wersja 2.6, sierpień 2026), pkt 5.2.1, 5.2.3 i 5.4
  6. Broszura informacyjna struktury logicznej FA(3) (MF), ogólne założenia formatu pól (pkt 4–10) i opis DaneIdentyfikacyjne dla Podmiot2 (tabela 10)

Artykuł ma charakter informacyjny i nie stanowi porady podatkowej. W konkretnej sprawie skonsultuj się z księgowym lub doradcą podatkowym.

Przeczytaj też