Jak biuro rachunkowe pobiera faktury z KSeF dla 20 klientów — bez 20 logowań i bez 20 godzin pracy

Poniedziałek, 5. dnia miesiąca. Na biurku 20 teczek z NIP-ami klientów. Na portalu KSeF: 20 sesji do otwarcia, 2000 faktur do pobrania. Kawa stygnie. W biurze rachunkowym z 20 klientami pobieranie faktur z Krajowego Systemu e-Faktur do programu księgowego to najbardziej czasochłonna i powtarzalna czynność miesiąca. Poniżej dokładna matematyka tego problemu — i konkretne rozwiązanie.

Matematyka bólu — ile naprawdę trwa ręczne pobieranie

Rozbijmy proces na kroki dla jednego klienta z ~100 fakturami kosztowymi miesięcznie:

21.5 godziny miesięcznie to prawie 3 dni robocze. Przy koszcie pracodawcy ~35 PLN/h (brutto z ZUS dla pracownika biura rachunkowego na umowie o pracę) to 752 PLN miesięcznie wydane na logowanie i klikanie. A plan Biuro kosztuje 299 PLN. Przy ręcznym eksporcie do Excela pojawia się dodatkowo 5 pułapek, które kosztują kolejne godziny.

3 modele obsługi KSeF w biurze rachunkowym

Nie każde biuro obsługuje KSeF tak samo. W praktyce istnieją 3 modele, każdy z innymi wymaganiami:

Model delegowany — biuro ma pełne uprawnienia

Klient nadaje biuru pełnomocnictwo w KSeF. Biuro wystawia faktury sprzedażowe i pobiera kosztowe w imieniu klienta. W tym modelu biuro potrzebuje certyfikatu .p12 z uprawnieniami do odczytu i wystawiania dla każdego NIPu.

Z auto-sync: biuro wgrywa 20 certyfikatów raz, harmonogram co 15 minut pobiera nowe faktury. Biuro widzi wszystko w jednym panelu, klient nie musi nic robić.

Model współdzielony — klient wystawia, biuro pobiera

Klient sam wystawia faktury sprzedażowe (w swoim programie lub ręcznie w portalu KSeF). Biuro ma uprawnienie tylko do odczytu — pobiera faktury kosztowe i sprzedażowe do zaksięgowania. To najczęstszy model w małych firmach.

Z auto-sync: identycznie — certyfikat read-only per klient. Biuro widzi nowe faktury automatycznie, bez logowania do portalu MF. Eksport CSV/Excel per klient — gotowy do importu do programu FK.

Model hybrydowy — mix zależny od klienta

W praktyce biuro z 20 klientami ma mix: 5 firm deleguje pełne uprawnienia, 10 daje read-only, a 5 ma własny system i wysyła dane manualnie. Auto-sync obsługuje pierwsze dwa warianty (15 NIPów automatycznie), a dla pozostałych 5 biuro importuje pliki ręcznie.

Nawet przy 15 z 20 NIPów w auto-sync: oszczędność to 15 × 65 min = ~16 godzin miesięcznie.

Jeden panel, 20 NIPów — jak to wygląda w praktyce

Po zalogowaniu do KSeF Import biuro widzi dashboard z listą wszystkich NIPów:

• Status synchronizacji per NIP — zielona ikona = sync OK, żółta = certyfikat wygasa, czerwona = błąd (np. cert wygasł, API niedostępne)
• Liczba nowych faktur — od ostatniego eksportu (np. "Kowalski Transport: 14 nowych kosztowych, 3 nowe sprzedażowe")
• Pasek postępu — przy pierwszym pobraniu historycznym: "pobrano 340/512 faktur (66%)"
• Następna synchronizacja — timer do następnego auto-sync (np. "za 8 minut")
• Szybki eksport — przycisk "Pobierz Excel" / "Pobierz CSV" per klient, bez wchodzenia w szczegóły

Auto-sync co 15 minut oznacza, że nowa faktura wystawiona o 9:00 jest w panelu biura najpóźniej o 9:15. Bez logowania do portalu, bez klikania, bez czekania na klienta.

Pipeline: KSeF → CSV → program księgowy

Konkretny przepływ od certyfikatu klienta do zaksięgowanej faktury w programie FK:

Krok 1: Certyfikaty 20 klientów (jednorazowo)

Każdy klient generuje plik .p12 w portalu KSeF i przesyła go biuru. Biuro wgrywa certyfikat do KSeF Import — 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 z kluczem per-tenant i zapisany na serwerze. Cały proces: ~2 minuty per klient, 20 klientów = ~40 minut jednorazowo.

Krok 2: Harmonogram synchronizacji

Dla każdego NIPu ustawiasz częstotliwość synchronizacji. Plan Biuro daje sync co 15 minut — najkrótszy dostępny interwał. System automatycznie:

