Najczęstsze błędy KSeF przy wysyłce faktury i jak je naprawić

Klikasz „wyślij", a zamiast numeru KSeF dostajesz komunikat o odrzuceniu — albo gorzej: faktura przechodzi, ale z błędnymi danymi, których już nie da się „anulować". To dwa zupełnie różne problemy i każdy naprawia się inaczej.

Stawka rośnie z każdym miesiącem. Od 1 kwietnia 2026 r. obowiązek wystawiania faktur w KSeF objął praktycznie wszystkich przedsiębiorców (najmniejsi — od 1 stycznia 2027 r.). Zgodnie z obecną ustawą kary z art. 106ni ustawy o VAT obowiązują od 1 stycznia 2027 r. Ministerstwo Finansów zapowiedziało 16 września 2026 r. ich przesunięcie na 1 stycznia 2028 r. — to projekt ustawy, jeszcze nieuchwalony. Przesunięcie dotyczy tylko kar, a nie samego obowiązku korzystania z KSeF.

W tym tekście przechodzimy przez sześć najczęstszych błędów wysyłki — od odrzuconego XML-a po duplikat z kodem 440 — i pokazujemy, kiedy wystarczy poprawić plik i wysłać ponownie, a kiedy konieczna jest korekta.

Zasada numer 1: odrzucenie ≠ błędna faktura wystawiona

Zanim przejdziemy do konkretnych błędów, jedna rzecz, która oszczędza mnóstwo nerwów: jeśli KSeF odrzucił plik, faktura w świetle prawa w ogóle nie została wystawiona. Nie potrzebujesz faktury korygującej — poprawiasz dane i wysyłasz dokument ponownie. To tzw. drugie podejście.

Korekta jest potrzebna dopiero wtedy, gdy faktura przeszła walidację, dostała numer KSeF, a błąd jest merytoryczny (zły nabywca, zła kwota, zła stawka). W KSeF nie ma opcji „anuluj" — każdą przyjętą fakturę z błędem naprawia się wyłącznie korektą.

Błąd 1: niezgodność ze schemą FA(3)

Od 1 lutego 2026 r. obowiązuje struktura logiczna FA(3). KSeF nie ocenia, jak faktura wygląda — sprawdza, czy plik XML jest zgodny ze schemą: czy wypełnione są wszystkie pola wymagane, czy format dat to RRRR-MM-DD, czy NIP to 10 cyfr bez myślników i prefiksu PL, czy znaki są kodowane w UTF-8.

Typowe przyczyny odrzucenia:

• brak pola wymaganego (np. data wystawienia P_1 lub numer faktury P_2),

• NIP w formacie 123-456-78-90 zamiast 1234567890,

• plik wygenerowany według starej wersji schemy (FA(2) zamiast FA(3)),

• niedozwolone znaki lub błędne kodowanie w polach tekstowych.

Jak naprawić: przeczytaj komunikat błędu — API KSeF 2.0 zwraca konkretny kod (exceptionCode) i opis w polu Details. Pełna lista kodów jest w dokumentacji integratora na ksef.podatki.gov.pl oraz w repozytorium CIRFMF/ksef-docs. Popraw wskazane pole i wyślij ponownie. Jeśli korzystasz z programu do fakturowania (a nie z ręcznie generowanego XML-a), dobry system zwaliduje plik przed wysyłką i w ogóle nie dopuści do odrzucenia.

Błąd 2: duplikat faktury (kod 440)

KSeF 2.0 uznaje fakturę za duplikat, gdy zgadzają się trzy parametry: NIP sprzedawcy, rodzaj faktury i numer faktury (pole P_2). Kwota i nabywca nie mają znaczenia. Unikalność jest sprawdzana globalnie, w całym systemie — i utrzymywana przez 10 lat.

Najczęstszy scenariusz: system nie dostał potwierdzenia (timeout, zerwane połączenie), użytkownik klika „wyślij" jeszcze raz — a pierwsza wysyłka jednak doszła.

