Rozwiązywanie problemów z KSeF

Najczęstsze sytuacje i sposób postępowania.
Klient KSeF nie jest uruchomiony
Program spróbuje uruchomić KSeF Client samodzielnie. Jeśli to się nie powiedzie, uruchom go ręcznie z menu Start i powtórz synchronizację.
Brak pliku KSeF_Client.exe albo skopiowano wersję z innego rocznika
Nie kopiujemy KSeF Client ręcznie. Faktura VAT 2027 pobiera go sama i sprawdza sumę kontrolną pliku — ręcznie wgrany plik z innego rocznika nie zadziała, a objawy są mylące (klient nie startuje, sesja zostaje nieaktywna, faktury nie dostają numeru KSeF).
Rocznik 2027 ma własną wersję klienta. Pliki z adresu …/pliki/ksef/ należą do
rocznika 2026 i do 2027 nie pasują — podobnie jak katalog C:\RAFSOFT\KSEF
(2026) nie jest tym samym co C:\RAFSOFT\KSEF2027.
Gdy plik zniknął albo wgrano niewłaściwy:
- Zamknij Fakturę VAT 2027.
- Zamknij KSeF Client — przy zegarze Windows kliknij strzałkę „Pokaż ukryte ikony”, prawym przyciskiem na ikonie klienta, Zakończ.
- Usuń błędnie skopiowany
KSeF_Client.exez kataloguC:\RAFSOFT\KSEF2027\. - Uruchom Fakturę VAT 2027 — program wykryje brak pliku i pobierze właściwą wersję sam.
- Uruchom synchronizację i sprawdź, czy dolny pasek klienta jest zielony.
Dane (token, ustawienia, pliki out/in) leżą w podkatalogach C:\RAFSOFT\KSEF2027\
osobno dla każdego NIP-u, więc usunięcie samego pliku programu ich nie dotyka.
Tryb KSeF wyłączony
Synchronizacja nic nie wyśle, dopóki obsługa KSeF nie jest włączona w ustawieniach klienta. Program zaproponuje otwarcie tych ustawień.
Nic się nie wysłało, choć faktury są wystawione
Sprawdź po kolei:
- czy lista przed wysyłką nie została anulowana albo pozycje odznaczone,
- czy dokument nie jest zablokowany — takie wiersze są na liście czerwone; blokadę zdejmuje Odblokuj wysyłkę do KSeF w menu pod prawym przyciskiem myszy,
- czy nie jest zaznaczone Tylko zaznaczone przy pustym zaznaczeniu.
Blokada wygrywa nawet z ręcznym zaznaczeniem — to celowe.
Faktury zakupowej nie ma na liście dokumentów
Najpewniej czeka w buforze: menu KSeF → Faktury zakupowe do zatwierdzenia…. Jeśli tam jej nie ma, została już wcześniej zaimportowana (program nie pokazuje powtórek) albo świadomie pominięta przyciskiem Pomiń zaznaczone.
Wiersza w buforze nie da się zaznaczyć
Wyszarzone pozycje to własna faktura sprzedażowa, która wróciła kanałem zakupowym, albo plik, którego nie da się odczytać. Są widoczne po to, żeby było wiadomo, co odpadło.
Pobiera tylko ostatnie ~30 dni, mimo ustawionej wcześniejszej daty
Przyczyną jest limit API KSeF, nie ustawienie programu. Jedno zapytanie o faktury może obejmować najwyżej 3 miesiące kalendarzowe — dłuższy zakres Ministerstwo Finansów odrzuca błędem 21405. Program sam przycina wtedy datę początkową do trzech miesięcy wstecz i zapisuje to w logu: „Zakres … dni > 3 miesiące – ograniczam DateFrom automatycznie”.
Przykład: zakres od 01.04.2026 przy synchronizacji 15.10.2026 to 197 dni, więc pobiorą się faktury od 16.07.2026.
Jak pobrać starsze faktury:
- Ustaw zakres na trzy miesiące (najstarszy okres, który Cię interesuje).
- Uruchom synchronizację i poczekaj na zakończenie.
- Przesuń zakres na kolejny kwartał i powtórz.
Pojedyncze starsze faktury szybciej pobrać z Aplikacji Podatnika i wczytać do programu.
Nie klikaj synchronizacji wielokrotnie pod rząd. Zapytanie o listę faktur ma limit 20 na godzinę — najsurowszy w API KSeF. Po jego przekroczeniu KSeF odmawia na godzinę, niezależnie od ustawień programu.
Czego to NIE jest wina: opcja „Zatwierdzaj faktury zakupowe przed importem” decyduje tylko o tym, czy faktury trafiają najpierw do bufora, czy od razu tworzą dokumenty zakupu. Nie ma wpływu na zakres dat.
Korekta w KSeF pokazuje tylko kwotę netto, bez VAT i brutto
To nie błąd. Korekta w KSeF wykazuje kwoty różnic, a nie pełne wartości faktury — tak wymaga art. 106j ust. 2 pkt 5 ustawy o VAT. Program liczy je jako (stan po korekcie) minus (stan przed korektą).
Gdy korekta dotyczy tylko danych formalnych — terminu płatności, adresu, numeru zamówienia, daty — kwoty się nie zmieniają, więc wszystkie różnice wynoszą zero. Dlatego w podglądzie KSeF nie widać kwoty VAT ani brutto: nie ma czego korygować.
W programie podgląd i wydruk korekty pokazują pełne kwoty (netto, VAT, brutto) — bo opisują dokument, a nie zmianę. Różnica między jednym a drugim widokiem jest więc normalna.
Jak to sprawdzić:
- Otwórz Lista dokumentów [F5].
- Zaznacz korektę.
- Menu KSeF → podgląd nadanego numeru.
Jeśli korekta zmieniała kwoty (cenę, ilość, stawkę VAT), a w podglądzie KSeF nadal nie ma VAT ani brutto — to już jest powód do zgłoszenia. Do zgłoszenia dołącz numer wersji programu, numer korekty i zrzut obu podglądów.
Nie usuwaj ani nie edytuj korekty wysłanej do KSeF. Dokument przyjęty przez system ma nadany numer KSeF i nie da się go wycofać — poprawia się go kolejną korektą.
Błąd 440 — duplikat
Dokument o tym numerze już jest w systemie KSeF. Sprawdź, czy faktura nie ma już nadanego numeru KSeF — jeśli ma, wysyłka się powiodła i nie należy jej powtarzać. Blokada ponownego wysłania tego samego numeru jest celowa.
Błąd 13 — paczka wysłana z błędami
Po synchronizacji w oknie postępu pojawia się wiersz „Wystąpił błąd synchronizacji KSeF
(kod: 13)”, a zaraz po nim komunikat, np. „KSeF odrzucił 3 faktury z wysłanej paczki”.
Komunikat podsumowuje odrzucenia według kodu KSeF — ile faktur ma dany kod i przykład
z przyczyną — i kończy się tym samym numerem kodu (Kod błędu KSeF: 13). Ma kilka linii bez
względu na to, czy odrzucone są 3 faktury, czy 100.
Błąd 13 oznacza, że faktury dotarły do KSeF, ale system Ministerstwa Finansów odrzucił część z nich albo wszystkie. To nie jest problem z internetem ani z logowaniem do KSeF. Przyczyna jest podana osobno dla każdej faktury — najczęściej:
| Kod przy fakturze | Znaczenie | Co zrobić |
|---|---|---|
| 450 | błąd w treści faktury — dane się wykluczają albo brakuje wymaganego pola (np. niepoprawny NIP nabywcy) | popraw dokument według opisu i uruchom synchronizację ponownie |
| 440 | duplikat — faktura już jest w KSeF | nic; patrz Błąd 440 — duplikat |
| 430 | plik faktury nie przeszedł weryfikacji | uruchom synchronizację ponownie; jeśli błąd wraca, zgłoś go do pomocy technicznej |
Faktury z paczki mogą mieć różne kody — każdą poprawia się osobno, a po poprawkach wystarczy ponowna synchronizacja.
Pokrewne kody o tym samym komunikacie:
- 11 — KSeF odrzucił całą paczkę z powodu braku uprawnień (kod 410): NIP sprzedawcy na fakturach różni się od NIP-u, na który zalogowany jest KSeF Client. Sprawdź Dane podatnika i konfigurację KSeF Client.
- 12 — cała paczka niezgodna ze schematem faktury (kod 422). Opis błędu wskazuje pole.
Pełna lista odrzuconych faktur — każda z numerem dokumentu, kodem i opisem — jest w oknie
synchronizacji pod wierszem z kodem i w pliku C:\RAFSOFT\KSEF2027\ksef_sync.log
(wiersze SYNC: odrzucona przez KSeF). Przyczyna zostaje też przy każdej odrzuconej fakturze
w kolumnie Status KSeF (błąd: …), a pełna treść odpowiedzi KSeF — w pliku
C:\RAFSOFT\KSEF2027\ksef_startup.log, w wierszach zaczynających się od [BLAD].
Faktura odrzucona z błędem walidacji
Treść błędu wskazuje pole, które nie spełnia wymagań struktury FA. Najczęstsze przyczyny:
- brak wymaganego oznaczenia albo pola w danych kontrahenta,
- niepoprawny NIP,
- tekst w polu, które powinno zawierać wyłącznie wartość liczbową,
- data spoza dozwolonego zakresu.
Popraw dokument i wyślij ponownie.
Synchronizacja „w toku” mimo braku postępu
Poprzednia sesja wysyłki jeszcze się nie zakończyła. Odczekaj kilka minut — blokada zwalnia się automatycznie.
Status „przetwarzana” nie zmienia się
To normalne przy większym obciążeniu systemu KSeF. Program odświeża statusy cyklicznie; jeśli stan utrzymuje się bardzo długo, sprawdź komunikaty w oknie KSeF Client.
Gdzie szukać szczegółów
Przebieg wysyłki i treści błędów zapisywane są w plikach w katalogu
C:\RAFSOFT\KSEF2027\. Przy zgłoszeniu do pomocy technicznej warto podać numer
dokumentu i treść komunikatu.
Czy ta strona była pomocna?