Faktura ustrukturyzowana — co to jest, co zawiera i jak ją wystawić

Faktura ustrukturyzowana to faktura wystawiona w Krajowym Systemie e-Faktur, w formacie XML zgodnym ze strukturą logiczną FA, wraz z nadanym jej numerem KSeF. Ten numer jest częścią definicji — bez niego dokument nie jest jeszcze fakturą ustrukturyzowaną.

To rozróżnienie brzmi jak formalność, a jest źródłem większości nieporozumień wokół KSeF. Poniżej pokazujemy dokument od środka: jak wygląda, co zawiera pole po polu, od kiedy jest obowiązkowy i jak go wystawić.

Na końcu dokładamy coś, czego nie znajdziesz w poradnikach: rozkład 1 190 nieudanych wysyłek do KSeF z naszego środowiska produkcyjnego i to, co je wywołuje.

Co to jest faktura ustrukturyzowana

Definicja, w której numer jest częścią dokumentu

Ustawa o VAT określa fakturę ustrukturyzowaną jako fakturę wystawioną przy użyciu KSeF wraz z przydzielonym numerem identyfikującym ją w tym systemie.

Warto przeczytać tę definicję dwa razy. Dokument jest fakturą ustrukturyzowaną dopiero wtedy, gdy system nada mu numer.

Plik XML, który leży na dysku albo czeka w kolejce wysyłki, jeszcze nią nie jest. To poprawnie przygotowany dokument, ale bez numeru pozostaje projektem.

Konsekwencja praktyczna jest prosta: status „wysłano” nie znaczy nic. Jeżeli w panelu widzisz wysłane faktury bez numerów sprzed kilku dni, to nie są dokumenty w drodze.

Czym różni się od e-faktury w PDF

Faktura elektroniczna w PDF też jest elektroniczna. Różnica nie leży w nośniku.

PDF jest obrazem dokumentu — jego treść odczytuje człowiek. Faktura ustrukturyzowana jest zbiorem pól o zdefiniowanym typie i dopuszczalnym zakresie wartości, który odczytuje maszyna.

Z tego wynika cała reszta różnic: kto nadaje numer, co jest datą wystawienia, gdzie dokument jest przechowywany i co może go zatrzymać.

Ostatni wiersz tej tabeli jest najważniejszy. Plik PDF zawsze się wyśle, choćby zawierał bzdury.

Faktura ustrukturyzowana przechodzi walidację schematu, zanim ktokolwiek spojrzy na jej treść handlową. Dokument może być bezbłędny księgowo i mimo to nie do przyjęcia technicznie.

Faktura a jej wizualizacja

Wizualizacja to podgląd faktury — PDF albo wydruk przygotowany na podstawie pliku XML. Bywa mylona z samą fakturą i nią nie jest.

Wizualizację można ułożyć dowolnie, dodać do niej logo i zmienić kolejność bloków. Treść faktury zapisanej w KSeF pozostaje ta sama.

Nabywca, który dostaje wizualizację poza systemem, potrzebuje sposobu na sprawdzenie, że odpowiada ona dokumentowi w KSeF. Do tego służy kod weryfikujący QR, o którym piszemy niżej.

Jak wygląda faktura ustrukturyzowana

Najkrótsza odpowiedź: wygląda jak plik tekstowy w formacie XML. Nie ma układu graficznego, marginesów ani miejsca na podpis.

Poniżej szkielet całego dokumentu. Usunęliśmy z niego pozycje i dane stron, żeby widać było samą konstrukcję.

Elementy mają polskie nazwy, bo taki jest wzór opublikowany przez Ministerstwo Finansów. Przestrzeń nazw w pierwszej linii wskazuje konkretną wersję tego wzoru.

Od 1 lutego 2026 r. obowiązuje wyłącznie struktura FA(3). Dotyczy to także faktur korygujących do dokumentów wystawionych wcześniej w wersji FA(2) albo FA(1).

Co zawiera faktura ustrukturyzowana

Siedem bloków struktury FA(3)

