Przykładowy plik XML faktury FA(3): struktura XML KSeF omówiona element po elemencie
Plik XML faktury KSeF ma element główny Faktura i cztery obowiązkowe części: Naglowek, Podmiot1, Podmiot2 i Fa; Stopka i kilka innych elementów są dobrowolne. Najprostszy wzór MF to przykład nr 1 z zestawu 26 plików FA(3) – zwykła faktura VAT w złotych z trzema pozycjami ze stawkami 23% i 5%. Omawiamy go fragment po fragmencie i pokazujemy, co można z niego usunąć.
Spis treści
- Jak wygląda szkielet pliku XML faktury FA(3)?
- Naglowek: dane techniczne pliku
- Podmiot1: dane sprzedawcy
- Podmiot2: nabywca oraz pola JST i GV
- Fa: waluta, daty i numer faktury
- Sumy: P_13_x, P_14_x i P_15
- Adnotacje: znaczniki obowiązkowe, nawet gdy „nie dotyczy”
- FaWiersz: pozycje faktury
- Platnosc i WarunkiTransakcji
- Stopka
- Które elementy przykładu możesz usunąć?
- Pozostałe przykłady MF – który plik do czego?
Struktura XML faktury w KSeF to drzewo z elementem głównym Faktura: najpierw Naglowek, potem Podmiot1 (sprzedawca) i Podmiot2 (nabywca), ewentualnie Podmiot3 i PodmiotUpowazniony, dalej Fa z treścią faktury, a na końcu dobrowolne Stopka i Zalacznik. Najłatwiej zobaczyć to na przykładzie nr 1 z zestawu MF – zwykłej fakturze VAT w złotych, którą niżej rozbieramy na części.
Przykłady pobierzesz z ksef.podatki.gov.pl, z zakładki Pliki do pobrania: ZIP „Przykładowe pliki dla struktury logicznej e-Faktury FA(3)” (195,81 KB). Ten sam zestaw MF udostępnia na stronie Krajowy System e-Faktur w serwisie KAS. W środku jest 26 plików od FA_3_Przykład_1.xml do Fa_3_Przykład_26.xml (wielkość liter w nazwach bywa różna) i PDF z opisami. 17 listopada 2026 r. sprawdziliśmy wszystkie 26 ze schematem FA(3) – każdy jest poprawny. Jak to zrobić u siebie, opisujemy w tekście o schemacie XSD FA(3).
Jak wygląda szkielet pliku XML faktury FA(3)?
Jeśli dane faktur masz w arkuszu i myślisz o generowaniu XML samodzielnie, przeczytaj najpierw KSeF a Excel.
<?xml version="1.0" encoding="UTF-8"?>
<Faktura xmlns="http://crd.gov.pl/wzor/2025/06/25/13775/">
<Naglowek>...</Naglowek>
<Podmiot1>...</Podmiot1>
<Podmiot2>...</Podmiot2>
<Fa>...</Fa>
<Stopka>...</Stopka>
</Faktura>
Kolejność elementów jest stała. Przykład nr 1 to faktura spółki ABC AGD (NIP 9999999999) dla F.H.U. Jan Kowalski (NIP 1111111111): lodówka, wniesienie sprzętu i promocyjny karton mleka, razem 2051 zł. Dane są fikcyjne. W pliku MF element Faktura deklaruje jeszcze prefiksy etd i xsi, ale żaden element z nich nie korzysta.
Naglowek: dane techniczne pliku
<Naglowek>
<KodFormularza kodSystemowy="FA (3)" wersjaSchemy="1-0E">FA</KodFormularza>
<WariantFormularza>3</WariantFormularza>
<DataWytworzeniaFa>2026-02-01T00:00:00Z</DataWytworzeniaFa>
<SystemInfo>SamploFaktur</SystemInfo>
</Naglowek>
Trzy pierwsze elementy są obowiązkowe i w każdej fakturze FA(3) wyglądają tak samo – poza datą. DataWytworzeniaFa to chwila utworzenia pliku w czasie UTC (litera Z na końcu). Może się różnić od daty wystawienia i od dnia wysyłki do KSeF. SystemInfo to nazwa programu, z którego korzystasz – możesz ją pominąć.
Podmiot1: dane sprzedawcy
<Podmiot1>
<DaneIdentyfikacyjne>
<NIP>9999999999</NIP>
<Nazwa>ABC AGD sp. z o. o.</Nazwa>
</DaneIdentyfikacyjne>
<Adres>
<KodKraju>PL</KodKraju>
<AdresL1>ul. Kwiatowa 1 m. 2</AdresL1>
<AdresL2>00-001 Warszawa</AdresL2>
</Adres>
<DaneKontaktowe>
<Email>abc@abc.pl</Email>
<Telefon>667444555</Telefon>
</DaneKontaktowe>
</Podmiot1>
NIP wpisujesz bez „PL” i bez kresek. Adres to jedna lub dwie linie zwykłego tekstu: AdresL1 jest obowiązkowa, AdresL2 – nie. DaneKontaktowe są dobrowolne i mogą wystąpić do trzech razy. W przykładzie brakuje dwóch pól, które czasem się przydają: PrefiksPodatnika z wartością PL przy WDT (faktura WDT w KSeF) i StatusInfoPodatnika, np. 1 dla firmy w likwidacji.
Podmiot2: nabywca oraz pola JST i GV
<Podmiot2>
<DaneIdentyfikacyjne>
<NIP>1111111111</NIP>
<Nazwa>F.H.U. Jan Kowalski</Nazwa>
</DaneIdentyfikacyjne>
<Adres>
<KodKraju>PL</KodKraju>
<AdresL1>ul. Polna 1</AdresL1>
<AdresL2>00-001 Warszawa</AdresL2>
</Adres>
<NrKlienta>fdfd778343</NrKlienta>
<JST>2</JST>
<GV>2</GV>
</Podmiot2>
Dane kontaktowe nabywcy pominęliśmy – wyglądają jak u sprzedawcy. Identyfikator nabywcy wybierasz jeden: NIP, KodUE z NrVatUE, KodKraju z NrID albo BrakID = 1. Polski NIP musi trafić do pola NIP, bo tylko wtedy KSeF udostępni fakturę nabywcy (broszura, formaty pól pkt 10). Pozostałe warianty opisujemy w tekstach faktura bez NIP i faktura dla zagranicznego kontrahenta.
JST i GV są obowiązkowe w każdej fakturze i stoją na końcu Podmiot2. Dla zwykłej firmy wpisujesz 2 i 2. Gdy faktura dotyczy szkoły lub innej jednostki podległej gminie (nabywcą jest wtedy gmina) albo członka grupy VAT, w odpowiednim polu wpisujesz 1 i dodajesz tę jednostkę w Podmiot3 z rolą 8 lub 10 (Podmiot3 w KSeF).
Fa: waluta, daty i numer faktury
<Fa>
<KodWaluty>PLN</KodWaluty>
<P_1>2026-02-15</P_1>
<P_1M>Warszawa</P_1M>
<P_2>FV2026/02/150</P_2>
<P_6>2026-01-27</P_6>
KodWaluty– kod ISO 4217, także przy złotówkach,P_1– data wystawienia; przy wysyłce online to dzień przesłania do KSeF. Data wcześniejsza oznacza tryb offline24, późniejsza – odrzucenie pliku (data wystawienia faktury),P_1M– miejsce wystawienia, dobrowolne,P_2– twój numer faktury, a nie numer KSeF (numeracja faktur),P_6– data dostawy lub zapłaty, jeśli różni się odP_1; zamiast niej możesz podać okres wOkresFaalbo osobne daty w wierszach (P_6A).
Sumy: P_13_x, P_14_x i P_15
<P_13_1>1666.66</P_13_1>
<P_14_1>383.33</P_14_1>
<P_13_3>0.95</P_13_3>
<P_14_3>0.05</P_14_3>
<P_15>2051</P_15>
P_13_x to suma netto dla danej stawki, P_14_x – podatek od tej sumy, a P_15 – kwota należności ogółem, jedyne kwotowe pole wymagane przez schemat w każdej fakturze. Numer pary zależy od rodzaju sprzedaży:
| Pola | Sprzedaż |
|---|---|
P_13_1, P_14_1 |
stawka 23% lub 22% |
P_13_2, P_14_2 |
8% lub 7% |
P_13_3, P_14_3 |
5% |
P_13_4, P_14_4 |
ryczałt dla taksówek osobowych |
P_13_5, P_14_5 |
procedura szczególna OSS |
P_13_6_1 (kraj), P_13_6_2 (WDT), P_13_6_3 (eksport) |
stawka 0% |
P_13_7 |
sprzedaż zwolniona |
P_13_8, P_13_9 |
poza krajem (np I) i usługi z art. 100 ust. 1 pkt 4 (np II) |
P_13_10 |
krajowe odwrotne obciążenie |
P_13_11 |
procedura marży |
Przy fakturze w walucie obcej dochodzą pola P_14_xW z podatkiem przeliczonym na złote. Ciekawostka: w przykładzie MF suma netto i VAT daje 2050,99 zł, a P_15 = 2051 zł. To najpewniej efekt zaokrągleń (nasz wniosek). KSeF nie sprawdza obliczeń (cz. II pkt 1.6.1), więc o zgodność kwot musi zadbać twój program.
Adnotacje: znaczniki obowiązkowe, nawet gdy „nie dotyczy”
<Adnotacje>
<P_16>2</P_16>
<P_17>2</P_17>
<P_18>2</P_18>
<P_18A>2</P_18A>
<Zwolnienie>
<P_19N>1</P_19N>
</Zwolnienie>
<NoweSrodkiTransportu>
<P_22N>1</P_22N>
</NoweSrodkiTransportu>
<P_23>2</P_23>
<PMarzy>
<P_PMarzyN>1</P_PMarzyN>
</PMarzy>
</Adnotacje>
<RodzajFaktury>VAT</RodzajFaktury>
<FP>1</FP>
Cały blok Adnotacje jest w każdej fakturze. P_16 (metoda kasowa), P_17 (samofakturowanie), P_18 (odwrotne obciążenie), P_18A (mechanizm podzielonej płatności) i P_23 (procedura uproszczona w transakcji trójstronnej) przyjmują 1 – „tak” albo 2 – „nie”. W trzech elementach złożonych „nie” zapisujesz osobnym znacznikiem z literą N na końcu: brak zwolnienia (P_19N; przy zwolnieniu zobacz podstawa zwolnienia z VAT), brak WDT nowych środków transportu (P_22N) i brak marży (P_PMarzyN; inaczej – faktura VAT marża).
RodzajFaktury = VAT to faktura podstawowa. Inne wartości to KOR, ZAL, ROZ, UPR, KOR_ZAL i KOR_ROZ. FP = 1 informuje, że faktura dotyczy sprzedaży zaewidencjonowanej na kasie rejestrującej (art. 106h ust. 1 i art. 109 ust. 3d ustawy o VAT) – przy zwykłej fakturze to pole pomijasz. Plik MF ma jeszcze DodatkowyOpis z parą Klucz i Wartosc („preferowane godziny dowozu”). Tak dopiszesz informację, dla której schemat nie ma osobnego pola.
FaWiersz: pozycje faktury
<FaWiersz>
<NrWierszaFa>1</NrWierszaFa>
<UU_ID>aaaa111133339990</UU_ID>
<P_7>lodówka Zimnotech mk1</P_7>
<P_8A>szt.</P_8A>
<P_8B>1</P_8B>
<P_9A>1626.01</P_9A>
<P_11>1626.01</P_11>
<P_12>23</P_12>
</FaWiersz>
Każda pozycja to osobny FaWiersz z kolejnym NrWierszaFa. P_7 to nazwa, P_8A jednostka miary, P_8B ilość, P_9A cena jednostkowa netto, P_11 wartość netto, a P_12 stawka ze słownika, np. 23, 8, 5, zw, 0 KR, np I. Liczysz od cen brutto? Użyj P_9B i P_11A. UU_ID to dobrowolny, unikalny identyfikator wiersza, przydatny przy korektach. W wierszu dopiszesz też GTIN, PKWiU czy GTU – zobacz BDO, GTIN i GTU na fakturze.
Platnosc i WarunkiTransakcji
<Platnosc>
<Zaplacono>1</Zaplacono>
<DataZaplaty>2026-01-27</DataZaplaty>
<FormaPlatnosci>6</FormaPlatnosci>
</Platnosc>
<WarunkiTransakcji>
<Zamowienia>
<DataZamowienia>2026-01-26</DataZamowienia>
<NrZamowienia>4354343</NrZamowienia>
</Zamowienia>
</WarunkiTransakcji>
</Fa>
Oba elementy są dobrowolne (FAQ, pyt. 9). Tu klient zapłacił przed wystawieniem faktury, przelewem – FormaPlatnosci 6. Pozostałe kody: 1 gotówka, 2 karta, 3 bon, 4 czek, 5 kredyt, 7 płatność mobilna. Przy fakturze do zapłaty zamiast Zaplacono podajesz TerminPlatnosci, a zwykle też RachunekBankowy z polem NrRB – zobacz rachunek bankowy na fakturze i skonto w KSeF.
Stopka
<Stopka>
<Informacje>
<StopkaFaktury>Kapiał zakładowy 5 000 000</StopkaFaktury>
</Informacje>
<Rejestry>
<KRS>0000099999</KRS>
<REGON>999999999</REGON>
<BDO>000099999</BDO>
</Rejestry>
</Stopka>
Stopka jest dobrowolna. StopkaFaktury mieści do 3500 znaków, a Rejestry – numery KRS, REGON i BDO. Literówka „Kapiał” pochodzi z pliku MF.
Które elementy przykładu możesz usunąć?
Usunęliśmy z przykładu SystemInfo, DaneKontaktowe, NrKlienta, P_1M, P_6, FP, DodatkowyOpis, UU_ID, Platnosc, WarunkiTransakcji i Stopka – plik nadal był zgodny ze schematem. Zgodność ze schematem to jednak nie wszystko. P_6 jest potrzebne, gdy data sprzedaży różni się od daty wystawienia, a nazwy, ilości i stawki w wierszach wymaga art. 106e ustawy o VAT, choć XSD ich nie wymusza. Różnice opisujemy w tekście obowiązkowe elementy faktury KSeF.
Pozostałe przykłady MF – który plik do czego?
| Nr | Co pokazuje | Więcej u nas |
|---|---|---|
| 1 | faktura VAT zapłacona przed wystawieniem | ten tekst |
| 2, 3 | korekta ceny: wiersze „przed” i „po” (StanPrzed) albo różnica |
faktura korygująca |
| 4 | sprzedaż hurtowa z faktorem i przewoźnikiem, różne daty dostawy | Podmiot3 |
| 5 | korekta błędnej nazwy nabywcy | faktura korygująca |
| 6, 7 | korekta zbiorcza – rabat za okres (wszystkie albo część dostaw) | korekta faktury spoza KSeF |
| 8 | VAT marża – samochód używany, zapłata częściowa | faktura VAT marża |
| 9 | leasing dla gminy, odbiorcą szkoła; stawka zw i 23% | KSeF w JST |
| 10 | faktura zaliczkowa z dodatkowym nabywcą | faktura zaliczkowa |
| 11–13 | korekty faktury zaliczkowej: stawka, kwota zaliczki, wartość zamówienia | korekta do korekty |
| 14 | faktura rozliczająca z podmiotem pierwotnym | faktura zaliczkowa |
| 15, 16 | faktura uproszczona do 450 zł (UPR) w dwóch wariantach |
obowiązkowe elementy faktury |
| 17, 18 | błędna faktura rozliczająca i jej korekta | faktura korygująca |
| 19 | biuro podróży: marża i usługa własna z 23% | faktura VAT marża |
| 20, 21 | faktura krajowa w walucie obcej: jeden kurs albo różne kursy | MPP w walucie obcej |
| 22 | WDT | faktura WDT |
| 23 | eksport, numer podatkowy nabywcy spoza UE | faktura eksportowa |
| 24, 25 | faktura z załącznikiem – rozliczenie energii elektrycznej | – |
| 26 | kaucja w systemie kaucyjnym w elemencie Rozliczenie |
– |
Najczęstsze pytania
Gdzie pobrać przykład faktury KSeF w XML?
Na ksef.podatki.gov.pl w zakładce Pliki do pobrania – ZIP „Przykładowe pliki dla struktury logicznej e-Faktury FA(3)” (ok. 196 KB). Ten sam zestaw jest w serwisie KAS na gov.pl. W paczce jest 26 plików XML i PDF z opisami przykładów.
Który przykład MF to zwykła faktura VAT?
Przykład nr 1: faktura podstawowa (RodzajFaktury = VAT) w złotych, sprzedawca i nabywca z NIP, trzy pozycje ze stawkami 23% i 5%, zapłacona przelewem przed wystawieniem.
Czy w pliku XML muszą być pola JST i GV?
Tak. Schemat FA(3) wymaga ich w każdym elemencie Podmiot2, na samym końcu. Przy zwykłej fakturze dla firmy wpisujesz w obu wartość 2.
Czy mogę wysłać przykładowy plik MF do KSeF?
Nie na produkcję – dane są fikcyjne. Na środowisko testowe tak, po zmianie NIP sprzedawcy na ten, w którego kontekście się logujesz, oraz daty P_1, numeru P_2 i DataWytworzeniaFa.
Czy faktura w KSeF może nie mieć pozycji FaWiersz?
Schemat to dopuszcza, bo pozycji nie potrzebuje np. faktura zaliczkowa. Zwykła faktura VAT musi jednak zawierać nazwę towaru, ilość, cenę i stawkę – tego wymaga art. 106e ustawy o VAT.
Źródła
- Przykładowe pliki dla struktury logicznej e-Faktury FA(3) (MF, ZIP) – przykład nr 1 i „Opisy przykładów” 1–26
- Broszura informacyjna struktury logicznej FA(3) (MF, sierpień 2026) – formaty pól pkt 10, tabele 3, 4, 9, 24, 26–29, 46–47 i 52
- Schemat XSD FA(3) (crd.gov.pl, wzór nr 13775) – elementy Faktura, Podmiot2, Fa, Adnotacje, FaWiersz, Platnosc
- Podręcznik KSeF 2.0 cz. II (MF, 06.08.2026), pkt 1.6.1 i rozdz. 2
- Pytania i odpowiedzi KSeF 2.0 (MF) – „Rozwiązania informatyczne, integracje i struktura KSeF”, pyt. 5, 9, 12 i 22
- Ustawa o VAT, t.j. Dz.U. 2026 poz. 1263 – art. 106e ust. 1, art. 106h ust. 1, art. 109 ust. 3d
Artykuł ma charakter informacyjny i nie stanowi porady podatkowej. W konkretnej sprawie skonsultuj się z księgowym lub doradcą podatkowym.