Podczas synchronizacji kontrahenta do Comarch ERP XL xSale nie opiera się wyłącznie na polu Kod widocznym na karcie kontrahenta. System korzysta także z technicznego powiązania z kontrahentem po stronie ERP, dzięki czemu łatwiej rozpoznać istniejącą kartę i ograniczyć ryzyko tworzenia duplikatów.
W tym artykule znajdziesz
- jak xSale rozpoznaje kontrahenta przy wysyłce do Comarch ERP XL,
- jak działa techniczne powiązanie kontrahenta z ERP,
- kiedy xSale tworzy nowy kod kontrahenta,
- co dzieje się po zmianie kodu kontrahenta w xSale,
- jak działa kolejność wyszukiwania kontrahenta,
- jakie dodatkowe ustawienia można włączyć w WebService XL.
Jak xSale rozpoznaje kontrahenta
Podczas wysyłki kontrahenta do Comarch ERP XL xSale sprawdza, czy taki kontrahent jest już dostępny w ERP. Do identyfikacji mogą być używane:
- kod kontrahenta,
- NIP,
- adres e-mail.
Jeżeli w ERP XL zostanie znaleziony pasujący kontrahent, xSale podepnie zamówienie do istniejącej karty zamiast tworzyć nową.
Techniczne powiązanie kontrahenta z ERP
xSale zapisuje techniczne powiązanie kontrahenta z ERP w polu wewnętrznym, niewidocznym w standardowym widoku interfejsu. Dzięki temu system pamięta, jaki kod kontrahenta został ostatecznie użyty po stronie Comarch ERP XL.
W praktyce oznacza to, że:
- jeżeli kontrahent został już wcześniej powiązany z ERP XL, przy kolejnych synchronizacjach xSale korzysta z tego ustalonego powiązania,
- jeżeli podczas wysyłki xSale znajdzie istniejącą kartę kontrahenta w ERP, zapisuje użyty kod i wykorzystuje go przy kolejnych synchronizacjach.
Kiedy xSale tworzy nowy kod kontrahenta
Jeżeli xSale nie znajdzie istniejącego powiązania z kontrahentem w ERP XL, sprawdza, czy aktualny kod kontrahenta może zostać użyty przy zakładaniu nowej karty.
Dla Comarch ERP XL kod kontrahenta jest uznawany za nieprawidłowy, gdy:
- jest pusty,
- ma więcej niż 20 znaków.
Jeżeli kod jest poprawny, może zostać użyty przy tworzeniu kontrahenta w ERP. Jeżeli kod nie spełnia tych warunków, xSale generuje nowy kod i zapisuje go jako techniczne powiązanie do kolejnych synchronizacji.
Zmiana kodu kontrahenta w xSale
Jeżeli na karcie kontrahenta w xSale zmienisz pole Kod, dotychczasowe techniczne powiązanie z ERP zostanie wyczyszczone. Przy kolejnej synchronizacji xSale ponownie przejdzie proces wyszukiwania i dopasowania kontrahenta.
To rozwiązanie pomaga w sytuacjach, w których dotychczasowe powiązanie trzeba zbudować od nowa, na przykład po zmianie kodu lub po korekcie danych kontrahenta.
Kolejność wyszukiwania kontrahenta
Kolejność sprawdzania danych identyfikujących kontrahenta jest konfigurowalna. W zależności od ustawień integracji xSale może szukać kontrahenta w Comarch ERP XL według ustalonej kolejności pola Kod, NIP i e-mail.
Jeżeli chcesz zmienić sposób identyfikacji kontrahentów w swojej integracji, skontaktuj się z helpdesk@xsale.ai.
Ustawienia dodatkowe w WebService XL
W WebService XL można dodatkowo włączyć ustawienie, które blokuje nadpisywanie adresu e-mail na istniejącej karcie kontrahenta podczas synchronizacji.
Wyłączenie nadpisywania adresu e-mail
- Uruchom Futuriti WebService XL i przejdź do konfiguracji.

- Przejdź do sekcji Konfiguracja → Wczytywanie dok. do ERP i zaznacz opcję nie nadpisuj e-mail na istniejącym kontrahencie.

- Po wprowadzeniu zmian zapisz ustawienia przyciskiem Zapisz.

- Aby wprowadzone zmiany zaczęły obowiązywać, przejdź do sekcji Harmonogram i zrestartuj usługę WebService XL: Zatrzymaj, następnie Odśwież status SOAP i Uruchom.

To ustawienie warto stosować wtedy, gdy na karcie kontrahenta w ERP XL ma pozostać dotychczasowy adres e-mail i nie powinien być on nadpisywany danymi przychodzącymi z xSale.