KSeF i integracja ERP: Łączenie polskich firm z krajowym systemem
Docavelo świętuje 2 lata: jeden system dla ponad 500 firm. Zarejestruj się i wypróbuj za darmo przez 14 dni

KSeF i integracja ERP: Łączenie polskich firm z krajowym systemem

Integracja Twojego ERP z polskim systemem KSeF wymaga łączności API, obsługi trybu offline i rygorystycznej walidacji danych: oto co musisz wiedzieć.

10 marca 2026 Docavelo Team 6 min
KSeF i integracja ERP: Łączenie polskich firm z krajowym systemem

Wyzwanie integracji: Łączenie ERP z KSeF

Dla większości polskich firm największym wyzwaniem obowiązkowej zgodności z KSeF nie jest zrozumienie prawa: jest to połączenie istniejącego oprogramowania ERP i księgowego z krajowym systemem e-fakturowania. Integracja systemów jest konsekwentnie wymieniana jako glówny problem przez firmy przygotowujące się do terminu 1 kwietnia 2026.

Ministerstwo Finansów opublikowało szczególowe specyfikacje API, a cztery nowe rozporządzenia obejmują wymagania techniczne: specyfikacje formatu faktur, protokoly integracji API, procedury trybu offline i reguły walidacji.

API KSeF: Wymagania techniczne

Aby połączyć się z KSeF, Twój system musi obsługiwać:

  • Generowanie ustrukturyzowanych faktur XML zgodnych z oficjalnym schematem KSeF
  • Uwierzytelnianie API z użyciem kwalifikowanych pieczęci elektronicznych lub profili zaufanych
  • Przesyłanie i pobieranie faktur w czasie rzeczywistym przez punkty końcowe KSeF
  • Obsługę unikalnych numerów identyfikacyjnych: kazda faktura otrzymuje numer referencyjny KSeF po akceptacji
  • Śledzenie statusu: monitorowanie, czy faktury sa wystawione, przesłane lub zatwierdzone

Tryb offline: Obsluga awarii KSeF

Jednym z najbardziej złożonych aspektów integracji z KSeF jest tryb offline. Gdy platforma KSeF doswiadcza przestojów lub połączenie internetowe zawodzi, firmy muszą nadal moc wystawiać faktury. Przepisy określają:

  • Faktury wystawione podczas przestoju muszą być oznaczone specjalnym wskaźnikiem offline
  • Faktury te muszą być przesłane do KSeF w określonym oknie po przywróceniu łączności
  • Twój system ERP musi utrzymywać lokalna kolejkę oczekujących przesyłek
  • Prawidlowa kolejność i numeracja muszą być zachowane w okresach offline i online

Walidacja danych: Dlaczego faktury sa odrzucane

Bledne lub niekompletne dane VAT to najczęstszy powód odrzucania faktur przez KSeF. Przed przesłaniem upewnij się, ze Twój system waliduje:

  • Poprawny NIP (numer identyfikacji podatkowej) zarówno sprzedawcy, jak i nabywcy
  • Prawidlowa kategoryzacje i obliczanie stawek VAT
  • Wymagane pola zgodne ze schematem XML KSeF (daty, kwoty, opisy)
  • Kodowanie znaków i obsługę znaków specjalnych w polskich polach tekstowych