Struktura dzieli dokument na bloki. Każdy odpowiada za inny rodzaj informacji i każdy ma własne reguły.

Nowością w wersji FA(3) jest możliwość dołączenia załącznika. Wymaga wcześniejszego zgłoszenia takiego zamiaru w urzędzie skarbowym.

W sprzedaży na marketplace praktycznie wszystkie problemy powstają w dwóch blokach: w danych nabywcy i w pozycjach faktury. Oba wypełniają się automatycznie z zamówienia.

Pola nagłówka faktury

Część Fa zaczyna się od pól, które na wydruku są zwykłym tekstem, a tutaj mają swoje nazwy i typy.

Pole P_1 zasługuje na osobną uwagę. To ono decyduje, w jakim trybie faktura zostanie uznana za wystawioną.

Jeżeli plik trafi do KSeF tego samego dnia, datą wystawienia jest dzień przesłania. Jeżeli później — dokument jest traktowany jako wystawiony w trybie offline24, a datą wystawienia zostaje wartość z P_1.

Pozycje: element FaWiersz

Każda pozycja sprzedaży to jeden element FaWiersz. Powtarza się tyle razy, ile wierszy ma faktura.

Zwróć uwagę na ostatnie pole. P_12 niesie stawkę podatku i jest to jedno z niewielu miejsc, w których schemat dopuszcza wyłącznie zamkniętą listę wartości.

W naszych danych to właśnie ono odpowiada za 72% wszystkich nieudanych wysyłek. Wracamy do tego w ostatniej części.

Dane nabywcy: cztery warianty

Blok Podmiot2 opisuje kupującego. Wygląda inaczej w zależności od tego, kim ten kupujący jest.

Cztery warianty, jeden blok. Polski przedsiębiorca podaje NIP, podatnik z innego kraju UE — kod kraju i numer VAT UE, kupujący spoza Unii — kod kraju i własny identyfikator.

Czwarty wariant jest w sprzedaży na marketplace najczęstszy i najmniej oczywisty. Kiedy kupujący nie ma numeru, dokument niesie element BrakID.

Adnotacje, czyli deklaracje domyślnie przeczące

Blok Adnotacje jest obecny na każdej fakturze, także wtedy, gdy nic szczególnego nie deklaruje.

Wtedy jego pola niosą wartości przeczące: nie metoda kasowa, nie samofakturowanie, nie odwrotne obciążenie.

Wartości domyślne opisują zwykłą sprzedaż krajową. Każde odstępstwo — mechanizm podzielonej płatności, procedura marży, odwrotne obciążenie — trzeba ustawić świadomie.

Od kiedy faktura ustrukturyzowana jest obowiązkowa

Dwa progi zamiast jednej daty

KSeF działa jako rozwiązanie dobrowolne od 1 stycznia 2022 r. Obowiązek wszedł w życie znacznie później i w dwóch etapach.

Od 1 lutego 2026 r. obowiązek objął przedsiębiorców, których wartość sprzedaży wraz z kwotą podatku przekroczyła w 2024 r. 200 mln zł.

Od 1 kwietnia 2026 r. objął pozostałych. Podstawą jest ustawa z 5 sierpnia 2025 r., która wprowadziła fazowanie terminów.

Co nadal można wystawiać poza KSeF

Razem z fazowaniem ustawodawca wprowadził kilka uproszczeń. Większość z nich obowiązuje do końca 2026 r.

Osobno, i bez daty końcowej, działa jeszcze jedna zasada. Faktury na rzecz osób fizycznych nieprowadzących działalności można wystawiać w KSeF dobrowolnie.

Decyzja należy do wystawcy. Dla sprzedawcy na marketplace jest to jedna z ważniejszych informacji w całym temacie — wracamy do niej niżej.

Kto musi wystawiać faktury ustrukturyzowane

Kto jest objęty obowiązkiem

Z KSeF korzystają podatnicy — jednoosobowe działalności, spółki, grupy VAT i jednostki samorządu terytorialnego.

