Изменения

Перейти к: навигация, поиск

RetailCRM

17 064 байта добавлено, 13:14, 28 марта 2020
Новая страница: «<div style="font-size: 24px; color: #a92424; background-color: #ffdede; border: 1px solid #ebccd1; padding: 3px 10px 10px;"> Если у вас уже есть и…»
<div style="font-size: 24px; color: #a92424; background-color: #ffdede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
Если у вас уже есть интеграция, то сначала напишите в службу поддержки, для активации нового режима для вашего аккаунта.
</div>

==Триггер “Отмена заказа при смене Типа доставки”==


[[Файл:rcrm_trig1.png|190px|thumb|right|рис.1 Типы доставок]]
1.Для начала потребуется найти и сопоставить пары:
<span style="color: red;>символьный код Типа доставки - API ключ</span>


2.Идем в настройки Типов доставок:
'''Настройки (1) -> Справочники (2) -> Типы доставок (3)''' (рис.1 Типы доставок).


3.Находим нужные нам доставки (или доставку).
На примере мы видим 2 Типа доставок:

'''Доставка межгород''', символьный код <span style="color: red;>'''outcity'''</span>

'''Доставка по городу''', символьный код <span style="color: red;>'''incity'''</span>

<span style="color: red;>'''Запишем эти значения.'''</span>
{|align="right"
|-valign="top"
|[[Файл:rcrm_trig2.png|170px|thumb|right|рис.2 Тип доставки город]]
|[[Файл:rcrm_trig3.png|170px|thumb|right|рис.3 Тип доставки межгород]]
|}


4.Создаем тестовые заказы на каждый Тип доставки.

У нас в примере 2 доставки, поэтому создадим 2 тестовых заказа, <span style="color: red;>обязательно выбирая тариф.</span>

Создав 2 заказа, <span style="color: red;>обязательно выбирая тариф</span>, мы видим следующее (рис.2 и рис.3 Два типа доставок город и межгород).

Таким образом получаем, что:

Доставка межгород, символьный код <span style="color: red;>'''outcity'''</span>, API ключ:
<span style="color: red;>'''WZHjxt5hsxxxxxxxxxxxxxxxxxxxxxxx'''</span>

Доставка по городу, символьный код <span style="color: red;>'''incity'''</span>, API ключ:
<span style="color: red;>'''fVJ4dO1h8xxxxxxxxxxxxxxxxxxxxxxx'''</span>

Пары символьный код <span style="color: red;>Типа доставки - API ключ</span> нужно записать. Текстовые наименования Типа доставки нам больше НЕ нужны.


5.Теперь, имея сопоставленные пары <span style="color: red;>символьный код Типа доставки - API ключ</span>, мы можем создать сам триггер:
{|align="right"
|-valign="top"
|[[Файл:rcrm_trig4.png|190px|thumb|right|рис.4 Настройки Триггеров]]
|[[Файл:rcrm_trig5.png|190px|thumb|right|рис.5 Кнопка "Добавить"]]
|-
|[[Файл:rcrm_trig6.png|190px|thumb|right|рис.6 Поле "Название"]]
|[[Файл:rcrm_trig7.png|190px|thumb|right|рис.7 Поле "Условие применения триггера"]]
|}

Идем в настройки Триггеров: '''Настройки (1) -> Коммуникации (2) -> Триггеры (3)''' (рис.4 Настройки Триггеров)


6.Жмем '''“Добавить”''' (рис.5 Кнопка "Добавить")

В появившемся окне нужно заполнить и настроить несколько полей:

1.Поле '''"Название"''' (рис.6 Поле "Название")

2.Поле '''"Условие применения триггера"''' (рис.7 Поле "Условие применения триггера"):

Вбиваем скрипт:
<source lang="javascript">
changeSet.hasChangedField("delivery_type") and changeSet.getOldValue("delivery_type").getCode() in ["outcity","incity"]
</source>
[[Файл:rcrm_trig8.png|190px|thumb|right|рис.8 выбор меню "Добавить действие"]]
Где:
*значения '''"outcity"''','''"incity"''' - это <span style="color: red;>символьные коды Типа доставки.</span>
:*Если у вас будет 1 Тип доставки, то нужно вписать в таком виде: '''["incity”]''' вместо '''["outcity","incity"]'''

3.Далее нужно нажать '''Добавить действие''' (1) -> '''Выполнить HTTP-запрос''' (2) (рис.8 выбор меню "Добавить действие"), чтобы появились дополнительные поля настроек (рис.9 Дополнительные поля настроек).


4.В поле '''"Адрес"''' прописываем адрес: https://home.courierexe.ru/retail/cancel

[[Файл:rcrm_trig9.png|190px|thumb|right|рис.9 Дополнительные поля настроек]]


5.В списке '''"HTTP метод"''' выбираем '''"POST"'''.


6.В списке '''"Передавать параметры"''' выбираем '''"В теле запроса (urlencode)"'''
Получим пример заполнения, как на (рис.9 Дополнительные поля настроек).


