Comarch ERP XL – KSeF – integracja i wdrożenie to jedno z najczęściej zgłaszanych zadań serwisowych w firmach przygotowujących się do obowiązkowego fakturowania w Krajowym Systemie e-Faktur. W systemie ERP XL obsługa KSeF wymaga poprawnej konfiguracji modułu integracji, ustawienia uprawnień operatorów oraz sprawdzenia komunikacji serwera aplikacji z usługami Ministerstwa Finansów.
W praktyce serwisowej problemy pojawiają się zarówno na etapie pierwszego wdrożenia (błędna konfiguracja certyfikatu lub tokenu), jak i już po uruchomieniu – gdy faktury nie są wysyłane, wysyłka zawiesza się w kolejce lub pojawiają się odrzucenia z kodami błędów. Poniżej opisujemy typowy zakres prac diagnostycznych i wdrożeniowych związanych z integracją KSeF w ERP XL.
Zakres wdrożenia integracji KSeF w Comarch ERP XL
Wdrożenie obsługi Krajowego Systemu e-Faktur w ERP XL obejmuje kilka warstw konfiguracji: ustawienia po stronie serwera aplikacji, parametry modułu integracji z KSeF, uprawnienia operatorów do wysyłki i odbioru faktur oraz mapowanie danych kontrahentów i pozycji dokumentów na strukturę wymaganą przez schemę FA. Każdy z tych elementów może być źródłem problemów, dlatego diagnostykę prowadzi się warstwowo – od połączenia sieciowego, przez uprawnienia, po zawartość samego dokumentu.
Konfiguracja połączenia i uwierzytelnienia
Integracja z KSeF wymaga poprawnie skonfigurowanego uwierzytelnienia – tokenu lub podpisu kwalifikowanego skojarzonego z danym podmiotem. W serwisie sprawdzamy, czy dane uwierzytelniające są aktualne i przypisane do właściwego środowiska (testowego lub produkcyjnego), ponieważ pomylenie środowisk jest jedną z najczęstszych przyczyn odrzuceń przy pierwszym uruchomieniu.
- Weryfikacja adresu usługi KSeF w konfiguracji ERP XL (środowisko testowe vs produkcyjne)
- Sprawdzenie ważności tokenu lub certyfikatu używanego do autoryzacji
- Test połączenia serwera aplikacji z usługami zewnętrznymi (firewall, proxy, porty wychodzące)
- Weryfikacja uprawnień operatora do modułu wysyłki i odbioru faktur
Mapowanie danych i struktura dokumentów
Poprawna integracja wymaga, aby dokumenty sprzedaży w ERP XL zawierały wszystkie dane wymagane przez strukturę logiczną faktury ustrukturyzowanej – kompletne dane kontrahenta, prawidłowe stawki VAT, jednostki miary i kody towarowe zgodne z wymaganiami schemy. Braki w kartotekach kontrahentów lub towarów często ujawniają się dopiero na etapie wysyłki, gdy system zwraca błąd walidacji.
Diagnostyka błędów wysyłki i odbioru
Gdy integracja jest już uruchomiona, a pojawiają się błędy, w pierwszej kolejności analizujemy log komunikacji z KSeF dostępny w module integracji ERP XL – zawiera on kody odrzuceń oraz opis przyczyny (np. niezgodność struktury XML, błędny NIP, nieaktualny token). Kolejnym krokiem jest sprawdzenie kolejki wysyłkowej – dokumenty mogą zalegać w kolejce z powodu przerwanej komunikacji z serwerem KSeF lub błędnej konfiguracji harmonogramu wysyłki automatycznej.
Najczęstsze problemy zgłaszane w serwisie
- Faktury nie są wysyłane automatycznie – sprawdzenie harmonogramu zadań i usługi odpowiedzialnej za komunikację
- Odrzucenie faktury przez KSeF – analiza kodu błędu i porównanie z danymi źródłowymi dokumentu
- Brak numeru KSeF na fakturze mimo poprawnej wysyłki – weryfikacja odbioru UPO (urzędowego poświadczenia odbioru)
- Rozbieżności między środowiskiem testowym a produkcyjnym po migracji konfiguracji
Efekt wdrożenia
Po zakończeniu prac konfiguracyjnych i diagnostycznych integracja KSeF w ERP XL działa w sposób ciągły – faktury są wysyłane automatycznie zgodnie z harmonogramem, a operatorzy mają wgląd w status każdego dokumentu bezpośrednio z poziomu systemu. W przypadku firm przygotowujących się dopiero do wdrożenia rekomendujemy przeprowadzenie pełnego testu na środowisku testowym KSeF przed przełączeniem na produkcję.
