2651
правка
Изменения
м
→Настройка триггеров
* [[Настройка триггеров для RetailCRM#Передача изменений заказа|«Изменения заказа в MeaSoft»]] — при наступлении события «Изменение заказа в RetailCRM». При изменении заказа в RetailCRM новые данные отправляются в MeSoft, если заказ передан и имеет статус «Новый» или «Ожидает синхронизации».
'''Примечание.''' Триггеры отправки и обновления данных заказа не учитывают типы оплат для наложенного платежа ('''ГлавнаяНастройки''' > '''Интеграция''' > '''Маркетплейс''' > '''ДоставкаДоставки'''). Поэтому если наложенный платеж для неоплаченного заказа равен нулю (например, при оплате на сайте), триггер все равно передаст сумму к оплате.
Для корректной отправки таких заказов не используйте триггеры.
Чтобы настроить триггер:
# Cоздайте пользовательский статус заказа, при установке которого заказ будет автоматически передаваться в курьерскую службу. Можно создать любое количество статусов.
## В RetailCRM выберите '''АдминистрированиеНастройки''' > '''Статусы''' и нажмите на кнопку '''Добавить'''. Откроется окно «Новый статус»: [[Файл:Rcrm trig103.png|600 px|none]]
## Заполните поля формы. В поле '''Символьный код''' используйте только цифры и латинские буквы без пробелов. Запишите созданный символьный код, он понадобится на следующих шагах.
# Выберите '''АдминистрированиеНастройки''' > '''Справочники''' > '''Типы доставок'''. Запишите символьные коды доставок, которые будут использоваться в триггере. В примере ниже используются коды outcity и incity.[[Файл:rcrm_trig104.png|600px|none]]# Откройте '''Администрирование''' > '''КоммуникацииНастройки''' > '''Триггеры''' и нажмите на кнопку '''Добавить+ Триггер'''. Откроется окно «Новый триггер».
#:Заполните поля:
#: '''Название'''. Название триггера, например «Отправка заказа в MeaSoft».
#: В разделе '''Событие'''. Выберите нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.#: В разделе '''Условие применения триггера'''. Добавьте установите переключатель '''Редактор''' и добавьте следующий скрипт:
#:<source lang="javascript">
order.getStatus().getCode() in ["SentMeaSoft"] and order.getDeliveryType().getCode() in ["outcity","incity"]
#* <code>SentMeaSoft</code> — символьный код статуса заказа. Если нужно указать 2 статуса, напишите их через запятую в виде: <code>["SentMeaSoft","SentMeaSoft_2"]</code> вместо <code>["SentMeaSoft"]</code>;
#* <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать 1 тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.
# Нажмите В разделе '''Добавить действиеДействие''' > нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/trigger/retailcrm;
#* '''HTTP метод''' — '''POST''';
|}
::'''Примечание'''. Переносы строк не допускаются.
:6. Нажмите В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.
:[[Файл:Новый триггер.png|600 px|none]]
Чтобы настроить триггер:
# В RetailCRM выберите '''АдминистрированиеНастройки''' > '''Справочники''' > '''Типы доставок'''. [[Файл:Rcrm_trig104.png|600 px|none]]
#: Запишите символьный код типа доставки (доставок), заказы которой отправляются в MeaSoft.
# Перейдите в раздел '''Операционная деятельностьПродажи''' и нажмите на кнопку '''Новый заказ'''. В разделе '''Доставка''' выберите тип доставки, заказы которой отправляются в MeaSoft, укажите город, вес и тариф.# В разделе '''Доставка''' появится поле '''API ключ службы доставки'''. Запишите его значение. В результате у вас есть пара «символьный код типа доставки» - — «API ключ службы доставки».
# Повторите действия пп. 2-3 для каждой доставки, заказы по которой отправляются в MeaSoft.
# Откройте '''Администрирование''' > '''КоммуникацииНастройки''' > '''Триггеры''' и нажмите на кнопку '''Добавить+ Триггер'''. Откроется окно «Новый триггер».
#: Заполните поля:
#* '''Название'''. Название триггера, например «Отмена заказа в MeaSoft»;
#* В разделе '''Событие'''. Выберите нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''';и нажмите на кнопку '''Добавить'''.#* В разделе '''Условие применения триггера'''. Добавьте установите переключатель '''Редактор''' и добавьте следующий скрипт:
#:<source lang="javascript">
changeSet.hasChangedField("delivery_type") and changeSet.getOldValue("delivery_type").getCode() in ["outcity","incity"]
</source>
#:где <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать один тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.
# Нажмите В разделе '''Добавить действиеДействие''' > нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/cancel/retailcrm;
#* '''HTTP метод''' — '''POST''';
|}
::'''Примечание'''. Переносы строк не допускаются.
:8. Нажмите В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.
:[[Файл:Новый триггер2.png|600 px|none]]
Триггер настроен.
Чтобы настроить триггер:
# В RetailCRM выберите '''АдминистрированиеНастройки''' > '''Справочники''' > '''Типы доставок'''. [[Файл:Rcrm_trig104.png|600 px|none]]
#: Запишите символьный код доставки (доставок), заказы которой отправляются в MeaSoft.
# Откройте '''Администрирование''' > '''КоммуникацииНастройки''' > '''Триггеры''' и нажмите на кнопку '''Добавить+ Триггер'''. Откроется окно «Новый триггер».
#: Заполните поля:
#* '''Название'''. Название триггера, например «Передача изменений заказа в MeaSoft»;
#* В разделе '''Событие'''. Выберите нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''';и нажмите на кнопку '''Добавить'''.#* В разделе '''Условие применения триггера'''. Добавьте установите переключатель '''Редактор''' и добавьте следующий скрипт:
#:<source lang="javascript">
changeSet.isUpdate() and
</source>
#:где <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать один тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.
# Нажмите В разделе '''Добавить действиеДействие''' > нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/update/retailcrm;
#* '''HTTP метод''' — '''POST''';
|}
::'''Примечание'''. Переносы строк не допускаются.
:5. Нажмите В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.
:[[Файл:Новый триггер3.png|600 px|none]]
Триггер настроен.
