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:
| Wynik | Co oznacza |
|---|---|
| Brak błędów strukturalnych | Plik XML jest zgodny ze schematem FA(3) |
| Rachunek na białej liście | Numer konta jest zarejestrowany w wykazie VAT |
| Błąd struktury | Konkretne pole jest niepoprawne lub brakujące |
| Rachunek nieznaleziony | Konto 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:
- Wprowadź korektę w systemie FK (zwykle nie edytuje się XML ręcznie).
- Wygeneruj poprawiony plik XML.
- Ponownie sprawdź go walidatorem (krok 2).
- 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?
| Sytuacja | Zalecane podejście |
|---|---|
| Jednostkowa faktura przed wysłaniem | Narzędzie online (np. Weryfikacja Faktur) |
| Integracja systemu FK z KSeF | Walidacja lokalna względem schematu XSD FA(3) |
| Masowa wysyłka faktur | Walidacja wsadowa (np. przez API lub skrypty) |
| Sprawdzenie rachunku bankowego | Narzędzie online (biała lista VAT) |
Powiązane artykuły
- Błędy walidacji KSeF – co oznaczają – kody błędów i ich znaczenie
- Walidacja techniczna vs walidacja biznesowa – porównanie zakresów kontroli
- Jak działa walidacja techniczna faktury w KSeF – mechanizm wewnątrz systemu
- Jak sprawdzić rachunek bankowy z faktury – weryfikacja konta w wykazie VAT
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.