Odbieranie faktur

Wizualizacja faktury KSeF: jak wygląda faktura z KSeF i co musi mieć jej PDF

W skrócie

Wizualizacja faktury KSeF to czytelna postać pliku XML: PDF, wydruk albo podgląd na ekranie. Fakturą jest sam XML z numerem KSeF, a wyglądu wizualizacji MF nie narzuca – programy mogą mieć własny układ, byle treść zgadzała się z plikiem. Wizualizacja używana poza KSeF musi mieć kod QR, a pod nim numer KSeF.

Spis treści
  1. Czym jest wizualizacja faktury KSeF?
  2. Jak wygląda faktura z KSeF? Czy MF daje wzór?
  3. Co musi mieć wizualizacja przekazana poza KSeF?
  4. Czy na fakturze KSeF można dodać logo?
  5. Co zawiera wizualizacja MF (styl.xsl) – sekcja po sekcji
  6. Dlaczego PDF faktury z KSeF jest pusty albo brakuje w nim danych?
  7. Wizualizacja faktury KSeF z pliku XML – przykład krok po kroku

Wizualizacja faktury KSeF to czytelny obraz pliku XML: PDF, wydruk albo podgląd na ekranie. Fakturą jest sam XML z numerem KSeF, a wyglądu wizualizacji nikt nie narzuca – MF publikuje własny arkusz styl.xsl, ale programy mogą mieć swój układ. Gdy używasz jej poza KSeF, musi mieć kod QR z numerem KSeF.

Samo pobieranie faktur z systemu opisujemy w tekście jak pobrać fakturę z KSeF.

Czym jest wizualizacja faktury KSeF?

Fakturą ustrukturyzowaną jest faktura wystawiona przy użyciu KSeF razem z przydzielonym jej numerem (art. 2 pkt 32a ustawy o VAT) – w praktyce plik XML zgodny ze strukturą FA(3). MF ujmuje to krótko: z formalnego punktu widzenia dokumentem jest XML (FAQ KSeF 2.0, sekcja „KSeF w JST”, pyt. 40). Wszystko, co wygląda jak „kartka” z tabelą pozycji, to wizualizacja tego pliku.

Spotkasz ją w kilku miejscach:

  • podgląd przed wysyłką – „Podgląd faktury” w Aplikacji Podatnika, a w aplikacji mobilnej ekran podsumowania z napisem „Kopia robocza”; to jeszcze nie faktura, bo nie ma numeru KSeF,
  • PDF pobrany z KSeF – z Aplikacji Podatnika, Aplikacji Mobilnej KSeF albo e-mikrofirmy (cz. II pkt 1.6.5),
  • PDF lub wydruk z programu do fakturowania, który sprzedawca wysyła klientowi,
  • podgląd HTML utworzony arkuszem MF styl.xsl.

Jak wygląda faktura z KSeF? Czy MF daje wzór?

Graficznego wzoru nie ma. Struktura FA(3), nazywana wzorem e-Faktury, określa, jakie dane i w jakim formacie trafiają do pliku XML, a nie jak mają wyglądać na papierze – MF pisze to wprost we wstępie do rozdz. 2 cz. II Podręcznika KSeF 2.0. Na pytanie, czy wizualizacja musi wyglądać jak wzór ministerstwa, MF odpowiada, że nie: programy mogą mieć własny wygląd, byle merytorycznie odzwierciedlał dane w KSeF (FAQ, „Wystawianie i otrzymywanie faktur”, pyt. 33).

O układzie decyduje wystawca albo dostawca programu. MF oczekuje trzech rzeczy: spójności z XML, czytelności i braku sprzeczności między plikiem przyjętym przez KSeF a dokumentem, który dostaje odbiorca (cz. II pkt 1.6.5). Jeśli szukasz „wzoru faktury KSeF”, przydadzą się raczej przykładowe pliki XML FA(3) i schemat XSD.

Skąd wziąć wizualizację?

