Węzeł 'FakturaZaliczkowa' - jak poprawnie linkować dokumenty?

Co się stanie, jeśli pominięty zostanie węzeł Fa/Zamowienie

AITekst opracowany z wykorzystaniem sztucznej inteligencji. Zasady i ograniczenia

Pominięcie węzła Fa/Zamowienie w strukturze faktury ustrukturyzowanej typu ZAL (zaliczkowa) uniemożliwia jej skuteczne wprowadzenie do obrotu prawnego w ramach Krajowego Systemu e-Faktur. Zgodnie z nowymi wytycznymi technicznymi, które weszły w życie 23 grudnia 2025 r., system KSeF nie przyjmuje dokumentów zaliczkowych pozbawionych tej sekcji. Brak wymaganego powiązania skutkuje natychmiastowym błędem krytycznym, co oznacza, że faktura ustrukturyzowana nie otrzymuje numeru identyfikującego i nie jest uznana za wystawioną w rozumieniu art. 106na ust. 1 ustawy o VAT.

Wielu podatników uważa, że wystawienie faktury zaliczkowej bez powołania się na konkretne zamówienie jest dopuszczalne, jednak walidator systemowy weryfikuje obecność tagów w czasie rzeczywistym. Najczęstsze komunikaty błędów, które pojawiają się na ekranie użytkownika, to: „Błąd walidacji: Element 'Fa/Zamowienie' jest wymagany dla typu ZAL”, „Brak wymaganego węzła Fa/Zamowienie” oraz „Kod błędu 422: Nieprawidłowa struktura XML - brak sekcji zamówienia”. System odrzuca plik na etapie wstępnej weryfikacji - nie ma przebacz.

Niezachowanie spójności struktury generuje poważne konsekwencje dla wszystkich stron transakcji. W relacji biznesowej Inwestor traci czas na wyjaśnianie statusu płatności, Księgowy traci możliwość odliczenia podatku naliczonego z wadliwego dokumentu, a Firma ryzykuje karę administracyjną za wadliwe wystawianie faktur. W związku z powyższym, przed wysłaniem dokumentu do bramki MF, podatnik musi upewnić się, że w wygenerowanym pliku XML znajduje się sekcja <Fa><Zamowienie>...</Zamowienie></Fa>.

Jak fizycznie utworzyć poprawne powiązanie w pliku XML

Prawidłowa lokalizacja węzła w strukturze logicznej FA(3) jest ściśle zdefiniowana w schemie XML. Element ten musi znajdować się pod ścieżką XPath: /Fa/JPK_Fa/Fa/Zamowienie. W ramach tego węzła system wymaga podania trzech kluczowych składowych: ZamowienieNr (identyfikator dokumentu zamówienia), ZamowienieData (data wystawienia zamówienia lub zawarcia umowy) oraz ZamowienieWartosc (całkowita kwota brutto zamówienia). Wartość w polu ZamowienieWartosc musi być zawsze większa od 0,00 zł, a format daty musi być zgodny z normą ISO 8601 (RRRR-MM-DD).

Oprogramowanie interfejsowe pobiera te dane najczęściej z modułu zamówień od odbiorców. Należy pamiętać, że element Fa/Zamowienie/ZamowienieWiersz umożliwia podanie szczegółowych danych dotyczących przedmiotu zamówienia, przy czym maksymalna liczba wierszy zamówienia może wynosić aż 10 000 pozycji zgodnie ze specyfikacją KSeF v. 1.7. Bezwzględnie obligatoryjne jest wskazanie wartości brutto całego zamówienia lub umowy w polu Fa/Zamowienie/WartoscZamowienia, co pozwala systemowi na weryfikację, czy suma wystawionych zaliczek nie przekracza wartości kontraktu.

Poniżej przedstawiono fragment poprawnej struktury XML dla faktury zaliczkowej:

<Fa>
<RodzajFaktury>ZAL</RodzajFaktury>
<Zamowienie>
<ZamowienieNr>ZAM-12/2025</ZamowienieNr>
<ZamowienieData>2025-06-01</ZamowienieData>
<ZamowienieWartosc>50000.00</ZamowienieWartosc>
</Zamowienie>
</Fa>

Zaleca się, aby numer zamówienia wpisywany w polu ZamowienieNr był identyczny z numeracją stosowaną w systemie ERP, ponieważ KSeF weryfikuje wszelkie niezgodności i literówki, co może utrudnić późniejsze automatyczne parowanie dokumentów. Prawidłowo przygotowany plik XML pozwala na automatyzację procesów księgowych po stronie nabywcy, który otrzymuje fakturę ustrukturyzowaną w dniu jej przesłania do systemu centralnego.

Wiele zaliczek do tego samego zamówienia - kolejność referencji

W przypadku transakcji o wysokiej wartości, gdzie płatność jest dzielona na kilka etapów, każda kolejna faktura zaliczkowa musi tworzyć logiczny łańcuch referencyjny. Zgodnie z art. 106f ust. 4 pkt 2 ustawy o podatku od towarów i usług, faktura końcowa musi zawierać numery wszystkich faktur wystawionych przed wydaniem towaru lub wykonaniem usługi. W systemie KSeF oznacza to konieczność odwoływania się do unikalnych numerów identyfikacyjnych (UID KSeF) poprzednich dokumentów. Brak pełnej listy referencyjnej skutkuje błędem struktury 403 i odrzuceniem dokumentu przez bramkę MF.

Proces linkowania kolejnych dokumentów powinien przebiegać według ściśle określonego schematu:

1. FZ-1 (Pierwsza zaliczka): Dokumentuje pierwszą wpłatę, zawiera tylko węzeł Fa/Zamowienie.
2. FZ-2 (Druga zaliczka): Zawiera węzeł Fa/Zamowienie oraz referencję do numeru KSeF pierwszej faktury (FZ-1).
3. FZ-KOŃC (Faktura końcowa): Ostatni dokument musi zamknąć wszystkie poprzednie UID-y, wskazując pełną historię wpłat w elemencie Fa/FakturaZaliczkowa.

Poniższa tabela ilustruje modelowe powiązania między dokumentami w procesie wieloetapowym:

Przed wystawieniem faktury końcowej, podatnik powinien wyeksportować listę UID-ów poprzednich faktur z panelu „Dokumenty powiązane” w swoim oprogramowaniu finansowo-księgowym. W sytuacji, gdy faktury zaliczkowe obejmują 100% należnego wynagrodzenia, w fakturze końcowej powinien zostać „wyzerowany podatek”, co potwierdza rozliczenie całości transakcji na etapach wcześniejszych. Ponadto, do odwoływania się do poprzednich faktur zaliczkowych w strukturze FA(3) przeznaczony jest dedykowany element Fa/FakturaZaliczkowa.