taxtech500 nagradza aztę trzeci miesiąc z rzędu, tym razem w dwóch kategoriach. Przeczytaj ogłoszenie →

Blog

Struktura FA(3) w KSeF od 2026 roku: kluczowe zmiany i wdrożenie

Ostatnia aktualizacja: 5 min czytania
Nowoczesny metalowy zewnętrzny dysk twardy leżący na wydrukowanym dokumencie z widoczną strukturą kodu XML, reprezentujący wdrożenie nowego formatu faktur FA(3) w KSeF.

Wprowadzenie nowej struktury logicznej FA(3) od 1 lutego 2026 roku stawia przed podatnikami szereg wyzwań technicznych. Zmiana ta wymaga bezwzględnego dostosowania systemów ERP do nowego schematu XML, aktualizacji namespace oraz uzupełnienia struktur danych o nowe obowiązkowe pola informacyjne.

Przejście na standard FA(3) w Krajowym Systemie e-Faktur (KSeF) stanowi kluczowy krok w modernizacji polskiego systemu podatkowego. Wszystkie dokumenty przesyłane od 1 lutego 2026 roku muszą być zgodne z nowym schematem, gdyż system KSeF 2.0 natychmiast odrzuci pliki przygotowane według starszego wzoru. Nowa struktura wprowadza istotne modyfikacje w zakresie identyfikacji nabywców, ról podmiotów trzecich oraz raportowania danych pozycyjnych.

Kluczowe wnioski i podsumowanie najważniejszych zmian

Proces migracji systemów księgowych z formatu FA(2) do nowej struktury FA(3) wymaga wykonania kilku precyzyjnych i obowiązkowych modyfikacji w schematach XML dokumentów.

  1. Modyfikacja adresu przestrzeni nazw XML (namespace) na aktualny URI obowiązujący dla FA(3).
  2. Aktualizacja danych w nagłówku faktury, w tym zmiana wartości atrybutu kodSystemowy oraz wersji schemy.
  3. Dodanie obowiązkowych pól JST oraz GV w strukturze informacyjnej dotyczącej nabywcy (Podmiot2).
  4. Dostosowanie mechanizmu generowania korekt dla dokumentów pierwotnych wystawionych pierwotnie w formacie FA(2).

Czym różni się struktura faktury FA(3) od wcześniejszej wersji FA(2)?

Nowa struktura FA(3) zastępuje dotychczasową wersję FA(2), wprowadzając rygorystyczne reguły walidacji technicznej oraz nowe, niewystępujące wcześniej elementy informacyjne.

Obszar technicznyStruktura FA(2)Struktura FA(3)
Przeznaczony okres stosowaniaWycofana z użycia z dniem 31 stycznia 2026 rokuObowiązuje jako jedyny format od 1 lutego 2026 roku
Nowe flagi w Podmiot2Brak takich pól w sekcji nabywcyObowiązkowe pola JST oraz GV
Identyfikacja pracownikaBrak dedykowanej roli w strukturzeNowa Rola 11 w elemencie Podmiot3
Raportowanie pozycjiPozycje wyłącznie w głównej strukturzeMożliwość stosowania elementu Zalacznik

Nowy namespace XML w schemie FA(3) – pułapka błędu weryfikacji

Zmiana adresu URI przestrzeni nazw jest kluczowym elementem nowej struktury, ponieważ jego błędne wskazanie powoduje natychmiastowe odrzucenie pliku XML przez bramkę KSeF.

Wersja strukturyDeklarowany namespace XML (xmlns)
FA(2)http://crd.gov.pl/wzor/2023/06/29/12648/
FA(3)http://crd.gov.pl/wzor/2025/06/25/13775/

Podatnicy muszą upewnić się, że ich oprogramowanie IT poprawnie generuje nagłówek dokumentu, wskazując nowy adres opublikowany przez Ministerstwo Finansów. Wszelkie próby wysłania dokumentu ze starą przestrzenią nazw zakończą się błędem walidacji semantycznej bezpośrednio na etapie komunikacji z interfejsem API.

Jakie zmiany zaszły w nagłówku (Naglowek) faktury ustrukturyzowanej?

W sekcji Naglowek nastąpiły zmiany o charakterze ewidencyjnym, które jednoznacznie identyfikują wersję formularza używaną do zapisu dokumentu.

Pole techniczneWartość w schemacie FA(2)Wartość w schemacie FA(3)
KodFormularza @kodSystemowyFA (2)FA (3)
KodFormularza @wersjaSchemyWartość właściwa dla FA(2)1-0E
WariantFormularza23

Te parametry nagłówka pozwalają systemom Ministerstwa Finansów na zastosowanie odpowiednich reguł logicznych podczas weryfikacji poprawności matematycznej i schematycznej przesyłanego pliku e-faktury.

Nowe obowiązkowe pola w Podmiot2: JST oraz GV

