Comarch ERP Altum – KSeF – integracja i wdrożenie to jedno z najczęściej zgłaszanych zadań serwisowych, odkąd Krajowy System e-Faktur stał się kluczowym elementem obiegu dokumentów sprzedażowych. Altum, jako system klasy ERP pracujący w architekturze klient-serwer na bazie SQL Server, wymaga poprawnej konfiguracji modułu integracji z KSeF na poziomie serwera aplikacji, certyfikatów oraz uprawnień w bazie danych.
W praktyce serwisowej problemy z KSeF w Altum dotyczą najczęściej błędnej konfiguracji tokenów autoryzacyjnych, nieaktualnych certyfikatów, złej konfiguracji środowiska testowego zamiast produkcyjnego oraz błędów komunikacji sieciowej między stanowiskiem a bramką KSeF. Poniżej przedstawiamy typowy zakres prac wdrożeniowych i diagnostycznych.
Na czym polega integracja Comarch ERP Altum z KSeF
Integracja z Krajowym Systemem e-Faktur w Comarch ERP Altum odbywa się poprzez dedykowany moduł komunikacji, który wysyła i odbiera faktury ustrukturyzowane w formacie zgodnym ze schemą KSeF (FA). Moduł ten korzysta z tokena lub podpisu kwalifikowanego do autoryzacji sesji, a cała komunikacja przebiega przez API Ministerstwa Finansów. W środowisku wieloodziałowym konfiguracja musi uwzględniać, które oddziały i jakie serie dokumentów mają być objęte automatyczną wysyłką.
Etapy wdrożenia integracji
- Weryfikacja wersji Comarch ERP Altum pod kątem zgodności z aktualną wersją API KSeF
- Konfiguracja danych autoryzacyjnych – token KSeF lub certyfikat kwalifikowany podpięty do konta firmy
- Ustawienie środowiska testowego (KSeF Test) w celu weryfikacji poprawności wysyłanych struktur XML przed przejściem na środowisko produkcyjne
- Mapowanie kontrahentów i danych sprzedażowych na wymagane pola schemy FA
- Konfiguracja harmonogramu automatycznej wysyłki lub trybu wysyłki ręcznej z poziomu operatora
Najczęstsze problemy zgłaszane w serwisie
Najczęściej spotykanym problemem jest odrzucenie faktury przez KSeF z powodu niezgodności danych kontrahenta (np. błędny NIP lub brak wymaganego pola adresowego). Drugim częstym przypadkiem jest wygaśnięcie tokena autoryzacyjnego, co skutkuje błędem uwierzytelnienia przy próbie połączenia z bramką. W takiej sytuacji konieczne jest wygenerowanie nowego tokena w systemie KSeF i ponowne podpięcie go w konfiguracji Altum.
Błędy komunikacji sieciowej
Ponieważ Altum pracuje w modelu klient-serwer, a wysyłka do KSeF odbywa się zwykle z poziomu serwera aplikacji, warto sprawdzić, czy serwer ma otwarty dostęp do adresów API Ministerstwa Finansów oraz czy nie blokuje go firewall lub proxy firmowe. Objawia się to zwykle timeoutem połączenia lub błędem SSL przy próbie nawiązania sesji.
Diagnostyka krok po kroku
Diagnostykę problemów z KSeF w Altum warto zacząć od sprawdzenia logów modułu integracji, dostępnych z poziomu konsoli administracyjnej systemu. Kolejnym krokiem jest weryfikacja statusu tokena oraz test połączenia z bramką testową. Jeśli błędy dotyczą konkretnych dokumentów, należy sprawdzić, czy struktura XML wygenerowana przez Altum jest zgodna z aktualnym schematem FA – rozbieżności pojawiają się zwykle po aktualizacjach wymagań KSeF.
Tryb produkcyjny a tryb testowy
Częstym błędem popełnianym przy wdrożeniu jest pozostawienie systemu w trybie testowym, co powoduje, że faktury nie trafiają do właściwego rejestru KSeF, mimo że operator widzi status „wysłano”. Przed uruchomieniem produkcyjnym należy jednoznacznie zweryfikować adres usługi w konfiguracji oraz potwierdzić autoryzację na środowisku produkcyjnym.
Podsumowanie
Prawidłowe wdrożenie integracji KSeF w Comarch ERP Altum wymaga uporządkowania danych kontrahentów, poprawnej konfiguracji certyfikatów i tokenów oraz przetestowania pełnego cyklu wysyłki na środowisku testowym przed przejściem na produkcję. Serwis obejmuje zarówno pierwsze wdrożenie, jak i diagnostykę błędów wysyłki w systemach już działających.