Jak naprawić: zanim ponowisz wysyłkę, sprawdź status pierwotnej sesji — być może faktura już ma numer KSeF. Jeśli błąd 440 wynika z faktycznie zdublowanej numeracji (np. dwa systemy wystawiają z tej samej serii), zmień numer faktury i pilnuj jednego źródła numeracji.

Błąd 3: data wystawienia z przyszłości

Pole P_1 z datą późniejszą niż moment przesłania pliku to pewne odrzucenie. Odwrotna sytuacja jest legalna: jeśli w P_1 jest data wcześniejsza niż dzień wysyłki, datą wystawienia pozostaje data z pola P_1, a stosuje się zasady trybu offline24 (wysyłka do następnego dnia roboczego).

Jak naprawić: popraw datę i wyślij ponownie. Jeśli wystawiasz faktury „z wyprzedzeniem", wstrzymaj wysyłkę do właściwego dnia — albo skonfiguruj system tak, żeby kolejkował dokumenty.

Błąd 4: problemy z autoryzacją — token, certyfikat, uprawnienia

Druga duża grupa błędów nie dotyczy treści faktury, tylko dostępu: wygasły certyfikat KSeF (lub token), brak nadanych uprawnień do wystawiania w imieniu podmiotu. To częsty problem w biurach rachunkowych, gdzie faktury wystawia pełnomocnik, oraz w spółkach, gdzie uprawnienia trzeba było najpierw zgłosić (np. formularzem ZAW-FA).

Jak naprawić: odnów certyfikat KSeF i zweryfikuj uprawnienia w module uprawnień KSeF. Zgodnie z obecnymi przepisami tokeny KSeF wygasają 31 grudnia 2026 r. Na konsultacjach 9 czerwca 2026 r. MF zaproponowało ich utrzymanie, ale decyzji w formie przepisu jeszcze nie ma — bezpieczniej przejść na certyfikat KSeF. Procedurę nadawania dostępu krok po kroku opisuje Ministerstwo Finansów na ksef.podatki.gov.pl. Ważne: dokument wprowadzony przez osobę bez uprawnień zostaje odrzucony, więc faktura nie istnieje — po uporządkowaniu dostępu wysyłasz ją normalnie.

Błąd 5: faktura przyjęta, ale z błędem merytorycznym

Tu zaczyna się prawdziwy problem, bo KSeF nie waliduje faktur merytorycznie. System nie sprawdza, czy kwota VAT jest policzona poprawnie, czy stawka jest właściwa, ani czy NIP nabywcy należy do firmy, której faktycznie sprzedałeś. Plik zgodny ze schemą przejdzie — z błędami i tak dostaniesz numer KSeF.

Dwa najczęstsze przypadki z praktyki pierwszych miesięcy obowiązkowego KSeF:

1. Zły nabywca — np. po użyciu funkcji „klonuj fakturę" i niepodmienieniu kontrahenta. Jedyna droga: faktura korygująca do zera plus nowa faktura z poprawnymi danymi. Jeśli wykryjesz błąd jeszcze w miesiącu sprzedaży, unikniesz rozliczania „podwójnego" VAT.

2. Błąd rachunkowy lub zła stawka — naprawiasz zwykłą korektą in plus / in minus, bez zerowania całej faktury.

Jak naprawić systemowo: przenieś walidację na etap przed wysyłką — weryfikacja NIP kontrahenta na białej liście, kontrola sum pozycji, blokada wysyłki przy niekompletnych danych. KSeF tego za Ciebie nie zrobi.

Błąd 6: brak monitoringu statusów i niedostępność systemu

Brak komunikatu o odrzuceniu nie oznacza, że faktura została przyjęta — czasem oznacza tylko, że Twój system nie odebrał odpowiedzi. Faktura bez sprawdzonego statusu i bez UPO to faktura w zawieszeniu.

Osobny przypadek to awaria lub przerwa serwisowa po stronie KSeF. Przepisy przewidują na tę okoliczność tryb offline i tryb awaryjny: fakturę wystawiasz poza systemem i przesyłasz do KSeF po przywróceniu dostępności, w ustawowym terminie.