• Skanuje metadane faktur w KSeF (faza discovery, pageSize 250)
• Pobiera nowe XML-e w batchach po 50 (faza download, z retry przy HTTP 429)
• Parsuje XML FA(3) na ustrukturyzowane dane (numer, daty, kwoty, kontrahenci, stawki VAT)
• Zapisuje do bazy — gotowe do eksportu

Krok 3: Eksport CSV — separator, kodowanie, kolumny per program

Każdy program księgowy ma inny format importu. KSeF Import pozwala skonfigurować eksport per klient:

• Separator: średnik (Optima, Symfonia) lub przecinek (standard)
• Kodowanie: UTF-8 z BOM (Excel) lub Windows-1250 (starsze programy FK)
• Kolumny: wybierasz, które z 22 dostępnych pól trafiają do pliku. Comarch Optima potrzebuje: numer KSeF, data wystawienia, data sprzedaży, NIP kontrahenta, nazwa, netto, stawka VAT, kwota VAT, brutto. Insert GT wymaga dodatkowo: typ dokumentu i walutę.
• Format dat: RRRR-MM-DD (standard) lub DD.MM.RRRR (Symfonia)

Konfiguracja per klient zapisuje się raz — każdy następny eksport używa tych samych ustawień. Szczegóły importu CSV do Optimy: pipeline KSeF do CSV do Optima. Informacje o brakujących polach w programach FK: 5 pól, których Twój program nie importuje.

Krok 4: Import do programu księgowego

Gotowy plik CSV/Excel importujesz do programu FK. Typowe ścieżki:

• Comarch Optima: Rejestry VAT → Import z pliku → CSV z separatorem średnikowym
• Symfonia: Ewidencja → Import dokumentów → plik CSV w kodowaniu 1250
• wFirma: Przychody/Wydatki → Import CSV → mapowanie kolumn
• Insert GT: Rejestry → Import danych → CSV z nagłówkiem

100 faktur jednego klienta: pobranie CSV (5 s) + import do FK (30 s) = 35 sekund. Porównaj z 65 minutami ręcznej pracy.

ROI: koszt planu Biuro vs koszt pracownika

Policzmy zwrot z inwestycji konkretnie:

5 016 PLN rocznie to konserwatywne liczenie. W praktyce oszczędność jest większa, bo:

• Mniej błędów — ręczne kopiowanie generuje ~2-5% pomyłek w kwotach. Każda pomyłka = czas na korektę deklaracji VAT.
• Szybsze zamknięcie miesiąca — faktury klientów są na bieżąco (sync co 15 min), nie czekasz na "dosłanie" brakujących.
• Zadowoleni klienci — szybszy feedback, mniej telefonów z pytaniem "czy dostaliście moją fakturę z 27-go?"
• Możliwość obsłużenia większej liczby klientów — 20.5 h/mc odzyskanego czasu to 2-3 dodatkowych klientów.

FAQ — najczęstsze pytania

Czy każdy klient musi dać osobny certyfikat?

Tak. Każdy NIP wymaga osobnego certyfikatu .p12 wygenerowanego w portalu KSeF. Certyfikat jest powiązany z konkretnym NIP-em i uprawnieniami (odczyt lub odczyt+zapis). Biuro nie może użyć jednego certyfikatu do 20 NIPów — to wynika z architektury KSeF, nie z ograniczeń naszego narzędzia. Wgranie 20 certyfikatów to jednorazowa czynność (~40 minut).

Co gdy klient zmieni certyfikat w trakcie miesiąca?

Stary certyfikat przestaje działać natychmiast — synchronizacja dla tego NIPu zwróci błąd. Dashboard pokaże czerwony alert. Wystarczy wgrać nowy certyfikat .p12 — system przeprowadzi walidację (plik → klucz prywatny → test połączenia z KSeF) i wznowi synchronizację. Nie tracisz żadnych faktur — przy następnym sync system pobierze wszystkie brakujące od ostatniego udanego pobrania.

Czy mogę pobrać faktury tylko jednego klienta, nie wszystkich?

Tak. Eksport CSV/Excel działa per NIP — wybierasz klienta, zakres dat i typ faktur (kosztowe, sprzedażowe, wszystkie). Możesz też eksportować zbiorczo wszystkich klientów naraz — dostaniesz osobny plik per NIP. Synchronizacja działa niezależnie od eksportu: system pobiera dane automatycznie, eksportujesz kiedy potrzebujesz.

Jak wygląda bezpieczeństwo certyfikatów 20 klientów?

Certyfikaty są szyfrowane AES-256-GCM z kluczem HKDF per-tenant (każdy klient ma osobny klucz szyfrowania). Klucze prywatne nigdy nie są przechowywane w formie jawnej — nawet administratorzy serwera nie mają dostępu do odszyfrowanych certyfikatów. Serwer stoi w Polsce (OVH Gdańsk), dane nie opuszczają UE. Każde użycie certyfikatu (logowanie do API KSeF) jest rejestrowane w audit logu dostępnym w panelu administracyjnym.