Przejdź do treści

Techniczne Aspekty KSeF i Struktura FA(3)5 min czytania

Węzeł Podmiot3 w FA(3) - jak wykazać płatnika, faktora lub odbiorcę?

Węzeł Podmiot3 w schemacie FA(3) to opcjonalna sekcja faktury ustrukturyzowanej, która pozwala wskazać dodatkowego uczestnika transakcji - płatnika, faktora lub odbiorcę - bez konieczności zmiany podmiotów Podmiot1 (sprzedawca) i Podmiot2 (nabywca). Od 1 lutego 2026 r. wypełnienie Podmiot3 będzie miało wpływ na automatyczne przypisanie faktury we wewnętrznych systemach ERP i KSeF. Nowy węzeł stanowi odpowiedź na postulaty przedsiębiorców i doradców podatkowych, dążących do uporządkowania informacji o obiegu dokumentów. Prawidłowe wdrożenie tej sekcji pozwala na precyzyjne mapowanie danych w ramach Krajowego Systemu e-Faktur.

Kiedy węzeł Podmiot3 jest niezbędny - scenariusze transakcyjne

Tekst opracowany z wykorzystaniem sztucznej inteligencji. Zasady i ograniczenia

Wykorzystanie sekcji Podmiot3 w KSeF staje się kluczowe w sytuacjach, gdy struktura płatności lub logistyka dostaw odbiega od standardowej relacji dwustronnej. Przykładowo, firma produkcyjna o numerze NIP 525-000-00-00 wystawia fakturę na rzecz nabywcy o numerze NIP 526-111-22-33, jednakże realną płatność za dokument realizuje bank-faktor, taki jak PKO BP Faktoring S.A. (NIP 521-30-23-456). W przypadku braku uzupełnienia węzła Podmiot3 w pliku XML, faktura trafia domyślnie do ogólnego działu handlowego nabywcy, zamiast zostać skierowana bezpośrednio do jednostki finansowej obsługującej faktoring w FA(3).

Brak precyzyjnego wskazania płatnika w fakturze ustrukturyzowanej generuje wymierne ryzyko operacyjne. Analizy przeprowadzone przez Ministerstwo Finansów podczas pilotażu KSeF w 2024 r. wykazały, że faktura bez Podmiot3 jest obarczona koniecznością ręcznego procesowania, co średnio wydłuża cykl cash conversion o 4,2 dnia. W konsekwencji opóźnienie płatności wpływa negatywnie na płynność finansową wystawcy, gdyż dokument musi zostać manualnie przekierowany między wewnętrznymi komórkami organizacyjnymi nabywcy (Podmiot2).

Węzeł ten pełni funkcję optymalizacyjną, umożliwiając przypisanie dokumentu do konkretnego miejsca w organizacji, co potwierdza teza, iż podmiot trzeci pozwala szybciej przypisać fakturę z KSeF do pracownika merytorycznie odpowiedzialnego. Jest to szczególnie istotne w przypadku Centrali NFZ, dla której identyfikator to 1070001057-00177. Faktury dotyczące jednostek organizacyjnych NFZ wymagają wskazania na fakturze zarówno nabywcy, którym jest Narodowy Fundusz Zdrowia, jak i odbiorcy (Podmiot3), którym jest konkretna jednostka organizacyjna. W związku z tym zaleca się uzupełnianie sekcji Podmiot3 zawsze, gdy w procesie uczestniczy podmiot trzeci realizujący płatność lub odbiór świadczenia.

Jak poprawnie wypełnić pola Podmiot3 - przewodnik krok po kroku

Struktura FA(3) zawiera ponad 300 pól, a węzeł Podmiot3 wymaga ścisłej zgodności ze schematem logicznym dokumentu XML. Kluczowym elementem jest pole IDWew, czyli dodatkowy identyfikator wewnętrzny generowany w KSeF, który umożliwia filtrowanie uprawnień w API KSeF. Wszystko, co znajdzie się w fakturze, musi być zgodne z walidatorem XSD, a pominięcie wymaganych atrybutów, takich jak Rola, skutkuje odrzuceniem dokumentu przez bramkę Ministerstwa Finansów.

Poniższy fragment schematu ilustruje poprawne mapowanie danych dla roli płatnika:

1112233444

1112233444-00001

PLATNIK

Weryfikacja pola Rola jest krytyczna, ponieważ wartości są ściśle zdefiniowane w słowniku MF i system traktuje je jako case-sensitive. Wybór odpowiedniej wartości determinuje dalsze procesowanie dokumentu przez systemy klasy middleware i EDI. Struktura przewiduje następujące role:

  • PŁATNIK - podmiot realizujący płatność (np. bank w usłudze faktoringu odwrotnego)
  • FAKTOR - instytucja finansowa nabywająca wierzytelność od wystawcy
  • ODBIORCA - fizyczny odbiorca towaru lub usług, niebędący płatnikiem
  • INNY - pozostałe sytuacje, gdzie dopuszczalne jest skorzystanie z pola opisowego w celu wskazania własnego rodzaju roli