Źródło Postać Kod QR i numer KSeF
Aplikacja Podatnika – „Pobierz”, format PDF PDF dodaje je system (FAQ, „KSeF w JST”, pyt. 70)
Aplikacja Mobilna KSeF, e-mikrofirma PDF sprawdź na pobranym pliku
program do fakturowania PDF lub wydruk w układzie dostawcy musi je dodać program (art. 106gb ust. 5)
arkusz MF styl.xsl z crd.gov.pl strona HTML „e-FAKTURA KSeF” brak
biblioteka MF ksef-pdf-generator z GitHuba PDF numer KSeF i link do kodu przekazujesz osobno

Dwa ostatnie wiersze to nasz odczyt plików MF z 17 listopada 2026 r. Arkusz styl.xsl czyta tylko XML, a numeru KSeF w XML nie ma – system nadaje go dopiero po przyjęciu pliku. Dlatego generator PDF przyjmuje go jako dane dodatkowe: w kodzie to pola nrKSeF, qrCode i qr2Code. MF wspomina też o transformacie udostępnionej razem ze wzorem nr 13775, która ma pomóc przy budowie własnej wizualizacji (cz. II pkt 1.6.5) – w repozytorium wzorów to właśnie plik styl.xsl.

Co musi mieć wizualizacja przekazana poza KSeF?

Gdy PDF albo wydruk trafia do klienta zagranicznego, konsumenta, banku czy urzędu, sprawdź pięć rzeczy:

  1. Kod QR (KOD I) prowadzący do faktury w KSeF (art. 106gb ust. 5 ustawy o VAT).
  2. Numer KSeF bezpośrednio pod kodem (§ 9 ust. 1 pkt 2 rozporządzenia w sprawie korzystania z KSeF). Faktura offline wydana przed wysyłką ma w tym miejscu napis „OFFLINE” i drugi kod z napisem „CERTYFIKAT” – szczegóły w tekście kod QR w KSeF.
  3. Treść zgodną z XML. Wizualizacja może być po angielsku albo dwujęzyczna, jeśli po przetłumaczeniu mówi to samo co plik (FAQ, pyt. 32) – zob. faktura po angielsku w KSeF.
  4. Tylko te adnotacje, które występują. W XML każda adnotacja ma znacznik 1 albo 2, a na wizualizacji pokazujesz te ze znacznikiem 1. Przykład MF: P_16 = 1 wymaga dopisku „metoda kasowa”, przy P_16 = 2 nie piszesz nic (cz. II pkt 1.6.5).
  5. Dane handlowe w XML, nie tylko na PDF. MF odradza wysyłanie do KSeF samego minimum ustawowego i dopisywanie terminu płatności czy numeru rachunku wyłącznie na wizualizacji. Do tego służą elementy Platnosc, WarunkiTransakcji, Rozliczenie i pole DodatkowyOpis.

Krajowemu nabywcy z NIP, który odbiera fakturę w KSeF, wizualizacji wysyłać nie musisz. PDF mailem ma dla niego charakter wyłącznie pomocniczy (FAQ, pyt. 50).

Na wizualizacji – tak. MF dopuszcza na niej dane bez znaczenia dla systemu, np. logo firmy albo kontakt do biura obsługi klienta (cz. II pkt 1.6.5). Do pliku XML logo nie dodasz: sprawdziliśmy schemat FA(3) i nie ma w nim żadnego elementu na grafikę.

Skutek praktyczny: logo zobaczy tylko ten, kto dostaje PDF z twojego programu. Nabywca, który pobierze fakturę z KSeF i otworzy ją w Aplikacji Podatnika albo w swoim systemie, zobaczy wizualizację zbudowaną z samego XML – bez logo. To nasz wniosek z budowy schematu. Dane, które mają być widoczne zawsze, wpisz do XML: e-mail i telefon w DaneKontaktowe, numery KRS, REGON i BDO w Stopka/Rejestry.

Co zawiera wizualizacja MF (styl.xsl) – sekcja po sekcji

Arkusz styl.xsl, opublikowany razem ze wzorem FA(3), tworzy stronę z tytułem „e-FAKTURA KSeF”. Pokazuje wyłącznie dane z XML, w stałej kolejności, i pomija sekcje, których w pliku nie ma:

