Jak zintegrować system ERP z KSeF i przygotować firmę do obsługi faktur ustrukturyzowanych?

Podłączenie systemu ERP do KSeF nie kończy się na uruchomieniu wysyłki faktur. Najwięcej problemów pojawia się później: przy odrzuconych dokumentach, nieprawidłowych danych kontrahentów, brakujących numerach KSeF i fakturach zakupowych, które trafiają do systemu, ale nie do właściwego działu. Integracja ERP z KSeF musi więc obejmować nie tylko komunikację z administracją skarbową, lecz także sposób wystawiania, odbierania, zatwierdzania i księgowania dokumentów. Od 1 kwietnia 2026 roku obowiązek wystawiania faktur ustrukturyzowanych dotyczy zasadniczo większości przedsiębiorców, z przejściowym wyjątkiem dla najmniejszych podatników. Dobrze skonfigurowane oprogramowanie ogranicza ręczną pracę, jednak źle zaprojektowany obieg dokumentów potrafi sparaliżować nawet sprawnie działający dział księgowości.

Jak połączyć ERP z KSeF i wybrać odpowiedni sposób integracji?

Krajowy System e-Faktur (KSeF) komunikuje się z oprogramowaniem przedsiębiorstw przez API KSeF 2.0. ERP przygotowuje fakturę jako plik XML zgodny ze strukturą FA(3), przesyła go do systemu Ministerstwa Finansów, a następnie odbiera informacje o wyniku przetwarzania. Po przyjęciu dokumentu KSeF nadaje mu unikalny numer identyfikacyjny. System ERP powinien zapisać ten numer, status faktury oraz urzędowe poświadczenie odbioru (UPO).

Nie wystarczy zatem, że program potrafi wygenerować XML. Musi jeszcze obsługiwać uwierzytelnianie, uprawnienia użytkowników, odpowiedzi API i ponawianie transmisji po błędach.

Przedsiębiorstwa mają trzy podstawowe możliwości integracji:

• Natywny moduł ERP – funkcja dostarczana przez producenta oprogramowania, np. w odpowiednio przygotowanych wersjach Comarch ERP Optima, Comarch ERP XL czy enova365. Najrozsądniejszy wybór, gdy firma korzysta z aktualnego systemu i nie potrzebuje nietypowego obiegu faktur.
• Zewnętrzny konektor lub platforma integracyjna – pośredniczy między ERP a KSeF. Sprawdza się, gdy przedsiębiorstwo ma kilka systemów sprzedażowych, oddzielny magazyn lub rozbudowane procedury akceptacji dokumentów.
• Dedykowana integracja API – rozwiązanie programistyczne przygotowane dla konkretnej organizacji. Ma sens przy starszym ERP bez odpowiedniego modułu, własnych aplikacjach sprzedażowych albo szczególnych wymaganiach dotyczących przepływu danych. Oznacza jednak konieczność samodzielnego utrzymywania zgodności z kolejnymi zmianami API.

Przykładowo hurtownia wystawiająca 1500 faktur miesięcznie w Comarch ERP XL zwykle nie potrzebuje osobnego systemu do samej komunikacji z KSeF, jeżeli posiadany moduł obsługuje wymagane dokumenty i automatyczną wysyłkę. Inaczej wygląda sytuacja producenta korzystającego równocześnie z ERP, sklepu B2B i własnego systemu obsługi zamówień. W takim przedsiębiorstwie warstwa integracyjna może ujednolicić dane z kilku źródeł, zanim dokument zostanie przesłany do KSeF.

Najważniejsze kryterium wyboru to nie liczba faktur, lecz liczba systemów i wyjątków w procesie ich wystawiania. Firma generująca 10 tysięcy prostych faktur miesięcznie może działać sprawniej na standardowym module niż przedsiębiorstwo wystawiające 300 dokumentów z rozliczeniami zaliczek, korektami i nietypowymi warunkami sprzedaży.

Przed zakupem integracji trzeba sprawdzić pięć parametrów:

