baza wiedzy

KSeF i struktura pliku XML

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(2) – 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.

Rozpocznij za darmo

Bez karty kredytowej • Plan darmowy bez ograniczeń czasowych

Jeden system.
Wiele możliwości.

Umów prezentację