XML faktury

XML faktury to plik w formacie XML, w którym zapisana jest cała faktura ustrukturyzowana: dane sprzedawcy i nabywcy, pozycje, kwoty i stawki VAT. Układ pól określa schemat FA(3). Właśnie ten plik wysyła się do KSeF i pobiera z KSeF, a PDF jest tylko jego czytelną wizualizacją.

Inaczej
plik XML faktury, e-faktura XML, faktura w formacie XML, XML z KSeF
  • Stan prawny na
  • Aktualizacja:

W praktyce

Dla człowieka XML jest mało czytelny, ale dla programów to zaleta: każda informacja ma stałe miejsce. Data wystawienia jest zawsze w polu P_1, numer faktury w P_2, a kwota należności ogółem w P_15. Dlatego faktury z KSeF da się wczytać do księgowości albo arkusza bez OCR i przepisywania.

Do odczytu służą wizualizacje: Aplikacja Podatnika KSeF, program do faktur albo darmowe narzędzia, które zamieniają XML na PDF lub tabelę.

Jak to działa

Plik zaczyna się od nagłówka, który wskazuje schemat, a dalej ma sekcje Podmiot1 i Podmiot2 oraz Fa z treścią faktury. Mocno skrócony fragment:

<Faktura xmlns="http://crd.gov.pl/wzor/2025/06/25/13775/">
  <Naglowek>
    <KodFormularza kodSystemowy="FA (3)" wersjaSchemy="1-0E">FA</KodFormularza>
    <WariantFormularza>3</WariantFormularza>
  </Naglowek>
  <Podmiot1>…sprzedawca…</Podmiot1>
  <Podmiot2>…nabywca…</Podmiot2>
  <Fa>
    <KodWaluty>PLN</KodWaluty>
    <P_1>2026-05-14</P_1>
    <P_2>FV/2026/05/112</P_2>
    …
    <P_15>1230.00</P_15>
    …
    <RodzajFaktury>VAT</RodzajFaktury>
  </Fa>
</Faktura>

Pełny opis pól jest w schemacie FA(3). KSeF odrzuca plik, który nie jest z nim zgodny.

Przykład

Księgowa pobiera z KSeF paczkę 40 faktur kosztowych za maj. Dostaje pliki XML, których nie przeczyta bezpośrednio, ale program księgowy wczytuje je automatycznie: nazwę dostawcy, NIP, kwoty netto i VAT bierze ze stałych pól, bez przepisywania.

Powiązane pojęcia

  • FA(3)

    FA(3) to aktualna struktura logiczna, czyli schemat XML, faktury ustrukturyzowanej w KSeF. Określa, jakie pola ma plik faktury, w jakiej kolejności i jak je wypełnić. Od 1 lutego 2026 r. FA(3) zastąpiła poprzednią wersję FA(2) i jest jedyną strukturą faktur VAT przyjmowaną przez produkcyjny KSeF.

  • Faktura ustrukturyzowana

    Faktura ustrukturyzowana to faktura wystawiona przy użyciu Krajowego Systemu e-Faktur, której system przydzielił numer KSeF. Ma postać pliku XML zgodnego ze strukturą logiczną FA(3), a nie dokumentu PDF ani papierowego. PDF czy wydruk takiej faktury to tylko jej wizualizacja.

  • Podmiot 1, Podmiot 2 i Podmiot 3

    Podmiot 1, Podmiot 2 i Podmiot 3 to sekcje pliku XML faktury w strukturze FA(3), w których zapisuje się strony transakcji. Podmiot 1 to sprzedawca, Podmiot 2 to nabywca, a Podmiot 3 to inne podmioty związane z fakturą, np. odbiorca, faktor, płatnik albo dodatkowy nabywca. Każdy z nich ma przypisaną rolę.

  • Numer faktury

    Numer faktury to kolejny numer nadany przez sprzedawcę w ramach jednej lub więcej serii, który jednoznacznie identyfikuje fakturę. W fakturze ustrukturyzowanej zapisuje się go w polu P_2 struktury FA(3). To inny numer niż numer KSeF, który nadaje system po przyjęciu faktury.

  • Załącznik do faktury w KSeF

    Załącznik do faktury w KSeF to dodatkowa, ustrukturyzowana część pliku XML faktury (element Zalacznik w strukturze FA(3)) na rozbudowane dane, które nie mieszczą się w zwykłych polach. Mogą go używać tylko podatnicy, którzy wcześniej zgłosili to w e-Urzędzie Skarbowym. Nie da się nim dołączyć pliku PDF, skanu, umowy ani treści marketingowych.

  • Automatyczne pobieranie faktur z KSeF

    Automatyczne pobieranie faktur z KSeF polega na tym, że program regularnie łączy się z KSeF przez API, wyszukuje nowe faktury firmy i zapisuje je jako pliki XML, PDF albo dane w tabeli. Nikt nie musi ręcznie logować się do Aplikacji Podatnika. Do samego pobierania wystarczy uprawnienie do przeglądania faktur.

Najczęstsze pytania

Jak otworzyć plik XML faktury z KSeF?

Najprościej w Aplikacji Podatnika KSeF albo w programie do faktur, który pokaże fakturę jako dokument. Pojedyncze pliki można też zamienić na PDF w darmowym wizualizatorze faktur KSeF, który działa w przeglądarce i nie wysyła plików na serwer.

Czy można edytować XML faktury?

Plik przed wysłaniem tworzy program do fakturowania i to w nim poprawia się dane. Po nadaniu numeru KSeF faktura jest niezmienna, a zmiany wprowadza się fakturą korygującą.

Jak zamienić XML z KSeF na Excela?

Pojedyncze pliki i paczki ZIP można przekonwertować w darmowym konwerterze XML z KSeF. Przy stałym napływie faktur wygodniejsze jest automatyczne pobieranie prosto do arkusza.

Źródła

  1. Struktura logiczna FA(3)Ministerstwo Finansów, ksef.podatki.gov.pl
  2. Schemat FA(3)Centralne Repozytorium Wzorów Dokumentów Elektronicznych

Treść sprawdzona ze źródłami: . Przepisy o KSeF często się zmieniają, więc przed decyzją podatkową sprawdź aktualny stan w źródłach.

Widzisz błąd albo nieaktualną informację? Daj nam znać, a poprawimy.