Faktura odrzucona w KSeF — pełna lista kodów błędów i jak naprawić w 5 minut

Wysłałeś fakturę do Krajowego Systemu e-Faktur i zamiast numeru KSeF dostałeś komunikat o błędzie. Według danych branżowych (NaprawKSeF, todayautomate) 60–70% odrzuceń wynika z błędów struktury XML — a większość z nich da się naprawić w 5 minut, jeśli wiesz co znaczy kod błędu.

Najważniejsze fakty na początek, zanim wpadniesz w panikę:

• Do końca 2026 nie ma kar finansowych za błędy KSeF (vacatio legis). Ale obowiązek wystawienia faktury w terminie wciąż obowiązuje.
• Faktura odrzucona prawnie nie istnieje — nie ma numeru KSeF, więc nie podlega korekcie. Trzeba poprawić dane i wysłać ponownie.
• Data wystawienia = data udanego wysłania, nie data pierwszej próby. Jeśli między próbami minął miesiąc, to ma znaczenie podatkowe.

W tym poradniku znajdziesz pełną mapę kodów błędów Ministerstwa Finansów, top 12 najczęstszych przyczyn z gotowymi fixami oraz porównanie pre-walidacji w trzech najpopularniejszych programach do fakturowania.

Jak rozpoznać że faktura została odrzucona

Po wysłaniu pliku XML do KSeF system zwraca jeden z dwóch dokumentów potwierdzających:

• UPO (Urzędowe Potwierdzenie Odbioru) — faktura zaakceptowana, dostała numer KSeF. Archiwizuj ten dokument — to jedyny dowód doręczenia.
• UPP (Urzędowe Potwierdzenie Przekazania) z opisem błędu — faktura odrzucona. W treści odpowiedzi (sekcja exceptionDetailList) znajdziesz konkretny kod błędu i komunikat.

W programie księgowym faktura odrzucona zwykle dostaje status Błąd, Odrzucona lub Niedoręczona do KSeF — w zależności od oprogramowania. W panelu wFirmy znajdziesz to w zakładce PRZYCHODY » Historia komunikacji z serwerem KSeF; w inFakt analogiczny widok jest w panelu faktury (sekcja Status w KSeF); w Fakturowni status pojawia się przy każdej fakturze na liście.

Cytat z forum InsERT, na podstawie zaleceń MF: "Bieżące monitorowanie statusów wystawianych faktur i pobieranie UPO jest podstawowym obowiązkiem podatnika."

Jeżeli próbowałeś wysłać fakturę i w panelu nie widzisz ani UPO, ani komunikatu błędu — najprawdopodobniej system MF jest niedostępny. To inny scenariusz, który opisaliśmy w osobnym poradniku: KSeF nie działa — co robić krok po kroku.

Mapa kodów błędów KSeF — szybka orientacja

Ministerstwo Finansów grupuje kody błędów w kategorie. Znajomość kategorii pozwala w 5 sekund ustalić czy problem dotyczy autoryzacji, treści faktury, czy systemu — i komu trzeba go zgłosić.

Zakres kodów	Kategoria	Kto naprawia
9xxx	Błędy podpisu (e-podpis kwalifikowany, podpis zaufany)	Ty / dostawca certyfikatu
20xxx	Niedozwolone sekcje XML, kodowanie, szyfrowanie	Producent programu
21111–21176	Autoryzacja (token, sesja, certyfikat)	Ty (re-autoryzacja)
21204–21218	Pakiet wsadowy, kodowanie dokumentu	Producent programu
21401–21409	Walidacja schematu XSD/JSON	Ty (poprawa danych)
21301–21305	Brak autoryzacji / wygasła sesja	Ty (logowanie)
23xxx	Błędy treści (puste pola, brak danych)	Ty (uzupełnienie)
25xxx	Certyfikaty (nie istnieje, odwołany)	Ty / dostawca certyfikatu
30001 i 440xx	Duplikaty, kolizje biznesowe	Ty (zmiana numeracji)
HTTP 5xx	Awaria serwera MF	MF — czekać lub tryb offline

