Odbieranie faktur z KSeF bez logowania — jak to zautomatyzować?

Jednym z największych utrapień związanych z KSeF jest konieczność regularnego logowania się do systemu, żeby sprawdzić, czy pojawiły się nowe faktury zakupowe. Wielu przedsiębiorców szuka sposobu na automatyczne odbieranie faktur z KSeF — bez codziennego otwierania portalu i ręcznego przeglądania listy dokumentów.

Dobra wiadomość: Ministerstwo Finansów przewidziało ten scenariusz. KSeF ma oficjalne API z autoryzacją przez certyfikat — nie trzeba „obchodzić systemu" ani używać skryptów web-scrapingowych. Wystarczy wygenerować raz certyfikat autoryzacyjny i podpiąć go do aplikacji takiej jak KSeF Import.

Dlaczego logowanie do KSeF jest problematyczne?

Portal KSeF wymaga uwierzytelnienia za każdym razem. W zależności od metody, może to oznaczać:

• Profil Zaufany — kilka przekierowań, wpisanie hasła, czasem kod SMS
• e-Dowód — podłączenie czytnika NFC lub użycie telefonu
• Certyfikat kwalifikowany — karta kryptograficzna lub token USB

Każde logowanie trwa od 30 sekund do kilku minut. Gdy robisz to codziennie lub kilka razy w tygodniu, tracisz realny czas pracy. A co gorsza — jeśli zapomnisz się zalogować, możesz przeoczyć ważną fakturę.

Certyfikat autoryzacyjny — klucz do automatyzacji

KSeF oferuje specjalny rodzaj certyfikatu, tzw. certyfikat autoryzacyjny (plik .p12), który umożliwia dostęp do API KSeF bez interakcji użytkownika. To legalna i oficjalna metoda autoryzacji, przeznaczona właśnie do automatycznego pobierania faktur.

Certyfikat autoryzacyjny uzyskasz na portalu KSeF. Po wygenerowaniu, plik .p12 można podłączyć do dowolnego systemu, który obsługuje API KSeF — na przykład do KSeF Import.

Jak działa automatyczne odbieranie w KSeF Import?

1. Wgrywasz certyfikat .p12 do KSeF Import. Plik jest szyfrowany algorytmem AES-256-GCM z unikalnym kluczem — nikt oprócz systemu nie ma do niego dostępu.
2. Ustawiasz harmonogram — np. synchronizacja co 6 godzin. System automatycznie łączy się z KSeF, otwiera sesję, pobiera nowe faktury i zamyka sesję.
3. Faktury trafiają do Twojego arkusza — Google Sheets, Excel lub CSV. Nie musisz logować się do niczego — dane czekają na Ciebie w arkuszu.

Cały proces odbywa się w tle, 24 godziny na dobę, 7 dni w tygodniu. Możesz sprawdzać faktury kiedy chcesz — ale nie musisz pamiętać, żeby to robić.

Bezpieczeństwo automatycznego dostępu

Automatyzacja nie oznacza rezygnacji z bezpieczeństwa. KSeF Import stosuje kilka warstw ochrony:

• Szyfrowanie certyfikatu — certyfikat jest szyfrowany per-tenant, klucz nigdy nie jest logowany ani przesyłany
• Sesje jednorazowe — każda synchronizacja otwiera nową sesję KSeF i zamyka ją po pobraniu danych
• Audit log — każda operacja (upload, sync, delete) jest zapisywana w dzienniku audytu
• Powiadomienia — dostajesz email o wynikach synchronizacji i o zbliżającym się wygaśnięciu certyfikatu

Koniec z codziennym logowaniem

Automatyczne odbieranie faktur to nie luksus — to oszczędność czasu i eliminacja ryzyka przeoczenia dokumentów. Jednorazowa konfiguracja w KSeF Import zastępuje setki logowań w ciągu roku.

Jak wygenerować certyfikat autoryzacyjny KSeF — krok po kroku

Procedura generowania certyfikatu w portalu KSeF (jednorazowo, potrzebujesz Profilu Zaufanego lub podpisu kwalifikowanego):

