Wystawianie faktur

Przykładowy plik XML faktury FA(3): struktura XML KSeF omówiona element po elemencie

W skrócie

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
  1. Jak wygląda szkielet pliku XML faktury FA(3)?
  2. Naglowek: dane techniczne pliku
  3. Podmiot1: dane sprzedawcy
  4. Podmiot2: nabywca oraz pola JST i GV
  5. Fa: waluta, daty i numer faktury
  6. Sumy: P_13_x, P_14_x i P_15
  7. Adnotacje: znaczniki obowiązkowe, nawet gdy „nie dotyczy”
  8. FaWiersz: pozycje faktury
  9. Platnosc i WarunkiTransakcji
  10. Stopka
  11. Które elementy przykładu możesz usunąć?
  12. 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ę od P_1; zamiast niej możesz podać okres w OkresFa albo 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

  1. Przykładowe pliki dla struktury logicznej e-Faktury FA(3) (MF, ZIP) – przykład nr 1 i „Opisy przykładów” 1–26
  2. 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
  3. Schemat XSD FA(3) (crd.gov.pl, wzór nr 13775) – elementy Faktura, Podmiot2, Fa, Adnotacje, FaWiersz, Platnosc
  4. Podręcznik KSeF 2.0 cz. II (MF, 06.08.2026), pkt 1.6.1 i rozdz. 2
  5. Pytania i odpowiedzi KSeF 2.0 (MF) – „Rozwiązania informatyczne, integracje i struktura KSeF”, pyt. 5, 9, 12 i 22
  6. 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.

Przeczytaj też