Pełną listę 90+ kodów Ministerstwo publikuje w specyfikacji technicznej API (sekcja InterfaceSpecification) oraz w repozytorium GitHub CIRFMF/ksef-docs. Najpełniejsze polskie zestawienie z komentarzem znajdziesz na aidergroup.pl/blog/kody-ksef.

Top 12 najczęstszych błędów — gotowe fixy

Na podstawie analiz NaprawKSeF i ksbot.pl, te dwanaście kodów odpowiada za większość odrzuceń w pierwszych miesiącach 2026 roku. Każdy z opisem co znaczy, dlaczego się pojawia i jak naprawić.

1. Kod 21401 — "Dokument nie jest zgodny ze schemą (XSD)"

Najczęstszy błąd walidacji. Oznacza, że plik XML nie pasuje do schematu FA(3) — brakuje wymaganego pola, jest dodatkowy nieoczekiwany element, źle nazwany tag lub błędne xmlns.

Fix: Sprawdź czy używasz aktualnego schematu (od 1 lutego 2026 obowiązuje FA(3) z przestrzenią xmlns="http://crd.gov.pl/wzor/2025/06/25/13775/"). Większość programów aktualizuje to automatycznie; jeśli wystawiałeś przez własną integrację — sprawdź repo MF na GitHub. Walidator online: RAFSOFT walidator FA(3).

2. Niezgodność sum (CHECKSUM_MISMATCH)

Pole P_13 (netto) plus P_14 (VAT) nie zgadza się z P_15 (brutto), z dokładnością do grosza. Najczęściej winowajcą jest niespójne zaokrąglanie — część programów liczy half-up, inne banker's rounding.

Fix: Przelicz sumy ręcznie. Jeśli błąd powtarza się przy fakturach z dużą liczbą pozycji — ustaw w programie jedną metodę zaokrąglania dla całej faktury, nie per pozycja. W wFirma znajdziesz tę opcję w USTAWIENIA » FAKTURY » Zaokrąglanie.

3. Nieprawidłowy format NIP (INVALID_NIP_FORMAT)

NIP zawiera myślniki, spacje, prefiks "PL" lub jest wpisany na 9 cyfr (zamiast 10). KSeF akceptuje tylko 10 cyfr bez separatorów; prefiks PL wpisuje się w osobne pole VAT-EU.

Fix: NIP 1234567890, nie PL123-456-78-90. Dla kontrahentów zagranicznych z UE — wypełnij pole kod kraju oddzielnie (DE, CZ, FR), bez modyfikowania pola NIP.

4. Nieprawidłowa stawka VAT (INVALID_VAT_RATE)

Stawka VAT przekazana jako liczba (23) zamiast jako kod literowy. KSeF akceptuje tylko predefiniowane wartości.

Fix: Dozwolone wartości: 23, 8, 5, 0 (eksport), zw (zwolniony), np (nie podlega), oo (odwrotne obciążenie). W programach wybiera się to z dropdownu — błąd pojawia się głównie przy własnych integracjach API.

5. Niekompletny adres (INCOMPLETE_ADDRESS)

Brakuje któregoś z pięciu wymaganych elementów: ulica, numer, kod pocztowy, miejscowość, kod kraju.

Fix: Wszystkie 5 pól musi być uzupełnionych. Kod kraju w formacie ISO 3166-1 alpha-2 (PL, DE, CZ — nie "Polska"). Dla osób fizycznych bez stałego adresu sprawdź, czy klient nie podał danych z poprzedniego mieszkania.

6. Pole "Uwagi" puste (Fakturownia-specific)

Jeden z najgłupszych powtarzalnych błędów: w XML jest sekcja "Uwagi", ale bez treści. Komunikat brzmi: "Rodzaj informacji — pole jest za krótkie (minimalna ilość znaków: 1)".