Korzystać mogą także podmioty przez nich wskazane, na przykład biuro rachunkowe, oraz organy egzekucyjne i komornicy sądowi.

Uprawnienia nadaje się w systemie albo zgłasza zawiadomieniem ZAW-FA. Każdy, kto z KSeF korzysta, musi się w nim uwierzytelnić.

Kto jest wyłączony

Wyłączenia dzielą się na trzy grupy. Pierwsza wynika ze statusu stron transakcji, druga z procedury szczególnej, trzecia z rozporządzenia wykonawczego.

Najważniejsza dla sprzedaży transgranicznej jest grupa druga. Faktur wystawianych w procedurze OSS nieunijnej, w procedurze importu IOSS ani w procedurze SME nie wystawia się w KSeF.

Co więcej, w tych przypadkach nie można ich tam wystawić nawet dobrowolnie.

Jak wystawić fakturę ustrukturyzowaną

Dwie drogi, nie jedna

Korzystanie z KSeF wymaga uwierzytelnienia. Może to zrobić sam podatnik albo osoba czy podmiot przez niego wskazany.

Ministerstwo Finansów udostępnia bezpłatne narzędzia. Drugą drogą jest program finansowo-księgowy zintegrowany z API KSeF.

Wybór nie jest kwestią gustu, tylko liczby dokumentów i tego, skąd pochodzą ich dane.

Przy kilku fakturach miesięcznie aplikacja Ministerstwa wystarcza. Przy sprzedaży na marketplace liczba faktur rośnie razem z liczbą zamówień, a dane wpisuje kupujący, nie sprzedawca.

Co się dzieje po naciśnięciu „wyślij”

Wysyłka nie jest pojedynczym żądaniem. To sesja, w której dokument jest przekazywany, a wynik trzeba odebrać osobno.

Najpierw otwierana jest sesja. Dopiero w niej wędruje dokument, a potem system trzeba odpytać o rezultat.

Token użyty do połączenia musi mieć zarówno prawo wystawiania faktur, jak i prawo odczytu statusu. Token z samym prawem wystawiania wygląda na poprawny w momencie zapisu i przestaje działać dokładnie wtedy, gdy potrzebny jest werdykt.

Numer KSeF i UPO — dowód, że faktura istnieje

Po pozytywnej weryfikacji system nadaje dokumentowi numer i wystawia urzędowe poświadczenie odbioru.

Numer ma trzydzieści pięć znaków i niesie w sobie NIP sprzedawcy oraz datę przyjęcia. Dzięki temu można go czytać, nie odpytując systemu.

Fakturę uznaje się za otrzymaną w dniu przydzielenia tego numeru. To jest data, od której liczą się terminy po stronie nabywcy.

Cztery tryby wystawiania faktury

Nie każda faktura trafia do KSeF w chwili wystawienia. Ustawa przewiduje tryb online i trzy odmiany trybu offline.

Różnica między nimi sprowadza się do jednego: która data jest datą wystawienia.

W trybie online jest nią dzień przesłania pliku do systemu. W każdym trybie offline — data wskazana przez wystawcę w polu P_1.

Dokument wystawiony offline i tak musi trafić do KSeF, tylko później, w terminie określonym ustawą.

Jak wystawić fakturę korygującą

Korekta w KSeF nie jest dopiskiem do istniejącego dokumentu. To osobna faktura, która wskazuje tę pierwotną.

Wskazanie działa na dwa sposoby naraz: przez numer nadany przez wystawcę i przez numer KSeF dokumentu pierwotnego. Po tym drugim system łączy oba dokumenty.

Jeżeli faktura pierwotna nie ma numeru KSeF — bo powstała przed obowiązkiem albo poza systemem — zamiast tych pól wysyła się znacznik jej braku.

Od 1 lutego 2026 r. korekty wystawia się w strukturze FA(3) także wtedy, gdy faktura pierwotna została wystawiona w wersji FA(2) albo FA(1).

Kiedy fakturę trzeba przekazać nabywcy

