Jak zwalidować fakturę KSeF przed wysłaniem

Dlaczego warto walidować fakturę przed wysłaniem do KSeF

Gdy wysyłasz plik XML do KSeF, system sprawdza jego poprawność formalną oraz wybrane reguły logiczne.

Jeśli faktura nie spełnia wymagań – zostaje odrzucona. W praktyce oznacza to:

  • brak dokumentu sprzedaży w systemie KSeF,
  • konieczność poprawki i ponownej wysyłki,
  • ryzyko opóźnienia w rozliczeniach z kontrahentem.

Walidacja przed wysłaniem pozwala wychwycić błędy na etapie, gdy ich naprawa jest prosta. Zamiast czekać na odrzucenie przez system Ministerstwa Finansów – sprawdzasz plik lokalnie lub narzędziem online.


Dwa poziomy walidacji faktury KSeF

Przed wysłaniem faktury warto rozróżnić, co tak naprawdę chcesz sprawdzić:

1. Walidacja strukturalna (techniczna)

Czy plik XML jest zbudowany poprawnie?

Sprawdza:

  • zgodność ze schematem XSD (FA(3)),
  • obecność wszystkich pól obowiązkowych,
  • poprawność formatów (data, NIP, kwoty),
  • właściwą strukturę elementów.

To podstawowy zakres kontroli wykonywany również przez KSeF.

2. Walidacja biznesowa

Czy dane na fakturze są wiarygodne?

Sprawdza:

  • czy NIP wystawcy i nabywcy istnieje w rejestrze VAT,
  • czy numer rachunku bankowego figuruje w wykazie podatników VAT (tzw. biała lista),
  • czy kontrahent nie jest podmiotem zawieszonym.

KSeF nie wykonuje takiej weryfikacji. To pozostaje po stronie podatnika lub jego narzędzi.

Więcej o różnicach między tymi dwoma rodzajami walidacji znajdziesz w artykule: Walidacja techniczna vs walidacja biznesowa. Pełny zakres tego, co KSeF sprawdza (a czego nie), opisuje artykuł Co KSeF sprawdza, a czego nie sprawdza.


Jak zwalidować fakturę KSeF – krok po kroku

Krok 1: Pobierz plik XML faktury

Plik XML generuje Twój system finansowo-księgowy (FK) lub program do fakturowania.

Upewnij się, że pobierasz plik przed wysłaniem do KSeF – to właśnie ten dokument będziesz walidować.

Zwróć uwagę na:

  • rozszerzenie pliku (.xml),
  • kodowanie (UTF-8),
  • czy plik nie jest pusty lub uszkodzony.

Krok 2: Sprawdź plik darmowym walidatorem

Otwórz walidator KSeF na stronie Weryfikacja Faktur.

Narzędzie pozwala:

  • wczytać plik XML faktury,
  • sprawdzić zgodność ze schematem FA(3),
  • zweryfikować numer rachunku bankowego w wykazie VAT,
  • uzyskać wynik bez rejestracji i bez opłat.

Cały proces zajmuje kilkadziesiąt sekund.


Krok 3: Odczytaj wynik walidacji

Po sprawdzeniu otrzymujesz informację o statusie faktury:

WynikCo oznacza
Brak błędów strukturalnychPlik XML jest zgodny ze schematem FA(3)
Rachunek na białej liścieNumer konta jest zarejestrowany w wykazie VAT
Błąd strukturyKonkretne pole jest niepoprawne lub brakujące
Rachunek nieznalezionyKonto nie figuruje w wykazie VAT – wymaga dodatkowej weryfikacji

Jeśli walidator wskazuje błędy – przejdź do kroku 4.


Krok 4: Popraw błędy i wyślij do KSeF

Po zidentyfikowaniu problemów:

  1. Wprowadź korektę w systemie FK (zwykle nie edytuje się XML ręcznie).
  2. Wygeneruj poprawiony plik XML.
  3. Ponownie sprawdź go walidatorem (krok 2).
  4. Wyślij poprawiony plik do KSeF.

Najczęstsze błędy wykrywane przed wysłaniem

Poniższe problemy często nie są widoczne w podglądzie faktury w systemie FK, ale mogą prowadzić do odrzucenia przez KSeF albo sygnalizować ryzyko po stronie biznesowej.

Błędny format NIP

NIP powinien być zapisany jako 10 cyfr bez spacji i myślników.