Fix: Albo wypełnij pole jakąkolwiek treścią, albo usuń je całkowicie z faktury. Dotyczy głównie Fakturowni — pomoc oficjalna: pomoc.fakturownia.pl.

7. Kod 30001 — "Podmiot lub uprawnienie już istnieje" (duplikat)

Próbujesz wystawić fakturę z numerem, który już został przyjęty przez KSeF. Często zdarza się gdy retry odbywa się bez wiedzy, że pierwsza próba przeszła.

Fix: Najpierw sprawdź w Aplikacji Podatnika MF czy faktura o tym numerze nie znajduje się już w systemie (po numerze własnym lub kontrahencie). Jeśli tak — używasz tego numeru. Jeśli nie — anuluj i nadaj nowy z bieżącej serii. W wFirma anulowanie znajdziesz w prawym menu kontekstowym faktury.

8. Kod 21111 — "Nieprawidłowe wyzwanie autoryzacyjne"

Token autoryzacyjny wygasł lub został unieważniony w trakcie sesji.

Fix: Wyloguj się z KSeF w panelu programu i autoryzuj ponownie (zwykle przez profil zaufany lub kwalifikowany e-podpis). W większości przypadków rozwiązuje się samoistnie po świeżej autoryzacji. Jeśli powtarza się — sprawdź czy nie próbujesz logować się jednocześnie z dwóch urządzeń (KSeF nie wspiera równoległych sesji).

9. Kod 21115 — "Nieprawidłowy certyfikat"

Certyfikat KSeF jest wgrany do programu, ale system go nie akceptuje. Najczęstsza przyczyna: pomylenie środowiska DEMO z produkcją (DEMO ma własne certyfikaty, nie działają w produkcji).

Fix: Sprawdź w ustawieniach programu czy wskazujesz https://ksef.mf.gov.pl/ (produkcja), nie https://ksef-demo.mf.gov.pl/. Wgraj certyfikat odpowiedni dla danego środowiska. Dla spółek pamiętaj o złożeniu druku ZAW-FA przed nadaniem uprawnień.

10. Kod 9103 — "Przekroczona liczba dozwolonych podpisów"

Wymagany jest dokładnie jeden podpis — wgrałeś dwa.

Fix: Usuń jeden z podpisów i wyślij ponownie. Błąd pojawia się głównie gdy współwłaściciel firmy próbuje współpodpisywać fakturę.

11. HTTP 403 — "Brak uprawnień"

Konto, z którego próbujesz wysłać fakturę, nie ma nadanych uprawnień KSeF na ten NIP.

Fix: Wejdź do Aplikacji Podatnika MF (ksef.mf.gov.pl) → zakładka UPRAWNIENIA → NADAJ UPRAWNIENIA. Jako uprawniony podaj swój PESEL (lub PESEL pracownika) i zakres "wystawianie faktur". Po nadaniu uprawnienia są aktywne natychmiast.

12. Niewłaściwy kod waluty (INVALID_CURRENCY_CODE)

W polu waluty wpisano ZŁ, złoty albo coś innego niż kod ISO 4217.

Fix: Tylko trzyliterowe kody ISO: PLN, EUR, USD, GBP, CHF. Pamiętaj, że niezależnie od waluty faktury, VAT zawsze przeliczasz na PLN po kursie NBP z dnia poprzedzającego datę wystawienia.

Pre-walidacja w wFirma vs inFakt vs Fakturownia

Pre-walidacja to funkcja, która uruchamia walidację schematu XSD lokalnie w programie — zanim plik trafi do KSeF. Jeśli coś jest nie tak, błąd pojawia się od razu na ekranie wystawiania, a Ty masz szansę poprawić dane bez generowania UPP z błędem.

wFirma

