Jak wystawić fakturę ustrukturyzowaną w KSeF — krok po kroku
Aby wystawić fakturę w KSeF: zbierasz dane sprzedaży, narzędzie buduje z nich plik XML w formacie FA(3), autoryzujesz sesję (token lub podpis XAdES) i wysyłasz dokument do KSeF, a system w odpowiedzi nadaje numer KSeF i UPO. Datą wystawienia jest data wysłania do KSeF (art. 106na ust. 1 ustawy o VAT). Tak działa KSeF.
Faktura ustrukturyzowana to nie PDF i nie skan — to plik XML w formacie FA(3), który system KSeF potrafi odczytać maszynowo. W myśl ustawy (art. 2 pkt 32a ustawy o VAT) jest to faktura wystawiona przy użyciu KSeF wraz z przydzielonym numerem identyfikującym ją w systemie. Od 1 lutego 2026 obowiązuje struktura FA(3) — zastąpiła ona FA(2) (obowiązującą od 1 września 2023 do 31 stycznia 2026). Poniżej cała droga: od danych sprzedaży po numer KSeF i UPO.
Jak wystawić fakturę w KSeF?
Krok po kroku: (1) zbierasz dane faktury, (2) narzędzie buduje z nich XML w formacie FA(3), (3) autoryzujesz sesję tokenem lub podpisem, (4) wysyłasz dokument do KSeF, (5) odbierasz numer KSeF i UPO. Datą wystawienia jest data wysłania (art. 106na ust. 1).
1. Zbierz dane faktury
Faktura ustrukturyzowana ma te same dane co zwykła: sprzedawca, nabywca (z NIP), pozycje, stawki VAT, kwoty, data sprzedaży i wystawienia. Różnica leży w formie — każde pole ma ściśle określone miejsce w schemacie FA(3).
2. Zbuduj dokument FA(3)
Nie piszesz XML ręcznie. Narzędzie do fakturowania mapuje dane na schemat FA(3) — to obejmuje m.in.:
- poprawne kody krajów i stawek VAT,
- przeliczenie walut obcych po kursie NBP (zobacz kursy walut na fakturze),
- walidację zgodności ze schematem przed wysyłką.
3. Otwórz sesję i podpisz
KSeF 2.0 wymaga autoryzowanej sesji. Uwierzytelniasz się tokenem lub podpisem (np. XAdES), otwierasz sesję online i w jej ramach wysyłasz dokument. Produkcja KSeF 2.0 działa od 1 lutego 2026; do prób bez ryzyka służy środowisko TEST (dostępne od 3 listopada 2025), w którym autoryzacja jest fikcyjna. Jest też Demo/preprod (od 15 listopada 2025) z realnym uwierzytelnianiem NIP, ale poza produkcją.
4. Wyślij i odbierz numer KSeF
Po wysyłce KSeF weryfikuje dokument. Jeśli jest poprawny:
- nadaje numer KSeF (unikalny identyfikator faktury w systemie),
- wystawia UPO — urzędowe poświadczenie odbioru, czyli potwierdzenie, że wysyłka zakończyła się sukcesem i faktura została wystawiona po nadaniu numeru KSeF (zobacz czym jest UPO).
Pamiętaj: datą wystawienia faktury jest data jej wysłania do KSeF (art. 106na ust. 1 ustawy o VAT) — nie data, którą wpiszesz w polu dokumentu.
Jeśli dokument ma błąd, dostajesz kod odrzucenia — wtedy poprawiasz dane i wysyłasz ponownie.
5. Zapisz numer i UPO
Numer KSeF i UPO to Twój dowód złożenia. Dobre narzędzie zapisuje je z powrotem przy fakturze, byś nie musiał szukać ich ręcznie. W KSeF Kit numer KSeF i UPO trafiają automatycznie na fakturę w Stripe.
Automatyzacja zamiast klikania
Ręczne wystawianie pojedynczych faktur w portalu jest możliwe, ale przy większej liczbie sprzedaży — męczące i podatne na błędy. Jeśli fakturujesz w Stripe, faktura może trafiać do KSeF automatycznie po finalizacji — bez kopiowania danych. Zobacz integrację Stripe + KSeF.