KSeF

Integracja EZD RP z KSeF: konfiguracja i odbiór faktur

Jak skonfigurować integrację EZD RP z KSeF: certyfikat, konto techniczne, uprawnienia, automatyczne pobieranie faktur i diagnostyka błędów.

Bazujemy na oficjalnych źródłach NASK / gov.pl. Linki źródłowe: na dole strony.
Ilustracja: KSeF — Integracja EZD RP z KSeF: konfiguracja i odbiór faktur

Od 23 stycznia 2026 r. EZD RP automatycznie pobiera faktury z Krajowego Systemu e-Faktur i rejestruje je w RPW. Konfiguracja wymaga certyfikatu KSeF, konta technicznego i odpowiednich uprawnień w EZD RP. Po prawidłowej konfiguracji faktury pojawiają się w EZD RP co 15 minut.

Co trzeba przygotować

  • Certyfikat KSeF — generowany w KSeF wraz z kluczem prywatnym (proces po stronie KSeF)
  • Konto techniczne KSeF — dedykowane konto do automatycznego pobierania faktur
  • Uprawnienie 'Administracja KSeF' w EZD RP — typowo dla administratora systemu
  • Dostęp internetowy z serwerów EZD RP do KSeF (wymagane otwarcie firewall)
  • Decyzja, jak traktować faktury — czy każda od razu trafia do dekretacji, czy do osobnego workflow

Krok po kroku — konfiguracja

  1. KSeF: wygenerowanie certyfikatu — w KSeF, w panelu administracyjnym, generujemy certyfikat z kluczem prywatnym. Pobieramy plik (typowo .p12) i hasło.
  2. KSeF: utworzenie konta technicznego — konto, które będzie automatycznie pobierało faktury. Nadajemy mu uprawnienia do odczytu faktur danej organizacji.
  3. EZD RP: nadanie uprawnienia 'Administracja KSeF' — administrator systemu nadaje to uprawnienie sobie lub wybranej osobie.
  4. EZD RP: konfiguracja integracji KSeF — w panelu administracyjnym wprowadzamy: NIP organizacji, certyfikat KSeF (wgrany plik), hasło certyfikatu, identyfikator konta technicznego.
  5. EZD RP: test połączenia — w panelu klikamy 'Testuj połączenie' lub uruchamiamy ręczne pobieranie. Powinniśmy zobaczyć potwierdzenie.
  6. EZD RP: aktywacja automatycznego pobierania — od tej chwili EZD RP pobiera faktury co 15 min.
Częstotliwość pobierania
Po prawidłowej konfiguracji EZD RP pobiera faktury z KSeF co 15 minut. Każda faktura jest rejestrowana automatycznie w RPW jako nowy dokument.

KSeF w wersji A i B EZD RP

EZD RP istnieje w dwóch wariantach: wersja A (oryginalna, podstawowa) i wersja B (rozszerzona o niektóre funkcje, m.in. dotyczące e-Doręczeń i obsługi specyficznych workflow). Konfiguracja KSeF jest w obu wariantach koncepcyjnie identyczna, ale interfejs i niektóre kroki mogą się różnić — sprawdzaj aktualną dokumentację dla swojej wersji.

KSeF nie pobiera faktur — diagnostyka

ObjawNajczęstsza przyczynaCo sprawdzić
Brak nowych faktur w RPWKonto techniczne nie ma uprawnieńW KSeF: czy konto techniczne ma uprawnienie do odczytu faktur danej organizacji
Błąd 401/403 w logach EZD RPWygasł certyfikat lub błędne hasłoWygenerować nowy certyfikat w KSeF, wgrać do EZD RP
Błąd timeout / networkFirewall blokuje ruch do KSeFUpewnić się, że serwery EZD RP mają dostęp do api.ksef.mf.gov.pl
Faktury są, ale w 'błędnym' obieguKonfiguracja workflow w EZD RPSprawdzić, do jakiego punktu obiegu trafiają faktury z KSeF (RPW → dekretacja vs RPW → komórka FK)
Pobiera tylko stare fakturyNiewłaściwy zakres dat w konfiguracjiSprawdzić ustawienia 'pobieranie od dnia' w panelu integracji