Co do zasady faktura jest wystawiana i otrzymywana w KSeF. Nabywca sam ją tam odbiera i nic wysyłać nie trzeba.

Ustawa wymienia jednak sytuacje, w których nabywca nie może tego zrobić. Wtedy fakturę trzeba przekazać mu w sposób z nim uzgodniony.

Kod weryfikujący QR

Faktura przekazana poza systemem musi zostać opatrzona kodem weryfikującym. Kod umożliwia nabywcy dostęp do dokumentu w KSeF i sprawdzenie jego danych.

Obowiązek dotyczy także każdego innego użycia faktury poza KSeF, nie tylko przekazania jej nabywcy.

Dla sprzedawcy na marketplace oznacza to, że kod QR jest regułą, a nie wyjątkiem. Większość jego kupujących to konsumenci.

Co dać kupującemu, zanim faktura dostanie numer

Bywa, że dokument trzeba wydać wcześniej, niż KSeF zdąży nadać numer. Typowo wtedy, gdy jedzie w paczce.

Na taką sytuację przewidziano potwierdzenie transakcji — dokument z dwoma kodami QR, mówiący, że faktura w KSeF dopiero zostanie wystawiona.

Potwierdzenie transakcji nie jest fakturą. To dokument o charakterze biznesowo-technicznym i nie zastępuje faktury ustrukturyzowanej.

Faktura ustrukturyzowana dla osoby fizycznej

To najczęstsze pytanie w sprzedaży detalicznej i jednocześnie miejsce, w którym najłatwiej o pomyłkę.

Faktury dla osób fizycznych nieprowadzących działalności można wystawiać w KSeF dobrowolnie. Nie ma obowiązku, ale nie ma też zakazu.

Jeżeli zdecydujesz się wystawiać je w KSeF, dokument wygląda niemal tak samo jak dla firmy. Różnica jest w bloku identyfikacyjnym: zamiast numeru pojawia się BrakID.

Konsument nie odbierze faktury w systemie, więc trzeba mu ją przekazać. A skoro trafia poza KSeF, wymaga kodu weryfikującego.

Co się psuje w praktyce: 1 190 nieudanych wysyłek

Do tej pory opisywaliśmy, jak dokument ma wyglądać. Teraz to, co się z nim dzieje, kiedy powstaje automatycznie z zamówienia.

Przeanalizowaliśmy 1 190 nieudanych wysyłek do KSeF przetworzonych przez easySales oraz 6 132 dokumenty przyjęte z nadanym numerem.

Piszemy „nieudane wysyłki”, a nie „odrzucone faktury”, bo to nie to samo. Część przypadków to błąd walidacji dokumentu, część — nieudane nawiązanie sesji, przy którym KSeF w ogóle nie zobaczył treści faktury.

Rozkład przyczyn

Jedna rzecz rzuca się w oczy od razu. Prawie żaden z tych błędów nie jest błędem księgowym.

To błędy danych. Biorą się stąd, że faktura powstała automatycznie z zamówienia, a nie została wypełniona przez człowieka, który zna kontrahenta.

Stawka VAT spoza polskiej listy

858 przypadków — blisko cztery razy więcej niż kolejna przyczyna.

Schemat FA dopuszcza w polu stawki podatku wyłącznie wartości stosowane w Polsce.

Skąd na fakturze polskiego sprzedawcy biorą się stawki 19, 20, 21 czy 27? Z zamówień transgranicznych.

Sprzedaż na zagranicznych platformach albo wysyłka do kupujących z innych krajów UE potrafi przynieść w zamówieniu stawkę obowiązującą tam. System fakturujący przepisuje ją na dokument.

Co z tym zrobić: ustal, które zamówienia generują stawki inne niż polskie, i nie wysyłaj tych faktur do KSeF tym samym przepływem.

To decyzja o zakresie wysyłki, a nie obejście walidacji. Jak traktować konkretną transakcję transgraniczną — to pytanie do Twojego księgowego; tutaj opisujemy wyłącznie to, co robi walidacja schematu.

