EN
Ten wpis opisuje synchronizację kontrahenta między xSale a Comarch ERP XL. Jeżeli chcesz sprawdzić, kiedy xSale przypisuje importowane zamówienie do istniejącego kontrahenta w xSale, zobacz wpis Jak xSale przypisuje kontrahenta do importowanego zamówienia?.
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.