KSeF XML do PDF: jak zamienić fakturę na czytelny dokument
W skrócie: fakturą w KSeF jest plik XML, a PDF tylko jego obrazem. Najprostsza droga z KSeF XML do PDF to pobrać fakturę od razu jako PDF z bezpłatnej Aplikacji Podatnika (do 10 faktur naraz) albo, bez logowania, przez kod QR lub wyszukiwarkę faktur. Jeśli masz już sam plik XML, Ministerstwo Finansów udostępnia otwarty generator PDF, ale pamiętaj, że plik XML nie zawiera numeru KSeF, a PDF używany poza KSeF musi mieć kod QR z tym numerem.
KSeF XML do PDF: najpierw ustal, skąd masz plik
Faktura ustrukturyzowana to plik XML zgodny ze wzorem FA(3). Programy księgowe go czytają, ale człowiek widzi w nim tylko znaczniki. Sposób na czytelny dokument zależy od tego, gdzie jest faktura:
| Sytuacja | Najprostszy sposób |
|---|---|
| Faktura jest w KSeF, masz dostęp do konta firmy | Aplikacja Podatnika: lista faktur, „Pobierz”, format PDF |
| Masz PDF lub wydruk z kodem QR | zeskanuj kod, podaj dane faktury i pobierz XML lub PDF |
| Znasz numer KSeF i dane faktury, nie masz logowania | „Wyszukaj fakturę” w Aplikacji Podatnika, bez logowania |
| Masz tylko plik XML na dysku | generator PDF Ministerstwa Finansów albo program do faktur |
| Potrzebujesz wielu faktur dla księgowej | pobieranie przez program księgowy (API), zwykle w XML |
Sposób 1: Aplikacja Podatnika, bez instalowania czegokolwiek
- Zaloguj się do Aplikacji Podatnika KSeF w kontekście NIP firmy.
- Otwórz listę faktur (sprzedażowych albo zakupowych) i ustaw filtry.
- Zaznacz od 1 do 10 faktur.
- Rozwiń przycisk „Pobierz” i wybierz format.
- Kilka faktur zapisze się jako archiwum ZIP, a nazwa każdego pliku to numer KSeF faktury.
Tak opisuje to Podręcznik użytkownika Aplikacji Podatnika KSeF 2.0 (rozdz. 5.3.2). Z ekranu szczegółów faktury także pobierzesz plik w wybranym formacie. Ministerstwo zaznacza, że bezpłatne narzędzia MF same oznaczają wizualizację kodem QR (ksef.podatki.gov.pl, „Kody weryfikujące QR”). Krok po kroku, z filtrami dat, opisujemy w artykule pobieranie faktur z KSeF.
Uwaga na opcję „Wczytaj fakturę”. Służy ona do wystawiania faktury z gotowego pliku XML, a nie do jego podglądu, więc nie używaj jej do konwersji cudzych faktur.
Sposób 2: bez logowania, przez kod QR albo wyszukiwarkę
Jeśli dostałeś fakturę w PDF lub na papierze z kodem QR, zeskanuj kod. Zobaczysz podstawowe dane faktury i informację, czy jest w KSeF. Po podaniu numeru faktury, NIP nabywcy (albo informacji o jego braku) i kwoty należności ogółem pobierzesz pełną fakturę w XML lub PDF (Podręcznik KSeF 2.0, cz. II, rozdz. 5.5). Kilka błędnych prób z rzędu czasowo blokuje pobranie tej faktury.
Bez kodu działa „Wyszukaj fakturę” na stronie logowania Aplikacji Podatnika. Podajesz numer KSeF, numer faktury, identyfikator i nazwę nabywcy oraz kwotę należności ogółem, a potem wybierasz format XML lub PDF (tamże, rozdz. 5.7; § 8 rozporządzenia w sprawie korzystania z KSeF).
Sposób 3: masz sam plik XML
Tu pomoże otwarty generator Ministerstwa Finansów: ksef-pdf-generator na GitHub, licencja MIT. To biblioteka dla programistów (TypeScript), która tworzy PDF faktury i UPO z pliku XML zgodnego z FA(1), FA(2) lub FA(3) po stronie klienta, czyli bez wysyłania pliku na cudzy serwer. Ma aplikację pokazową, którą uruchamia się lokalnie poleceniami npm install i npm run dev (wymaga Node.js). To rozwiązanie dla osoby technicznej, nie dla każdego właściciela sklepu.
Ważny szczegół, który łatwo przeoczyć: plik XML faktury nie zawiera numeru KSeF, bo system nadaje go dopiero po przyjęciu pliku. Generator MF przyjmuje numer KSeF i treść kodu QR jako osobne dane. Jeśli przerobisz XML na PDF bez nich, dostaniesz czytelny obraz, ale nie wizualizację, którą można przekazać poza KSeF.
Konwertery online: zasady bezpieczeństwa
W sieci są strony i paczki npm, które „zamieniają XML z KSeF na PDF”. Zanim wgrasz tam fakturę, pamiętaj:
- faktura zawiera dane Twoje i kontrahenta, kwoty i czasem numer rachunku. Wgrywając ją na obcy serwer, przekazujesz te dane dalej,
- wybieraj narzędzia działające lokalnie w przeglądarce albo na Twoim komputerze i sprawdź, kto za nimi stoi,
- nie edytuj i nie formatuj XML przed konwersją. Kod QR zawiera skrót SHA-256 pliku faktury, więc zmieniony plik da kod, który nie zgodzi się z fakturą w KSeF (dokumentacja API KSeF 2.0, „Kody weryfikujące QR”),
- PDF z konwertera to nadal tylko obraz. Fakturą pozostaje XML w KSeF.
Pamiętaj też, że każdy, kto ma PDF z kodem QR, może pobrać fakturę z KSeF. Kto jeszcze widzi Twoje faktury, opisujemy w artykule kto widzi faktury w KSeF.
Kiedy PDF musi mieć kod QR
Kod QR jest wymagany, gdy wizualizacja wychodzi poza KSeF: przekazujesz ją konsumentowi, firmie zagranicznej albo używasz faktury poza systemem (art. 106gb ustawy o VAT; FAQ MF, kategoria „Tryby offline i kody QR”, pyt. 7). Przy fakturze online to jeden kod z numerem KSeF pod spodem. PDF zrobiony tylko do własnego wglądu czy do archiwum takiego wymogu nie potrzebuje, bo faktura i tak jest przechowywana w KSeF przez 10 lat. Szczegóły: kod QR na fakturze KSeF i wizualizacja faktury KSeF w PDF.
Masowa konwersja dla księgowej
Biuro rachunkowe zwykle wcale nie potrzebuje PDF. Programy księgowe pobierają faktury z KSeF przez API i czytają je wprost z XML. Masowe pobieranie przez API daje wyłącznie pliki XML (FAQ MF, kategoria „Zagadnienia techniczne”, pyt. 1). Jeśli księgowa ma uprawnienie do przeglądania Twoich faktur, pobierze je sama; zobacz uprawnienia w KSeF dla księgowej. PDF przyda się raczej Tobie, do szybkiego podglądu albo dla klienta.
Po stronie sprzedaży sprawę załatwia program, który wystawia faktury. W naszej aplikacji KSeF Faktury dla Shopify PDF z kodem QR powstaje po nadaniu numeru KSeF i leży przy zamówieniu, więc nie trzeba niczego konwertować.
Najczęstsze pytania
Czy PDF wygenerowany z XML jest fakturą?
Nie. Fakturą jest XML w KSeF. PDF z kodem QR i numerem KSeF to wizualizacja, którą można posługiwać się poza systemem.
Czy mogę przerobić XML na PDF w Wordzie albo w przeglądarce?
Przeglądarka pokaże surowe znaczniki XML. Do czytelnego dokumentu potrzebujesz narzędzia, które zna strukturę FA(3), na przykład Aplikacji Podatnika albo generatora MF.
Dlaczego mój PDF z konwertera nie ma numeru KSeF?
Bo numeru KSeF nie ma w pliku XML. Konwerter musi go dostać osobno. Najprościej pobrać PDF bezpośrednio z Aplikacji Podatnika.
Czy pobranie faktury przez kod QR wymaga logowania?
Nie. Po zeskanowaniu kodu i podaniu numeru faktury, identyfikatora nabywcy i kwoty należności ogółem pobierzesz fakturę bez uwierzytelnienia.
Artykuł ma charakter ogólnej informacji i nie jest poradą podatkową.
Źródła
- Podręcznik użytkownika Aplikacji Podatnika KSeF 2.0, wersja 2.6: rozdz. 5.2.3 „Wczytaj fakturę”, 5.3.2 „Podgląd i pobieranie faktur”, anonimowe wyszukanie faktury
- Podręcznik KSeF 2.0, cz. II: rozdz. 5.5 i 5.7
- Kody weryfikujące QR, ksef.podatki.gov.pl
- Dokumentacja API KSeF 2.0, „Kody weryfikujące QR” (GitHub CIRFMF)
- ksef-pdf-generator, repozytorium Ministerstwa Finansów na GitHub
- Pytania i odpowiedzi KSeF 2.0, MF: kategoria „Tryby offline i kody QR”, pyt. 7; kategoria „Zagadnienia techniczne”, pyt. 1
- Rozporządzenie w sprawie korzystania z KSeF, Dz.U. 2025 poz. 1815: § 7-9
- Ustawa o VAT, tekst jednolity Dz.U. 2026 poz. 1263: art. 106gb
- Pliki do pobrania KSeF 2.0: struktura FA(3)
Stan prawny na 19 października 2026 r.