Przejdź do głównej treści
KSeF · FA(3)

Faktura ustrukturyzowana i struktura FA(3)

Faktura ustrukturyzowana to faktura wystawiona przy użyciu KSeF z nadanym w nim numerem identyfikującym (art. 2 pkt 32a ustawy o VAT). Ma postać pliku XML zgodnego ze strukturą logiczną FA(3), którą Ministerstwo Finansów opublikowało 25 czerwca 2025 r. w Centralnym Repozytorium Wzorów Dokumentów Elektronicznych na ePUAP. Od 1 lutego 2026 r. FA(3) jest jedynym wzorem i zastąpiła FA(2), także przy korektach faktur wystawionych wcześniej w FA(2).

FlexigoTech · Odpowiada: Víctor Gómez · Aktualizacja: 17 listopada 2026

Najważniejsze

Moduł
KSeF 2.0
Wersje
Odoo 17, 18, 19 i 20
Sprawdzone
w kodzie źródłowym modułu, wersja 17.0, 18.0, 19.0 i 20.0 · w źródłach podanych na końcu
Czas czytania
3 min

Kiedy faktura jest ustrukturyzowana

Sam plik XML jeszcze nie jest fakturą. Fakturą ustrukturyzowaną staje się dopiero wtedy, gdy KSeF przyjmie go i nada mu numer. Przed nadaniem numeru system sprawdza dwie rzeczy: czy plik jest zgodny z obowiązującym wzorem i czy wysyłająca osoba ma uprawnienia. Rachunków nie sprawdza: faktura z błędnie policzoną sumą zostanie przyjęta i trzeba ją będzie skorygować. Jak wygląda cała droga faktury, opisujemy w poradniku o fakturach w KSeF.

FA(3) w datach

  1. 25 czerwca 2025 r. Ministerstwo Finansów publikuje docelową strukturę logiczną FA(3) w CRWDE na ePUAP.
  2. 1 stycznia 2026 r. W e-Urzędzie Skarbowym można zgłaszać zamiar wystawiania faktur z załącznikiem.
  3. 1 lutego 2026 r. FA(3) zastępuje FA(2) i staje się jedynym wzorem faktury ustrukturyzowanej. Od tego dnia można też dodawać do faktury załącznik.

Z czego składa się FA(3)

Nagłówek
Dane techniczne o przesyłanej fakturze.
Podmiot1
Sprzedawca.
Podmiot2
Nabywca.
Podmiot3
Dodatkowe podmioty, na przykład faktor albo jednostka podrzędna JST.
PodmiotUpowazniony
Podmioty upoważnione, na przykład komornik sądowy albo przedstawiciel podatkowy.
Szczegółowe dane faktury
Kwoty, stawki podatku, wymagane adnotacje, a także informacje o płatności i transporcie.
Stopka
Dodatkowe informacje.
Zalacznik
Załącznik do faktury. Wymaga wcześniejszego zgłoszenia w e-Urzędzie Skarbowym.

W FA(3) wystawia się wszystkie rodzaje faktur: podstawowe, korygujące, zaliczkowe i rozliczające. Dwa pola, które najczęściej sprawiają kłopot, opisujemy osobno: daty P_1 i P_6 oraz dane nabywcy w Podmiot2.

Pola obowiązkowe i fakultatywne

Faktura, która ma wszystkie dane wymagane przez ustawę o VAT i strukturę FA(3), jest prawidłowa, nawet jeśli nie ma pól fakultatywnych. Dane fakultatywne podaje się wtedy, gdy zachodzi ustawowa przesłanka. O pozostałych polach dodatkowych, na przykład takich, których oczekuje nabywca, strony transakcji umawiają się między sobą.

Korekty faktur wystawionych w FA(2)

Od 1 lutego 2026 r. używa się wyłącznie FA(3). Dotyczy to także faktury korygującej do faktury wystawionej przed tą datą w FA(2) lub FA(1) i faktury rozliczającej zaliczkę zafakturowaną wcześniej w FA(2) lub FA(1).

Wizualizacja i kod QR

Gdy fakturę trzeba przekazać poza KSeF, na przykład konsumentowi albo firmie zagranicznej, wysyła się jej wizualizację, na przykład PDF. Wizualizacja może mieć własny wygląd i może być po angielsku albo dwujęzyczna, ale musi zgadzać się z danymi w pliku XML. Musi też mieć kod QR, który pozwala sprawdzić fakturę w KSeF.

Inne struktury w KSeF

Oprócz FA(3) KSeF przyjmuje strukturę PEF dla faktur w zamówieniach publicznych, zgodną z normą europejską, oraz FA_RR(1) dla faktur VAT RR.

