Przejdź do treści
KSeF Kit

Wizualizacja faktury KSeF: PDF to nie faktura

Fakturą jest plik XML w formacie FA(3), który leży w KSeF i ma nadany numer KSeF. Wizualizacja, czyli PDF, wydruk albo podgląd na ekranie, to tylko obraz tego dokumentu. Nie jest osobną fakturą i nie zastępuje oryginału. Dlatego na wizualizacji liczy się przede wszystkim jedno: czy da się z niej wrócić do faktury w systemie, po numerze KSeF i po kodzie weryfikacyjnym.

Jeszcze niedawno faktura i PDF były praktycznie tym samym. Wystawiałeś dokument, drukowałeś go albo wysyłałeś mailem, i to właśnie ten plik krążył między firmami. Od 1 lutego 2026, odkąd KSeF jest obowiązkowy, kolejność się odwróciła. Najpierw powstaje XML, system nadaje mu numer i trzyma go u siebie przez dziesięć lat. PDF powstaje później, z tego XML-a, i jest wygodą, a nie transakcją.

Ta jedna zmiana tłumaczy większość pytań, które ludzie zadają po pierwszym kontakcie z KSeF. Czemu dostałem plik XML zamiast faktury. Czemu kontrahent prosi o PDF, skoro fakturę już ma. Po co ten kod QR na wydruku.

Czym właściwie jest wizualizacja

Słowo brzmi urzędowo, a znaczy rzecz prostą: czytelna dla człowieka postać faktury, która w systemie jest plikiem XML. Może to być PDF, wydruk na papierze, ekran w programie księgowym albo załącznik do maila. Każda z tych postaci pokazuje te same dane, tylko w formie, którą da się przeczytać bez edytora XML.

To słowo nie pochodzi z ustawy. Ustawa o VAT w ogóle nie używa terminu „wizualizacja” i nie mówi, jak taki dokument ma wyglądać. Nie narzuca układu, czcionki ani tego, czy na wydruku ma być Twoje logo. Mówi co innego: kiedy fakturę trzeba udostępnić poza systemem i czym ją wtedy oznaczyć. Cała reszta to praktyka rynkowa i wzory z dokumentacji technicznej Ministerstwa Finansów.

Dlatego dwie firmy mogą przysłać Ci wizualizacje tej samej faktury wyglądające zupełnie inaczej i obie będą w porządku. Liczy się treść i kod, nie grafika.

Trzy sytuacje, w których ludzie tego szukają

Prawie każdy, kto szuka wizualizacji faktury KSeF, ma jeden z trzech problemów.

Dostałem plik XML i nie umiem go otworzyć. Kontrahent przesłał załącznik, który w przeglądarce wygląda jak drzewo tagów. Chcesz zobaczyć kwoty, terminy i pozycje, a nie kod. Jak to zrobić, opisuję niżej.

Muszę dać klientowi coś czytelnego. Klient jest konsumentem, firmą zagraniczną albo po prostu nie ma dostępu do KSeF. Faktura leży w systemie, ale on jej tam nie zobaczy, więc potrzebuje dokumentu, który przyjdzie mailem. To najczęstszy przypadek i to on rządzi wymogami z następnej części.

Potrzebuję wydruku. Do teczki, do kierowcy, do banku, do wniosku o dotację. Papier nadal bywa potrzebny, tyle że teraz jest kopią, a nie oryginałem.

Co musi się znaleźć na wizualizacji

To dwie różne rzeczy: co nakazuje ustawa i co przyjęło się robić.

Ustawa nakazuje kod. Art. 106gb ust. 5 ustawy o VAT mówi, że podatnik ma obowiązek oznaczyć fakturę ustrukturyzowaną „kodem umożliwiającym dostęp do tej faktury w Krajowym Systemie e-Faktur oraz umożliwiającym weryfikację danych zawartych na tej fakturze”. Obowiązek uruchamiają dwie sytuacje: udostępnienie faktury nabywcy z art. 106gb ust. 4 inaczej niż przez KSeF albo użycie faktury poza systemem. Praktycznie znaczy to tyle, że każdy PDF, który wychodzi z Twojej firmy, ma nieść ten kod.

Nabywcy z ust. 4 to właśnie ci, którzy faktury w KSeF nie zobaczą: gdy miejscem świadczenia jest inne państwo, gdy nabywca nie ma siedziby w Polsce, gdy nie posługuje się numerem identyfikacji podatkowej albo gdy jest osobą fizyczną nieprowadzącą działalności. Takiemu nabywcy fakturę udostępnia się „w sposób z nim uzgodniony”, czyli zwykle mailem, w PDF.

Jest jeszcze jeden przepis, o którym łatwo zapomnieć. Art. 106gb ust. 6 dotyczy nabywców bez numeru podatkowego i konsumentów, którzy odbierają fakturę przez KSeF. Wtedy trzeba im zapewnić dostęp przez podanie kodu z ust. 5 oraz „danych umożliwiających zidentyfikowanie tej faktury”, czyli numeru KSeF. Sam numer bez kodu nie wystarcza, sam kod bez numeru też nie.

