Problem z wysyłką faktury do KSeF

Jeśli masz problem z wysłaniem faktury do KSeF, poniżej znajdziesz listę najczęstszych przyczyn i sposoby ich rozwiązania.

Krok 1: Sprawdź komunikat błędu

API KSeF zawsze zwraca odpowiedź z informacją o błędzie. Zanim cokolwiek zmienisz, przeczytaj dokładnie treść błędu — często wskazuje dokładnie, co jest nie tak.

Najczęstsze problemy z wysyłką faktury

Problem 1: Błąd walidacji XML (kod 400)

Faktura nie przeszła walidacji schematu XSD.

Sprawdź:

•Czy XML jest zgodny ze schematem FA(2) opublikowanym przez MF

•Czy wszystkie wymagane pola są wypełnione (NIP sprzedawcy, NIP nabywcy, kwoty)

•Czy daty są w prawidłowym formacie (YYYY-MM-DD)

•Czy kwoty netto + VAT = brutto

Problem 2: Nieaktywna lub wygasła sesja (kod 401)

Próbujesz wysłać fakturę bez aktywnej sesji lub sesja wygasła.

Rozwiązanie: Otwórz nową sesję przez InitToken i użyj zwróconego SessionToken.

Problem 3: Brak uprawnień (kod 403)

Token nie ma uprawnień do wysyłki faktur dla danego NIP-u.

Rozwiązanie: Sprawdź zakres uprawnień tokena. Wygeneruj nowy z uprawnieniem do wysyłki.

Problem 4: Duplikat faktury

KSeF odrzuca fakturę, którą już wcześniej wysłałeś.

Sprawdź: Numer faktury — jeśli taka faktura jest już w KSeF, nie możesz jej wysłać ponownie. Jeśli poprzednia próba zakończyła się błędem, sprawdź czy faktura faktycznie nie trafiła do systemu.

Problem 5: Niedostępność serwera KSeF

Czasem serwery KSeF są niedostępne (przerwy techniczne, przeciążenie).

Sprawdź: Status serwisów MF. Implementuj retry z opóźnieniem.

Problem 6: Błąd NIP nabywcy

KSeF może weryfikować poprawność NIP nabywcy.

Sprawdź: Czy NIP nabywcy jest prawidłowy i zarejestrowany w systemie VIES/MF.

Jak debugować problem?

1.Loguj pełne żądania i odpowiedzi API

2.Sprawdź kod błędu HTTP i treść odpowiedzi JSON

3.Zweryfikuj XML faktury walidatorem XSD przed wysłaniem

4.Testuj na środowisku testowym KSeF

Szybsze rozwiązanie

Nasze [proxy KSeF](/proxy-ksef) wychwytuje i loguje wszystkie błędy wysyłki, upraszczając diagnostykę. [Skontaktuj się z nami](/kontakt) po pomoc techniczną.

Problem z wysyłką faktury do KSeF — rozwiązania