Jak sprawdzić FA(3) przed wysyłką w Odoo

KSeF odrzuca plik niezgodny ze wzorem, a odrzucony plik nie jest fakturą. Nasz moduł KSeF 2.0 Validator Odoo waliduje FA(3) faktury względem oficjalnego schematu Ministerstwa Finansów w FlexigoTech Cloud: w Odoo 18, 19 i 20 plik wygenerowany albo wysłany przez l10n_pl_edi, w każdej wersji także plik wgrany ręcznie. Wynik i komunikaty zostają przy fakturze. Moduł nie wysyła faktur do KSeF. Kosztuje 9 € w Odoo Apps za wersję Odoo i wymaga subskrypcji FlexigoTech Cloud od 29 € miesięcznie netto, z 14 dniami za darmo. Gdy KSeF mimo to odrzuci fakturę, przyczynę zwykle wskazuje kod 450.

Przebieg walidacji w widoku formularza z przyciskami Run i Export checklist, uzyskanym wynikiem punktowym, a poniżej wiersz dla każdej faktury z wynikiem, kodem błędu i powodem
Zrzut z danymi demonstracyjnymi: przebieg walidacji faktur w module. Przy fakturze, która nie przeszła, widać kod błędu i powód, na przykład brak danych korekty.
Widok kanban KSeF Dashboard z kartą Wawel Digital sp. z o.o.
Zrzut z danymi demonstracyjnymi: karta firmy w panelu KSeF z gotowością faktur i stanem certyfikatu.

Najczęstsze pytania

Czy faktura w PDF wysłana mailem jest fakturą ustrukturyzowaną?

Nie. Fakturą ustrukturyzowaną jest plik XML przyjęty przez KSeF z nadanym numerem. PDF to tylko wizualizacja, którą przekazuje się nabywcom spoza KSeF, z kodem QR.

Od kiedy obowiązuje FA(3)?

Od 1 lutego 2026 r. Od tego dnia do wszystkich faktur ustrukturyzowanych stosuje się wyłącznie FA(3).

Czy fakturę korygującą do faktury z FA(2) wystawiam w FA(2)?

Nie. Od 1 lutego 2026 r. korektę wystawia się w FA(3), także gdy faktura pierwotna powstała w FA(2) lub FA(1).

Czy faktura bez pól fakultatywnych jest prawidłowa?

Tak, jeśli ma wszystkie dane wymagane przez ustawę o VAT i strukturę FA(3).

Dane z tej strony sprawdziliśmy 17 listopada 2026 r. na stronach Ministerstwa Finansów o fakturze ustrukturyzowanej i o strukturze FA(3) (ksef.podatki.gov.pl) oraz w pytaniach i odpowiedziach o KSeF 2.0.

Czytaj dalej

KSeF, czyli Krajowy System e-Faktur: kogo obowiązuje i od kiedyKSeF obowiązuje od 1 lutego 2026 r. przy sprzedaży powyżej 200 mln zł, od 1 kwietnia 2026 r. pozostałych. Co zmienia 1 stycznia 2027 r., tryby offline, kary i Odoo.Faktury w KSeF: wystawianie, odbiór, numer KSeF i kod QRJak wystawić fakturę w KSeF, kiedy jest wystawiona i otrzymana, co z numerem KSeF, kodem QR, korektą i fakturą dla konsumenta lub firmy z zagranicy.Daty w FA(3): P_1, P_6 i DataWytworzeniaFaReguły dat w schemacie FA(3) 1-0E i w KSeF: P_1 w czasie polskim, P_6, DataWytworzeniaFa od 2025-09-01. Kiedy kończą się kodem 450 i jak wypełnia je Odoo 18, 19 i 20.Nabywca w FA(3): identyfikator, JST i GV w Podmiot2Nabywca w schemacie FA(3) 1-0E: NIP, numer VAT UE, inny identyfikator albo BrakID oraz znaczniki JST i GV. Suma kontrolna NIP w KSeF i co wpisuje Odoo.Kod 450 w KSeF: „Błąd weryfikacji semantyki dokumentu faktury”Kod 450 oznacza, że KSeF odrzucił fakturę FA(3) po sprawdzeniu treści. Gdzie jest prawdziwa przyczyna, czego nie pokazuje Odoo 18, 19 i 20 i jak wysłać fakturę ponownie.
Sprawdzone w kodzie źródłowym modułu (wersja 17.0, 18.0, 19.0 i 20.0) i w podlinkowanych źródłach

Źródła