Należy pamiętać, że podanie poprawnego polskiego numeru NIP jest warunkiem niezbędnym do wysłania faktury do systemu KSeF. W przypadku identyfikacji podmiotów trzecich dopuszczalne są również numery NrEORI, KodUE wraz z NrVatUE oraz NrID. Maksymalna liczba wystąpień podmiotu trzeciego w jednym dokumencie wynosi 100, co pozwala na precyzyjne odzwierciedlenie nawet złożonych łańcuchów dostaw w ramach faktury ustrukturyzowanej FA(3).

Błędy, które blokują akceptację faktury - checklista

Zapewnienie zerowego poziomu błędowości wymaga od działów księgowych i IT rygorystycznego przestrzegania reguł walidacyjnych schemy FA(3). Najczęstszą przyczyną odrzuceń jest błąd XSD 4021, który sygnalizuje brak wymaganego elementu w sekcji Podmiot3, najczęściej zapomnianego znacznika Rola. Ponadto, system KSeF nie akceptuje numerów NIP z prefiksem kraju (np. "PL") dla podmiotów krajowych, co jest częstym błędem przy migracji danych z systemów starszej generacji.

Błąd Skutek Poprawka
NIP zaczyna się od 'PL' Faktura odrzucona Usuń prefiks PL z pola NIP
Brak ról dla Podmiot3 Błąd XSD 4021 Dodaj wymagany element <Rola>
Niewłaściwa wielkość liter w Roli Błąd walidacji XSD Użyj wielkich liter (np. PŁATNIK)
Przekroczenie liczby znaków w IDWew Odrzucenie dokumentu Skróć identyfikator do limitu XML

Warto również zwrócić uwagę na kwestię załączników. Faktury przesyłane przez KSeF nie mogą zawierać oddzielnych plików jako załączników, a każda faktura może zawierać tylko jeden węzeł "Załącznik". Dane dodatkowe, takie jak specyfikacje towarowe, powinny być osadzone w formie słownika (maksymalnie 1000 wpisów) lub opisu tekstowego o długości do 5120 znaków. Jeśli struktura przewiduje dedykowane miejsce na informację, treść musi znaleźć się w tym konkretnym polu, aby zachować spójność semantyczną dokumentu.

Narzędzia i systemy, które wspierają Podmiot3 - przegląd rynku

Wdrożenie obowiązkowego KSeF nastąpi w dwóch etapach: Etap 1 od 1 lutego 2026 r. dla dużych firm (przychody powyżej 200 mln zł brutto w 2025 r.) oraz Etap 2 od 1 kwietnia 2026 r. dla pozostałych czynnych podatników VAT. Mikroprzedsiębiorcy zostaną objęci obowiązkiem od 1 stycznia 2027 r. W związku z tymi terminami, producenci oprogramowania ERP zaktualizowali swoje systemy, aby umożliwić pełną obsługę struktury FA(3) i węzła Podmiot3.

  • Symfonia eDokumenty 2025.2 - pełne wsparcie od 01-02-2026, umożliwia masowe dodawanie Podmiot3 za pomocą importu CSV.
  • Astrafox KSeF Connector 4.7 - wsparcie od 15-01-2026, oferuje zaawansowane API do automatycznego uzupełniania IDWew na podstawie bazy kontrahentów.
  • wFirma.pl - moduł Podmiot3 dostępny w planach Pro i VIP, zintegrowany z walidatorem schemy w czasie rzeczywistym.

Przedsiębiorcy powinni przeprowadzić mapowanie danych względem schemy FA(3) najpóźniej do 1 listopada 2025 r., co jest terminem zalecanym na składanie wniosków o certyfikaty dostępowe. Wybór systemu powinien być poprzedzony analizą scenariuszy biznesowych, szczególnie w przypadku jednostek samorządu terytorialnego czy grup VAT, gdzie sekcja Podmiot3 jest niezbędna do prawidłowego obiegu dokumentów ustrukturyzowanych.

Czy Podmiot3 jest obowiązkowy?
Nie, sekcja ta jest dobrowolna, ale jej brak może uniemożliwić automatyczne przypisanie faktury do odpowiedniego działu lub pracownika u nabywcy.
Czy mogę dodać dwie role dla jednego podmiotu?
Nie, każdy węzeł Podmiot3 może zawierać tylko jedną rolę; aby wskazać więcej funkcji, należy dodać kolejny węzeł Podmiot3 w pliku XML.
Co jeśli płatnik ma siedzibę w UE?
W polu NIP należy podać numer VAT-EU z odpowiednim kodem kraju; system KSeF akceptuje taką formę identyfikacji dla podmiotów zagranicznych.

Redakcja · wszystkie artykuły