Wizualizacja faktury KSeF: jak wygląda faktura z KSeF i co musi mieć jej PDF
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
- Czym jest wizualizacja faktury KSeF?
- Jak wygląda faktura z KSeF? Czy MF daje wzór?
- Co musi mieć wizualizacja przekazana poza KSeF?
- Czy na fakturze KSeF można dodać logo?
- Co zawiera wizualizacja MF (styl.xsl) – sekcja po sekcji
- Dlaczego PDF faktury z KSeF jest pusty albo brakuje w nim danych?
- 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 | dodaje je system (FAQ, „KSeF w JST”, pyt. 70) | |
| Aplikacja Mobilna KSeF, e-mikrofirma | 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 |
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:
- Kod QR (KOD I) prowadzący do faktury w KSeF (art. 106gb ust. 5 ustawy o VAT).
- 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.
- 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.
- 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”, przyP_16= 2 nie piszesz nic (cz. II pkt 1.6.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,Rozliczeniei poleDodatkowyOpis.
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).
Czy na fakturze KSeF można dodać logo?
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:
- Pobierz
styl.xslze strony wzoru crd.gov.pl/wzor/2025/06/25/13775/. - 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 liniixsl:importwpisz samą jego nazwę. - Uruchom procesor XSLT 1.0, np.
xsltprocw systemie Linux lub macOS:
xsltproc --param nazwy-dla-kodow "false()" -o faktura.html styl.xsl faktura.xml
- Otwórz
faktura.htmlw 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
- Podręcznik KSeF 2.0 cz. II (MF, 06.08.2026), pkt 1.6.5, wstęp do rozdz. 2 i pkt 5.4
- 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
- Wzór FA(3) w Centralnym Repozytorium Wzorów Dokumentów Elektronicznych (nr 13775) – schemat.xsd i styl.xsl
- 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
- Rozporządzenie MFiG w sprawie korzystania z KSeF, Dz.U. 2025 poz. 1815 – § 9 (oznaczanie faktury kodem i numerem KSeF)
- 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.