Funkcja walidacji jest wbudowana i włączona domyślnie. W panelu znajdziesz ją w PRZYCHODY » KSeF i integracje » Konfiguracja. Po wystawieniu faktury i kliknięciu "Wyślij do KSeF" wFirma najpierw sprawdza zgodność z FA(3) lokalnie — jeśli coś nie pasuje, dostajesz konkretny komunikat z numerem pola, w którym jest problem (a nie surowy kod błędu KSeF).

Dodatkowy plus: Historia komunikacji z serwerem KSeF jest dostępna per faktura — możesz wrócić do każdej próby wysyłki i zobaczyć jaki dokładnie komunikat zwrócił MF. Pomocne gdy szukasz wzorca powtarzających się błędów. Pełna instrukcja: pomoc.wfirma.pl.

Uwaga: jeśli wystawiasz faktury przez API z zewnętrznej integracji (np. własna apka), wFirma zaleca wyłączenie pre-walidacji w panelu — może blokować faktury przesyłane przez integrację.

inFakt

Walidacja działa podobnie — błędy walidacyjne pokazują się w panelu faktury z konkretnym opisem (zamiast surowego kodu). Help center inFakt ma kilka dedykowanych artykułów z procedurą fixu: "Błędna wysyłka faktury do KSeF — jak dokonać korekty" (artykuł 23476361754258 w pomoc.infakt.pl) oraz "Jak poprawiać błędy na fakturach w KSeF" (29210933920786).

Specyficzna sytuacja w inFakt: faktury kosztowe pobierane z KSeF czasem nie pojawiają się w widoku — to znana sprawa, opisana w artykule 33448591185042 w pomocy. Rozwiązanie: synchronizacja ręczna w panelu kosztów.

Fakturownia

Walidator XSD działa, ale Fakturownia ma więcej "specyficznych" pułapek konfiguracyjnych. Pomoc oficjalna wymienia 11 typowych problemów konfiguracji (pomoc.fakturownia.pl) — od opisanego wyżej pustego pola "Uwagi" po przekroczone limity certyfikatów dla kont obsługujących wiele firm. Jeśli korzystasz z Fakturowni dla kilku NIP-ów, sprawdź ten dokument przed pierwszą wysyłką.

Porównanie skrócone

Funkcja	wFirma	inFakt	Fakturownia
Pre-walidacja XSD przed wysyłką	✅ wbudowana, włączona domyślnie	✅ wbudowana	✅ ale wymaga konfiguracji
Czytelne komunikaty błędów (zamiast surowych kodów)	✅	✅	⚠️ częściowo
Historia komunikacji z KSeF per faktura	✅ pełny log	✅ podstawowy	✅
Tryb hybrydowy (do końca 2026)	✅	✅	✅
Wsparcie multi-firma (kilka NIP)	✅	✅	⚠️ wymaga manualnej autoryzacji

Co MF każe zrobić proceduralnie po odrzuceniu

Krajowa Izba Księgowych oraz oficjalne komunikaty Ministerstwa Finansów (zebrane m.in. na kik.edu.pl) wskazują jednoznaczną procedurę.

1. Bieżąco monitoruj statusy wszystkich wystawianych faktur — albo w panelu programu, albo w Aplikacji Podatnika MF.
2. Pobieraj UPO dla każdej zaakceptowanej faktury i archiwizuj. UPO to jedyny dowód, że faktura znajduje się w systemie i ma nadany numer KSeF.
3. Identyfikuj błąd z odpowiedzi systemu (sekcja exceptionDetailList w XML odpowiedzi).
4. NIE księguj odrzuconej faktury jako przychodu lub kosztu. Prawnie nie istnieje — nie ma numeru KSeF, więc nie znajdzie się w JPK ani w KPiR.
5. Popraw dane w programie księgowym lub w pliku XML.
6. Wyślij ponownie jako "nową" próbę. KSeF nadaje nowy numer, jeśli walidacja przejdzie.
7. Pobierz UPO dla zaakceptowanej wersji.
8. Ustal procedurę z kontrahentem — np. mailowe potwierdzenie wysłania faktury z KSeF z numerem UPO. Zapobiega sytuacji "nie dostałem faktury" przy braku powiadomień.