Błędnie:  123-456-78-90
Poprawnie: 1234567890

Niepoprawny format daty

KSeF wymaga formatu YYYY-MM-DD.


Błędnie:  15.05.2026
Poprawnie: 2026-05-15

Brakujące pole obowiązkowe

Schemat FA(3) zawiera pola, których obecność jest wymagana. Pominięcie choćby jednego skutkuje odrzuceniem.

Najczęściej pomijane:

  • P_1 – data wystawienia faktury,
  • P_13_1 – podstawa opodatkowania (stawka 23%),
  • KodUE – w transakcjach wewnątrzwspólnotowych.

Niezgodność sum pozycji z podsumowaniem

Niezgodności rachunkowe mogą zostać wykryte przez KSeF w ramach walidacji lub ujawnić się na etapie rozliczeń.

Sytuacja, gdy suma wartości pozycji netto nie zgadza się z polem sumy całkowitej, to błąd, który może prowadzić do odrzucenia faktury albo późniejszych problemów podatkowych.


Rachunek bankowy poza białą listą

To nie jest błąd strukturalny – KSeF może przyjąć taką fakturę.

Jednak przelew na rachunek niewidniejący w wykazie podatników VAT może mieć konsekwencje podatkowe (np. ograniczenia w zaliczeniu wydatku do kosztów lub odpowiedzialność solidarna).

Dlatego warto sprawdzić rachunek przed płatnością.


Kiedy walidacja offline, a kiedy narzędzie online?

SytuacjaZalecane podejście
Jednostkowa faktura przed wysłaniemNarzędzie online (np. Weryfikacja Faktur)
Integracja systemu FK z KSeFWalidacja lokalna względem schematu XSD FA(3)
Masowa wysyłka fakturWalidacja wsadowa (np. przez API lub skrypty)
Sprawdzenie rachunku bankowegoNarzędzie online (biała lista VAT)

Powiązane artykuły


FAQ

Czy mogę zwalidować fakturę bez wysyłania do KSeF?

Tak. Walidacja lokalna lub online (np. przez walidator Weryfikacja Faktur) odbywa się poza systemem KSeF. Samo sprawdzenie pliku nie oznacza jego wysłania do Ministerstwa Finansów.


Co sprawdza walidator schematowy, czego nie sprawdza KSeF?

Walidator schematowy sprawdza zgodność XML ze schematem (XSD). KSeF oprócz tego stosuje także dodatkowe reguły walidacyjne (np. spójność danych, uprawnienia, kontekst wysyłki).

Natomiast walidatory online mogą dodatkowo sprawdzać elementy biznesowe (np. rachunek bankowy w wykazie VAT), których KSeF nie weryfikuje.


Faktura przeszła walidację, ale KSeF ją odrzucił – dlaczego?

Może to wynikać z:

  • braku uprawnień do wysyłania faktur w imieniu danego podmiotu,
  • pomylenia środowiska testowego z produkcyjnym,
  • duplikatu wysyłki,
  • dodatkowych reguł walidacyjnych stosowanych przez KSeF.

Czy walidacja faktury jest obowiązkowa?

Nie ma przepisu nakazującego walidację przed wysłaniem. Jednak odrzucona faktura nie jest uznawana za wystawioną w KSeF (nie otrzymuje numeru KSeF), więc w praktyce nie funkcjonuje jako dokument w systemie.

Dlatego walidacja to dobra praktyka, choć nie formalny obowiązek.


Ile czasu zajmuje walidacja online?

Kilkadziesiąt sekund. Wczytanie pliku XML i uzyskanie wyniku w walidatorze Weryfikacja Faktur trwa zazwyczaj poniżej minuty.


Treść ma charakter informacyjny i edukacyjny. Nie stanowi porady prawnej ani podatkowej.

Przydatne serwisy

Darmowa walidacja faktury KSeF

Sprawdź plik XML względem schematu XSD — bez rejestracji.

Status KSeF

Pierwszy serwis prezentuje informacje o statusie samego KSeF, drugi – komunikaty techniczne Ministerstwa Finansów.

Dalsze korzystanie z tej witryny oznacza akceptację Polityki prywatności . Używamy plików cookie, aby zapewnić najlepszą jakość korzystania z naszej witryny internetowej. Przeczytaj naszą Politykę plików cookie .
Akceptuj Odrzuć