Przewodnik · Walidacja FA(3)

Przechodzi lokalną XSD, a KSeF nadal odrzuca — jak szukać rozjazdu

XSD to baza, ale nie pełny obraz. KSeF wykonuje dodatkowe walidacje semantyczne i biznesowe, które potrafią zatrzymać poprawnie wyglądający lokalnie XML.

Typ

Przewodnik

Warstwa

Walidacja FA(3)

Skutek

Ostrzeżenie

Typowy komunikat GoKSeF

Plik wygląda poprawnie lokalnie, ale KSeF zwraca błąd semantyczny albo biznesowy, którego nie widać w podstawowej kontroli XSD.

Źródłem problemu najczęściej są dane wejściowe, mapowanie pól albo rozjazd między plikiem walidowanym lokalnie i plikiem rzeczywiście wysyłanym do KSeF.

Jak to poprawić

  1. 1 Zacznij od lokalnej walidacji XSD, a następnie przejdź do walidacji semantycznej i biznesowej.
  2. 2 Sprawdź zgodność mapowania pól z nowoczesnym FA(3), szczególnie identyfikatorów, dat i sum VAT.
  3. 3 Zweryfikuj, czy generator nie generuje powtarzalnych prefiksów lub niepełnych numerów (np. REGON, VAT-UE, NIP).
  4. 4 Oddziel problem dokumentu od problemu integracji: najpierw potwierdź, czy KSeF odrzuca sam XML, czy operację wysyłki/odczytu.
  5. 5 Jeżeli błąd pozostaje niejasny, porównaj raport GoKSeF z pełną odpowiedzią API KSeF i logiem generatora.

Sprawdź przed ponowną walidacją

  • Lokalny raport XSD i semantyczny jest czysty.
  • Identyfikatory i mapowania po stronie źródła są spójne i kompletne.
  • Środowisko API, token i certyfikat są wzajemnie zgodne.

FAQ

Dlaczego GoKSeF sprawdza coś więcej niż XSD?
Bo XSD nie obejmuje wszystkich walidacji biznesowych i semantycznych, których wymaga KSeF.
Czy po lokalnym OK XSD mogę od razu ponawiać wysyłkę?
Nie od razu. Najpierw wyeliminuj niespójności danych i statusu, dopiero potem podejmuj kolejną próbę.

Powiązane artykuły

Przewodnik · Walidacja XML / kodowanie

XML: błąd kodowania, prologu UTF-8 i białych znaków

Tego typu problemy są częste i podstępne: komunikat wygląda na merytoryczny, a źródło błędu okazuje się czysto techniczne.

Przewodnik · Walidacja XML / kodowanie

FA(3): lokalna walidacja przechodzi, ale API KSeF nadal odrzuca XML

To techniczny wariant rozjazdu między lokalną walidacją i zachowaniem API KSeF.

Przewodnik · KSeF API / status

Faktura wysłana do KSeF, ale brak numeru KSeF albo UPO

Dokument został przekazany do KSeF, ale numer KSeF albo UPO nie są jeszcze dostępne.

Przewodnik · KSeF API / status

Faktura w trakcie przetwarzania w KSeF — co to znaczy

Status przetwarzania nie musi oznaczać błędu, ale wymaga świadomej kontroli i dalszej diagnostyki.

Sprawdź poprawiony plik

Po poprawieniu danych źródłowych wygeneruj XML ponownie i sprawdź nowy plik w GoKSeF.

Przejdź do walidatora Inne błędy