Sekcja Co zawiera
Nagłówek kod formularza FA (3), napis „Krajowy System e-Faktur (KSeF)”, rodzaj faktury słownie: podstawowa, korygująca, zaliczkowa…
Dane faktury waluta, numer (P_2), data wystawienia (P_1), miejsce wystawienia, data sprzedaży lub okres
Sprzedawca i nabywca NIP, nazwa, adres, adres korespondencyjny, dane kontaktowe, status podatnika
Podmiot trzeci, podmiot upoważniony dane i rola, jeśli występują
Pozycje nazwa, miara, ilość, cena, wartość, stawka, GTU, GTIN, PKWiU, CN, procedura
Podsumowanie wg stawek kwoty netto i VAT dla każdej stawki, kwota należności ogółem
Warunki płatności termin, forma, zapłata częściowa, rachunek bankowy i faktora, skonto, link do płatności
Adnotacje metoda kasowa, samofakturowanie, odwrotne obciążenie, MPP, zwolnienie z podstawą, nowe środki transportu, procedury marży
Korekta przyczyna oraz numer, data i numer KSeF faktury korygowanej
Dodatkowy opis, rozliczenia, warunki transakcji, zamówienie, WZ jeśli są wypełnione
Stopka teksty ze StopkaFaktury, numery KRS, REGON, BDO
Załącznik tabele i teksty z elementu Zalacznik
Dane techniczne data i czas wytworzenia pliku, nazwa systemu wystawcy

Opisy pól są urzędowe – przy numerze faktury widnieje np. formuła z ustawy o kolejnym numerze nadanym w ramach serii. Adnotacje arkusz pokazuje jako „1. Tak” albo „2. Nie”. Kodu QR i numeru KSeF tej faktury na stronie nie ma.

Dlaczego PDF faktury z KSeF jest pusty albo brakuje w nim danych?

Wizualizacja pokazuje tylko to, co jest w XML i co narzędzie potrafi odczytać.

Objaw Prawdopodobna przyczyna Co zrobić
brak rachunku, terminu płatności, numeru zamówienia sprzedawca nie wypełnił Platnosc ani WarunkiTransakcji – to węzły nieobowiązkowe (FAQ, „Rozwiązania informatyczne, integracje i struktura KSeF”, pyt. 9) poproś o uzupełnianie XML; tych danych nie ma też w twoim programie
sam ciąg dat i kwot, bez opisów XML i arkusz z różnych wersji struktury, np. plik FA(2) i arkusz FA(3) użyj narzędzia dla wersji z KodFormularza w nagłówku pliku
drzewo znaczników albo zlepiony tekst w przeglądarce otwierasz surowy XML bez arkusza pobierz PDF z Aplikacji Podatnika
program pokazuje mniej niż Aplikacja Podatnika program nie obsługuje rzadszych elementów FA(3), np. Zalacznik lub Rozliczenie porównaj z PDF z KSeF, zgłoś to dostawcy
napis „OFFLINE” zamiast numeru KSeF faktura offline wydana przed wysyłką do KSeF po nadaniu numeru pobierz fakturę z KSeF jeszcze raz

Drugi wiersz sprawdziliśmy sami: przykładowy plik MF z podmienioną przestrzenią nazw na tę z FA(2) arkusz styl.xsl zamienił w ciąg dat i kwot bez żadnych etykiet. Czwarty wiersz to nasza ocena, nie stanowisko MF.

Uwaga na nazwę. „Pusta faktura” w języku podatkowym oznacza coś innego: fakturę stwierdzającą czynności, których nie wykonano – z takiej faktury nie odliczysz VAT (art. 88 ust. 3a pkt 4 lit. a ustawy o VAT). Jeśli dostałeś w KSeF fakturę za transakcję, której nie było, zobacz fałszywa faktura w KSeF.

Wizualizacja faktury KSeF z pliku XML – przykład krok po kroku

Tak zamienisz w czytelną stronę plik pobrany z KSeF albo jeden z przykładów MF:

  1. Pobierz styl.xsl ze strony wzoru crd.gov.pl/wzor/2025/06/25/13775/.
  2. Arkusz importuje drugi plik MF – WspolneSzablonyWizualizacji_v12-0E.xsl – z adresu w crd.gov.pl. Jeśli twój procesor nie ma dostępu do sieci, pobierz też ten plik i w linii xsl:import wpisz samą jego nazwę.
  3. Uruchom procesor XSLT 1.0, np. xsltproc w systemie Linux lub macOS:
