Najczęściej zadawane pytania

Tak, w głównym walidatorze. GoKSeF to aplikacja Blazor Server — plik XML jest przesyłany do serwera GoKSeF przez szyfrowane połączenie HTTPS i przetwarzany w pamięci operacyjnej wyłącznie na czas walidacji.

Plik nie jest wysyłany do KSeF i nie jest archiwizowany jako historia faktur. Nie jest zapisywany na dysku serwera ani w bazie danych. Po zakończeniu sesji GoKSeF nie utrzymuje trwałej kopii treści XML.

Jeśli potrzebujesz węższego sprawdzenia po stronie przeglądarki, zobacz lokalną walidację beta. Ten tryb odczytuje XML w przeglądarce i nie wysyła pełnej treści XML do serwerowego walidatora GoKSeF, ale nie obejmuje MF/VIES, raportów PDF, batch ani historii walidacji.

Szczegóły architektury i bezpieczeństwa opisuje strona Bezpieczeństwo XML.

Nie w sensie ścisłym: faktura XML może zawierać dane osobowe, dane kontrahentów, kwoty, adresy i odniesienia do dokumentów.

GoKSeF minimalizuje przetwarzanie. Plik XML służy do pokazania wyniku walidacji, nie jest wysyłany do KSeF, nie jest archiwizowany i nie tworzymy historii faktur na koncie. Jeżeli to możliwe, używaj danych testowych lub zanonimizowanych.

Nie. Walidacja odbywa się po stronie naszego serwera w bezpiecznym środowisku — plik nigdy nie jest przekazywany do bramki KSeF Ministerstwa Finansów ani zapisywany długoterminowo.

Nie. Treść wgrywanego pliku XML jest przetwarzana wyłącznie w trakcie sesji walidacji i nie jest zapisywana po jej zakończeniu. Nie zbieramy ani nie przechowujemy zawartości Twoich faktur.

Dla ochrony przed nadużyciami i rate limitingu GoKSeF przetwarza adres IP albo pseudonimowy klucz techniczny wyliczony na jego podstawie. Produkcyjne liczniki mogą być przechowywane w Redis, ale nie są łączone z treścią XML.

Szczegóły w Polityce prywatności oraz na stronie Bezpieczeństwo XML.

Zacznij od XML wygenerowanego przez system źródłowy. Uruchom walidację, odczytaj pierwszy błąd blokujący, popraw dane u źródła, wygeneruj świeży XML i sprawdź plik ponownie.

Praktyczną ścieżkę krok po kroku opisuje przewodnik: jak zwalidować XML KSeF FA(3) przed wysyłką.

Walidator GoKSeF wykonuje trzy warstwy weryfikacji:

1. Składnia XML — encje, kodowanie UTF-8, BOM, struktura tagów. Wskazujemy linię i kolumnę błędu.
2. Schemat XSD FA(3) — zgodność z oficjalnym schematem opublikowanym przez Ministerstwo Finansów (FA-1.0E z 25.06.2025). Każde naruszenie z opisem po polsku.
3. Reguły logiczne — sumy brutto/netto, format NIP, spójność dat sprzedaży i wystawienia, stawki VAT, słowniki KSeF.

Nie. GoKSeF sprawdza składnię XML, zgodność z lokalnym pakietem XSD FA(3) oraz wybrane reguły semantyczne i biznesowe. Pozytywny wynik pomaga przygotować dokument do wysyłki, ale nie gwarantuje przyjęcia przez KSeF.

KSeF może stosować dodatkowe albo niezależnie aktualizowane kontrole we własnym środowisku. Wynik GoKSeF ma charakter pomocniczy i informacyjny — patrz pytanie poniżej.

Nie. Pozytywny wynik walidacji w GoKSeF oznacza, że plik spełnia zweryfikowane przez nas reguły techniczne — ale nie jest tożsamy z gwarancją przyjęcia przez system KSeF Ministerstwa Finansów.

KSeF stosuje własny zestaw reguł walidacyjnych, który może różnić się od zakresu wdrożonego w GoKSeF lub być aktualizowany niezależnie. Wynik GoKSeF ma charakter pomocniczy i informacyjny — nie zastępuje weryfikacji w środowisku KSeF.

Przeanalizuj komunikaty walidatora — wskazują dokładnie, którego fragmentu pliku XML dotyczy błąd (linia, kolumna, opis problemu). Najczęstsze przyczyny: brak wymaganego pola, nieprawidłowy format danych, błędna wartość, problem z kwotami, datami, danymi kontrahenta lub niezgodność ze strukturą FA(3).

Jeżeli plik pochodzi z systemu ERP lub księgowego, przekaż wynik walidacji osobie odpowiedzialnej za konfigurację lub integrację systemu — to typowo problem mapowania danych do FA(3).

FA(3) to trzecia główna wersja struktury logicznej e-Faktury wymaganej przez KSeF. Jest to plik XML zgodny ze schematem XSD opublikowanym przez Ministerstwo Finansów (wersja 1-0E).

