Jak biuro rachunkowe pobiera faktury z KSeF dla 20 klientów do Excela i CSV?
Wgrywasz raz certyfikat .p12 per NIP klienta, ustawiasz harmonogram synchronizacji co 15 minut (plan Biuro) i od tej chwili faktury każdego klienta spływają do panelu automatycznie. Z jednego miejsca eksportujesz plik .xlsx lub CSV per klient – gotowy do importu do programu FK. Nie logujesz się do portalu MF, nie klikasz XML-ów ręcznie.
- Plan Biuro obsługuje do 20 NIP-ów z jednego panelu; sync co 15 minut, bez limitu faktur.
-
Excel (
.xlsx) i CSV dostępne od planu Firma – biuro ma oba formaty bez dopłat. - Pierwsze pobranie per NIP obejmuje ostatnie 90 dni; potem dochodzą tylko nowe faktury.
- Certyfikat każdego klienta szyfrowany AES-256-GCM, klucz generowany osobno per użytkownik, serwery w UE (OVH).
- Oszczędność: ok. 20 h ręcznej pracy miesięcznie przy 20 klientach z 100 fakturami każdy.
W tym artykule
Od problemu do efektu
PWERęczne pobieranie faktur dla każdego NIP-u z osobna – logowanie, filtrowanie, pobieranie XML-ów partiami – pochłania kilkadziesiąt godzin miesięcznie i generuje ryzyko pominięcia dokumentów.
KSeF Import łączy się z API KSeF certyfikatem klienta i automatycznie pobiera nowe faktury w tle. Biuro widzi wszystkich klientów w jednym miejscu i eksportuje plik Excel lub CSV jednym kliknięciem.
Zamiast trzech dni roboczych na pobieranie faktur masz kompletny, ustrukturyzowany plik per klient – gotowy do importu w programie FK tego samego dnia.
Ile naprawdę trwa ręczne pobieranie faktur dla 20 klientów
Rozbijmy pracę dla jednego klienta z ok. 100 fakturami kosztowymi w miesiącu. Czynności wykonywane ręcznie w portalu KSeF:
| Krok | Czynność | Czas |
|---|---|---|
| 1 | Logowanie do portalu KSeF (certyfikat lub profil zaufany) | 3 min |
| 2 | Filtrowanie listy faktur (zakres dat, typ: kosztowe) | 2 min |
| 3 | Pobieranie 100 XML-ów partiami (ok. 10 rund kliknięć) | 30 min |
| 4 | Skopiowanie danych z XML do Excela lub parsowanie | 20 min |
| 5 | Czyszczenie danych (kwoty, duplikaty, kodowanie) | 10 min |
| Razem | Per klient | ~65 min |
| 20 klientów | 20 x 65 min | ~22 h / miesiąc |
Nawet zbiorczy eksport z portalu zwraca plik XML w schemacie FA(3) – ok. 80 pól zagnieżdżonych w sekcjach, zoptymalizowanych pod maszynę, nieczytelnych dla człowieka. Do zaksięgowania i tak potrzebujesz tabeli z kwotami, datami i kontrahentami.
Jak działa automatyczny eksport – krok po kroku
Konfigurację wykonujesz raz per NIP. Potem system działa w tle, a biuro odbiera gotowe pliki.
-
1
Wgranie certyfikatu klienta
Klient generuje plik
.p12w portalu KSeF i przekazuje go biuru. Biuro wgrywa certyfikat do panelu – system przeprowadza 3-etapową walidację: sprawdza plik i hasło, wyciąga klucz prywatny, testuje połączenie z API KSeF. Certyfikat jest szyfrowany AES-256-GCM kluczem generowanym osobno per użytkownik i przechowywany na serwerach w Unii Europejskiej (OVH). Ok. 2 minuty per klient. -
2
Pierwsze pobranie historyczne
System automatycznie pobiera faktury z ostatnich 90 dni. KSeF ogranicza pojedyncze zapytanie do 3 miesięcy, więc to okno pobieramy w turach, bez udziału użytkownika. API KSeF udostępnia ok. 60 faktur na godzinę dla jednego NIP – przy dużej liczbie dokumentów zostaw pobranie na noc.
-
3
Automatyczny sync co 15 minut
Plan Biuro synchronizuje faktury co 15 minut. System wykrywa nowe dokumenty, pobiera XML-e i parsuje je do ustrukturyzowanych danych (numer KSeF, daty, kwoty, kontrahenci, stawki VAT, MPP, GTU). Duplikaty są wykluczane po numerze KSeF.
-
4
Eksport Excel lub CSV per klient
W panelu wybierasz NIP klienta, zakres dat i typ faktur (kosztowe, sprzedażowe lub wszystkie), klikasz Pobierz Excel lub Pobierz CSV. Plik
.xlsxi CSV dostępne od planu Firma. Konfigurujesz kolumny raz – kolejne eksporty używają tych samych ustawień. -
5
Import do programu FK
Gotowy plik wgrywasz do Comarch Optima, Symfonii, enova365, Insert GT lub wFirma. Typowe ścieżki: Rejestry VAT → Import z pliku. 100 faktur jednego klienta: ok. 35 sekund od pobrania pliku do zaksięgowania.
Przy pierwszym pobraniu dla wielu NIP-ów uruchom je jeden po drugim, nie wszystkich naraz – API KSeF limituje zapytania per NIP i per adres IP. System sam respektuje limity i ponawia próby, ale rozłożenie w czasie przyspiesza ogólne dociąganie historii.
Zobacz, jak KSeF Import pobiera faktury kosztowe i układa je w gotowy arkusz.
Pipeline KSeF → Excel/CSV → program FK
Konkretne pola i ustawienia eksportu zależą od programu księgowego. Oto typowe konfiguracje dla najpopularniejszych systemów FK:
| Program FK | Format | Separator | Kluczowe pola |
|---|---|---|---|
| Comarch Optima | CSV | średnik | numer KSeF, data wystawienia, data sprzedaży, NIP kontrahenta, nazwa, netto, stawka VAT, kwota VAT, brutto |
| Symfonia | CSV | średnik | jak Optima + format daty DD.MM.RRRR, kodowanie Windows-1250 |
| Insert GT | CSV / XLS | przecinek | jak Optima + typ dokumentu, waluta |
| enova365 | XLSX | – | import przez standardowy format Excel, mapowanie kolumn |
| wFirma | CSV | przecinek | przychody i wydatki z mapowaniem kolumn w kreatorze importu |
Konfiguracja per klient zapisuje się raz – każdy kolejny eksport używa tych samych ustawień. Szczegółowy przewodnik po imporcie CSV do Optimy: pipeline KSeF do CSV do Optima.
Dla faktur wystawionych w walutach obcych (EUR, USD itp.) eksport zawiera walutę oryginalną i równowartość w PLN po kursie średnim NBP z dnia poprzedzającego datę wystawienia, zgodnie ze schematem FA(3).
Bezpieczeństwo certyfikatów 20 klientów
Biuro przechowuje w systemie certyfikaty wielu klientów – architektura bezpieczeństwa jest zaprojektowana z myślą o tym scenariuszu.
- Szyfrowanie AES-256-GCM – każdy certyfikat szyfrowany kluczem generowanym osobno per użytkownik algorytmem HKDF. Klucze prywatne nigdy nie są przechowywane jawnie.
- Izolacja per konto – dane każdego użytkownika przechowywane z osobnym identyfikatorem; żaden klient biura rachunkowego nie widzi danych innego.
- Serwery w Unii Europejskiej – infrastruktura OVH; dane nie opuszczają UE.
- 3-etapowa walidacja przy uploadzie – plik + hasło → klucz prywatny → próbne połączenie z API KSeF. Certyfikat bez uprawnienia odczytu faktur (
InvoiceRead) jest odrzucany przed zapisem. - Alert przy wygaśnięciu certyfikatu – panel pokazuje ostrzeżenie, gdy certyfikat klienta zbliża się do końca ważności, a sync dla danego NIP-u zwraca błąd po wygaśnięciu.
Architektura KSeF wiąże certyfikat z konkretnym NIP-em i zakresem uprawnień (odczyt lub odczyt+wystawianie). Biuro nie może użyć jednego certyfikatu dla 20 NIP-ów – to ograniczenie systemu MF, nie narzędzia. Wgranie 20 certyfikatów to jednorazowa czynność, ok. 40 minut.
ROI: plan Biuro vs koszt ręcznej pracy
Prosty rachunek przy założeniu 20 klientów, 100 faktur każdy, kosz czasu pracownika ok. 35 zł/h brutto z ZUS:
| Pozycja | Ręcznie | Z KSeF Import |
|---|---|---|
| Czas pobierania faktur / mc | ~22 h | ~1 h (eksport + import do FK) |
| Koszt czasu pracownika / mc | ~770 zł (22 h x 35 zł/h) | ~35 zł (1 h x 35 zł/h) |
| Koszt narzędzia / mc | 0 zł | 347 zł (plan Biuro) |
| Łączny koszt / mc | ~770 zł | ~334 zł |
| Oszczędność / mc | – | ~436 zł + 21 h odzyskanego czasu |
| Oszczędność / rok | – | ~5 232 zł + 252 godziny |
Odzyskane 21 godzin miesięcznie to ok. 2–3 dodatkowych klientów, których biuro może obsłużyć bez zatrudniania kolejnej osoby. Pełne porównanie planów: cennik. Dla biur obsługujących więcej niż 20 NIP-ów możliwe jest uruchomienie kilku kont lub kontakt w sprawie indywidualnych warunków.
Najczęstsze pytania
Krótkie, konkretne odpowiedzi na pytania, które zadają użytkownicy i wyszukiwarki.
Tak. Każdy NIP wymaga osobnego certyfikatu .p12 wygenerowanego w portalu KSeF przez klienta lub biuro z odpowiednim pełnomocnictwem. Certyfikat jest powiązany z konkretnym NIP-em i zakresem uprawnien. Biuro nie moze uzyc jednego certyfikatu dla 20 NIP-ow – wynika to z architektury KSeF. Wgranie 20 certyfikatow to jednorazowa czynnosc, ok. 40 minut.
Stary certyfikat przestaje dzialac natychmiast – synchronizacja dla tego NIP-u zwroci blad i panel pokaze alert. Wystarczy wgrac nowy plik .p12 – system przeprowadzi walidacje i wznowi synchronizacje. Nie tracisz faktur: przy kolejnym sync system pobierze wszystkie brakujace od ostatniego udanego pobrania.
Tak. Excel (.xlsx) i CSV sa dostepne od planu Firma wyzej, wiec plan Biuro ma oba formaty. Solo to tylko Arkusze Google. Siedmiodniowy okres probny daje pelne limity planu Biuro (20 NIP-ow, bez limitu faktur, sync co 15 min), wiec masz Excel i CSV od pierwszego dnia.
Standardowy eksport zawiera: numer KSeF, numer faktury, datę wystawienia, datę sprzedazy, NIP i nazwę sprzedawcy, NIP i nazwę nabywcy, kwoty netto/VAT/brutto, stawki VAT, walutę i przeliczenie na PLN po kursie srednim NBP, oznaczenia MPP i GTU. Wybierasz, ktore kolumny trafiaja do pliku.
Pierwsze pobranie obejmuje ostatnie 90 dni. Czas zalezy od liczby faktur: API KSeF udostepnia ok. 60 faktur na godzine dla jednego NIP. Przy 100 fakturach to ok. 2 godziny; system pobiera w tle, nie musisz czekac przy ekranie.
Plan Biuro obejmuje do 20 NIP-ow. Przy wiekszej liczbie klientow mozna uruchomic kilka kont Biuro lub skontaktowac sie z zespolem w sprawie indywidualnych warunkow.
Doradczyni biur rachunkowych. Wspiera obsługę wielu NIP-ów w KSeF i przygotowanie danych z faktur pod programy księgowe.