Praktyka dokłada numer KSeF pod kodem. Dokumentacja Ministerstwa Finansów mówi wprost, że pod kodem QR umieszcza się numer KSeF faktury, a jeśli numeru jeszcze nie ma, w tym miejscu pojawia się napis „OFFLINE”. To nie jest wymóg ustawowy, tylko wzór, którego trzyma się cały rynek. Trzymaj się go też, bo Twój odbiorca będzie szukał numeru dokładnie tam.

Zostaje trzecia część, najbardziej oczywista: treść faktury. Strony, pozycje, stawki, kwoty, terminy. Wizualizacja bez tego jest tylko naklejką z kodem.

Krótko: numer KSeF, kod weryfikacyjny, treść. Jak działają same kody, czym różni się KOD I od KOD II i dlaczego liczysz je u siebie zamiast pobierać z API, opisuję osobno w kodach QR na fakturze KSeF.

Jak obejrzeć XML, którego nie umiesz otworzyć

Masz cztery drogi, od najwygodniejszej.

Bezpłatna Aplikacja Podatnika KSeF. Ministerstwo Finansów udostępnia własną aplikację pod adresem ap.ksef.mf.gov.pl i ona po prostu to potrafi. Przegląda faktury i korekty, pozwala wyszukać i pobrać wystawione dokumenty w formacie XML lub PDF, pobrać UPO dla jednej faktury albo wielu naraz, obsługuje kody QR i daje dostęp do faktury po zeskanowaniu kodu. Nie musisz kupować programu, żeby zobaczyć własną fakturę. Zajrzyj tam, zanim ktoś sprzeda Ci przeglądarkę KSeF za abonament. Środowisko testowe działa pod ap-test.ksef.mf.gov.pl, produkcja pod ap.ksef.mf.gov.pl. Stare adresy z KSeF 1.0 już nie odpowiadają.

Skan kodu QR z wizualizacji. Jeśli dostałeś PDF z kodem, wystarczy go zeskanować. Zobaczysz uproszczoną prezentację podstawowych danych faktury oraz potwierdzenie, że dokument jest w KSeF. To wystarczy, żeby sprawdzić, czy faktura jest prawdziwa. Pełny dostęp do treści, na przykład pobranie pliku XML, wymaga podania dodatkowych danych, więc przypadkowy przechodzień nie przeczyta cudzej faktury ze zdjęcia wydruku.

Twój program księgowy. Większość programów, które umieją odbierać faktury z KSeF, umie też pokazać je po ludzku i wydrukować.

Ostateczność: przeglądarka. XML otwarty w przeglądarce albo w edytorze tekstu da się przeczytać, bo nazwy pól w FA(3) są po polsku. Wystarczy, żeby sprawdzić jedną kwotę. Na dokument dla klienta się nie nadaje.

Czy PDF ma jeszcze jakąkolwiek moc

Tu trzeba mówić ostrożnie, bo odpowiedź nie jest zerojedynkowa.

PDF nie jest fakturą. Faktura ustrukturyzowana to dokument w KSeF, identyfikowany numerem KSeF, i to on wywołuje skutki w VAT. Wizualizacja niczego nie wystawia i niczego nie zastępuje. Jeśli PDF różni się od XML-a, prawdziwy jest XML.

To nie znaczy, że PDF jest bezwartościowy. Dla nabywcy spoza systemu to jedyna postać faktury, jaką w ogóle zobaczy, i to na jej podstawie zapłaci. Dla Ciebie to dokument handlowy, załącznik do umowy, materiał do rozliczenia projektu. Kod weryfikacyjny robi z niego coś więcej niż kartkę: po zeskanowaniu prowadzi do faktury w KSeF, więc odbiorca sprawdzi, czy dokument, który trzyma w ręku, odpowiada temu, co jest w systemie. Na tym polega cała jego wartość i dlatego kod oraz numer KSeF są ważniejsze niż układ strony.

Czego nie powiem, bo nie chcę zgadywać: nie ma jednej prostej reguły, jak sądy i organy podatkowe potraktują wizualizację w sporze z kontrahentem. Praktyka dopiero się układa. Bezpieczna zasada jest jedna: dbaj, żeby z każdej wizualizacji dało się dotrzeć do oryginału.

Co archiwizować

Tu jest dobra wiadomość. Zgodnie z art. 112aa ustawy o VAT faktury ustrukturyzowane po przesłaniu do KSeF są przechowywane w systemie przez 10 lat, licząc od końca roku, w którym zostały wystawione, a art. 112 i art. 112a się do nich nie stosuje. Czyli państwo archiwizuje je za Ciebie i nie musisz trzymać własnej kopii faktury tylko po to, żeby spełnić wymóg przechowywania.