Cytat z analizy Bankier.pl (Tomasz Groszyk, Crido): "Problem polega na tym, że zanim informatycy zdiagnozują przyczynę odrzucenia, faktura zostanie już zaksięgowana w ERP. Powstaje rozbieżność, którą systemy analityczne administracji skarbowej mogą uznać za sygnał ryzyka."

Wniosek praktyczny: nie księguj automatycznie wszystkich wystawionych faktur w systemie wewnętrznym. Najpierw poczekaj na UPO, dopiero potem oznacz fakturę jako "wystawioną" w księdze.

Najczęstsze pułapki — z forów i komentarzy księgowych

Korekta odrzuconej faktury — błąd, którego nie zauważysz

Kuszące jest poprawić odrzuconą fakturę przez wystawienie korekty. To pomyłka prawna. Korektę można wystawić tylko do faktury, która istnieje w systemie KSeF i ma nadany numer. Odrzucona faktura nie istnieje — nie ma czego korygować. Trzeba poprawić dane i wysłać jako kolejną próbę pod nowym lub tym samym numerem własnym.

Procedura korekty istniejącej faktury (już zaakceptowanej przez KSeF) jest opisana osobno: Faktura korygująca w KSeF — 7 scenariuszy korekty krok po kroku.

Faktura "przyjęta" ale kontrahent jej nie widzi

Inna sytuacja niż odrzucenie: KSeF nadaje numer, status to "Przyjęta", ale klient mówi że nie widzi faktury w swoim panelu. To problem doręczenia, nie walidacji. Najczęstsze przyczyny: blokada powiadomień email po stronie kontrahenta, brak konta w KSeF, błędny NIP nabywcy. Procedura weryfikacji opisana będzie w osobnym poradniku (w przygotowaniu).

Trzy niewidoczne bajty

Cytat eksperta z Bankier.pl: "Trzy niewidoczne w edytorze bajty potrafią zatrzymać proces, w którym krążą dokumenty warte setki tysięcy złotych." Chodzi o tzw. BOM marker (Byte Order Mark) — niewidoczny prefix UTF-8, który niektóre edytory tekstu dodają automatycznie. KSeF go nie akceptuje.

Fix: Jeśli edytujesz XML ręcznie (np. własna integracja), zapisuj plik bez BOM. Notepad++: Encoding » UTF-8 (without BOM). VS Code: w prawym dolnym rogu klik na "UTF-8 with BOM" → wybierz "Save with Encoding" → "UTF-8".

Faktury z VAT-EU i sekcjami CDATA

Cytat z analizy Aider Polska (komentarz dla Bankiera): "Systemy informatyczne MF mają trudności z wizualizacją faktur zawierających sekcje CDATA". Faktury formalnie poprawne, ale w panelu MF wyświetlają się jako puste lub zniekształcone. Problem zgłoszony — czekamy na fix po stronie MF.

Workaround: Unikaj sekcji CDATA w polach opisowych — używaj zwykłego tekstu z escapowaniem znaków specjalnych (&, <).

Kiedy wezwać help desk MF lub księgową

Większość błędów rozwiążesz sam — pomoc wewnętrzna w wFirmie/inFakt/Fakturowni wystarczy w 90% przypadków. Czasem jednak warto sięgnąć dalej.

Help desk Krajowej Administracji Skarbowej (KSeF)

• Telefon krajowy: 801 055 055 (linia stacjonarna)
• Telefon mobilny / zagranica: +48 22 330 03 30
• Godziny: poniedziałek–piątek, 8:00–18:00
• Po wybraniu numeru — wciśnij opcję 6 (dedykowane wsparcie KSeF).
• Chat: chatbot Kaspro 24/7 oraz czat z konsultantem w godzinach pracy infolinii — w prawym dolnym rogu na ksef.podatki.gov.pl.

