Spis treści 7 sekcji
Faktura XML zapisuje dane w uporządkowanych polach, zamiast przedstawiać dokument jako obraz. Po wystawieniu faktury w KSeF oryginałem jest plik XML, a pobrany PDF stanowi jego wizualizację1.
Przykład poniżej pokazuje układ pól i pomaga odróżnić formaty dokumentów. Art. 2 pkt 32a ustawy o VAT definiuje fakturę ustrukturyzowaną jako wystawioną w KSeF i posiadającą nadany w nim numer identyfikujący2.
Jak odróżnić XML pojedynczej faktury od pliku JPK_FA?
XML pojedynczej faktury i JPK_FA różnią się strukturą oraz przeznaczeniem, nie tylko nazwą pliku z rozszerzeniem „.xml”. Plik FA(3) zapisuje jedną fakturę, a JPK_FA może zawierać dane wielu faktur sprzedaży3. W porównaniu uwzględniono też JPK_V7, który łączy ewidencję VAT z deklaracją.
Otwórz plik i zacznij od jego początku. Sprawdź nazwę struktury oraz przestrzeń nazw. Dopiero potem ustal, do czego służy dany eksport:
| Plik | Co zawiera i jak go rozpoznać |
|---|---|
| XML pojedynczej faktury | Oznaczenie FA(3) wskazuje strukturę faktury ustrukturyzowanej. W nagłówku element WariantFormularza ma wartość „3”. |
| JPK_FA | Oznaczenie JPK_FA wskazuje plik kontrolny z danymi faktur sprzedaży. Eksport JPK_FA nie jest plikiem pojedynczej faktury przeznaczonym do KSeF. |
| JPK_V7 | Ten plik łączy ewidencję VAT z deklaracją. Służy do czegoś innego niż JPK_FA oraz XML pojedynczej faktury. |
Dane w tabeli: 4
W kolejnym kroku porównaj XML pojedynczej faktury ze schematem XSD, który opisuje dopuszczalną budowę pliku. Schemat FA(3) określa elementy, typy danych, wymagane pola i zależności między nimi5.
Struktura FA(3) zastąpiła FA(2) 1 lutego 2026 r.6,7.
Na koniec ustal cel eksportu: wystawienie pojedynczej faktury albo przekazanie danych faktur sprzedaży do kontroli. To rozróżnienie ma znaczenie prawne. Art. 193a § 1 Ordynacji podatkowej pozwala organowi żądać danych JPK_FA, lecz § 1a wyłącza faktury przesłane do KSeF8.
Jak zapisać pozycje faktury, stawki VAT i kwoty podsumowania w XML?
FaWiersz przechowuje pozycje faktury w XML. Każda pozycja trafia do osobnego elementu, natomiast kwoty podsumowania zapisuje się w polach faktury. Struktura FA(3) wymaga co najmniej 1 pozycji5. Dopuszcza maksymalnie 10 000 wystąpień elementu FaWiersz4.
Każda pozycja faktury musi zawierać NrWierszaFa, czyli numer wiersza, oraz P_7, czyli nazwę towaru lub usługi5. Podczas eksportu z programu przypisz oba pola do właściwej pozycji. Sprawdź też, czy opis odpowiada wystawianej fakturze. W strukturze FA(3) nazwa w polu P_7 może mieć maksymalnie 512 znaków4.
Podsumowanie VAT powinno odpowiadać stawkom użytym na fakturze. Tabela wskazuje wartości, które należy zestawić z pozycjami dla poszczególnych stawek w strukturze FA(3). Przy sprzedaży objętej stawką 23% pole P_13_1 zawiera sumę netto. Odpowiadającą jej kwotę VAT zapisuje pole P_14_14.
| Stawka VAT | Kontrola podsumowania |
|---|---|
| 23% | Porównaj kwoty z pozycjami objętymi tą stawką. |
| 8% | Porównaj kwoty z pozycjami objętymi tą stawką. |
| 5% | Porównaj kwoty z pozycjami objętymi tą stawką. |
| 0% | Porównaj wartość sprzedaży z pozycjami objętymi tą stawką. |
Dane w tabeli: 5,7
Pole P_15 zawiera całkowitą kwotę brutto faktury w strukturze FA(3)5. Po wygenerowaniu pliku zestaw ją z należnością na fakturze. Skontroluj przy tym zgodność pozycji z podsumowaniem.
Przy sprzedaży za 100 zł netto i stawce VAT 23% kontrolna kwota należności ogółem w P_15 wynosi 123 zł4.
Gdzie w XML faktury zapisać dane sprzedawcy i nabywcy?
Dane sprzedawcy należą do elementu Podmiot1, a dane nabywcy do elementu Podmiot2 faktury XML. Ten podział oddziela strony transakcji. Art. 106e ust. 1 pkt 3 ustawy o VAT wymaga podania na fakturze imion i nazwisk lub nazw podatnika i nabywcy oraz ich adresów9.
Podmiot1 zawiera dane identyfikacyjne i adresowe wystawcy, a Podmiot2 – nabywcy. Eksportując fakturę z programu, przypisz nazwę, identyfikator podatkowy i adres do właściwej strony. Nie kieruj się samą kolejnością pól w formularzu. Art. 106e ust. 1 pkt 4 i 5 ustawy o VAT wskazuje numery identyfikacyjne podatnika oraz nabywcy, pod którymi dokonano transakcji9.
Przy kontroli stron faktury porównaj obie sekcje z danymi wystawianego dokumentu. Upewnij się, że dane sprzedawcy nie trafiły do sekcji nabywcy.
Sprawdź również długość polskiego NIP: numer składa się z 10 cyfr10.
Faktura XML – przykład uproszczonego fragmentu kodu
Przykładowy fragment faktury XML pokazuje, jak znaczniki oddzielają pozycję towarową od kwoty podsumowania. To pomoc w odczytaniu układu pól, nie gotowy dokument. Fragment zawiera wartości zastępcze i nie nadaje się do wysłania do KSeF. Pełna faktura FA(3) zawiera cztery obowiązkowe sekcje główne: Naglowek, Podmiot1, Podmiot2 i Fa4.
Uproszczony fragment: <Fa> <P_15>[kwota brutto]</P_15> <FaWiersz> <NrWierszaFa>[numer pozycji]</NrWierszaFa> <P_7>[nazwa towaru]</P_7> </FaWiersz> </Fa>. Znaczniki FaWiersz obejmują tutaj dane pozycji. W pełnym pliku uwzględnij też trzy obowiązkowe sekcje pominięte we fragmencie: Naglowek, Podmiot1 i Podmiot24.
Symfonia udostępnia w materiałach pomocy przykładowy plik faktury w strukturze FA(3) o rozmiarze 3 KB6. Plik FA(3) pobrany z KSeF można wczytać do programu Symfonia Handel6.
Struktura FA(3) obowiązuje dla faktur ustrukturyzowanych wystawianych od 1 lutego 2026 r.2.
TGSoft opisuje fakturę sprzedaży towaru opłaconego w całości przed wystawieniem. Pokazuje też utworzenie struktury FA.XML (3) z użyciem kodu C# i danych JSON11. Według TGSoft Ministerstwo Finansów opublikowało 25 przykładowych plików XML11. Fragment znaczników ułatwia rozpoznanie pól, a pełny plik pozwala prześledzić ich układ w całej fakturze.
Limit pojedynczego pliku XML wynosi 1 MB bez załącznika albo 3 MB, gdy faktura zawiera załącznik12.
Krok 3: wyślij XML do KSeF i wystaw fakturę ustrukturyzowaną
KSeF przyjmuje plik XML faktury ustrukturyzowanej. Samo wygenerowanie go w programie nie jest jeszcze wysyłką. System Najszybsza tworzy XML zgodny z KSeF, ale nie przesyła go automatycznie1.
- Eksport z systemu Najszybsza zapisuje plik XML faktury. Przed wysłaniem plik nie ma numeru KSeF ID1.
- Wczytanie w Aplikacji Podatnika KSeF pozwala obejrzeć wizualizację faktury przed jej wystawieniem1.
- Wystawienie w Aplikacji Podatnika KSeF następuje po wczytaniu i sprawdzeniu faktury1.
Plik XML przed wysłaniem jest przygotowanym dokumentem, nie fakturą wystawioną już w KSeF. Eksport, kontrola wizualizacji i wystawienie to odrębne czynności. Zapisanie pliku nie kończy wysyłki.
Najczęściej zadawane pytania
Czy PDF pobrany z KSeF jest oryginałem faktury?
Nie. Oryginałem jest plik XML, a PDF stanowi jego wizualizację.
Jaki limit rozmiaru ma plik XML faktury?
Maksymalnie 1 MB bez załącznika albo 3 MB, gdy faktura zawiera załącznik.
Co opisuje schemat XSD dla FA(3)?
Określa dopuszczalną budowę pliku, w tym elementy, typy danych, wymagane pola i zależności między nimi.
Od kiedy struktura FA(3) zastąpiła FA(2)?
FA(3) zastąpiła FA(2) 1 lutego 2026 r.
Czy plik FA(3) pobrany z KSeF można wczytać do Symfonia Handel?
Tak, plik FA(3) pobrany z KSeF można wczytać do programu Symfonia Handel.
Źródła
- ↑Jak wystawić fakturę w KSeF – krok po kroku z pliku XML | Najszybsza https://najszybsza.pl/pomoc/jak-wystawic-fakture-w-ksef
- ↑Ministerstwo Finansów – Faktura ustrukturyzowana i struktura logiczna FA https://ksef.podatki.gov.pl/informacje-ogolne-ksef-20/faktura-ustrukturyzowana-i-struktura-logiczna-fa/
- ↑Ministerstwo Finansów – Pytania i odpowiedzi dotyczące JPK https://podatki.gov.pl/podatki-firmowe/jednolity-plik-kontrolny/jpk_vat/pytania-i-odpowiedzi-jpk_vat
- ↑Ministerstwo Finansów – Broszura informacyjna dotycząca struktury logicznej FA(3) https://ksef.podatki.gov.pl/media/kmriagdg/broszura-informacyjna-dotyczaca-struktury-logicznej-fa-3.pdf
- ↑Struktura faktury XML KSeF – Opis pol https://ksefstart.pl/wiedza/struktura-faktury
- ↑Przykładowy plik xml w strukturze FA(3) https://ksef.wsparcie.symfonia.pl/hc/pl/articles/29736617154066-Przyk%C5%82adowy-plik-xml-w-strukturze-FA-3
- ↑Ministerstwo Finansów, broszura informacyjna FA(3), opis pól P_13_1 i P_14_1. ([ksef.podatki.gov.pl](ksef.podatki.gov.pl https://ksef.podatki.gov.pl/media/jknpcymf/broszura-informacyjna-dotyczaca-struktury-logicznej-fa-3-04032026.pdf
- ↑Dziennik Ustaw – Ordynacja podatkowa, tekst jednolity https://eli.gov.pl/api/acts/DU/2025/111/text.pdf
- ↑Dziennik Ustaw – Ustawa o podatku od towarów i usług, tekst ujednolicony https://eli.gov.pl/api/acts/DU/2025/775/text/U/D20250775Lj.pdf
- ↑Ministerstwo Finansów – Sprawdź status NIP https://sprawdznip.podatki.gov.pl/
- ↑Programy dla Firm TGSoft Kraków https://www.tgsoft.pl/Blog?id=293
- ↑Ministerstwo Finansów – Podręcznik KSeF 2.0, część II https://ksef.podatki.gov.pl/media/qzlha3vx/podrecznik-ksef-20-cz-ii-wystawianie-i-otrzymywanie-faktur-w-ksef-20260209.pdf
Ceny i warunki sprawdzone u źródeł: październik 2026.