Kto powinien skonfigurować KSeF — kompetencje

  • Administrator EZD RP — wpisuje certyfikat, hasło, parametry techniczne
  • Osoba z dostępem do KSeF (zwykle księgowa lub osoba z uprawnieniami) — generuje certyfikat, tworzy konto techniczne
  • Sieć / IT — otwiera firewall do api.ksef.mf.gov.pl
  • Zwykle to 3 różne osoby — wymaga koordynacji

Checklista przygotowania KSeF

Przed konfiguracją sprawdź
  • Czy księgowa ma już dostęp do KSeF i potrafi generować certyfikaty
  • Czy administrator EZD RP wie, gdzie w panelu konfiguruje się KSeF
  • Czy IT otworzyło firewall do api.ksef.mf.gov.pl
  • Czy mamy procedurę reakcji, gdy faktura przyjdzie poza godzinami pracy
  • Czy wiemy, do której komórki FK powinny domyślnie trafiać faktury
  • Czy uzgodniliśmy, kto codziennie sprawdza, czy faktury się pobierają (monitoring)
Źródła oficjalne
Sprawdzone: 30 maja 2026
Pomożemy z konfiguracją KSeF w EZD RP

Pełna konfiguracja certyfikatów, kont technicznych, integracji w wersji A i B. Diagnostyka problemów z pobieraniem.

Umów konsultację
Wsparcie wdrożeniowe
Potrzebujesz wsparcia we wdrożeniu lub konfiguracji? Skontaktuj się z zespołem Lynx360 — bezpłatna pierwsza konsultacja.
Integracja EZD RP z KSeF →

Najczęstsze pytania

Czy konfigurację KSeF musi robić księgowa?

Nie — konfigurację po stronie EZD RP robi administrator systemu (z uprawnieniem 'Administracja KSeF'). Księgowa potrzebuje natomiast wygenerować certyfikat i utworzyć konto techniczne po stronie KSeF.

Co z fakturami sprzed integracji?

Faktury wystawione przed uruchomieniem integracji nie są retroaktywnie pobierane do EZD RP. Od momentu konfiguracji KSeF zaczyna pobierać tylko nowe faktury. Stare można pobrać ręcznie z KSeF, jeśli to konieczne.

Czy KSeF działa też w SaaS EZD RP?

Tak — integracja KSeF jest dostępna w obu modelach (SaaS i on-premise). W SaaS konfiguracja jest tym samym procesem, tylko serwery EZD RP są w infrastrukturze dostawcy.

Co, jeśli używamy zewnętrznego systemu FK?

Faktura z KSeF trafia do EZD RP, dalej możesz ją zsynchronizować z systemem FK przez API EZD RP (lub eksport). Wiele systemów FK ma już gotowe konektory do EZD RP.

Co z fakturami w trybie offline (np. KSeF awaryjny tryb)?

EZD RP obsługuje także faktury wystawione w trybie offline w KSeF — pojawią się w RPW po odzyskaniu połączenia z KSeF.

Czytaj dalej

Integracje
API EZD RP: integracje, Swagger, klucze i piaskownica
Przewodnik po API EZD RP dla integratorów i urzędów: dostęp do piaskownicy, Swagger, klucze API, upload-tokeny, RPW, JRWA i bezpieczeństwo.
e-Doręczenia
e-Doręczenia w EZD RP: PURDE, PUH, konfiguracja
Praktyczny przewodnik po e-Doręczeniach w EZD RP: PURDE, PUH, konfiguracja skrzynki, uprawnienia, problemy z wysyłką i odbiorem korespondencji.
Wdrożenie
Wdrożenie EZD RP krok po kroku: harmonogram, zespół, ryzyka
Kompletny przewodnik wdrożenia EZD RP w urzędzie: decyzja, audyt, model SaaS/on-premise, infrastruktura, konfiguracja, szkolenia i start produkcyjny.