Kiedy dzwonić do MF: gdy błąd dotyczy autoryzacji, certyfikatu, ZAW-FA, dostępu do panelu — czyli rzeczy które producent programu ma "po swojej stronie" tylko w połowie.

Wsparcie programu

Każdy program do faktur ma własny help desk:

• wFirma: chat w panelu + telefon + bogata baza pomocy pomoc.wfirma.pl
• inFakt: chat + telefon + dedykowane artykuły KSeF pomoc.infakt.pl
• Fakturownia: chat + email + 11 dedykowanych poradników KSeF pomoc.fakturownia.pl

Księgowa

Wezwij księgową gdy:

• Błędy walidacji powtarzają się 5+ razy w tygodniu w tej samej kategorii — to sygnał, że masz problem z mappingiem danych w systemie wewnętrznym.
• Pojawia się spór z kontrahentem o NIP lub dane podstawowe — księgowa pomoże ustalić poprawne dane (KRS, biała lista, VIES).
• Trzeba skorygować fakturę z poprzedniego roku po odrzuceniu — kwestie przedawnienia są nietrywialne.

Checklist: zanim wyślesz następną fakturę

Pięć minut sprawdzenia oszczędza godziny diagnostyki.

1. Numeracja — czy numer faktury jest unikatowy w obrębie roku i serii? Sprawdź ostatnią wystawioną.
2. NIP nabywcy — 10 cyfr bez separatorów, dla zagranicznych z UE prefiks kraju w osobnym polu. Sprawdź na białej liście (wykaz podatników VAT).
3. Adres nabywcy — wszystkie 5 elementów (ulica, numer, kod pocztowy, miasto, kod kraju ISO).
4. Stawki VAT — używasz kodów (zw, np, oo) a nie liczb tekstowych.
5. Sumy — netto + VAT = brutto, do grosza. Jeden tryb zaokrąglenia.
6. Data wystawienia — format YYYY-MM-DD, nie późniejsza niż dzień, w którym faktycznie wysyłasz do KSeF.
7. Waluta — kod ISO 4217 (PLN, EUR), nie "zł".
8. Pole Uwagi — albo wypełnione, albo kompletnie usunięte (uwaga Fakturownia).
9. Sesja autoryzacyjna — czy nie wygasła? Jeśli wystawiałeś fakturę więcej niż godzinę temu — re-autoryzuj przed wysłaniem.
10. Pre-walidacja włączona — sprawdź w ustawieniach programu czy walidator XSD jest aktywny przed wysyłką.

Programy które najlepiej radzą sobie z błędami KSeF

Po pierwszych miesiącach obowiązywania KSeF jasno widać, które narzędzia mają najlepszy workflow obsługi błędów. Dwa, które wybralibyśmy w 2026 roku do nowej firmy:

Jeśli zastanawiasz się nad wymianą obecnego programu albo wybierasz pierwszy — pełne porównanie wszystkich wartych uwagi narzędzi znajdziesz w naszym rankingu programów do fakturowania online 2026. Dla pełnego kontekstu KSeF — zacznij od poradnika KSeF — co to jest i jak przygotować firmę w 2026.

Najważniejsze do zapamiętania

• Odrzucona faktura prawnie nie istnieje — nie księguj jej, nie korygruj, popraw dane i wyślij ponownie.
• Data wystawienia = data udanej wysyłki, nie pierwszej próby. Może mieć skutki podatkowe.
• Do końca 2026 brak kar finansowych, ale obowiązek wystawienia w terminie nadal obowiązuje.
• Top 3 najczęstsze błędy: niezgodność sum (zaokrąglenia), zły format NIP, brak elementów adresu.
• Pre-walidacja w programie łapie 80% błędów zanim trafią do MF — sprawdź czy masz włączoną.
• Help desk MF: 801 055 055 lub +48 22 330 03 30, opcja 6, pn–pt 8:00–18:00.
• UPO archiwizuj — to jedyny dowód, że faktura jest w KSeF i ma nadany numer.