Jak wykazać WZ w strukturze faktury ustrukturyzowanej? - praktyka KSeF 2026

Gdzie fizycznie umieścić numer WZ w XML FA(3)

AITekst opracowany z wykorzystaniem sztucznej inteligencji. Zasady i ograniczenia

Wielu podatników operuje w oparciu o błędne przekonanie, iż brak dedykowanego pola etykietowanego jako "WZ" w schemie XSD uniemożliwia powiązanie dokumentu magazynowego z fakturą. Należy jednak wskazać, że struktura faktury ustrukturyzowanej opiera się na uniwersalnych kontenerach danych, a błąd KSeF-412 (nieprawidłowy format dokumentu towarzyszącego) wynika zazwyczaj z błędnej składni, a nie braku możliwości technicznych. Element AdditionalDocumentReference służy właśnie do agregowania odniesień do dokumentów zewnętrznych, takich jak zamówienia, umowy czy właśnie dowody wydania zewnętrznego (WZ).

Zgodnie ze specyfikacją techniczną Ministerstwa Finansów, numer dokumentu WZ powinien zostać umieszczony w sekcji AdditionalDocumentReference przy użyciu atrybutu SchemeID="WZ". Dokładny XPath dla tego zapisu to /Invoice/cac:AdditionalDocumentReference/cbc:ID. Warto podkreślić, że AdditionalDocumentReference może wystąpić maksymalnie 99 razy w jednym pliku XML, co pozwala na rozliczenie zbiorcze wielu wydań magazynowych jedną fakturą ustrukturyzowaną. KSeF nie waliduje kolejności numerów WZ, a jedynie ich unikalność w obrębie danego dokumentu sprzedaży.

W procesie mapowania danych należy zwrócić szczególną uwagę na spójność identyfikatorów. Poniższa tabela przedstawia dopuszczalne warianty numeracji oraz ryzyka związane z ich implementacją w systemach DMS (Document Management System):

Przed pełnym wdrożeniem struktury FA(3) rekomenduje się ustalenie wewnętrznego standardu numeracji dokumentów magazynowych, aby uniknąć kolizji danych. Zaleca się również przetestowanie środowiska demo KSeF, ponieważ pliki XML są tam odrzucane z identycznymi komunikatami błędów jak w środowisku produkcyjnym, co pozwala na wczesne wykrycie nieprawidłowości w węźle AdditionalDocumentReference.

Automatyzacja: jak ERP wpisuje WZ bez ręcznego klikania

W profesjonalnych systemach klasy ERP, takich jak Subiekt nexo, proces generowania dokumentów magazynowych jest zintegrowany z wystawianiem faktur sprzedaży. W nexo wystarczy zaznaczyć flagę "Generuj WZ przy zapisie FS", co uruchamia procedurę automatycznego powiązania dokumentów w bazie danych. Użytkownik może skonfigurować to ustawienie w sekcji Sprzedaż / Ustawienia / Dokumenty towarzyszące. System w tle wykonuje instrukcję SELECT NEXT VALUE FOR WZ_SEQ, aby pobrać kolejny numer z sekwencji i automatycznie wstawić go do struktury XML przesyłanej do Krajowego Systemu e-Faktur.

Fakturownia oraz inne systemy działające w modelu SaaS pozwalają zautomatyzować proces tworzenia dokumentów magazynowych WZ i PZ dzięki wykorzystaniu mechanizmów API oraz webhooków. W przypadku tych rozwiązań numer WZ będzie widoczny na wydruku faktury, jeżeli wystawimy go równocześnie z dodawaną fakturą. Jeśli w kolumnie "DM" na liście dokumentów widnieje oznaczenie potocznie zwane "ptaszkiem", oznacza to, że faktura jest poprawnie powiązana z dokumentem magazynowym i informacja ta zostanie przekazana do KSeF.

Proces automatyzacji w systemach webowych przebiega zazwyczaj według poniższej procedury:

1. Aktywacja integracji z KSeF w panelu administracyjnym systemu ERP.
2. Zdefiniowanie prefiksu dla dokumentów WZ (np. "WZ/MAG1/").
3. Weryfikacja struktury payloadu webhooka wysyłanego na endpoint /api/ksf/doc-reference.
4. Monitorowanie logów zdarzeń w katalogu storage/logs/ksf-error.log w celu wyłapania błędów transmisji.

Należy zauważyć, że Subiekt nexo w wersji 2025.1.3 automatycznie wstawia numer WZ do pola AdditionalDocumentReference bez konieczności zakupu dodatkowych licencji. Z kolei system Fakturownia przesyła stosowne powiadomienie (webhook) w ciągu 3 minut od momentu zaksięgowania dokumentu FS. Przed ostatecznym wdrożeniem automatyzacji konieczne jest wykonanie backupu bazy danych, gdyż błędnie nadane sekwencje numerów WZ w strukturze XML są trudne do skorygowania po ich zatwierdzeniu przez Ministerstwo Finansów. Warto również ustawić alert e-mail dla kodów odpowiedzi HTTP różnych od 200, co pozwoli na natychmiastową reakcję w przypadku awarii API.

Data wystawienia WZ a data faktury - pułapki czasowe

Korelacja dat między wydaniem towaru a wystawieniem faktury ma kluczowe znaczenie dla spójności raportowania JPK_V7. Art. 106i ust. 1 pkt 4 lit. b) ustawy o VAT wskazuje, że za datę sprzedaży przyjmuje się dzień wydania towaru, co musi znajdować odzwierciedlenie w dacie wystawienia WZ. KSeF porównuje datę w polu IssueDate pliku XML z datą nadania numeru identyfikującego przez system, a nie z datą widniejącą na wizualizacji PDF. Jeśli towar opuścił magazyn 15 marca, a faktura ustrukturyzowana trafiła do KSeF 14 kwietnia, system automatycznie zidentyfikuje ryzyko przekroczenia terminów i wyśle komunikat KSeF-WZ-01.

Chociaż fakturę uznaje się za wystawioną w dniu jej poprawnego przesłania do systemu KSeF, to rozbieżności czasowe między WZ a FS mogą skutkować sankcjami. W okresie obowiązkowym faktura jest uznana za otrzymaną w momencie nadania jej numeru przez KSeF, co zamyka drogę do samodzielnego przesyłania dokumentów drogą mailową. Poniższa tabela obrazuje logikę walidacji terminów przez algorytmy Ministerstwa Finansów:

Ostrzeżenie KSeF-WZ-01 nie blokuje samej wysyłki faktury, lecz staje się trwałym śladem cyfrowym widocznym dla organów skarbowych podczas czynności sprawdzających. Aby wyeliminować 90% tych komunikatów, rekomenduje się ujednolicenie dat wystawienia WZ oraz faktury sprzedaży w obrębie jednego dnia roboczego. W sytuacjach skomplikowanych logistycznie warto rozważyć wystawienie faktury pro-forma w dniu fizycznego wydania towaru, a finalnej faktury ustrukturyzowanej w dniu następnym, zachowując ustawowe terminy raportowania.