• Obsługę aktualnego API KSeF 2.0 i struktury FA(3).
• Automatyczne pobieranie numerów KSeF, UPO i informacji o odrzuceniu dokumentu.
• Obsługę uprawnień, certyfikatów oraz bezpiecznego przechowywania danych uwierzytelniających.
• Mechanizm kolejkowania, ponawiania wysyłki i zabezpieczenie przed niekontrolowanym ponownym przesyłaniem faktur.
• Możliwość pobierania faktur zakupowych i przekazywania ich do właściwego rejestru lub procesu akceptacji.

Szczególnie kosztownym błędem jest traktowanie braku odpowiedzi API jako dowodu, że faktura nie została wysłana. Po przerwaniu połączenia dokument mógł już trafić do KSeF. Zanim integracja ponowi transmisję, powinna sprawdzić wynik wcześniejszej operacji.

Istotna jest też cena. Korzystanie z państwowego KSeF i jego API jest bezpłatne, ale producent ERP lub dostawca integracji może pobierać opłaty za moduł, licencję, pakiet komunikacyjny, wdrożenie i serwis. Przed podpisaniem umowy należy otrzymać wycenę obejmującą nie tylko uruchomienie, ale również obsługę dokumentów, aktualizacje i usuwanie awarii. Sama obecność przycisku „Wyślij do KSeF” nie przesądza o zakresie wykupionej usługi.

Przygotowanie danych, uprawnień i obiegu faktur przed uruchomieniem KSeF

Najpierw trzeba uporządkować dane źródłowe. KSeF nie poprawia automatycznie błędów w kartotekach ERP i nie zastępuje kontroli księgowej. Faktura może zostać poprawnie przyjęta pod względem technicznym, choć zawiera nieprawidłowy opis usługi, błędne rozliczenie albo niewłaściwie wskazanego odbiorcę.

Dobrym punktem wyjścia jest audyt 30–50 rzeczywistych dokumentów reprezentujących różne przypadki sprzedaży. Należy uwzględnić zwykłe faktury krajowe, faktury zaliczkowe, końcowe, korekty, dokumenty walutowe i transakcje zagraniczne, jeśli występują w firmie.

Kontrola powinna objąć przede wszystkim:

• Kartoteki kontrahentów – NIP, dane identyfikacyjne, rolę nabywcy i odbiorcy oraz powiązanie faktury z zamówieniem.
• Stawki i procedury VAT – prawidłowe oznaczenia, zwolnienia, transakcje unijne i rozliczenia szczególne.
• Mapowanie danych FA(3) – przypisanie pól ERP do właściwych elementów struktury XML, także dla korekt i zaliczek.
• Uprawnienia w KSeF – rozdzielenie prawa do wystawiania dokumentów, ich przeglądania oraz zarządzania dostępami.
• Obieg zakupów – ustalenie, kto weryfikuje fakturę, identyfikuje zamówienie, potwierdza dostawę i zatwierdza płatność.

Przykład z praktyki: przedsiębiorstwo handlowe odbiera miesięcznie 800 faktur kosztowych. Część dotyczy zakupów magazynowych, część transportu, a pozostałe usług administracyjnych. Jeżeli ERP tylko pobiera je z KSeF do jednej kolejki, księgowość nadal musi ręcznie ustalać, kto odpowiada za każdy wydatek.

Lepsze rozwiązanie polega na automatycznym dopasowywaniu dokumentów do numerów zamówień, kontrahentów i danych dostawy. Faktura zgodna z zamówieniem może przejść uproszczoną ścieżkę akceptacji, a dokument z rozbieżnością ceny, ilości lub odbiorcy powinien trafić do wyjaśnienia. Automatyczne księgowanie wszystkich pobranych faktur bez takiej kontroli jest ryzykowne – faktura wystawiona na NIP przedsiębiorstwa nie dowodzi jeszcze, że zakup został zamówiony i zaakceptowany.

Osobnego przygotowania wymaga uwierzytelnianie. Certyfikat KSeF typu 1 służy do uwierzytelniania w systemie, natomiast certyfikat typu 2 jest wykorzystywany do potwierdzania tożsamości wystawcy faktur w trybach szczególnych offline. Certyfikaty są ważne maksymalnie przez dwa lata. Firma powinna prowadzić ewidencję ich ważności, przypisać odpowiedzialność za odnowienie i zabezpieczyć klucze prywatne przed nieuprawnionym dostępem.

