Wróć do walidatora

Wiedza GoKSeF

Jak zwalidować XML KSeF FA(3) przed wysyłką

Walidacja to techniczny punkt kontroli przed formalną ścieżką KSeF. Pomaga sprawdzić, czy plik XML faktury jest czytelny, zgodny z FA(3) i nie zawiera wybranych niespójności logicznych.

Otwórz walidator XML Najczęstsze błędy

Na co ma odpowiedzieć walidacja

Czy plik jest technicznie czytelny?

Pierwsza warstwa sprawdza, czy dokument jest poprawnym XML-em i da się go bezpiecznie odczytać.

Czy pasuje do FA(3)?

Warstwa schematu sprawdza wymagane pola, formaty wartości i reguły strukturalne z pakietu XSD FA(3).

Czy wybrane dane są logicznie spójne?

GoKSeF dodaje wybrane kontrole semantyczne i merytoryczne, np. dotyczące identyfikatorów, stawek VAT, sum, dat i walut.

Co poprawić dalej?

Dobry raport powinien wskazać pole, wyjaśnić skutek i podpowiedzieć, czy poprawić XML, czy dane w systemie źródłowym.

Rekomendowana ścieżka sprawdzenia

  1. 1 Przygotuj plik XML wygenerowany przez system źródłowy, a nie ręcznie poprawianą kopię, jeśli możesz tego uniknąć.
  2. 2 Uruchom walidację i najpierw sprawdź blokery: składnia XML i błędy XSD FA(3) zwykle zatrzymują proces najwcześniej.
  3. 3 Odczytaj nazwę pola, linię albo ścieżkę techniczną oraz podpowiedź naprawy. Gdy błąd wynika z danych generowanych automatycznie, popraw system źródłowy.
  4. 4 Wygeneruj świeży XML i sprawdź go ponownie. Nie zakładaj, że poprawa jednego pola automatycznie naprawia sumy, stawki VAT albo odniesienia.
  5. 5 W realnym procesie wysyłki zostaw miejsce na przegląd merytoryczny tego, czego nie da się potwierdzić z pojedynczego XML.

Pełny walidator czy tryb lokalny?

Użyj pełnego walidatora, gdy potrzebujesz raportu

Walidator serwerowy daje raport operatora, podgląd faktury, eksport PDF oraz informacje o kontrahentach, gdy odpowiednie funkcje są włączone.

Użyj trybu lokalnego do węższej kontroli technicznej

Lokalna walidacja odczytuje wybrany plik XML w przeglądarce i nie wysyła go do serwerowego walidatora, ale nie obejmuje MF/VIES, PDF, batch ani historii.

Ważne ograniczenie

Pozytywny wynik GoKSeF nie gwarantuje ostatecznego przyjęcia przez KSeF i nie jest wiążącą poradą podatkową, prawną ani księgową. Traktuj go jako techniczną bramkę jakości przed kolejnym krokiem procesu.

FAQ

Czy GoKSeF wysyła fakturę do KSeF?
Nie. GoKSeF sprawdza XML przed formalną wysyłką. Nie jest końcowym kanałem transmisji do KSeF.
Czy pozytywny wynik gwarantuje przyjęcie przez KSeF?
Nie. Oznacza, że plik przeszedł kontrole zaimplementowane w GoKSeF. Ostateczne przyjęcie zależy od szerszego procesu i środowiska wysyłki.
Co zwykle zrobić jako pierwsze po błędzie?
Popraw dane źródłowe w ERP, systemie księgowym albo fakturowym, wygeneruj XML ponownie i sprawdź nowy plik.
Kiedy użyć lokalnej walidacji?
Gdy potrzebujesz węższej kontroli technicznej XML/FA(3) w przeglądarce i nie potrzebujesz MF/VIES, PDF, batch ani historii.

Zacznij od swojego pliku

Sprawdź XML, odczytaj pierwszy błąd blokujący, popraw dane źródłowe i wygeneruj plik ponownie.

Otwórz walidator XML Walidacja lokalna