Jak automatycznie pobierać faktury z KSeF?
Automatyczne pobieranie faktur z KSeF to import dokumentów przez API Krajowego Systemu e-Faktur na podstawie certyfikatu. Wgrywasz certyfikat raz, ustawiasz harmonogram, a KSeF Import sam łączy się z API, pobiera nowe faktury kosztowe i sprzedażowe, parsuje XML w schemacie FA(3) i układa dane w wybranym miejscu – Arkuszach Google, Excelu, CSV lub zbiorczym PDF. Nie logujesz się już do portalu MF, a faktura trafia do arkusza w godzinę od jej wystawienia.
- Certyfikat KSeF wgrywasz raz – import faktur z KSeF rusza automatycznie, bez logowania do portalu przy każdym dokumencie.
- Harmonogram pobierasz pod plan: co 24 h (Solo), 6 h (Firma), 2 h (Grupa) lub 15 min (Biuro) – zadanie w tle respektuje limity API KSeF.
- Pierwsze pobranie obejmuje ostatnie 90 dni, potem dochodzą tylko nowe faktury (deduplikacja po numerze KSeF).
- Dane trafiają tam, gdzie ich potrzebujesz: Arkusze Google (każdy plan), Excel/CSV/PDF (Firma i wyżej), foldery PDF na Dysku Google (Biuro).
W tym artykule
Od problemu do efektu
PWEKSeF przechowuje faktury, ale ich nie zestawia. Musisz logować się do portalu, sprawdzać, czy doszło coś nowego, i ręcznie odczytywać XML, który jest nieczytelny dla człowieka. Przy kilkudziesięciu fakturach miesięcznie to stałe ryzyko, że coś przeoczysz.
Po jednorazowej konfiguracji KSeF Import łączy się z API Twoim certyfikatem, sam pobiera nowe faktury i parsuje je do gotowej tabeli. Ty nie robisz nic – pracę wykonuje zadanie w tle według ustawionego harmonogramu.
Faktura pojawia się w Twoim arkuszu w godzinę od wystawienia, z numerem KSeF przy każdej pozycji. Zamiast pilnować portalu, masz zawsze aktualny, kompletny rejestr gotowy do księgowania.
Czym jest automatyczne pobieranie faktur z KSeF
Krajowy System e-Faktur to centralne repozytorium faktur ustrukturyzowanych. Od 1 lutego 2026 r. najwięksi podatnicy wystawiają i odbierają faktury wyłącznie przez KSeF, a od 1 kwietnia 2026 r. obowiązek objął niemal cały rynek. System nadaje każdej fakturze unikalny numer KSeF i ją archiwizuje – ale na tym jego rola się kończy. KSeF nie tworzy zestawień, nie eksportuje do arkusza i nie powiadamia, że doszła nowa faktura.
Automatyczne pobieranie (czyli import faktur z KSeF) to proces, w którym zewnętrzna aplikacja regularnie odpytuje API systemu, ściąga nowe dokumenty i zamienia surowy XML na czytelne dane. Różnica względem pracy ręcznej jest zasadnicza:
| Aspekt | Ręcznie w portalu KSeF | Automatyczny import |
|---|---|---|
| Logowanie | Przy każdej sesji, certyfikatem lub przez ePUAP | Raz – certyfikat wgrany do panelu |
| Wykrycie nowej faktury | Sam musisz sprawdzać | Zadanie w tle pobiera ją samo |
| Format danych | XML FA(3), nieczytelny gołym okiem | Tabela: numer KSeF, kwoty, stawki, daty |
| Zestawienie miesiąca | Ręczne przepisywanie | Gotowe w arkuszu lub pliku |
| Ryzyko pominięcia | Wysokie przy wielu fakturach | Deduplikacja po numerze KSeF |
Jak działa automatyczny import – certyfikat, API, harmonogram
Konfigurację wykonujesz raz. Późniejsze pobrania są w pełni automatyczne – nie musisz nawet otwierać aplikacji.
-
1
Wgranie certyfikatu
Zakładasz konto i wgrywasz plik
.p12lub.pfxuprawniający do odczytu faktur danego NIP. Certyfikat szyfrujemy AES-256-GCM kluczem generowanym osobno dla każdego konta i przechowujemy w Unii Europejskiej (OVH). -
2
Wybór NIP i harmonogramu
Ustawiasz, jak często sprawdzać KSeF: co 24 h, 6 h, 2 h lub 15 minut, zależnie od planu. Zadanie w tle pilnuje limitów API, żeby nie przekroczyć dozwolonej liczby zapytań.
-
3
Pierwsze pobranie historyczne
Start obejmuje ostatnie 90 dni. KSeF ogranicza pojedyncze zapytanie do 3 miesięcy, więc to okno pobieramy w turach – automatycznie, a później dochodzą już tylko nowe dokumenty.
-
4
Parsowanie XML na dane
Każdą fakturę FA(3) rozbijamy na pola: numer KSeF, numer faktury, daty, NIP-y, netto, VAT, brutto, stawki, walutę, MPP i GTU. Jedna faktura staje się jednym wierszem.
-
5
Zapis do wybranego miejsca
Dane lądują w Arkuszach Google na żywo, w pliku Excel, CSV albo zbiorczym PDF. Możesz też skonfigurować kilka miejsc naraz – np. arkusz dla siebie i CSV dla biura rachunkowego.
Aplikacja nie loguje się Twoim hasłem ani profilem zaufanym. Działa na certyfikacie KSeF z konkretnym uprawnieniem do odczytu faktur (InvoiceRead), więc zakres dostępu jest wąski i pod Twoją kontrolą – w każdej chwili możesz certyfikat wycofać w KSeF.
Zobacz, jak KSeF Import pobiera faktury kosztowe i układa je w gotowy arkusz.
Gdzie trafiają pobrane faktury – Excel, Arkusze, CSV, PDF
Automatyczne pobieranie ma sens tylko wtedy, gdy dane trafiają tam, gdzie naprawdę pracujesz. KSeF Import zapisuje je w czterech formatach, a dostępność zależy od planu:
| Cel | Do czego służy | Dostępność |
|---|---|---|
| Arkusze Google | Rejestr na żywo, współdzielony z księgową | Każdy plan, w tym Solo |
| Excel (.xlsx) | Analiza, tabele przestawne, uzgodnienie JPK | Firma, Grupa, Biuro |
| CSV | Import do Optimy, Symfonii, enova, wFirma | Firma, Grupa, Biuro |
| Zbiorczy PDF | Archiwum i wizualizacja dokumentów | Firma, Grupa, Biuro |
| Foldery PDF na Dysku Google | Automatyczne archiwum per NIP i miesiąc | Tylko Biuro |
Plan Solo eksportuje wyłącznie do Arkuszy Google. Excel, CSV, zbiorczy PDF i podgląd faktury dochodzą od planu Firma, a automatyczne foldery PDF na Dysku Google są w planie Biuro. Pełne porównanie znajdziesz w cenniku.
Najczęstsze ścieżki to faktury z KSeF do Excela, eksport do Arkuszy Google na żywo oraz CSV pod program księgowy. Jeśli zależy Ci tylko na dokumentach do archiwum, sprawdź zbiorcze pobieranie faktur PDF.
Jak często pobierać i jakie są limity KSeF
Częstotliwość pobierania ustawiasz pod swój plan. Im wyższy plan, tym krótszy odstęp między synchronizacjami:
- Solo – synchronizacja co 24 godziny,
- Firma – co 6 godzin,
- Grupa – co 2 godziny,
- Biuro – co 15 minut (faktura w arkuszu niemal zaraz po wystawieniu).
API KSeF ma twarde limity zapytań na jeden NIP (rzędu kilkudziesięciu faktur na godzinę), dlatego pobierania nie da się przyspieszyć w nieskończoność. Zadanie w tle samo rozkłada ruch w czasie, ponawia próby przy chwilowych błędach serwera i pilnuje, żeby nie dostać blokady – tak właśnie działa automatyczne pobieranie faktur z KSeF według harmonogramu. To dla Ciebie niewidoczne – widzisz tylko efekt, czyli rosnący komplet faktur.
Przy starcie nadrabiamy ostatnie 90 dni, więc komplet zbiera się partiami przez kilka godzin. Przez ten czas eksport i Arkusze Google mogą być jeszcze niepełne – aplikacja pokazuje pasek postępu i wysyła e-mail, gdy pierwsze pobranie się zakończy. Zostaw je na noc i rano masz pełny zakres.
Dla kogo – od JDG po biura rachunkowe
Automatyczny import faktur z KSeF rozwiązuje inny problem na każdym etapie wielkości firmy.
Jednoosobowa działalność
Nie chcesz logować się do KSeF co kilka dni, żeby sprawdzić koszty. Ustawiasz pobieranie raz i co miesiąc wysyłasz księgowej jeden kompletny arkusz. Więcej w tekście o odbieraniu faktur bez logowania.
Małe i średnie firmy
Przy setkach faktur miesięcznie liczy się szybkość. Konfigurujesz częste pobieranie i masz dane do controllingu niemal w czasie rzeczywistym – zobacz automatyczne pobieranie co godzinę.
Biura rachunkowe
Obsługujesz wiele NIP-ów. Jeden panel pobiera faktury wszystkich klientów i generuje CSV pod program księgowy – tak jak w opisie obsługi 20 klientów z jednego panelu. Gdy masz historyczne zaległości, pomoże masowe pobieranie faktur.
Najczęstsze pytania
Krótkie, konkretne odpowiedzi na pytania, które zadają użytkownicy i wyszukiwarki.
Tak. Automatyczny import działa na certyfikacie KSeF (plik .p12 lub .pfx) z uprawnieniem do odczytu faktur dla danego NIP. To bezpieczniejsze niż udostępnianie hasła czy profilu zaufanego, bo zakres dostępu jest wąski, a certyfikat możesz w każdej chwili wycofać po stronie KSeF.
To zależy od planu: co 24 godziny w planie Solo, co 6 godzin w planie Firma, co 2 godziny w planie Grupa i co 15 minut w planie Biuro. Siedmiodniowy okres próbny daje limity planu Biuro, więc od początku testujesz pobieranie co 15 minut.
Pierwsze pobranie obejmuje ostatnie 90 dni – KSeF ogranicza pojedyncze zapytanie do trzech miesięcy, więc to okno ściągamy w turach. Później aplikacja dobiera już tylko nowe dokumenty i pomija te, które masz, dzięki deduplikacji po numerze KSeF.
Nie. Logujesz się raz, wgrywając certyfikat. Od tego momentu aplikacja łączy się z API KSeF samodzielnie, według harmonogramu, a Ty nie otwierasz już portalu Ministerstwa Finansów.
Do Arkuszy Google (każdy plan), a także do Excela, CSV i zbiorczego PDF w planie Firma i wyższych. W planie Biuro dochodzą automatyczne foldery PDF na Dysku Google. Możesz skonfigurować kilka miejsc docelowych jednocześnie.
Zadanie w tle ponawia próby i kontynuuje pobieranie w kolejnym cyklu, zamiast przerywać pracę. Przejściowe błędy serwera KSeF czy chwilowe przekroczenie limitu zapytań nie powodują utraty faktur – po prostu dochodzą one przy następnej synchronizacji.
Inżynier integracji KSeF. Odpowiada za połączenia z API Krajowego Systemu e-Faktur, automatyzacje i parsowanie struktury logicznej FA(3).