Kody błędów KSeF (150, 440, 450) – co oznaczają i jak poprawić fakturę
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
- Skąd się biorą kody KSeF?
- Kody statusu faktury – co oznaczają i co zrobić?
- Dlaczego faktura nie przechodzi do KSeF? Najczęstsze przyczyny
- Błąd 450: co KSeF sprawdza w pliku faktury?
- Błąd 440 „Duplikat faktury” – co dalej?
- Kody sesji: 440 „Sesja anulowana” i 445
- Czy odrzucona faktura jest wystawiona?
- 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”), oraz401,403i429, 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:
KodUEiNrVatUE– podatnik VAT z UE: kod kraju osobno, numer bez prefiksu,NrID, opcjonalnie zKodKraju– 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_1jest późniejsza niż dzień przyjęcia pliku przez KSeF, - NIP w
Podmiot1,Podmiot2,Podmiot3lubPodmiotUpowaznionyma 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_1zostanie przyjęty, ale jako faktura w trybie offline24 z datą zP_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
- 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
- CIRFMF/ksef-api, specyfikacja OpenAPI – statusy faktury (SessionInvoiceStatusResponse), sesji (SessionStatusResponse), odpowiedzi 202 i 400
- CIRFMF/ksef-api, „Weryfikacja faktury” (09.04.2026) – przesłanki odrzucenia i duplikaty
- CIRFMF/ksef-api, „Sesja – sprawdzenie stanu i pobranie UPO” (20.04.2026), pkt 2–7
- Podręcznik użytkownika Aplikacji Podatnika KSeF 2.0 (wersja 2.6, sierpień 2026), pkt 5.2.1, 5.2.3 i 5.4
- 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.