Jak naprawić: monitoruj statusy wysyłek (najlepiej automatycznie), pobieraj UPO i śledź komunikaty o niedostępności na stronach MF. W systemie zintegrowanym z API warto mieć mechanizm ponawiania wysyłki z kontrolą duplikatów — patrz błąd 2.

Checklist: zanim klikniesz „wyślij do KSeF"

• [ ] Plik generowany według aktualnej schemy FA(3), nie FA(2)

• [ ] NIP-y zapisane jako 10 cyfr, bez myślników i prefiksu PL

• [ ] Data wystawienia (P_1) nie jest datą z przyszłości

• [ ] Numer faktury unikalny — jedno źródło numeracji dla wszystkich kanałów wystawiania

• [ ] Dane nabywcy zweryfikowane (szczególnie po sklonowaniu poprzedniej faktury)

• [ ] Certyfikat KSeF (lub token) ważny, uprawnienia nadane i potwierdzone

• [ ] Po wysyłce: sprawdzony status i pobrane UPO — dopiero wtedy temat jest zamknięty

Wyślij dobrze za pierwszym razem

Większość błędów KSeF dzieli się na dwie kategorie: techniczne (poprawiasz i wysyłasz ponownie) i merytoryczne (czeka Cię korekta). Obie najlepiej łapać przed wysyłką — bo gdy zaczną obowiązywać kary (obecnie od 1 stycznia 2027 r.; MF zapowiedziało przesunięcie na 1 stycznia 2028 r.), błędy przestaną być tylko irytujące i zaczną kosztować.

Biurko waliduje fakturę względem schemy FA(3) przed wysyłką, sprawdza NIP kontrahenta, pilnuje numeracji, a po przyjęciu faktury przez KSeF automatycznie pobiera UPO. Przetestuj Biurko bezpłatnie przez 14 dni na biurko.io i przestań walczyć z kodami błędów.

FAQ

Co zrobić, gdy KSeF odrzucił fakturę?

Odrzucona faktura nie została wystawiona w świetle prawa, więc nie wystawiasz korekty. Odczytaj kod błędu z komunikatu, popraw wskazane dane (najczęściej: schema FA(3), format NIP, brakujące pole, data) i wyślij dokument ponownie do KSeF.

Co oznacza błąd 440 w KSeF?

Kod 440 to duplikat faktury. KSeF 2.0 wykrywa go po trzech polach: NIP sprzedawcy, rodzaj faktury i numer faktury (P_2). Sprawdź, czy pierwotna wysyłka nie została już przyjęta i czy numeracja faktur nie powiela się między systemami.

Czy można anulować fakturę wysłaną do KSeF?

Nie. Faktura, która otrzymała numer KSeF, jest wystawiona i nie da się jej anulować ani edytować. Każdy błąd merytoryczny — zły nabywca, kwota, stawka VAT — naprawia się wyłącznie fakturą korygującą, w skrajnym przypadku korektą do zera i nową fakturą.

Czy KSeF sprawdza poprawność kwot i stawek VAT?

Nie. KSeF waliduje głównie zgodność pliku XML ze strukturą logiczną FA(3) oraz uprawnienia i duplikaty. Za poprawność kwot, stawek i danych kontrahenta odpowiada wystawca — dlatego walidację merytoryczną warto mieć w programie do fakturowania, przed wysyłką.

Od kiedy grożą kary za błędy w KSeF?

Zgodnie z obecną ustawą kary z art. 106ni ustawy o VAT obowiązują od 1 stycznia 2027 r. Ministerstwo Finansów zapowiedziało 16 września 2026 r. ich przesunięcie na 1 stycznia 2028 r. — to projekt ustawy, jeszcze nieuchwalony. Przesunięcie dotyczy tylko kar, a nie samego obowiązku korzystania z KSeF, który działa już od 1 lutego 2026 r. (największe firmy) i 1 kwietnia 2026 r. (pozostali podatnicy; najmniejsi — od 1 stycznia 2027 r.).