KSeF8 min

Faktura ustrukturyzowana FA(3): co musi zawierać

Przegląd pól krytycznych i najczęstszych błędów, które powodują odrzucenie dokumentu przez system.

faktura ustrukturyzowanafa3ksef schema

Dane obowiązkowe i walidacje

Schemat FA(3) zawiera pola, które muszą być spójne logicznie, nie tylko formalnie. Nawet poprawne technicznie wartości mogą być odrzucone, jeśli relacje między polami są niespójne.

Dlatego warto wdrożyć dwuetapową kontrolę: walidację techniczną schemy i walidację biznesową reguł wewnętrznych.

  • Walidacja struktury XML.
  • Walidacja relacji kwot i stawek.
  • Walidacja danych kontrahenta.

Najczęstsze błędy w praktyce

Najwięcej błędów pojawia się przy korektach, dokumentach zaliczkowych i nietypowych scenariuszach sprzedaży. Powodem bywa brak spójnego modelu danych między systemami.

Wdrożenie testów regresji na reprezentatywnych przykładach faktur znacząco ogranicza liczbę odrzuceń po uruchomieniu produkcji.

  • Błędy identyfikatora kontrahenta.
  • Niespójności wartości netto i VAT.
  • Problemy z dokumentami korygującymi.

Jak przygotować firmę do zmian schemy

Schemy i interpretacje mogą się zmieniać, dlatego nie warto kodować reguł na sztywno w wielu miejscach. Lepiej utrzymywać centralny moduł walidacji.

To podejście przyspiesza aktualizacje i pozwala uniknąć sytuacji, w której różne systemy firmowe stosują różne wersje reguł.

  • Centralny moduł reguł walidacji.
  • Wersjonowanie zmian w modelu faktury.
  • Automatyczne testy po każdej aktualizacji.