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, a okres przejściowy bez kar kończy się 31 grudnia 2026 r. Od 1 stycznia 2027 r. urząd może już nakładać kary pieniężne za naruszenia związane z KSeF (biznes.gov.pl).

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 data sprzedaży P_6),

• 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, faktura zostaje przyjęta jako wystawiona w trybie offline24, a datą wystawienia jest data z pola P_1.

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 token, nieważny certyfikat KSeF, 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ć: odśwież lub wygeneruj nowy token/certyfikat i zweryfikuj uprawnienia w module uprawnień 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)

• [ ] Token / certyfikat KSeF 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 od 1 stycznia 2027 r. błędy przestaną być tylko irytujące i zaczną kosztować.

Biurko waliduje fakturę względem schemy FA(3), sprawdza NIP kontrahenta, pilnuje numeracji i automatycznie pobiera UPO — zanim cokolwiek trafi do KSeF. 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 wyłącznie 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?

Kary pieniężne za naruszenia związane z KSeF mogą być nakładane od 1 stycznia 2027 r. Do 31 grudnia 2026 r. trwa okres przejściowy bez sankcji, ale obowiązek wystawiania faktur w systemie działa już od 1 lutego (duże firmy) i 1 kwietnia 2026 r. (pozostali podatnicy).