1. Zaloguj się do portalu KSeF (ksef.mf.gov.pl) jako właściciel lub osoba z uprawnieniem „Administrator".
2. Przejdź do „Certyfikaty" → „Generuj nowy certyfikat". Wybierz typ: „Certyfikat autoryzacyjny do integracji" (nie mylić z certyfikatem do logowania).
3. Podaj opis (np. „KSeF Import — certyfikat dla ANTENA Sp. z o.o.") i wybierz zakres uprawnień. Dla odbierania faktur wystarczy uprawnienie Przeglądanie faktur (najniższy przywilej).
4. Pobierz wygenerowany plik .p12 i hasło. UWAGA: plik można pobrać tylko raz. Jeśli go zgubisz, musisz wygenerować nowy.
5. Wgraj .p12 do KSeF Import w panelu → Certyfikaty → Dodaj nowy. Aplikacja sprawdzi ważność, wyciągnie NIP z CN i zapisze zaszyfrowaną kopię.
6. Wybierz harmonogram w sekcji „Synchronizacja" (24h / 6h / 2h / 15 min). Pierwszy sync uruchamia się automatycznie w ciągu 5 minut.

Certyfikat autoryzacyjny ma 24 miesiące ważności. 30 dni przed wygaśnięciem KSeF Import wyśle Ci 3 maile ostrzegawcze, żebyś zdążył wygenerować nowy.

FAQ — najczęstsze pytania

Czy to jest zgodne z regulacjami MF?

Tak — Ministerstwo Finansów udostępnia API KSeF z autoryzacją przez certyfikaty właśnie po to, żeby umożliwić integrację z systemami zewnętrznymi. Certyfikat autoryzacyjny to oficjalny mechanizm wprowadzony w specyfikacji. Używanie go przez aplikację jak KSeF Import to standardowe rozwiązanie, stosowane również przez duże systemy ERP (Comarch, Symfonia, SAP).

Czy muszę pobierać faktury o konkretnej godzinie?

Nie — KSeF nie ma „godziny dostarczenia" faktur. Sprzedawca wystawia fakturę w KSeF, która natychmiast jest widoczna dla nabywcy. Harmonogram synchronizacji w KSeF Import określa tylko, jak często aplikacja ma sprawdzać nowe faktury. Przy 15-minutowym sync nowe faktury widzisz w arkuszu w ciągu 15 minut od ich wystawienia.

Co się stanie, jeśli KSeF będzie chwilowo niedostępny?

KSeF Import retry'uje zapytanie z exponential backoff (1s, 2s, 4s, 8s...). Jeśli po 3 próbach nadal błąd 5xx albo 429 (rate limit), aplikacja odkłada synchronizację do następnego cyklu i wysyła Ci email z informacją. Brak faktur nie przepadnie — zostaną pobrane przy następnej udanej synchronizacji.

Co jeśli uwierzytelnienie dwuskładnikowe (2FA) jest wymagane w naszej organizacji?

2FA w KSeF dotyczy logowania interaktywnego do portalu. Certyfikat autoryzacyjny to osobny kanał autoryzacji — nie wymaga 2FA, bo sam jest silnym sekretem kryptograficznym. Zabezpieczenie leży po Twojej stronie (chronić plik .p12 i hasło) oraz po stronie aplikacji (KSeF Import szyfruje go AES-256-GCM).

Czy aplikacja odbiera też faktury sprzedażowe?

Tak — certyfikat autoryzacyjny umożliwia zarówno odczyt faktur otrzymanych (kosztowych), jak i wystawionych (sprzedażowych). W panelu widzisz oba typy w osobnych zakładkach albo w jednym arkuszu z kolumną „Typ" (Kosztowa / Sprzedażowa).

Jak wyłączyć synchronizację tymczasowo?

W panelu „Harmonogram" kliknij „Wstrzymaj". Synchronizacja nie uruchomi się w kolejnym cyklu. Wznawiasz tym samym przyciskiem — następny sync za ~15 min. Dla planu Biuro możesz wstrzymać sync per NIP (przydatne, gdy klient biura zmienia certyfikat).