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
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
- Struktura logiczna FA(3)Ministerstwo Finansów, ksef.podatki.gov.pl
- 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.