Są dwa zastrzeżenia. Po pierwsze, jeśli te 10 lat upłynie wcześniej niż przedawnienie zobowiązania podatkowego, resztę okresu zapewniasz sam, już poza KSeF. Po drugie, brak obowiązku to nie to samo co brak powodu. Własna kopia przydaje się, gdy chcesz coś sprawdzić bez logowania do systemu, gdy księgowa pracuje na swoich plikach albo gdy zmieniasz narzędzia.

Co warto trzymać, w kolejności ważności: numer KSeF przy każdej fakturze, UPO oraz XML. Numer KSeF to adres dokumentu w systemie, a bez niego szukanie faktury robi się niepotrzebnie żmudne. UPO dowodzi, że KSeF fakturę przyjął, i opisuję je osobno w tekście o urzędowym poświadczeniu odbioru. PDF trzymaj, jeśli lubisz, ale traktuj go jak kopię listu, nie jak list.

Faktura wystawiona offline

Osobny przypadek, wart jednego akapitu. Fakturę wystawioną w trybie offline lub offline24 przekazujesz nabywcy, zanim system nada jej numer KSeF. Wizualizacja niesie wtedy dwa kody: KOD I z napisem „OFFLINE” i KOD II z napisem „CERTYFIKAT”, który potwierdza tożsamość wystawcy. Numer KSeF pojawi się dopiero po przesłaniu dokumentu do systemu, więc wizualizacja przekazana wcześniej go nie zawiera. Szczegóły, łącznie z terminem przesłania, są w kodach QR na fakturze KSeF.

Najczęstsze nieporozumienia

Co pokazuje KSeF Kit

Na koniec uczciwie, bo to ważniejsze niż ładna obietnica. KSeF Kit nie generuje wizualizacji faktury. PDF faktury robi Stripe i to on trafia do klienta, tak jak wcześniej. My dokładamy do tego stronę KSeF, czyli dowody i identyfikatory, których w PDF-ie ze Stripe'a nie ma.

Co dostajesz:

Czego nie robimy: nie rysujemy obrazka kodu QR, nie składamy PDF-a faktury i nie dopisujemy numeru KSeF do PDF-a wystawionego przez Stripe'a, bo Stripe nie pozwala zmieniać sfinalizowanej faktury. Dlatego numer KSeF mieszka w panelu i na potwierdzeniu do druku.

Jeśli dopiero układasz proces, zacznij od jak wystawić fakturę ustrukturyzowaną, a potem zobacz integrację Stripe z KSeF.

Najczęstsze pytania

Czy faktura z KSeF ma PDF?

Nie z automatu. KSeF przechowuje fakturę jako plik XML w formacie FA(3) i to ten plik jest fakturą. PDF powstaje dopiero wtedy, gdy ktoś zrobi go z XML-a: Twój program, program księgowy nabywcy albo bezpłatna Aplikacja Podatnika KSeF, która pozwala pobrać wystawiony dokument w formacie XML lub PDF.

Co to jest wizualizacja faktury ustrukturyzowanej?

Czytelna dla człowieka postać faktury, która w systemie jest plikiem XML: PDF, wydruk albo ekran w programie. Ustawa o VAT nie używa słowa „wizualizacja” i nie narzuca układu takiego dokumentu. Nakłada za to obowiązek oznaczenia faktury kodem, który daje do niej dostęp w KSeF i pozwala zweryfikować dane.

Co musi być na wydruku faktury z KSeF?

Treść faktury, kod weryfikacyjny (KOD I) oraz numer KSeF, który zgodnie z dokumentacją Ministerstwa Finansów umieszcza się pod kodem QR. Obowiązek oznaczenia kodem wynika z art. 106gb ust. 5 ustawy o VAT i dotyczy faktur przekazywanych nabywcy poza KSeF albo używanych poza systemem.

Czy wydrukowana faktura z KSeF ma moc prawną?

Wydruk nie jest fakturą, tylko jej obrazem. Oryginał leży w KSeF i identyfikuje go numer KSeF. Dla kontrahenta wydruk pozostaje dokumentem handlowym, po którym da się dotrzeć do oryginału, o ile niesie numer KSeF i kod weryfikacyjny.

Czy muszę archiwizować PDF faktury?

Nie po to, żeby spełnić obowiązek przechowywania. Zgodnie z art. 112aa ustawy o VAT faktury ustrukturyzowane są przechowywane w KSeF przez 10 lat, licząc od końca roku wystawienia, a art. 112 i 112a się do nich nie stosuje. Jeśli te 10 lat upłynie przed przedawnieniem zobowiązania podatkowego, resztę okresu zapewniasz sam, poza KSeF.

Jak obejrzeć fakturę, jeśli dostałem sam plik XML?

Najprościej w bezpłatnej Aplikacji Podatnika KSeF pod adresem ap.ksef.mf.gov.pl: przegląda faktury i pozwala pobrać je w formacie XML lub PDF. Możesz też zeskanować kod QR z wizualizacji, ale zobaczysz wtedy uproszczoną prezentację podstawowych danych, a pełny dostęp wymaga podania dodatkowych informacji.