7.Жмите кнопку '''"Добавить"''' параметр 2 раза.


8.Теперь снова жмите кнопку '''"Добавить параметр"''' столько раз, сколько у вас было сопоставленных пар <span style="color: red;>символьный код Типа доставки - API ключ.</span>
[[Файл:rcrm_trig10.png|200px|thumb|right|рис.10 Добавление параметров]]


В нашем случае было 2 пары, поэтому мы опять нажмем 2 раза. Итого у нас будет 4 нажатия и мы увидим следующее (рис.10 Добавление параметров).

9.Теперь нам нужно эти поля заполнить следующими данными:
[[Файл:rcrm_trig11.png|200px|thumb|right|рис.11 Заполнили параметры данными]]
{| class="wikitable" cellpadding="10" cellspacing="0" border="2"
|'''Параметр'''
|'''Значение'''
|-
|'''id'''
|<source lang="javascript">{{ order.getNumber() }}</source>
|-
|'''code'''
|<source lang="javascript">{{ changeSet.getOldValue("delivery_type").getCode() }}</source>
|-
|<span style="color: red;>символьный код Типа доставки</span> из 1-ой пары сопоставлений
|<span style="color: red;>API ключ</span> из 1-ой пары сопоставлений
|-
|<span style="color: red;>символьный код Типа доставки</span> из 2-ой пары сопоставлений
|<span style="color: red;>API ключ</span> из 2-ой пары сопоставлений
|-
|}


По итогу мы получим следующее (см. рис.11 Заполнили параметры данными).

Обратите внимание, что <span style="color: red;>ВО ВСЕХ СЛУЧАЯХ ДАННЫЕ ЗАПИСАНЫ В ОДНОЙ СТРОКЕ, ПЕРЕНОСОВ СТРОК БЫТЬ НЕ ДОЛЖНО!</span>


10.Последнее действие - нажатие кнопки '''"Сохранить"'''. Настройка триггера завершена.


<div style="font-size: 24px; color: #a92424; background-color: #ffdede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
Если у вас уже есть интеграция, то сначала напишите в службу поддержки, для активации нового режима для вашего аккаунта.
</div>

==Триггер “Передача заказа при смене Статуса заказа”==

{|align="right"
|-valign="top"
|[[Файл:rcrm_trig101.png|200px|thumb|right|рис.1 Настройки]]
|[[Файл:rcrm_trig102.png|200px|thumb|right|рис.2 Кнопка "Добавить"]]
|-
|[[Файл:rcrm_trig103.png|200px|thumb|right|рис.3 Настройки полей статуса]]
|[[Файл:rcrm_trig104.png|200px|thumb|right|рис.4 настройки Типов доставок]]
|-
|[[Файл:rcrm_trig105.png|200px|thumb|right|рис.5 Тип доставки город]]
|[[Файл:rcrm_trig106.png|200px|thumb|right|рис.6 Тип доставки межгород]]
|}

1.Для начала нужно создать '''Статус заказа''' (или статусы, если вам нужно передавать заказы при двух или более статусах)
Заходим в настройки (рис.1).



2.Кнопка '''"Добавить"''' (рис.2).


3.Указываем поля '''"Название"''', '''"Символьный код"''', '''"Группа"'''.

<span style="color: red;>'''"Символьный код"''' необходимо записать, так как он понадобится в дальнейшем!</span>

Символьный код желательно вбивать латинскими буквами и цифрами, без пробелов, например '''"ks2008send'''" (рис.3).


4.Следующим шагом потребуется найти и сопоставить пары
<span style="color: red;>символьный код Типа доставки - API ключ.</span>
{|align="right"
|-valign="top"

|}


5.Переходим в настройки Типов доставок: '''"Настройки"''' (1) -> '''"Справочники"''' (2) -> '''"Типы доставок"''' (3) (рис. 4).


6.Находим нужные нам доставки (или доставку).
На примере выше мы видим 2 Типа доставок:

'''"Доставка межгород"''', символьный код <span style="color: red;>'''outcity'''</span>

'''"Доставка по городу"''', символьный код <span style="color: red;>'''incity'''</span>

<span style="color: red;>'''Запишем эти значения.'''</span>


7.Создаем тестовые заказы на каждый Тип доставки.
У нас в примере 2 доставки, поэтому создадим 2 тестовых заказа, <span style="color: red;>обязательно выбирая тариф</span>.

Создав 2 заказа, <span style="color: red;>обязательно выбирая тариф</span>, мы видим следующее (рис.5 и рис.6).


Таким образом получаем, что:

Доставка межгород, символьный код <span style="color: red;>'''outcity'''</span>, API ключ <span style="color: red;>'''WZHjxt5hsSgfxxxxxxxxxxxxxxxxxxxx'''</span>

