Изменения

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

<div style="font-size: 16px; 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/reintegrations/requests/cancel/retailcrm [[Файл: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.Последнее действие - нажатие кнопки '''"Сохранить"'''. Настройка триггера завершена.