FA(3) wprowadza zmiany względem wcześniejszych struktur logicznych, dlatego systemy fakturowe, ERP i księgowe powinny zostać zweryfikowane pod kątem zgodności z aktualnym schematem. Poprzednie wersje FA(1) i FA(2) nie będą akceptowane przez KSeF po wdrożeniu nowej struktury.

Walidator przyjmuje pliki w formacie .xml o maksymalnym rozmiarze 5 MB. Możesz wgrać plik przez drag&drop, przycisk wyboru lub wkleić treść XML bezpośrednio w pole tekstowe.

Rekomendujemy korzystanie z danych testowych lub zanonimizowanych, jeśli nie ma konieczności walidacji pliku z rzeczywistymi danymi kontrahentów.

Walidator jest darmowy — 5 sprawdzeń dziennie bez logowania lub 10 dziennie po zalogowaniu na konto free. Plany PRO i FIRMA z trybem zbiorczym są w przygotowaniu — zobacz cennik.

Bez logowania: 5 walidacji dziennie z jednego adresu IP. Po zalogowaniu (konto free): 10 walidacji dziennie. Limit resetuje się o północy.

Dla większych wolumenów — tryb zbiorczy i plan PRO z rozszerzonymi limitami są w przygotowaniu.

Limit odnawia się o północy. Jeśli potrzebujesz większych wolumenów — tryb zbiorczy jest w przygotowaniu, a dla firm z ERP, własnym systemem fakturowania lub bazą SQL — Szczegóły integracji.

Tryb zbiorczy umożliwi walidację wielu plików XML jednocześnie — przesłanie całej paczki faktur i otrzymanie zbiorczego raportu z wynikami dla każdego pliku.

Funkcja jest w przygotowaniu i będzie dostępna w ramach płatnego planu PRO. Aby otrzymać powiadomienie o uruchomieniu, zostaw adres e-mail na stronie trybu zbiorczego.

Walidator FA(3) to szybkie narzędzie diagnostyczne — sprawdzasz pojedynczy plik XML i dostajesz raport błędów w sekundę. Idealny do diagnozy konkretnego pliku.

Integracja KSeF to pełna usługa B2B prowadząca firmę od danych w ERP/SQL aż do procesu wysyłki do KSeF i monitoringu jakości. Walidacja jest jednym z etapów kontroli jakości — nie całą usługą.

Jeżeli problem dotyczy całego procesu, wielu faktur, mapowania danych albo Waszej bazy SQL — naturalnym kolejnym krokiem jest integracja systemu z KSeF.

Pięć etapów: (1) analiza środowiska i źródeł danych — ERP, baza SQL, logika faktur; (2) mapowanie pól faktury do XML FA(3) zgodnego ze schematem MF; (3) walidacja techniczna i logiczna; (4) przygotowanie procesu wysyłki do bramki KSeF (obsługa odrzuceń, ponowień, identyfikatorów KSeF); (5) monitoring błędów i jakości danych w aplikacji online.

Każdy etap przy wsparciu naszego zespołu — Szczegóły integracji.

Tak — to typowy scenariusz integracji. Rozpoznajemy strukturę bazy, niestandardową logikę faktur i przekładamy dane na poprawny XML FA(3) zgodnie ze schematem Ministerstwa Finansów (FA-1.0E).

Nie obiecujemy gotowego wdrożenia „od ręki" — zakres i harmonogram zależą od ERP, jakości danych i Waszego procesu. Zapytaj o integrację, żeby zobaczyć co realnie da się zrobić u Was.

Tak. Walidator GoKSeF sprawdzi pojedynczy XML wygenerowany przez ERP, system księgowy, CRM, e-commerce lub własne narzędzie fakturowe — o ile plik ma format faktury ustrukturyzowanej FA(3). Wynik posłuży do diagnozy konkretnego problemu.

Jeśli błędy są systemowe (powtarzają się na wielu fakturach, dotyczą mapowania danych, słowników KSeF lub całego procesu wysyłki) — to sygnał, że potrzebna jest integracja systemu z KSeF, a nie tylko diagnoza pojedynczego XML.

KSeF (Krajowy System e-Faktur) to centralny system teleinformatyczny Ministerstwa Finansów umożliwiający wystawianie, przesyłanie i archiwizowanie faktur ustrukturyzowanych w Polsce.

Terminy obowiązkowego korzystania z KSeF zależą od grupy podatników oraz aktualnego stanu przepisów. Przed podjęciem decyzji należy sprawdzić aktualne komunikaty Ministerstwa Finansów i KAS — ksef.podatki.gov.pl.

Nie. GoKSeF jest narzędziem technicznym i pomocniczym. Pomaga sprawdzić plik XML faktury pod kątem określonych reguł walidacyjnych, ale nie zastępuje profesjonalnej analizy podatkowej, prawnej ani księgowej.

W sprawach interpretacji przepisów, obowiązków podatkowych, odpowiedzialności lub decyzji księgowych należy skonsultować się z właściwym specjalistą.