Wszystkie artykuły

    KSeF8 min czytania

    Faktura ustrukturyzowana w KSeF: jak wygląda i co zawiera schemat FA(3)

    Zespół FakturaFlow

    Praktycy automatyzacji KSeF dla biur rachunkowych w Polsce.

    Ostatnia aktualizacja:

    Faktura ustrukturyzowana KSeF to coś zupełnie innego niż dotychczasowy PDF lub skan papierowej faktury. To plik XML, który musi ściśle odpowiadać schematowi FA(3) opublikowanemu przez Ministerstwo Finansów. Każde biuro rachunkowe, które od 1 lutego 2026 r. obsługuje największych podatników (obrót powyżej 200 mln zł), od 1 kwietnia 2026 r. pozostałych czynnych podatników VAT, lub od 1 stycznia 2027 r. najmniejszych podatników, musi rozumieć tę strukturę, bo błędne pole w XML oznacza automatyczne odrzucenie faktury przez system.

    Poniżej znajdziesz dokładny opis tego, co zawiera faktura KSeF, jak wygląda numer KSeF i co dzieje się z dokumentem po wysyłce.

    Czym jest schemat FA(3)?

    Schemat FA(3) to oficjalny format XML definiujący strukturę faktury ustrukturyzowanej w Polsce. Ministerstwo Finansów opublikowało go jako plik XSD (XML Schema Definition), który służy do walidacji każdego dokumentu przed przyjęciem go do KSeF.

    Wersja FA(3) obowiązuje od 1 września 2023 r. i zastąpiła wcześniejszy schemat FA(2). Zawiera ponad 300 pól, z których kilkadziesiąt jest bezwzględnie wymaganych. Nieznajomość struktury jest kosztowna: KSeF waliduje XML w pełni automatycznie i odrzuca dokumenty bez możliwości ręcznej korekty po stronie systemu.

    Szczegółową mapę pól schematu FA(3) znajdziesz w dedykowanym przewodniku po strukturze faktury.

    Obowiązkowe sekcje faktury KSeF

    Dokument XML dzieli się na kilka głównych bloków. Poniżej omawiamy każdy z nich z perspektywy biura rachunkowego.

    Naglowek: nagłówek dokumentu

    Sekcja Naglowek identyfikuje wersję schematu i datę wytworzenia pliku. Pole SystemInfo przyjmuje dowolny ciąg znaków identyfikujący oprogramowanie wystawcy. Wartość ta trafia do logów MF i jest przydatna przy diagnozowaniu błędów po stronie systemu.

    Podmiot1: dane wystawcy

    Sekcja Podmiot1 zawiera dane sprzedawcy. Kluczowe pola:

    Pole XMLPrzykładowa wartośćUwagi
    NIP5252287009NIP bez kresek, 10 cyfr
    NazwaPodmiotuBiuro Rachunkowe Kwiatkowski sp. z o.o.Pełna nazwa rejestrowa
    NazwaHandlowaKwiatkowski RachunkowośćOpcjonalne
    Adres.KodPocztowy00-950Format XX-XXX
    Adres.MiejscowoscWarszawa

    Biura rachunkowe wystawiające faktury w imieniu klientów wpisują dane klienta, nie biura. Token KSeF musi być wystawiony przez właściciela NIP wpisanego w Podmiot1. Więcej o tym, jak pozyskać i skonfigurować token, wyjaśnia artykuł Token KSeF: jak wygenerować i skonfigurować uprawnienia.

    Podmiot2: dane nabywcy

    Sekcja Podmiot2 zawiera dane kupującego. W przypadku faktur B2B wymagany jest NIP nabywcy. W fakturach dla osób fizycznych (B2C) pole NIP może być puste, ale KSeF wymaga wtedy innych danych identyfikacyjnych nabywcy.

    Ważna zasada: jeśli nabywca jest czynnym podatnikiem VAT i posiada NIP, faktura wystawiana od 1 kwietnia 2026 r. musi trafić do KSeF. Nie można zamiast niej wysłać tradycyjnego PDF.

    Fa: sekcja główna faktury

    To serce dokumentu. Sekcja Fa zawiera metadane faktury:

    Pole XMLPrzykładowa wartośćUwagi
    KodWalutyPLNDla transakcji w złotych
    DataWystawienia2026-04-15Format YYYY-MM-DD
    TypFakturyVATVAT, ZAL, ROZ, KOR, KOR_ZAL, KOR_ROZ
    P_12026/04/0001Numer faktury wystawcy
    P_156150.00Kwota należności ogółem brutto

    Pole TypFaktury decyduje o logice całego dokumentu. Faktura korygująca (KOR) wymaga dodatkowej sekcji opisującej przyczynę zmiany wraz z odwołaniem do numeru KSeF korygowanego dokumentu.

    FaWiersz: pozycje faktury

    Każda pozycja na fakturze to osobny blok FaWiersz. Przykład dla usługi księgowej:

    <FaWiersz>
      <NrWierszaFa>1</NrWierszaFa>
      <P_7>Obsługa księgowa kwiecień 2026</P_7>
      <P_8A>SZT</P_8A>
      <P_8B>1</P_8B>
      <P_9A>5000.00</P_9A>
      <P_12>23</P_12>
    </FaWiersz>
    

    Pole P_12 to kod stawki VAT: 23, 8, 5, dla stawki 0% jeden z kodów 0 KR (sprzedaż krajowa), 0 WDT (wewnątrzwspólnotowa dostawa towarów) lub 0 EX (eksport), a także zw (zwolnienie), np I lub np II (sprzedaż niepodlegająca opodatkowaniu w kraju) i oo (odwrotne obciążenie krajowe). Samo 0 nie jest poprawną wartością.

    Rozliczenie i Platnosc

    Sekcja Rozliczenie podsumowuje kwoty VAT według stawek. Sekcja Platnosc zawiera termin płatności, sposób zapłaty oraz numer rachunku bankowego. Numer rachunku nie jest wymagany przy mechanizmie podzielonej płatności (split payment): zgodnie z art. 106e ust. 1 pkt 18a ustawy o VAT faktura powyżej 15 000 zł brutto obejmująca towary lub usługi z załącznika nr 15 musi zawierać tylko wyrazy „mechanizm podzielonej płatności”.

    Jak wygląda numer KSeF?

    Numer KSeF to unikalny identyfikator nadawany przez Ministerstwo Finansów po przyjęciu dokumentu. Ma stały format:

    YYYYMMDD-XX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-NN
    

    Przykład: 20260415-FA-A1B2C3D4E5F6A7B8C9D0E1F2A3B4-01

    Numer KSeF:

    • nie zastępuje numeru faktury wystawcy (biuro nadal generuje własną numerację),
    • jest dowodem na to, że faktura trafiła do systemu MF,
    • stanowi podstawę do odliczenia VAT przez nabywcę.

    Nabywca może pobrać fakturę z KSeF na podstawie swojego NIP i numeru KSeF lub zakresu dat wystawiania.

    Co dzieje się po wysyłce? Urzędowe Poświadczenie Odbioru

    Po przyjęciu faktury przez KSeF system zwraca Urzędowe Poświadczenie Odbioru (UPO). UPO to plik XML zawierający:

    • numer KSeF nadany dokumentowi,
    • datę i godzinę przyjęcia z dokładnością do milisekund,
    • hash (odcisk cyfrowy) przesłanego pliku XML.

    UPO jest dokumentem urzędowym potwierdzającym skuteczne doręczenie faktury. Zgodnie z przepisami faktura wystawiona przez KSeF jest uznawana za doręczoną nabywcy w chwili przyjęcia jej przez system, bez potrzeby osobnego wysyłania PDF na e-mail.

    Biura rachunkowe powinny archiwizować UPO razem z XML faktury przez co najmniej 5 lat. Cockpit KSeF FakturaFlow automatycznie pobiera i zapisuje UPO do każdej przesłanej faktury, eliminując ręczny krok pobierania z panelu MF.

    Kompletny przykład XML faktury KSeF

    Poniżej skrócony, ale kompletny pod względem sekcji przykład XML faktury za usługi księgowe:

    <?xml version="1.0" encoding="UTF-8"?>
    <Faktura xmlns="http://crd.gov.pl/wzor/2025/06/25/13775/">
      <Naglowek>
        <KodFormularza kodSystemowy="FA (3)" wersjaSchemy="1-0E">FA</KodFormularza>
        <WariantFormularza>3</WariantFormularza>
        <DataWytworzeniaFa>2026-04-15T10:23:00</DataWytworzeniaFa>
        <SystemInfo>FakturaFlow</SystemInfo>
      </Naglowek>
      <Podmiot1>
        <DaneIdentyfikacyjne>
          <NIP>5252287009</NIP>
          <NazwaPodmiotu>Biuro Rachunkowe Kwiatkowski sp. z o.o.</NazwaPodmiotu>
        </DaneIdentyfikacyjne>
        <Adres>
          <KodKraju>PL</KodKraju>
          <AdresL1>ul. Marszałkowska 45/12, 00-001 Warszawa</AdresL1>
        </Adres>
      </Podmiot1>
      <Podmiot2>
        <DaneIdentyfikacyjne>
          <NIP>7272456789</NIP>
          <NazwaPodmiotu>Klient sp. z o.o.</NazwaPodmiotu>
        </DaneIdentyfikacyjne>
        <Adres>
          <KodKraju>PL</KodKraju>
          <AdresL1>ul. Piotrkowska 200, 90-001 Łódź</AdresL1>
        </Adres>
      </Podmiot2>
      <Fa>
        <KodWaluty>PLN</KodWaluty>
        <DataWystawienia>2026-04-15</DataWystawienia>
        <TypFaktury>VAT</TypFaktury>
        <P_1>2026/04/0001</P_1>
        <P_2M>2026-04-15</P_2M>
        <FaWiersz>
          <NrWierszaFa>1</NrWierszaFa>
          <P_7>Obsługa księgowa kwiecień 2026</P_7>
          <P_8A>SZT</P_8A>
          <P_8B>1</P_8B>
          <P_9A>5000.00</P_9A>
          <P_12>23</P_12>
        </FaWiersz>
        <Rozliczenie>
          <P_13_1>5000.00</P_13_1>
          <P_14_1>1150.00</P_14_1>
        </Rozliczenie>
        <Platnosc>
          <Termin>2026-04-29</Termin>
          <Forma>6</Forma>
          <NrRachunku>PL61109010140000071219812874</NrRachunku>
        </Platnosc>
        <P_15>6150.00</P_15>
      </Fa>
    </Faktura>
    

    Faktura KSeF a tradycyjny PDF

    Wielu właścicieli firm pyta, czy mogą nadal wysyłać faktury w PDF. Odpowiedź od 1 kwietnia 2026 r. brzmi następująco:

    Forma dokumentuStatus po 1 lutego / 1 kwietnia 2026 r.*
    XML FA(3) wysłany przez KSeFJedyna prawna forma faktury dla czynnych podatników VAT
    PDF wysłany e-mailemNie jest fakturą w rozumieniu przepisów podatkowych
    Faktura papierowaNie jest fakturą w rozumieniu przepisów podatkowych
    PDF poza KSeF (B2C, nierezydenci)Nadal dopuszczalny w wąskich wyjątkach

    * Obowiązek wszedł w życie 1 lutego 2026 r. dla podatników z obrotem powyżej 200 mln zł. Pozostali czynni podatnicy VAT muszą stosować KSeF od 1 kwietnia 2026 r. Najmniejsi podatnicy dołączają od 1 stycznia 2027 r.

    Biuro rachunkowe, które przetwarza faktury PDF swoich klientów, musi przekształcać je do formatu XML FA(3) przed wysyłką do KSeF. FakturaFlow umożliwia import faktur z PDF i Excela, automatycznie budując poprawny XML i wysyłając go do systemu MF.

    Jak sprawdzić poprawność faktury przed wysyłką?

    Przed wysyłką do KSeF warto zwalidować XML lokalnie. Dostępne metody:

    1. Walidacja schematem XSD: plik XSD FA(3) dostępny na stronie MF; można użyć narzędzi takich jak xmllint lub walidatorów online.
    2. Środowisko testowe KSeF: API testowe pod https://api-test.ksef.mf.gov.pl przyjmuje faktury testowe bez rejestrowania ich jako dokumenty prawne.
    3. Walidacja w Cockpicie KSeF: FakturaFlow waliduje strukturę XML automatycznie przed każdą wysyłką i wskazuje konkretne pole powodujące błąd walidacji.

    Szczegóły najczęstszych błędów walidacji omawia artykuł Najczęstsze błędy KSeF i jak je naprawić.

    Podsumowanie

    1. Faktura KSeF to plik XML zgodny ze schematem FA(3), a nie PDF ani skan.
    2. Dokument dzieli się na sekcje: Naglowek, Podmiot1, Podmiot2, Fa (z pozycjami FaWiersz), Rozliczenie i Platnosc.
    3. Po przyjęciu przez MF faktura otrzymuje numer KSeF i Urzędowe Poświadczenie Odbioru (UPO).
    4. Archiwizacja UPO razem z XML jest obowiązkiem biura rachunkowego.
    5. Obowiązek wystawiania faktur przez KSeF dotyczy: od 1 lutego 2026 r. największych podatników (obrót powyżej 200 mln zł), od 1 kwietnia 2026 r. wszystkich czynnych podatników VAT, a od 1 stycznia 2027 r. obejmie także najmniejszych przedsiębiorców.

    Jeśli Twoje biuro obsługuje kilkudziesięciu lub kilkuset klientów, ręczne budowanie i wysyłanie XML jest niemożliwe w skali. FakturaFlow obsługuje wysyłkę hurtową, walidację i automatyczne pobieranie UPO w planach od 199 zł/mies. (Starter) przez 319 zł/mies. (Professional) do 499 zł/mies. (Enterprise). Więcej o hurtowej wysyłce przeczytasz w artykule Jak wysyłać faktury do KSeF hurtowo.

    Z bloga

    Czytaj dalej

    Wszystkie artykuły

    KSeF9 min czytania

    KSeF 3.0: co jest już przesądzone, a co dopiero propozycją

    „KSeF 3.0” to określenie branżowe, a nie nazwa z komunikatów Ministerstwa Finansów. Za tym hasłem stoją trzy różne rzeczy: funkcje, które już działają, zmiany zapisane w ustawie z konkretną datą oraz zapowiedzi, które dopiero mogą wejść w życie. Rozdzielamy jedno od drugiego, z datami i źródłami. Aktualizacja: październik 2026 r.

    Czytaj

    KSeF8 min czytania

    KSeF a kasa fiskalna i paragony: co się zmienia od 1 stycznia 2027

    KSeF nie zastępuje kasy fiskalnej, a paragony nie trafiają do systemu. To dwa odrębne obowiązki, które działają obok siebie. Wyjaśniamy, jak KSeF i kasa rejestrująca współistnieją, co dzieje się z fakturą do paragonu, jak traktować paragon z NIP do 450 zł oraz jak nie policzyć tej samej sprzedaży dwa razy w JPK_VAT. Obowiązek KSeF wchodzi etapami: 1 lutego 2026 r. (>200 mln zł), 1 kwietnia 2026 r. (pozostali czynni podatnicy VAT), 1 stycznia 2027 r. (najmniejsi).

    Czytaj

    KSeF9 min czytania

    Obowiązki biura rachunkowego w 2026 r.: KSeF, RODO i nowe procedury

    Rok 2026 to dla biur rachunkowych jeden z najbardziej wymagających okresów ostatniej dekady. KSeF wszedł w życie etapami: 1 lutego 2026 r. dla największych podatników (obrót > 200 mln zł), 1 kwietnia 2026 r. dla pozostałych czynnych podatników VAT, a od 1 stycznia 2027 r. obejmie także najmniejszych. Sprawdź, jakie obowiązki spadają na biuro, gdzie kończy się odpowiedzialność księgowego i co warto wdrożyć już teraz.

    Czytaj