Jak zbiorczo wyeksportować pliki XML z KSeF?
W panelu KSeF Import wgrywasz certyfikat dla danego NIP, wybierasz zakres (okres, faktury kosztowe lub sprzedażowe) i zlecasz zbiorczy eksport XML (nazywany też masowym lub grupowym pobieraniem plików XML). Aplikacja pobiera oryginalne pliki XML faktur prosto z Krajowego Systemu e-Faktur i pakuje je w jeden plik ZIP. Pojedynczy XML pobierzesz też wprost z listy faktur. Funkcja działa w planach Firma, Grupa i Biuro.
- Zbiorczy eksport XML pobiera oryginalne pliki źródłowe faktur z KSeF (dokładnie tak, jak zostały wystawione) i pakuje je w jeden plik ZIP.
- Wybierasz zakres: NIP, okres lub daty, faktury kosztowe albo sprzedażowe – reszta dzieje się w tle.
- XML to format wymiany danych, nie tylko do czytania: nadaje się do archiwum, audytu i zasilania systemów zewnętrznych (ERP, programy księgowe, integracje).
- Pojedynczy plik XML pobierzesz wprost z listy faktur, bez logowania do portalu MF.
- Eksport XML jest dostępny w planach Firma, Grupa i Biuro (plan Solo ma tylko Arkusze Google).
W tym artykule
Od problemu do efektu
PWEPortal KSeF udostępnia źródłowy plik XML faktury osobno dla każdego dokumentu. Przy setkach faktur miesięcznie zbudowanie kompletnego archiwum oryginałów to setki kliknięć i godziny pracy.
KSeF Import łączy się z API Twoim certyfikatem, pobiera oryginalne pliki XML z wybranego okresu i pakuje je w jeden ZIP – sam pilnuje limitów Ministerstwa Finansów i dociąga brakujące dokumenty w tle.
Zamiast wyklikiwać pliki pojedynczo masz komplet oryginalnych XML-i gotowych do długoterminowego archiwum, kontroli podatkowej i importu do systemów zewnętrznych.
Czym jest zbiorczy (masowy, grupowy) eksport XML i po co go używać
Faktura w Krajowym Systemie e-Faktur powstaje jako plik XML zgodny ze schematem FA(3) (starsze dokumenty: FA(2)). To właśnie ten plik jest oryginałem faktury ustrukturyzowanej – dokumentem, który prawnie został wystawiony i zarejestrowany przez Ministerstwo Finansów. Excel czy PDF to wygodne wyciągi danych, ale to XML jest źródłem.
Zbiorczy eksport XML pobiera te oryginalne pliki dla całego wybranego zakresu i pakuje je w jedno archiwum ZIP. Dzięki temu jednym zleceniem zbierasz to, co w portalu trzeba by pobierać fakturę po fakturze. Takie masowe, grupowe pobieranie oryginalnych plików XML zastępuje setki pojedynczych pobrań z portalu Ministerstwa Finansów.
XML jest ustrukturyzowany i czytelny dla maszyn, więc nadaje się do zasilania systemów zewnętrznych – programów księgowych, systemów ERP, integracji i hurtowni danych. Tam, gdzie program przyjmuje pliki XML faktur, oryginał z KSeF wgrasz bez przepisywania danych.
Jeśli zamiast oryginałów potrzebujesz czytelnej tabeli z kwotami i kontrahentami, użyj eksportu do innych formatów – Excela, CSV lub Arkuszy Google. XML i formaty tabelaryczne odpowiadają na różne potrzeby: oryginał kontra wygodna analiza.
Kiedy potrzebujesz oryginalnego XML, a kiedy Excela
Wybór formatu zależy od tego, co chcesz z fakturami zrobić. Poniższe zestawienie pomaga zdecydować, kiedy sięgnąć po oryginalny XML, a kiedy po wyciąg tabelaryczny.
| Potrzeba | Najlepszy format | Dlaczego |
|---|---|---|
| Długoterminowe archiwum oryginałów | XML (ZIP) | Oryginalny dokument źródłowy, niezmieniony |
| Audyt i kontrola podatkowa | XML (ZIP) | Dowód w postaci wystawionego pliku FA(3) |
| Import do programu księgowego lub ERP | XML | Maszynowo czytelny format wymiany danych |
| Analiza kosztów, tabela przestawna | Excel / CSV | Czytelna tabela: kwoty, daty, kontrahenci |
| Wgląd online dla zespołu | Arkusze Google | Wspólny dostęp, synchronizacja na żywo |
| Archiwum do czytania, wydruk | Czytelny dla człowieka, gotowy do druku |
Wiele firm korzysta z obu ścieżek równolegle: oryginalne XML-e trzyma jako archiwum, a do bieżącej pracy używa eksportu do Excela lub do CSV.
Zobacz, jak KSeF Import pobiera faktury kosztowe i układa je w gotowy arkusz.
Jak zlecić zbiorczy eksport XML – krok po kroku
Konfigurację wykonujesz raz, a samo pobieranie i pakowanie dzieje się w tle. Cała ścieżka prowadzi z tego samego panelu.
-
1
Wgraj certyfikat dla NIP
W panelu wejdź w Certyfikaty i dodaj plik
.p12lub.pfx– ten sam, którego używasz do logowania w KSeF. Certyfikat szyfrujemy AES-256-GCM kluczem generowanym osobno dla każdego użytkownika i przechowujemy na serwerach w Unii Europejskiej (OVH). -
2
Wybierz zakres eksportu
Wskaż NIP, okres lub konkretne daty oraz typ faktur: kosztowe albo sprzedażowe. Eksportujesz dokładnie te dokumenty, których potrzebujesz, bez nadmiarowych plików.
-
3
Zleć zbiorczy eksport XML
Uruchamiasz eksport jednym kliknięciem. Działa on asynchronicznie, podobnie jak masowe pobieranie PDF – możesz zamknąć przeglądarkę, bo praca trwa po stronie serwera.
-
4
Pobierz paczkę ZIP
Gdy archiwum jest gotowe, pobierasz jeden plik ZIP z oryginalnymi XML-ami całego zakresu. Brakujące faktury system dociąga w tle, respektując limity API KSeF.
Nie potrzebujesz całego archiwum? Pojedynczy plik XML pobierzesz wprost z listy faktur – jednym kliknięciem przy wybranym dokumencie, bez logowania do portalu Ministerstwa Finansów.
Co z limitami API KSeF i dużymi zakresami
API KSeF udostępnia faktury z ograniczoną przepustowością – w praktyce około 60 faktur na godzinę dla jednego NIP. To ograniczenie Ministerstwa Finansów, a nie aplikacji, i dotyczy każdego, kto pobiera dane z systemu. Zbiorczy eksport XML nie ma sztywnego limitu liczby faktur – brakujące dokumenty są po prostu dociągane w tle.
KSeF Import radzi sobie z tym za Ciebie:
- Praca asynchroniczna – eksport działa w tle, tak jak masowe pobieranie PDF; nie blokuje panelu i nie wymaga otwartej przeglądarki.
- Respektowanie limitów – zapytania do KSeF są kolejkowane tak, aby nie przekroczyć przepustowości API.
- Dociąganie brakujących faktur – jeśli któregoś oryginału jeszcze nie ma lokalnie, system pobierze go w tle, zanim trafi do paczki.
- Deduplikacja po numerze KSeF – każda faktura ma unikalny numer KSeF, więc w archiwum nie powtórzą się te same dokumenty.
Budujesz archiwum z większego zakresu? Zleć eksport i zostaw go w tle. Brakujące oryginały dociągną się partiami w granicach limitu KSeF, a Ty odbierzesz gotową paczkę ZIP, gdy będzie kompletna.
Typowe zastosowania eksportu XML
Zbiorczy eksport oryginalnych XML-i przydaje się wszędzie tam, gdzie liczy się sam dokument źródłowy, a nie jego wyciąg.
- Długoterminowe archiwum – trzymasz oryginalne pliki faktur we własnym zasobie, niezależnie od dostępności portalu MF. KSeF przechowuje faktury przez 10 lat, ale to rejestr rządowy, a nie Twoja kopia.
- Audyt i kontrola podatkowa – urząd lub audytor oczekuje wystawionych dokumentów; jednym zleceniem przygotujesz komplet oryginałów za dany okres.
- Import do systemów zewnętrznych – ERP, programy księgowe i integracje, które przyjmują pliki XML faktur, zasilisz oryginałem z KSeF bez przepisywania.
- Przekazanie do biura rachunkowego – zamiast udostępniać dostęp do KSeF, wysyłasz jeden plik ZIP z oryginalnymi fakturami za okres.
Excel, CSV i PDF to wygodne wyciągi danych z faktur, a XML to oryginalny dokument źródłowy. Jeśli zależy Ci na czytelnej tabeli do analizy, sięgnij po masowe pobieranie faktur do zestawienia; jeśli na oryginałach – po zbiorczy eksport XML.
Najczęstsze pytania
Krótkie, konkretne odpowiedzi na pytania, które zadają użytkownicy i wyszukiwarki.
Tak. Eksport pobiera oryginalne pliki XML faktur dokładnie tak, jak zostały wystawione i zarejestrowane w Krajowym Systemie e-Faktur, i pakuje je w jeden plik ZIP. To dokumenty źródłowe, a nie wyciąg danych do Excela.
To pliki XML zgodne ze schematem faktury ustrukturyzowanej Ministerstwa Finansów – najczęściej FA(3), a dla starszych dokumentów FA(2). Są ustrukturyzowane i czytelne maszynowo, więc nadają się do importu do systemów zewnętrznych.
Nie ma sztywnego limitu liczby faktur. Eksport działa asynchronicznie, a brakujące oryginały system dociąga w tle, respektując przepustowość API KSeF, która wynosi około 60 faktur na godzinę dla jednego NIP. Przy większym zakresie po prostu zostawiasz eksport w tle.
Tak. Pojedynczy plik XML pobierzesz wprost z listy faktur, jednym kliknięciem przy wybranym dokumencie. Nie musisz wtedy tworzyć całej paczki ZIP ani logować się do portalu Ministerstwa Finansów.
Eksport XML, zarówno zbiorczy, jak i pojedynczy, jest dostępny w planach Firma, Grupa i Biuro – tak samo jak eksport do Excela, CSV, PDF oraz podgląd faktury. Plan Solo obejmuje wyłącznie eksport do Arkuszy Google. Siedmiodniowy okres próbny daje pełny dostęp do limitów planu Biuro, więc masz eksport XML od pierwszego dnia.
Excel i PDF to wygodne wyciągi danych, a XML to oryginalny dokument źródłowy faktury. Oryginał przydaje się do długoterminowego archiwum, podczas kontroli podatkowej oraz przy imporcie do systemów zewnętrznych, które przyjmują pliki XML faktur.
To różne nazwy tej samej funkcji. Masowy eksport XML, grupowe pobieranie plików XML i zbiorczy eksport XML oznaczają to samo: pobranie wielu oryginalnych plików XML faktur naraz, spakowanych w jeden plik ZIP. W KSeF Import realizujesz to jednym zleceniem dla wybranego zakresu, czyli NIP, okresu i typu faktur.
Doradczyni biur rachunkowych. Wspiera obsługę wielu NIP-ów w KSeF i przygotowanie danych z faktur pod programy księgowe.