Masowe pobieranie faktur PDF z KSeF — porównanie metod: portal, API, automatyzacja

Trzy drogi do tego samego celu

Szukasz sposobu na masowe pobieranie faktur PDF z KSeF i trafiasz na trzy opcje. Każda obiecuje rozwiązanie problemu, ale diabeł tkwi w szczegółach. Zanim zdecydujesz, potrzebujesz uczciwego porównania — nie reklamy, a faktów.

Przeszedłem przez wszystkie trzy drogi (na żywym organizmie — z prawdziwymi fakturami). Oto co musisz wiedzieć, zanim zaczniesz.

Metoda 1: Portal Ministerstwa Finansów (ręcznie)

Jak to działa

Logujesz się do portalu KSeF (ksef.mf.gov.pl) certyfikatem kwalifikowanym lub profilem zaufanym. Szukasz faktury po dacie, NIP-ie kontrahenta lub numerze. Pobierasz XML. Jeśli chcesz PDF — musisz go sam wygenerować z XML-a (portal nie udostępnia PDF-ów).

Plusy

• Za darmo — opłacasz tylko certyfikat kwalifikowany, który i tak masz
• Oficjalne źródło — pewność, że dane są autentyczne
• Nie wymaga żadnych dodatkowych narzędzi

Minusy

• Jedna faktura naraz — nie ma opcji „zaznacz wszystkie i pobierz"
• XML, nie PDF — portal nie generuje wizualizacji w formacie PDF
• Wolny — logowanie trwa, wyszukiwanie trwa, pobieranie trwa
• Limity sesji — po 30 minutach bezczynności wyrzuca
• Bez automatyzacji — musisz tam wrócić za każdym razem ręcznie

Czas na 100 faktur

Przy średnio 2-3 minutach na fakturę (szukanie + pobieranie XML + ewentualna konwersja do PDF): 4-5 godzin. Bez przerw na kawę.

Metoda 2: Własne skrypty (komunikacja z KSeF po sieci)

Jak to działa

Piszesz (lub zlecasz programiście) własny program, który komunikuje się z KSeF automatycznie. Program loguje się certyfikatem, wysyła zapytania, pobiera XML-e i przetwarza je na PDF-y. Brzmi jak idealne rozwiązanie — bo masz pełną kontrolę.

Plusy

• Pełna kontrola — robisz dokładnie to, czego potrzebujesz
• Automatyzacja — raz napisane, działa samo
• Brak opłat miesięcznych — płacisz tylko za serwer

Minusy (i tu zaczynają się schody)

• Wymaga programisty — samodzielne napisanie takiego rozwiązania to tygodnie pracy
• Autentykacja certyfikatem — złożony proces kryptograficzny (podpis XAdES), łatwo o błędy
• Limity KSeF — Ministerstwo ogranicza liczbę zapytań: 20 pobrań metadanych na godzinę, 64 pobrania faktur na godzinę. Trzeba to obsłużyć
• XML → PDF — samo pobranie XML to dopiero połowa drogi. Przetworzenie na czytelny PDF wymaga zrozumienia schematu FA(3) i budowy generatora dokumentów
• Utrzymanie — Ministerstwo zmienia schemat kilka razy do roku. Każda zmiana = poprawki w kodzie
• Obsługa błędów — zerwane sesje, wygasłe certyfikaty, timeouty, zmiany w limitach — wszystko trzeba obsłużyć

Czas i koszt

• Budowa: 40-120 godzin pracy programisty (4-12 tys. PLN przy stawce 100-150 PLN/h)
• Utrzymanie: 5-10 godzin miesięcznie (poprawki, aktualizacje schematu)
• Serwer: 50-200 PLN/miesiąc

Metoda 3: Gotowe narzędzie (np. KSeF Import)

Jak to działa

Rejestrujesz się, podłączasz certyfikat KSeF, wybierasz harmonogram synchronizacji. Narzędzie automatycznie pobiera wszystkie faktury, przetwarza XML na czytelny format i udostępnia podgląd + PDF do pobrania. Pojedynczo lub zbiorczo.

Plusy

• Działa od pierwszego dnia — nie budujesz, nie czekasz, nie testujesz tygodniami
• PDF-y gotowe natychmiast — każda faktura ma czytelny podgląd i możliwość pobrania PDF
• Zbiorcze pobieranie — cały miesiąc jako paczka ZIP jednym kliknięciem
• Limity KSeF obsłużone — narzędzie samo pilnuje, żeby nie przekroczyć dozwolonych zapytań
• Aktualizacje w tle — gdy Ministerstwo zmieni schemat, Ty nie musisz nic robić
• Eksport do Excela i Google Sheets — dane z faktur trafią tam, gdzie ich potrzebujesz

Minusy

• Opłata miesięczna (od 29 PLN)
• Zależność od zewnętrznego dostawcy
• Mniejsza elastyczność niż własne rozwiązanie (ale czy naprawdę potrzebujesz niestandardowych funkcji?)