Nie należy nadawać każdemu pracownikowi uprawnień administracyjnych tylko po to, aby mógł wysłać fakturę. W większej organizacji operator sprzedaży powinien wystawiać dokumenty, księgowość je weryfikować, a uprawnienia nadawać wyznaczony administrator. Dzięki temu odejście pracownika nie wymusza chaotycznej przebudowy dostępu do całego systemu.

Warto też uwzględnić obowiązujące terminy:

• 1 lutego 2026 r. – obowiązek wystawiania faktur dla podatników, których sprzedaż brutto w 2024 roku przekroczyła 200 mln zł, oraz początek obowiązkowego odbierania faktur w KSeF w podstawowym zakresie.
• 1 kwietnia 2026 r. – obowiązek wystawiania faktur dla pozostałych przedsiębiorców, z przewidzianymi ustawowo wyjątkami.
• Do 31 grudnia 2026 r. – przejściowa możliwość wystawiania faktur poza KSeF dla najmniejszych podatników, których miesięczna sprzedaż dokumentowana odpowiednimi fakturami nie przekracza 10 tys. zł brutto. Przekroczenie limitu powoduje powstanie obowiązku od faktury, którą limit przekroczono.
• 1 stycznia 2027 r. – zakończenie tego ułatwienia oraz rozpoczęcie stosowania sankcji pieniężnych przewidzianych za naruszenia obowiązków wystawiania faktur w KSeF.

Odroczenie kar w 2026 roku nie oznacza odroczenia samego obowiązku.

Testowanie integracji ERP z KSeF i zabezpieczenie firmy przed awariami

Najbardziej miarodajny test nie polega na wysłaniu jednej poprawnej faktury. Trzeba przeprowadzić cały cykl: utworzenie dokumentu w ERP, wygenerowanie XML, przesłanie do KSeF, odbiór statusu, zapis numeru KSeF i UPO, a następnie sprawdzenie zgodności zapisów w księgowości. Osobno należy przetestować faktury zakupowe oraz przypadki błędów.

W praktyce dobrym rozwiązaniem jest przygotowanie scenariuszy testowych, w których integracja musi:

1. Wysłać poprawną fakturę i zapisać jej identyfikator KSeF.
2. Obsłużyć odrzucenie pliku z błędną strukturą lub niepoprawnymi danymi.
3. Rozpoznać brak odpowiedzi serwera bez automatycznego tworzenia kolejnego dokumentu.
4. Pobrać fakturę zakupową i powiązać ją z właściwym kontrahentem.
5. Obsłużyć fakturę korygującą oraz wymagane powiązania z dokumentem pierwotnym.
6. Wznowić przetwarzanie kolejki po czasowej niedostępności połączenia.

Dla firmy realizującej sprzedaż przez całą dobę ważny jest tryb offline24. Pozwala on wystawić fakturę elektroniczną zgodną z FA(3) bez natychmiastowego przesłania do KSeF. Co do zasady dokument należy dosłać najpóźniej następnego dnia roboczego po wystawieniu. W przypadku oficjalnie ogłoszonej awarii KSeF stosuje się odrębne terminy, a sposób udostępniania dokumentów poza systemem podlega dodatkowym wymaganiom dotyczącym kodów QR.

Wyobraźmy sobie hurtownię, która wystawia fakturę w piątek wieczorem, kiedy połączenie z systemem jest niedostępne. Poprawnie skonfigurowany ERP powinien zachować dokument w kolejce offline, oznaczyć jego status, umożliwić wymagane przepisami udostępnienie nabywcy, a następnie przesłać go do KSeF w obowiązującym terminie. Jeśli połączenie wróci dopiero w poniedziałek, operator musi widzieć, które dokumenty oczekują na wysyłkę. Sam zapis XML na dysku nie wystarcza.