Nowy format wymaga obligatoryjnego określenia statusu prawnego nabywcy w zakresie jego powiązań z jednostkami samorządowymi oraz grupami VAT.

Nazwa polaZnaczenie pola w strukturze FA(3)Wartość standardowa (brak powiązania)
JSTOkreśla status jednostki samorządu terytorialnego2
GVOkreśla status członka grupy VAT2

Zgodnie z wytycznymi Ministerstwa Finansów, w przypadku standardowych transakcji biznesowych z kontrahentami komercyjnymi, którzy nie należą do wymienionych grup podmiotów, należy wpisać wartość '2'. Pozwala to na zachowanie poprawności strukturalnej dokumentu bez wpływu na jego merytoryczną treść podatkową.

Identyfikacja pracownika i nowa Rola 11 w elemencie Podmiot3

Wprowadzenie nowej roli w elemencie Podmiot3 rewolucjonizuje sposób dokumentowania zakupów dokonywanych bezpośrednio przez pracowników na rzecz pracodawcy.

  1. Zastosowanie nowej wartości Rola = 11, która identyfikuje pracownika jako osobę dokonującą zakupu w imieniu podmiotu gospodarczego.
  2. Aktywacja warunkowej ścieżki walidacji, w której nie podaje się numeru NIP pracownika.
  3. Wymóg oznaczenia elementu BrakID wartością dającą wynik logiczny 1.
  4. Uzupełnienie imienia i nazwiska pracownika w wyznaczonym polu o nazwie Nazwa.

Nowy element Zalacznik i zasady jego stosowania

Dynamiczny element Zalacznik umożliwia przekazywanie szczegółowych informacji o pozycjach faktury, jednak jego stosowanie podlega restrykcyjnym procedurom.

  1. Stosowanie elementu jest ograniczone wyłącznie do dokumentów o skomplikowanej i rozbudowanej strukturze pozycji towarowych.
  2. Wymagane jest wcześniejsze formalne zgłoszenie chęci korzystania z tej opcji za pośrednictwem platformy e-Urząd Skarbowy.
  3. Element ten może służyć wyłącznie do przekazywania danych strictly podatkowych, takich jak precyzyjne jednostki miar czy szczegółowe ceny netto.
  4. Kategorycznie zabrania się umieszczania w załącznikach materiałów o charakterze marketingowym, warunków gwarancji, cenników lub treści umów cywilnoprawnych pod rygorem utraty uprawnienia.

Korygowanie faktur pierwotnych FA(2) w nowym formacie FA(3)

Wystawianie faktur korygujących po wprowadzeniu systemu KSeF 2.0 wymaga zastosowania nowych zasad technicznych dotyczących referencji do dokumentów historycznych.

  1. Wszystkie faktury korygujące wystawiane po 1 lutego 2026 roku muszą być sporządzone wyłącznie w formacie FA(3), nawet jeśli korygują dokument wystawiony w FA(2).
  2. W strukturze korygującej DaneFaKorygowanej należy obowiązkowo wskazać referencję do faktury pierwotnej.
  3. W przypadku korekt do dokumentów z KSeF 1.0 (czyli pierwotnie FA(2)) stosuje się specjalne pole NrKSeFN ustawione na wartość parametru równego 1.
Czym różni się struktura faktury FA(3) od wcześniejszej wersji FA(2)?
Główne różnice obejmują nowy adres URI przestrzeni nazw, zaktualizowane parametry wersji w nagłówku, nowe obowiązkowe pola JST i GV dla nabywcy, wprowadzenie roli pracownika (Rola 11) oraz możliwość dołączania ustrukturyzowanych załączników pozycji.
Od kiedy obowiązuje nowa struktura logiczna FA(3) w KSeF?
Format FA(3) staje się jedyną obowiązującą strukturą logiczną faktury ustrukturyzowanej od 1 lutego 2026 roku. Po tym terminie pliki przesłane w starym formacie FA(2) będą automatycznie odrzucane przez system.
Co grozi za wysłanie faktury z nieprawidłowym namespace KSeF?
Wysłanie dokumentu XML zawierającego niepoprawną lub nieaktualną przestrzeń nazw (np. ze schematu FA(2)) skutkuje natychmiastowym odrzuceniem dokumentu przez bramkę KSeF z powodu błędu walidacji struktury XSD.
Jak uzupełnić pola JST oraz GV, jeśli nie dotyczą mojego kontrahenta?
W przypadku transakcji z podmiotami, które nie są jednostkami samorządu terytorialnego ani członkami grup VAT, w polach JST oraz GV w sekcji Podmiot2 należy wpisać domyślną wartość '2'.

Opracowane przez aztę na podstawie przepisów obowiązujących w dniu 4 lipca 2026. Informacja ogólna, nie porada w Twojej sprawie.

Zapytaj aztę o swoją sprawę.

Każda odpowiedź wskazuje źródło, więc możesz otworzyć przepis i sam go sprawdzić.

Zacznij bezpłatnie