xsltproc --param nazwy-dla-kodow "false()" -o faktura.html styl.xsl faktura.xml
  1. Otwórz faktura.html w przeglądarce, a PDF zapisz poleceniem drukowania.

Parametr nazwy-dla-kodow wyłącza zamianę kodów, np. kodu kraju, na nazwy. Bez niego arkusz sięga po kolejne słowniki z crd.gov.pl – w naszym teście przekształcenie przerwało się wtedy błędem. Testowaliśmy w Pythonie z biblioteką lxml (17.11.2026, przykłady MF nr 1, 4 i 12):

from lxml import etree

arkusz = etree.XSLT(etree.parse("styl.xsl"))
html = arkusz(etree.parse("faktura.xml"), **{"nazwy-dla-kodow": "false()"})
open("faktura.html", "wb").write(bytes(html))

O drukowaniu i przechowywaniu faktur: czy faktury z KSeF trzeba drukować.

Najczęstsze pytania

Czy wizualizacja faktury KSeF musi wyglądać jak wzór MF?

Nie. MF w FAQ KSeF 2.0 potwierdza, że programy mogą generować własny wygląd faktury. Wizualizacja musi jednak merytorycznie odpowiadać danym z pliku XML w KSeF i nie może wprowadzać odbiorcy w błąd.

Czy PDF faktury z KSeF jest fakturą?

Formalnie fakturą jest plik XML z numerem KSeF, a PDF to jego wizualizacja. PDF lub wydruk z kodem QR i numerem KSeF możesz jednak używać poza systemem, także jako dowód księgowy – tak wyjaśnia MF w FAQ KSeF 2.0.

Gdzie znaleźć wzór faktury KSeF?

Graficznego wzoru nie ma. Wzorem jest struktura logiczna FA(3) w Centralnym Repozytorium Wzorów Dokumentów Elektronicznych (nr 13775). Obok schematu XSD jest tam arkusz styl.xsl, który zamienia plik XML w czytelny podgląd.

Czy można dodać logo do faktury w KSeF?

Do wizualizacji tak – MF dopuszcza na PDF logo i kontakt do obsługi klienta. Struktura FA(3) nie ma jednak pola na grafikę, więc nabywca, który pobiera fakturę z KSeF, logo nie zobaczy.

Dlaczego na wizualizacji z KSeF nie ma numeru rachunku?

Bo sprzedawca nie wpisał go do pliku XML. Wizualizacja pokazuje tylko dane z XML, a element Platnosc z rachunkiem bankowym jest w FA(3) nieobowiązkowy. Poproś sprzedawcę, by podawał rachunek w pliku, a nie tylko w PDF.

Źródła

  1. Podręcznik KSeF 2.0 cz. II (MF, 06.08.2026), pkt 1.6.5, wstęp do rozdz. 2 i pkt 5.4
  2. FAQ KSeF 2.0 (MF) – „Wystawianie i otrzymywanie faktur” pyt. 32–34 i 50; „Rozwiązania informatyczne, integracje i struktura KSeF” pyt. 9; „KSeF w JST” pyt. 40 i 70
  3. Wzór FA(3) w Centralnym Repozytorium Wzorów Dokumentów Elektronicznych (nr 13775) – schemat.xsd i styl.xsl
  4. Ustawa o VAT, t.j. Dz.U. 2026 poz. 1263 – art. 2 pkt 32a, art. 88 ust. 3a pkt 4, art. 106gb ust. 4–5a
  5. Rozporządzenie MFiG w sprawie korzystania z KSeF, Dz.U. 2025 poz. 1815 – § 9 (oznaczanie faktury kodem i numerem KSeF)
  6. CIRFMF/ksef-pdf-generator – biblioteka MF do wizualizacji PDF faktur (plik src/lib-public/types/common.types.ts)

Artykuł ma charakter informacyjny i nie stanowi porady podatkowej. W konkretnej sprawie skonsultuj się z księgowym lub doradcą podatkowym.

Przeczytaj też