KSeF i struktura pliku XML

Krótka odpowiedź: plik XML faktury w KSeF musi być zgodny ze schemą FA(3) (obowiązuje od lutego 2026) — dokument dzieli się na nagłówek, dane stron, pozycje i podsumowanie, a system waliduje go względem definicji XSD Ministerstwa Finansów. Poniżej omówienie struktury; kompletny przykład pliku z pakietem do pobrania znajdziesz w artykule przykładowy plik XML faktury ustrukturyzowanej.

Krajowy System e-Faktur wykorzystuje do przesyłania i rejestrowania faktur format XML, zgodny ze schematem logicznym określonym przez Ministerstwo Finansów. Jest to tzw. faktura ustrukturyzowana, której treść nie ma formy graficznej, lecz zestawu danych opisanych w sposób maszynowy.

Najważniejsze cechy formatu XML w KSeF:

• Schemat FA(3) – obowiązujący standard struktury dokumentu XML, który określa, jakie pola muszą lub mogą być zawarte (np. dane sprzedawcy, nabywcy, pozycje, stawki VAT, daty, formy płatności).
  
• Walidacja dokumentu – każdy plik XML musi przejść walidację logiczną i techniczną, zanim zostanie przyjęty przez system. Błędy uniemożliwiają jego rejestrację.
  
• Brak formy graficznej – faktura XML nie zawiera żadnego wyglądu „drukowanego”, dlatego firmy często stosują oprogramowanie, które generuje widok PDF na potrzeby wewnętrzne lub dla klienta.
  
• Jednolitość danych – dzięki temu sam proces księgowania, weryfikacji i raportowania może zostać zautomatyzowany – dane są jednoznaczne i spójne.
  

Przykładowa struktura pliku XML dla KSeF

<?xml version='1.0' encoding='UTF-8'?>
<Faktura>
  <Podmiot1>
    <NIP>1234567890</NIP>
    <Nazwa>Przykładowa Firma Sp. z o.o.</Nazwa>
    <Adres>ul. Przykładowa 1, 00-001 Warszawa</Adres>
  </Podmiot1>
  <Podmiot2>
    <NIP>9876543210</NIP>
    <Nazwa>Odbiorca Sp. z o.o.</Nazwa>
    <Adres>ul. Klienta 2, 00-002 Kraków</Adres>
  </Podmiot2>
  <PozycjeFaktury>
    <Pozycja>
      <NazwaTowaruUslugi>Usługa konsultingowa</NazwaTowaruUslugi>
      <Ilosc>1</Ilosc>
      <CenaJednostkowa>1000.00</CenaJednostkowa>
      <StawkaVAT>23</StawkaVAT>
      <KwotaVAT>230.00</KwotaVAT>
      <WartoscBrutto>1230.00</WartoscBrutto>
    </Pozycja>
  </PozycjeFaktury>
  <WartoscNetto>1000.00</WartoscNetto>
  <WartoscVAT>230.00</WartoscVAT>
  <WartoscBrutto>1230.00</WartoscBrutto>
  <DataWystawienia>2025-07-15</DataWystawienia>
  <FormaPlatnosci>Przelew</FormaPlatnosci>
  <TerminPlatnosci>2025-07-30</TerminPlatnosci>
</Faktura>

Zrozumienie struktury XML jest szczególnie istotne dla firm korzystających z własnych systemów ERP lub tworzących dedykowane integracje z KSeF. Ministerstwo Finansów udostępnia oficjalną dokumentację techniczną, schematy XSD i przykłady plików XML do testowania.

XML generuje się sam — jeśli nie piszesz integracji

Strukturę warto znać przy budowie własnych systemów; w codziennym fakturowaniu wystarczy program zgodny z KSeF — w Mizzox poprawny XML w FA(3) powstaje automatycznie z formularza, bez dotykania znaczników (za darmo).

Szerzej w przewodniku: przewodnik po KSeF 2026.

W praktyce: KSeF w Mizzox bez dodatkowych kroków.

FAQ

Jaka schema XML obowiązuje w KSeF?

FA(3) — od 1 lutego 2026 r.; zastąpiła wcześniejszą FA(2). Pliki i integracje pod starą wersję wymagały aktualizacji.

Z jakich sekcji składa się plik faktury?

Z nagłówka (dane dokumentu), danych sprzedawcy i nabywcy, pozycji towarów/usług oraz podsumowania kwot — plus pola opcjonalne.

Gdzie znajdę oficjalną definicję XSD?

Na stronach Ministerstwa Finansów (podatki.gov.pl/ksef) wraz z przykładowymi plikami i środowiskiem testowym.