Automatyczne akcje w BaseLinker

Od wersji 1.963 w systemie WMS możliwe jest skonfigurowanie automatycznego wywoływania akcji z BaseLinker po zrealizowaniu dokumentu.

WMS wywołuje metodę BaseLinker runOrderMacroTrigger dla zamówienia wskazanego w atrybucie BASELINKERNR. Wywołana zostanie tylko jedna najlepiej dopasowana akcja. Jeśli ponawiasz akcję ręcznie, upewnij się, że akcja w BaseLinker może zostać wykonana ponownie bez niepożądanych skutków, np. ponownego wysłania wiadomości lub powielenia operacji.

Wymagania wstępne

• Włączona konfiguracja: BaseLinker_TriggerExternalEventOnDocumentRealization
• Atrybut BASELINKERNR o typie liczba całkowita na dokumencie przechowujący identyfikator zamówienia w BaseLinker. Typowy scenariusz: Zewnętrzny integrator BL → ERP Dokument RO z atrybut „BASELINKERNR” → Futuriti WMS Connector → Futuriti WMS dokument
• Aktywny token API BaseLinker. Gdzie znaleźć token?

Konfiguracja tokenu API BaseLinker

Wygenerowany token API BaseLinker należy zapisać w systemie WMS. Przejdź do konfiguracji: Menu Główne → Konfiguracja → BaseLinker → Token API BaseLinker

Wprowadź token API i zapisz konfigurację.

Konfiguracja mapowań wyzwalaczy

Przejdź do konfiguracji mapowań wyzwalaczy: Menu Główne → Konfiguracja → BaseLinker → Mapowanie wyzwalaczy BaseLinker a WMS

Na wyświetlonej liście można dodać nowe mapowanie lub edytować istniejące.

• Nazwa wyzwalacza – dowolna nazwa wyświetlana na liście
• Identyfikator wyzwalacza – akcja w systemie BaseLinker, która zostanie wykonana po spełnieniu warunków (lista pobierana z API documentation – baselinker.com)
• Typ dokumentu – określa, dla jakich typów dokumentów wyzwalacz jest aktywny
• Sposób dostawy – wartość atrybutu „sposób dostawy”, dla której wyzwalacz jest aktywny
• Gabaryt – wartość atrybutu „gabaryt”, dla której wyzwalacz jest aktywny
• Operator realizujący – określa, dla jakiego operatora wyzwalacz zostanie aktywowany

Warunki są opcjonalne. Jeśli pole pozostanie puste, oznacza to, że filtr jest aktywny dla wszystkich wartości.

Priorytet wyzwalaczy

Może wystąpić sytuacja, w której filtry będą do siebie zbliżone. System WMS wywołuje jedną dopasowaną akcję dla dokumentu w momencie jego zatwierdzania. Jeśli dla zatwierdzonego dokumentu pasuje wiele zdefiniowanych akcji, można nadać im priorytety. W takim przypadku system wywoła akcję o najwyższym priorytecie.

Z listy wyzwalaczy (Menu Główne → Konfiguracja → BaseLinker → Mapowanie wyzwalaczy BaseLinker a WMS) wybierz przycisk Priorytet.

Zostanie otwarta formatka priorytetów.

Akcje znajdujące się wyżej na liście mają wyższy priorytet.

W tym przykładzie pierwsza akcja uwzględnia dodatkowo gabaryt, natomiast druga działa dla wszystkich gabarytów. Aby zapewnić, że pierwsza akcja zawsze zostanie wykonana dla dokumentów z atrybutem gabaryt „B”, należy umieścić ją na najwyższym poziomie priorytetu.

Konfiguracja akcji automatycznej po zatwierdzaniu dokumentu

Przejdź do konfiguracji akcji automatycznej i ją aktywuj:

Menu Główne → Konfiguracja → BaseLinker → Po zatwierdzeniu dokumentu, wyślij zapytanie do zewnętrznych integracji zgodnie z konfiguracją wyzwalaczy

Ponawianie akcji dla dokumentów

Na liście dokumentów należy zaznaczyć dokumenty, dla których akcja ma zostać ponowiona lub wywołana.

Zostanie wyświetlony komunikat, w którym można wybrać, czy akcja powinna zostać wywołana dla wszystkich dokumentów, czy tylko dla tych zakończonych błędem.

Jeśli system napotkał problemy, zostaną one wyświetlone wraz z możliwością ponowienia operacji w przypadku błędów przejściowych.