Доставка по городу, символьный код <span style="color: red;>'''incity'''</span>, API ключ <span style="color: red;>'''fVJ4dO1h8uQoxxxxxxxxxxxxxxxxxxxx'''</span>
{|align="right"
|-valign="top"
|[[Файл:rcrm_trig107.png|200px|thumb|right|рис.7 Настройки]]
|[[Файл:rcrm_trig108.png|200px|thumb|right|рис.8 Кнопка "Добавить"]]
|-
|[[Файл:rcrm_trig109.png|200px|thumb|right|рис.9 Поле "Название триггера"]]
|[[Файл:rcrm_trig110.png|200px|thumb|right|рис.10 Скрипт применения триггера]]
|}
Пары <span style="color: red;>символьный код Типа доставки - API ключ</span> нужно записать. Текстовые наименования Типа доставки нам больше НЕ нужны.


8.Теперь, имея <span style="color: red;>символьный код Статуса заказа</span> (или статусов, если вам нужно передавать заказы при двух и более статусах) и сопоставленные пары <span style="color: red;>символьный код Типа доставки - API ключ</span>, мы можем создать сам триггер:

Переходим в настройки Триггеров: '''"Настройки"''' (1) -> '''"Коммуникации"''' (2) -> '''"Триггеры"''' (3) (рис.7).


9.Кнопка '''"Добавить"''' (рис.8).

В появившемся окне нужно заполнить и настроить несколько полей:

1.Поле '''"Название"''' (рис.9).

2.В поле '''"Условие применения триггера"''' добавляем скрипт (рис.10):
<source lang="javascript">
order.getStatus().getCode() in ["ks2008send"] and order.getDeliveryType().getCode() in ["outcity","incity"]
</source>
{|align="right"
|-valign="top"
|[[Файл:rcrm_trig111.png|200px|thumb|right|рис.11 выбор меню "Добавить действие"]]
|[[Файл:rcrm_trig112.png|200px|thumb|right|рис.12 Дополнительные поля настроек]]
|}
Где:
*''''''"ks2008send"'''''' - это <span style="color: red;>символьный код Статуса заказа</span>.
:*Если у вас будет 2 статуса, то нужно вписать их через запятую в таком виде: '''["ks2008send_1",”ks2008send_2”]''' вместо '''["ks2008send"]'''
*'''"outcity"''','''"incity"''' - это <span style="color: red;>символьные коды Типа доставки</span>.
:*Если у вас будет 1 Тип доставки, то нужно вписать в таком виде '''["incity”]''' вместо '''["outcity","incity"]'''


3.Далее нужно нажать '''Добавить действие''' (1) -> '''Выполнить HTTP-запрос''' (2) чтобы появились дополнительные поля настроек (рис.11).

4.В поле '''"Адрес"''' прописываем: https://home.courierexe.ru/retail/trigger

5.В списке '''"HTTP метод"''' выбираем '''"POST"'''.

6.В списке '''"Передавать параметры"''' выбираем '''"В теле запроса (urlencode)"'''.
Получим следующие настройки полей (рис. 12).

7.Нажимаем кнопку '''"Добавить параметр"''' 2 раза подряд.

8.Теперь снова нажимаем кнопку '''"Добавить параметр"''' столько раз, сколько у вас было сопоставленных пар <span style="color: red;>символьный код Типа доставки - API ключ</span>.
{|align="right"
|-valign="top"
[[Файл:rcrm_trig113.png|200px|thumb|right|рис.13 Добавление параметров]]
|-
[[Файл:rcrm_trig114.png|200px|thumb|right|рис.14 Заполнили параметры данными]]
|}
В нашем случае было 2 пары, поэтому мы опять нажмем 2 раза. Итого у нас будет 4 нажатия и мы увидим следующее (рис. 13).

9.Теперь нам нужно эти поля заполнить следующими данными:

{| class="wikitable" cellpadding="10" cellspacing="0" border="2"
|'''Параметр'''
|'''Значение'''
|-
|'''id'''
|<source lang="javascript">{{ order.getNumber() }}</source>
|-
|'''sum'''
|<source lang="javascript">{{ order.getIntegrationDeliveryData().getDeclaredSum() }}</source>
|-
|<span style="color: red;>символьный код Типа доставки</span> из 1-ой пары сопоставлений
|<span style="color: red;>API ключ</span> из 1-ой пары сопоставлений
|-
|<span style="color: red;>символьный код Типа доставки</span> из 2-ой пары сопоставлений
|<span style="color: red;>API ключ</span> из 2-ой пары сопоставлений
|-
|}


По итогу мы получим следующее заполнение полей (рис.14):

Обратите внимание, что <span style="color: red;>ВО ВСЕХ СЛУЧАЯХ ДАННЫЕ ЗАПИСАНЫ В ОДНОЙ СТРОКЕ, ПЕРЕНОСОВ СТРОК БЫТЬ НЕ ДОЛЖНО!</span>

10.Последнее действие - нажатие кнопки '''"Сохранить"'''. Настройка триггера завершена.
1924
правки

Навигация