Dlaczego KSeF nie daje eksportu do PDF i jak to obejść?
Portal Ministerstwa Finansów przechowuje faktury jako dane XML, a nie dokumenty wizualne – dlatego nie istnieje przycisk „pobierz wszystkie jako PDF". Możesz to obejść legalnie: narzędzia takie jak KSeF Import łączą się z API KSeF Twoim certyfikatem, pobierają faktury i generują z nich czytelne PDF-y, pakując je w jedną paczkę ZIP. Nie piszesz kodu – konfigurujesz raz i klikasz.
- KSeF = rejestr danych XML, nie dokumentów PDF – brak masowego eksportu to celowa decyzja architektoniczna MF.
- Oryginałem faktury jest XML w KSeF; PDF to wizualizacja tych samych danych, akceptowana przez urzędy i księgowych.
- Legalny sposób: narzędzie łączące się przez oficjalne API KSeF Twoim certyfikatem generuje PDF-y i pakuje w ZIP.
- Limit API KSeF to ~60 faktur/h na NIP – dobre narzędzie respektuje go automatycznie i dociąga resztę w tle.
- 200 faktur miesięcznie ręcznie = ponad 1,5 h klikania; z automatycznym eksportem = 3–5 minut.
W tym artykule
Od problemu do efektu
PWEPortal KSeF pozwala obejrzeć fakturę i wydrukować ją do PDF przez przeglądarkę – ale tylko jedną naraz. Przy setkach dokumentów miesięcznie to godziny straconej pracy.
KSeF Import łączy się z API KSeF Twoim certyfikatem, pobiera wszystkie faktury z wybranego okresu i generuje czytelne PDF-y – bez instalacji czegokolwiek na komputerze.
Zamiast wyklikiwać każdą fakturę osobno masz gotową paczkę czytelnych PDF-ów – do archiwum, dla księgowej lub na wypadek kontroli.
Dlaczego portal KSeF nie ma opcji masowego eksportu PDF?
Krajowy System e-Faktur to rejestr danych, a nie system generowania dokumentów wizualnych. Faktury przechowywane są w formacie XML zgodnym ze schematem FA(3) – lekkie, ustrukturyzowane dane, zoptymalizowane pod maszynowe przetwarzanie, nieczytelne dla człowieka.
Pomyśl o tym jak o wyciągu bankowym: bank trzyma Twoje transakcje jako dane (kwota, data, odbiorca). Czytelny PDF w aplikacji to zasługa aplikacji – nie banku. Gdyby KSeF generował PDF dla każdej faktury każdej z milionów firm, potrzebowałby wielokrotnie więcej serwerów.
- Wydajność – XML waży kilka kB; PDF z czcionkami i układem to wielokrotnie więcej. Dla milionów firm to nieakceptowalne obciążenie.
- Limity API – KSeF ogranicza zapytania per NIP (~60 faktur/h). Generowanie PDF-ów po stronie serwera MF musiałoby ten limit jeszcze bardziej obniżyć.
- Brak jednego standardu wizualnego – każda branża ma inne oczekiwania co do wyglądu faktury. MF świadomie zostawia to narzędziom zewnętrznym.
Oryginałem jest plik XML w KSeF – to on ma moc prawną. PDF to wizualizacja tych samych danych, akceptowana przez urzędy i księgowych. Numer KSeF widoczny na PDF-ie pozwala w każdej chwili zweryfikować oryginał w rządowym systemie.
Co portal KSeF faktycznie oferuje
Portal MF nie jest bezużyteczny – ale jego możliwości kończą się dość szybko, gdy masz więcej niż kilka faktur miesięcznie.
| Co chcesz zrobić | Portal KSeF | KSeF Import |
|---|---|---|
| Podejrzeć jedną fakturę | Tak – widok czytelny | Tak |
| Pobrać jedną fakturę jako XML | Tak | Tak |
| Pobrać jedną fakturę jako PDF | Tylko opcja drukuj w przeglądarce | Tak – wygenerowany PDF |
| Pobrać 50 faktur naraz jako PDF | Nie | Tak – paczka ZIP |
| Wyeksportować wszystkie faktury zbiorczo | Tylko XML (surowe dane) | PDF, Excel, Sheets, CSV |
| Automatyczne pobieranie co X godzin | Nie | Tak – harmonogram |
Masz 10 faktur miesięcznie? Portal wystarczy. Przy 50, 100 lub 200 – to godziny powtarzalnej pracy co miesiąc, które możesz wyeliminować raz konfigurując narzędzie.
Zobacz, jak KSeF Import pobiera faktury kosztowe i układa je w gotowy arkusz.
Trzy ścieżki, by dostać PDF-y z KSeF
Skoro portal MF nie oferuje masowego eksportu PDF, masz trzy realne opcje.
| Ścieżka | Czas uruchomienia | Koszt | Dla kogo |
|---|---|---|---|
| Ręczne klikanie w portal | 0 (zaraz) | 0 zł | Firmy z kilkoma fakturami miesięcznie |
| Własne rozwiązanie programistyczne | tygodnie–miesiące | kilka–kilkanaście tys. zł + utrzymanie | Duże firmy z własnym IT |
| Gotowe narzędzie (np. KSeF Import) | 5 minut konfiguracji | od 9 zł/mies. | MŚP, biura rachunkowe, freelancerzy |
KSeF udostępnia dane przez autoryzowane API – wystarczy mieć certyfikat firmy z uprawnieniem do odczytu faktur. Narzędzie, które łączy się z KSeF Twoim certyfikatem, działa na tej samej zasadzie co portal MF.
Jak to działa w praktyce – krok po kroku
Przy wyborze gotowego narzędzia cały proces sprowadza się do kilku kroków, a sama konfiguracja zajmuje kilka minut.
-
1
Wgraj certyfikat
Jeden raz wgrywasz plik
.p12lub.pfx– ten sam, którego używasz do logowania w portalu KSeF. Certyfikat szyfrowany jest AES-256-GCM kluczem generowanym osobno per użytkownik i przechowywany na serwerach w Unii Europejskiej (OVH). -
2
System pobiera faktury w tle
Aplikacja łączy się z API KSeF, respektuje limit ~60 faktur/h per NIP i dociąga faktury z ostatnich 90 dni partiami. Możesz zamknąć przeglądarkę – pobieranie trwa po stronie serwera.
-
3
Wybierz faktury do eksportu PDF
Filtrujesz po zakresie dat, typie (kosztowe/sprzedażowe) lub kontrahencie. Możesz zaznaczyć „wszystkie" albo konkretną grupę.
-
4
Kliknij „Pobierz PDF"
System generuje czytelne PDF-y i pakuje je w jeden plik ZIP, czytelnie nazwany (numer faktury lub numer KSeF).
-
5
Pobierz gotową paczkę
Otwierasz ZIP i masz folder z PDF-ami gotowymi do archiwum, wysyłki do księgowej lub przekazania na kontrolę. Szczegółowy poradnik krok po kroku: Zbiorcze pobieranie faktur z KSeF do PDF.
API KSeF udostępnia ~60 faktur na godzinę dla jednego NIP. Przy dużej historii zostaw synchronizację na noc – rano masz pełny zakres bez ręcznego ponawiania.
Dla kogo i ile naprawdę oszczędzasz
Masowy eksport PDF przydaje się wszędzie tam, gdzie ręczne klikanie jest nieefektywne lub niemożliwe do skalowania.
- Firmy z 50+ fakturami miesięcznie – ręczne pobieranie zabiera zbyt dużo czasu.
- Biura rachunkowe – obsługujesz wielu klientów, każdy ma swoje faktury; zamiast logować się do portalu KSeF osobno dla każdego, pobierasz wszystko z jednego panelu.
- Firmy prowadzące archiwum – przepisy nakazują przechowywanie dokumentów; PDF-y na dysku lub w chmurze to najprostsza forma.
- Kontrola podatkowa – komplet PDF-ów z danego okresu dostarczasz w kilka minut, a nie w kilka godzin.
| Liczba faktur / mies. | Ręcznie (portal) | Z KSeF Import |
|---|---|---|
| 50 faktur | ~25 minut | 3–5 minut |
| 200 faktur | ~1,5 godziny | 3–5 minut |
| 500 faktur | ~4 godziny | kilkanaście minut konfiguracji |
Potrzebujesz też tabelarycznego zestawienia faktur, nie tylko PDF-ów? KSeF Import obsługuje oba scenariusze równocześnie – eksport do Excela i PDF-y z jednego narzędzia.
Najczęstsze pytania
Krótkie, konkretne odpowiedzi na pytania, które zadają użytkownicy i wyszukiwarki.
Tak. KSeF udostępnia dane przez oficjalne, szyfrowane API. Każde narzędzie, które łączy się z KSeF certyfikatem Twojej firmy, działa dokładnie tak jak portal MF. Oryginałem faktury pozostaje XML w KSeF – PDF to jego czytelna wizualizacja.
Tak. Oryginałem jest XML przechowywany w KSeF, który gwarantuje archiwizację Ministerstwo Finansów. PDF to forma wizualna tych samych danych. Numer KSeF widoczny na PDF-ie pozwala zweryfikować oryginał w systemie MF w każdej chwili – to standard akceptowany przez księgowych i urzędy skarbowe.
Nie ma limitu po stronie narzędzia. Ograniczenie dotyczy API KSeF, które udostępnia ok. 60 faktur na godzinę dla jednego NIP. Przy dużej historii narzędzie pobiera faktury partiami w tle i samo kompletuje zakres.
Certyfikat jest szyfrowany algorytmem AES-256-GCM kluczem generowanym osobno dla każdego użytkownika i przechowywany na serwerach w Unii Europejskiej (OVH). Połączenie z KSeF odbywa się przez oficjalne, szyfrowane API. Szczegóły opisuje polityka prywatności.
To możliwe, ale nawet wtedy ograniczenia portalu pozostaną: brak harmonogramów, brak filtrów zbiorczych, brak integracji z Excelem czy Sheets. Automatyczne narzędzia oferują znacznie więcej niż jednorazowy eksport.
Tak. KSeF Import obsługuje oba formaty równocześnie. Możesz mieć cykliczny eksport do Excela lub Arkuszy Google oraz na żądanie pobrać paczkę PDF-ów z dowolnego okresu – z jednego panelu.
Inżynier integracji KSeF. Odpowiada za połączenia z API Krajowego Systemu e-Faktur, automatyzacje i parsowanie struktury logicznej FA(3).