Sesja nie została otwarta

218 przypadków. To jedyna pozycja na liście, która nie jest odrzuceniem faktury.

Jeżeli sesja się nie otworzy, KSeF nie zobaczy treści dokumentu. Nie ma czego walidować.

Najczęstsza przyczyna leży po stronie uprawnień tokena, opisanych wyżej. Ten błąd nie mówi nic o treści faktury i nie da się go naprawić, poprawiając dane.

Pozostałe sześć wzorców

Razem 114 przypadków, czyli niecałe 10%. Wszystkie sprowadzają się do jakości danych przychodzących z zamówienia.

• W polu NIP nie ma numeru NIP (72) — kupujący wpisuje NIP: 1234567890 zamiast samego numeru albo podaje czeskie IČO czy słowackie DIČ.
• Niekompletne dane identyfikacyjne (15) — blok identyfikacyjny nabywcy wymaga kompletu, a brakuje go już na wejściu, w samym zamówieniu.
• Pole kontaktowe z danymi innego typu (8) — w polu telefonu ląduje nazwa firmy. Pola faktury dziedziczą dokładnie to, co przyszło w zamówieniu.
• Duplikat numeru (5) — KSeF pilnuje unikalności numeru i zgłasza kolizję kodem 440. Jeśli wskazany dokument to ta sama faktura, jej numer i UPO przypisują się same.
• Data wystawienia po dacie przyjęcia (5) — dokumentu nie da się przyjąć „wstecz z przyszłości”. Zwykle chodzi o datowanie z wyprzedzeniem albo o strefę czasową.
• Pozostałe (9) — pojedyncze, niepowtarzalne sytuacje: błędny numer VAT UE, brak faktury do wysłania, przekroczony limit żądań.

Pierwsze pytanie przy każdym błędzie

Zanim zaczniesz szukać przyczyny w konkretnym dokumencie, sprawdź jedną rzecz. Czy nie wychodzi wszystko, czy tylko część.

To rozróżnienie oszczędza najwięcej czasu w całym temacie, bo obie kategorie zgłasza się komu innemu.

Sesja to sprawa dla osoby zarządzającej uprawnieniami. Walidacja — dla osoby odpowiedzialnej za dane zamówień. Wysłanie problemu do niewłaściwej z nich kosztuje zwykle dzień.

Gdzie leży poprawka

Diagnoza jest połową roboty. Poniżej druga połowa: co konkretnie naprawia każdy z tych przypadków.

Wniosek praktyczny jest chyba ważniejszy niż same liczby. Większość odrzuceń nie wymaga pracy przy dokumentach, tylko jednej decyzji o zakresie wysyłki i dwóch reguł czyszczących dane.

To kilka godzin roboty, po których ta ścieżka przestaje wymagać uwagi. Nie stały koszt obsługi, jak wygląda w pierwszym miesiącu.

Jak ustawić to krok po kroku, opisujemy w przewodniku: KSeF i faktury ustrukturyzowane. Jeśli chcesz zobaczyć samo połączenie, jest tutaj: integracja z KSeF.

Metodologia

Dane obejmują wysyłki faktur do KSeF przetworzone przez easySales od 15 maja 2026 do 4 września 2026, ze środowiska produkcyjnego.

Liczymy wysyłki, nie komunikaty błędów. Jedna nieudana wysyłka bywa ponawiana i zapisuje wtedy kilka komunikatów, więc zliczanie komunikatów zawyżyłoby zwłaszcza pozycję „sesja nie została otwarta”.

Każda wysyłka jest przypisana do jednej przyczyny — tej, na której zakończyła się ostatecznie. Z zestawienia wyłączone są wysyłki pominięte dlatego, że faktura była już zarejestrowana w KSeF, oraz dokumenty wciąż przetwarzane.

Nazwy elementów i pól w tym artykule pochodzą ze struktury logicznej FA(3) oraz z dokumentu XML budowanego przez easySales. Wszystkie wartości w przykładach są syntetyczne.