Przy rozbudowanych wdrożeniach znaczenie ma doświadczenie dostawcy w konkretnym środowisku ERP. Przykładem jest acomit.pl, marka ACOMIT zajmująca się wdrożeniami Comarch ERP i enova365. W ofercie ma m.in. rozwiązanie ACOMIT e-KSeF XL, rozszerzające Comarch ERP XL o automatyczne wysyłanie odpowiednio oznaczonych faktur, pobieranie UPO i raportowanie statusów. Takie narzędzie ma sens w firmie, której podstawowym problemem jest ręczne uruchamianie wysyłki oraz kontrolowanie jej rezultatów. Nie zastąpi jednak całego procesu akceptacji zakupów ani nie naprawi błędów w kartotekach kontrahentów.

Przed zakupem podobnego rozszerzenia należy sprawdzić kompatybilność z posiadaną wersją ERP, wymagane licencje i dodatkowe komponenty. W przypadku ACOMIT e-KSeF XL wskazane są m.in. wspierana wersja Comarch ERP XL, odpowiednie licencje modułów oraz ACOMIT Workflow. Pominięcie tych wymagań w kalkulacji oznacza ryzyko dodatkowych kosztów.

Istotne jest także określenie odpowiedzialności serwisowej. Gdy dokument nie trafia do KSeF, przyczyną może być błąd ERP, konektora, konfiguracji uprawnień albo niedostępność usługi państwowej. Umowa z dostawcą powinna jasno wskazywać, kto diagnozuje każdy z tych przypadków i jak odbywa się eskalacja zgłoszenia.

Za ukończoną integrację należy uznać dopiero taką, która poprawnie obsługuje również sytuacje nieudane, a nie tylko standardową wysyłkę.

FAQ – najczęstsze pytania o integrację ERP z KSeF

Czy każda firma musi kupić nowy system ERP do obsługi KSeF?
Nie. Jeżeli obecny ERP ma aktualny i zgodny z KSeF moduł, zazwyczaj wystarczy jego aktualizacja, konfiguracja oraz uruchomienie odpowiednich uprawnień. Wymiana całego systemu ma sens dopiero wtedy, gdy producent nie zapewnia wymaganej integracji lub oprogramowanie nie obsługuje potrzebnych procesów.

Czy integracja ERP z KSeF jest płatna?
Państwowy system KSeF i dostęp do jego API są bezpłatne. Koszty mogą dotyczyć licencji ERP, modułów dodatkowych, prac wdrożeniowych, usług integracyjnych i utrzymania. Trzeba sprawdzić również opłaty uzależnione od liczby przetwarzanych dokumentów.

Czy można wystawiać faktury, gdy KSeF nie działa?
Tak, w przewidzianych przepisami trybach szczególnych, m.in. offline24. Wymagane są jednak prawidłowy format dokumentu, właściwe oznaczenia oraz dotrzymanie terminu późniejszego przesłania faktury, jeżeli przepisy tego wymagają.

Czy faktury zakupowe automatycznie trafią do księgowości?
Nie zawsze. KSeF umożliwia ich odbieranie, natomiast automatyczny import, przypisanie kont księgowych, dopasowanie do zamówień i ścieżka zatwierdzania zależą od możliwości oraz konfiguracji ERP.

Jak długo KSeF przechowuje faktury?
Przez 10 lat, licząc od końca roku, w którym faktura została wystawiona. Nie oznacza to jednak, że KSeF zastępuje archiwizację wszystkich dokumentów towarzyszących transakcji, takich jak umowy, zamówienia czy protokoły odbioru.

Od czego zacząć integrację ERP z KSeF?
Od sprawdzenia wersji posiadanego ERP i wykonania testu pełnego obiegu jednej rzeczywistej faktury: od jej wystawienia po zapis numeru KSeF i UPO. Następnie trzeba zweryfikować pobieranie faktur zakupowych oraz zachowanie systemu przy błędzie transmisji. Jeżeli ERP nie rozróżnia dokumentu oczekującego na wysyłkę, odrzuconego i przyjętego przez KSeF, ten problem należy usunąć w pierwszej kolejności. Bez prawidłowej obsługi statusów dalsza automatyzacja zwiększy ryzyko błędów zamiast je ograniczyć.