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ć.

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


