Podczas synchronizacji kontrahenta do Comarch ERP Optima 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 Optima,
- 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.
Jak xSale rozpoznaje kontrahenta
Podczas wysyłki kontrahenta do Comarch ERP Optima 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 Optimie 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 Optima.
W praktyce oznacza to, że:
- jeżeli kontrahent został już wcześniej powiązany z ERP, 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, sprawdza, czy aktualny kod kontrahenta może zostać użyty przy zakładaniu nowej karty.
Dla Comarch ERP Optima kod kontrahenta jest uznawany za nieprawidłowy, gdy:
- jest pusty,
- ma więcej niż 20 znaków,
- zawiera znaki kontrolne,
- zawiera znaki spoza zakresu akceptowanego przez integrację.
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. Domyślnie wykorzystywana jest kolejność code;nip;email.
Jeżeli chcesz zmienić tę kolejność, przejdź do:
xSale V2 → Integracje, a następnie edytuj integrację z Comarch ERP Optima i wybierz opcję przejścia do instalatora. Ustawienie kolejności wyszukiwania kontrahenta znajduje się w dalszych krokach konfiguracji integracji.
Jeżeli chcesz zmienić sposób identyfikacji kontrahentów w swojej integracji, skontaktuj się z helpdesk@xsale.ai.
Ustawienia dodatkowe w webservice
W integracji z Comarch ERP Optima można dodatkowo włączyć ustawienia, które wpływają na sposób aktualizacji danych istniejącego kontrahenta.
Wyłączenie nadpisywania danych kontrahenta
Jeżeli kontrahent już istnieje w Optimie, można ustawić integrację tak, aby xSale podłączał zamówienie do istniejącej karty bez nadpisywania danych na tej karcie.
W tym celu przejdź w webservice do sekcji Wczytywanie dok. do ERP i zaznacz opcję Nie nadpisuj danych na istniejących w ERP kontrahentach.
Po zapisaniu ustawień zrestartuj usługę webservice, aby zmiana zaczęła obowiązywać.
Kontrahenci dodawani przez integrację mogą być przypisywani tylko do jednej wybranej grupy kontrahentów w ERP.