Czas na 100 faktur

Podłączenie certyfikatu: 2 minuty. Pobranie 100 faktur: automatyczne, w tle. Generowanie paczki PDF: 3-5 minut. Razem: mniej niż kwadrans, z czego 10 minut to oczekiwanie — nie Twoja praca.

Porównanie w tabeli — twarde liczby

Która metoda jest dla Ciebie?

Wybierz portal MF, jeśli:

• Masz mniej niż 10 faktur miesięcznie
• Nie potrzebujesz PDF-ów (wystarczy Ci XML)
• Masz dużo wolnego czasu i cierpliwości

Wybierz własne skrypty, jeśli:

• Masz 500+ faktur miesięcznie i bardzo specyficzne wymagania
• Masz dział IT lub stałego programistę
• Potrzebujesz niestandardowej integracji z własnym systemem ERP
• Budżet nie jest ograniczeniem (4-12 tys. PLN na start + utrzymanie)

Wybierz gotowe narzędzie, jeśli:

• Masz 20-1000 faktur miesięcznie
• Chcesz zacząć dziś, a nie za miesiąc
• Nie masz programisty i nie chcesz go zatrudniać
• Potrzebujesz PDF-ów + eksportu do Excela lub Google Sheets
• Cenisz swój czas bardziej niż 29 PLN miesięcznie

Najczęstsze obawy — i odpowiedzi

„A co z bezpieczeństwem certyfikatu?"

Słuszna obawa. W przypadku KSeF Import — certyfikat jest szyfrowany na serwerze i nigdy nie jest przechowywany w postaci otwartej. Szczegóły opisaliśmy w sekcji bezpieczeństwa. W przypadku własnych skryptów — bezpieczeństwo zależy całkowicie od Twojego programisty.

„Czy nie wystarczy mi program księgowy?"

Zależy. Jeśli Twój program ma integrację z KSeF i generuje PDF-y z pobranych faktur — tak, może wystarczyć. Ale wiele programów pobiera tylko metadane (listę faktur), a nie pełną treść. Sprawdź, czy Twój program:

• Pobiera automatycznie (bez klikania w każdą osobno)
• Generuje PDF-y z pełnymi danymi (pozycje, kwoty, adres)
• Pozwala na masowe pobieranie PDF-ów (ZIP z całym miesiącem)

Jeśli nie — potrzebujesz dodatkowego narzędzia. KSeF Import świetnie współgra z programami księgowymi — uzupełnia je o wizualizację i eksport, którego im brakuje.

„Ministerstwo nie udostępni tego za darmo w przyszłości?"

Może. KSeF jest rozwijany od 2022 roku i do dziś portal nie ma opcji masowego pobierania PDF-ów. Plany Ministerstwa nie obejmują budowy narzędzia do codziennej pracy z fakturami — KSeF ma być rejestrem, nie programem księgowym. Ale nawet jeśli kiedyś dodadzą masowy eksport PDF — pytanie brzmi: ile faktur przepuścisz ręcznie do tego czasu?

Praktyczny scenariusz — biuro rachunkowe z 15 klientami

Anna prowadzi biuro rachunkowe. Ma 15 klientów, łącznie 300 faktur kosztowych miesięcznie. Co miesiąc musi je przejrzeć, zweryfikować i zaksięgować.

• Portal MF: 300 × 3 min = 15 godzin. Prawie 2 dni robocze poświęcone na klikanie.
• Własne skrypty: Inwestycja 8 tys. PLN, potem 3 miesiące testów i poprawek. Zwrot po roku — jeśli skrypty nie się nie zepsują.
• KSeF Import (plan Biuro): 299 PLN/miesiąc. Paczki PDF-ów per klient, gotowe w 15 minut. Zaoszczędzone: 14 godzin miesięcznie = 168 godzin rocznie.

Przy stawce 100 PLN/h za pracę biura — oszczędność to 16 800 PLN rocznie vs. koszt narzędzia 3 588 PLN rocznie. Zwrot w pierwszym miesiącu.

Podsumowanie — nie buduj tego, co możesz kupić za cenę kawy

Masowe pobieranie PDF-ów z KSeF to problem, który ma rozwiązanie. Pytanie tylko, ile czasu i pieniędzy chcesz wydać, zanim zaczniesz z niego korzystać:

• Portal MF — darmowy, ale kosztuje Twoje godziny. Sensowny do 10 faktur.
• Własne skrypty — pełna kontrola, ale 4-12 tys. PLN i tygodnie budowy. Dla dużych firm z IT.
• Gotowe narzędzie — 29 PLN/msc i działa od dziś. Dla wszystkich, którzy cenią swój czas.

Zarządzasz wieloma NIP-ami? Tym bardziej warto zautomatyzować — ręczne logowanie do portalu pod każdym NIP-em osobno to podwójna strata czasu.