<div style==Введение=="font-size: 18px; color: #a92424; background-color: #ffdede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">'''Триггер''' - это событиеОбратите внимание, при наступлении которогоRetailCRM не передает Услуги, срабатывает другое событиене используйте их.</div>
Пример триггера:
Каждый месяц 1-го числа у вас списывается абонентская плата за интернет. В таком примере, триггер "настал 1-ый день месяца" - это событие, при наступлении которого срабатывает другое событие "списание абонентской платы"
В реалиях '''RetailCRM''', предусмотрены 3 триггера:== Настройка интеграции ==
# В RetailСRM cоздайте API-ключ. Для этого откройте '''Настройки''' > '''Интеграция''' > '''Ключи доступа к API''' и нажмите на кнопку '''Добавить'''. Откроется страница «Новый ключ API». На этой странице:## В поле '''Комментарий''' введите краткое описание интеграции, например «По городу».## В поле '''Тип доступа''' выберите '''Доступ ко всем магазинам'''.## В списке '''Разрешенные методы API''' установите все флажки.## Нажмите на кнопку '''Сохранить'''.#: API-ключей может быть несколько, и для каждого API-ключа необходимо выполнить эти настройки. Подробнее об управлении API-ключами см. [https://help.retailcrm.ru/Users/ApiKeys документацию RetailCRM].# Настройте интеграцию в [[Личный кабинет клиента#Интеграция|личном кабинете клиента MeaSoft]]:## Выберите пункт основного меню '''Настройки''' > '''Интеграция''', перейдите на вкладку '''Настройки интеграции''' и в списке «Все интеграции» в строке «RetailCRM» нажмите '''Добавить'''. ## В окне «Настройка интеграции RetailCRM» укажите название интеграции, домен RetailCRM, созданный выше API-ключ. При необходимости укажите значения других полей. Описание некоторых полей:##* '''Получать статусы доставки''' — выберите '''Получать''', чтобы в RetailCRM передавались статусы заказа из MeaSoft. Настройки передачи статусов для RetailCRM см. в разделе [[#Передача статусов из MeaSoft|«Передача статусов из MeaSoft»]];##*1) Триггер '''"отправка Получать тип и сумму оплаты''' — выберите значение '''Получать''', чтобы получать тип и сумму оплаты из MeaSoft. Если тип оплаты, указанный в заказе, не совпадает с типом оплаты в MeaSoft и цена заказа не равна нулю, платеж в RetailCRM удаляется, создается новый платеж с суммой и типом оплаты из MeaSoft. Данные передаются, если в КС2008"заказе осталась только одна сумма к оплате;##* '''Код поля для имени курьера''' — укажите символьный код пользовательского поля в заказе RetailCRM, при наступлении события в которое будет передано имя курьера. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM];##* '''Код статуса оплаты'''"Смена — укажите символьный код статуса платежа, чтобы в RetailCRM отображался статус платежа после доставки заказа. Чтобы увидеть символьный код статуса, в RetailCRM выберите '''Настройки''' > '''Справочники''' > '''Статусы оплат'''. Статус платежа передается, если на момент закрытия заказа оставалась только одна сумма к оплате;##* '''Использовать данные склада как отправителя''' — если выбрано значение '''Использовать''', данные отправителя заполняются следующей информацией о складе: адрес, название склада, телефон контактного лица ('''Настройки''' > '''Магазины''' > '''Склады''');##* '''Передавать ФИО получателя из пользовательского поля''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое вводится имя фактического получателя. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM];##* '''Передавать телефон получателя из пользовательского поля''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое вводится телефон фактического получателя. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM]. Интеграция не передает электронную почту получателя. ##* '''Обновлять заказ при изменении''' — определяет, будет ли заказ в MeaSoft обновлен при изменении данных на "Отправлен стороне RetailCRM. Возможные значения: '''Да''', '''Нет'''.#: По завершении настройки нажмите '''Сохранить'''.# Настройте интеграцию в КС2008""RetailCRM:## Откройте '''Настройки''' > '''Справочники''' > '''Типы доставок''' и на странице «Типы доставок» нажмите на кнопку '''Добавить'''. Откроется окно «Новая доставка»:[[Файл:Retail1.png|none|1000 px|]]## В этом окне заполните обязательные поля и в выпадающем списке '''Интегрировать с''' выберите значение '''MeaSoft'''.## Нажмите '''Сохранить'''.
:*То есть, когда вы меняете статус заказу, то срабатывает триггер '''"отправка заказа в КС2008"Примечание''' и заказ уходит . Интеграция привязана к личному кабинету клиента курьерской службы. При необходимости работать из другого личного кабинета создайте новую интеграцию, начиная с пункта настройки в систему КС2008личном кабинете.
*2) Триггер '''"отмена заказа Чтобы отправлять заказы в КС2008"''', курьерскую службу по статусам и отменять при наступлении события '''"Смена изменении типа доставки у заказа"''', используйте [[RetailCRM#Настройка триггеров|триггеры]].
:*То есть== Передача типа платежа в ЛК из retailCRM ==Если символьный код передаваемого платежа содержит вхождение слова "card", когда вы меняете Тип заказа с нашей доставки на доставкуто платеж передается как Карта, например, в Почту Россиииначе Наличные.Если заказ будет оплачен, то мы отменяем ваш заказ в нашей системе (если он туда передавался и имеет статус '''"Новый"''' или '''"Ожидает синхронизации"''')передается NO.
*3) Триггер '''"изменения заказа в КС2008"''', при наступлении события '''"Изменения заказ в RetailCRM"'''.
:*То == Исключение печати чеков ==В настройках интеграции есть, когда вы меняете данные заказа - данные меняются в в нашей системе (если он туда передавался и имеет статус настройка '''"Новый"Не печатать чеки для способа оплаты''' или '''"Ожидает синхронизации"''').
==Триггер “Отмена заказа при смене Типа доставки”==Данная настройка выводит список способов оплаты из retailCRM.
Вы можете выбрать те способы оплаты, при наличии которых в заказе в систему MeaSoft будет передана нулевая цена по товарам и нулевая сумма по заказу. Это полезно для оплаты заказа безналом по счету юр.лицами и для перемещения товаров между своими складами без оплаты.
<div style="font-size: 16px; color: #a92424; background-color: #ffdede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">'''Примечание:'''= Передача наложенного платежа ==
Запрос отмены предназначен для отмены тех заказов, по которым не было произведено изменений - статуса доставки, статуса корреспонденции, времени доставки - то есть заказов, которые ещё не находятся в работеЧтобы настроить корректную передачу наложенного платежа:# Откройте '''Настройки''' > '''Интеграция''' и выберите модуль MEASOFT.Возможность отмены заказа есть только у курьерских служб # На странице «Настройки интеграции с тарифом MeaSoft» перейдите на вкладку '''"Премиум"Доставка''' и по-умолчанию она выключенана панели справа выберите пункт '''Способы оплаты'''.# Установите флажки для способов оплаты, которые могут использоваться для передачи наложенного платежа, ее нужно отдельно включить: и нажмите '''Сохранить '''.[[Личный кабинет курьерской службы#Дополнительные настройкиФайл:Retail5.png|none|1000 px]].
При отмене заказа поле '''"Инфо о доставке"''' получает значение '''"Отменено заказчиком"''', поле '''"Дата доставки"''' - текущую дату, а '''"Вручил курьер"''' - системную запись '''"ОТМЕНА"'''Интеграция транслирует НДС товаров.</div>[[Файл:rcrm_trig1.png|190px|thumb|right|рис.1 Типы доставок]]1.Для начала потребуется найти и сопоставить пары:<span style="color: red;>символьный код Типа доставки - API ключ</span>
== Передача статусов из MeaSoft ==
2.Идем в настройки Типов доставокЧтобы получать статусы заказа из MeaSoft: # Откройте '''Настройки (1) -''' > Справочники (2) -> Типы доставок (3)''' (рисИнтеграция''' и выберите модуль MEASOFT.# На странице «Настройки интеграции с MeaSoft» перейдите на вкладку '''Доставка''' и на панели справа выберите пункт '''Статусы'''.# Настройте сопоставление статусов MeaSoft и RetailCRM. Для этого в столбце «Статус в RetailCRM» из выпадающего списка выберите соответствие для каждого статуса службы доставки. ''' [[Файл:Retail передача статусов.1 Типы доставок)png|none|1000 px]]# Нажмите на кнопку '''Сохранить'''.
Статус из MeaSoft в RetailCRM передается 1 раз в 30 минут. Поэтому некоторые промежуточные статусы для заказа могут быть пропущены, и будет показан последний выставленный на момент синхронизации статус заказа.
3В интеграции RetailCRM нет понятия "Финальный статус".Находим нужные нам доставки (или доставку)Интеграция отправляет все статусы, которые есть у заказа, без дополнительных условий.На примере мы видим 2 Типа доставок:
== Проверка интеграции ==Чтобы проверить настройки интеграции:# Перейдите в форму создания заказа и убедитесь, что в списке '''Доставка межгородТип доставки''', символьный код <span style="colorпоявилось соответствующее значение:[[Файл: red;>Retail2.png|none|1000 px]]# Нажмите '''outcityВыбрать тариф'''. Тарифы должны передаваться из настроек курьерской службы:[[Файл:Retail3.png|none|800 px]]</spanbr>В случае ошибки обратитесь в курьерскую службу для настройки тарифов. Проверить тарифы можно в ЛК MeaSoft в разделе '''Калькулятор'''.
'''Доставка по городу''', символьный код <span style="color: red;>'''incity'''</span>=Печатные формы ==
<span style="colorЧтобы в RetailCRM формировать печатные формы, аналогичные формам в Личном кабинете MeaSoft, используйте один из следующих способов: red* в сохраненном заказе на панели действий сверху нажмите '''Печать''' и выберите нужную печатную форму «Курьерская служба»;* в списке заказов отметьте заказы флажками, внизу страницы нажмите '''Действия''' >'''Запишем эти значения.Распечатать документы'''</span>{|align="right" |-valign="top" |[[Файл:rcrm_trig2и выберите печатную форму «Курьерская служба».png|170px|thumb|right|рис.2 Тип доставки город]] |[[Файл:rcrm_trig3.png|170px|thumb|right|рис.3 Тип доставки межгород]] |}
== Настройка триггеров ==
4.Создаем тестовые заказы на каждый Тип доставки;Триггер:Хранимая процедура специального типа, автоматически выполняющаяся при наступлении заданного события.
У нас в примере 2 доставки, поэтому создадим 2 тестовых заказаПример: каждый месяц 1-го числа списывается абонентская плата за интернет. Триггер «1-ый день месяца» — это событие, <span style="color: red;>обязательно выбирая тарифпри наступлении которого срабатывает процедура «списание абонентской платы».</span>
Создав 2 заказа, <span style="color: red;>обязательно выбирая тариф</span>, мы видим следующее (рис.2 Триггеры используются для автоматической отправки заказов в курьерскую службу и риснеобязательны для работы модуля.3 Два типа доставок город и межгород)Вы можете отправлять заказы вручную, снимая флажок '''Не синхронизировать со службой доставки''' в разделе '''Доставка''' на странице заказа перед его сохранением. Таким образом получаем, что:
Доставка межгородДля RetailCRM предусмотрены следующие триггеры:* [[Настройка триггеров для RetailCRM#Передача заказа при смене статуса|«Отправка заказа в MeaSoft»]] — при наступлении события «Смена статуса заказа на "Отправлен в MeaSoft"». При установке статуса, означающего, что заказ отправлен в курьерскую службу, символьный код <span style="color: redсрабатывает триггер, и заказ передается в MeaSoft;>'''outcity'''</span>* [[Настройка триггеров для RetailCRM#Отмена заказа при смене типа доставки|«Отмена заказа в MeaSoft»]] — при наступлении события «Смена типа доставки у заказа». При изменении типа доставки с доставки MeaSoft на доставку, API ключ:например, Почтой России, заказ в MeaSoft отменяется, если он туда передан и имеет статус «Новый» или «Ожидает синхронизации»;<span style="color: red;>'''WZHjxt5hsxxxxxxxxxxxxxxxxxxxxxxx'''</span>* [[Настройка триггеров для RetailCRM#Передача изменений заказа|«Изменения заказа в MeaSoft»]] — при наступлении события «Изменение заказа в RetailCRM». При изменении заказа в RetailCRM новые данные отправляются в MeSoft, если заказ передан и имеет статус «Новый» или «Ожидает синхронизации».
Доставка по городу, символьный код <span style="color: red;>'''incityПримечание.'''</span>Триггеры отправки и обновления данных заказа не учитывают [[#Передача наложенного платежа|типы оплат для наложенного платежа]]. Поэтому если наложенный платеж для неоплаченного заказа равен нулю (например, при оплате на сайте), API ключ:<span style="color: red;>'''fVJ4dO1h8xxxxxxxxxxxxxxxxxxxxxxx'''</span>триггер все равно передаст сумму к оплате. Для корректной отправки таких заказов не используйте триггеры.
Пары символьный код <span style="color: red;>Типа доставки - API ключ</span> нужно записать. Текстовые наименования Типа доставки нам больше НЕ нужны.== Передача заказа при смене статуса ===
Чтобы настроить триггер:
# 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"] and changeSet.hasChangedField("status")
</source>
#:где
#* <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''';
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';
# Нажмите на кнопку '''Добавить параметр''' 3 раза подряд и заполните появившиеся поля следующими данными:
:::{|class="wikitable"
!Параметр
!Значение
|-
|id||<nowiki>{{ order.getNumber() }}</nowiki>
|-
|sum||<nowiki>{{ order.getIntegrationDeliveryData().getDeclaredSum() }}</nowiki>
|-
|key||<nowiki>{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</nowiki>
|}
::'''Примечание'''. Переносы строк не допускаются.
:6. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.
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|thumb600 px|right|рис.6 Поле "Название"none]] |[[Файл:rcrm_trig7.png|190px|thumb|right|рис.7 Поле "Условие применения триггера"]] |}
Идем в настройки Триггеров: '''Настройки (1) -> Коммуникации (2) -> Триггеры (3)''' (рисТриггер настроен.4 Настройки Триггеров)
6.Жмем '''“Добавить”''' (рис.5 Кнопка "Добавить")=== Отмена заказа при смене статуса ===
Чтобы настроить триггер:# Cоздайте пользовательский статус заказа, при установке которого заказ будет автоматически отменяться. Можно создать любое количество статусов. ## В появившемся окне нужно заполнить RetailCRM выберите '''Настройки''' > '''Статусы''' и настроить несколько полейнажмите на кнопку '''Добавить'''. Откроется окно «Новый статус»: [[Файл:Rcrm trig103.png|600 px|none]]## Заполните поля формы. В поле '''Символьный код''' используйте только цифры и латинские буквы без пробелов. Запишите созданный символьный код, он понадобится на следующих шагах.1# Выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. Запишите символьные коды доставок, которые будут использоваться в триггере.Поле В примере ниже используются коды outcity и incity.[[Файл:rcrm_trig104.png|600px|none]]# Откройте '''Настройки''"Название"' > '''Триггеры''' и нажмите на кнопку '''+ Триггер''' (рис.6 Поле "Название")Откроется окно «Новый триггер». #:Заполните поля:2.Поле #: '''"Условие применения триггера"Название''' (рис.7 Поле "Условие применения Название триггера"), например «Отмена заказа в MeaSoft».#:В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''. Вбиваем #: В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:#:<source lang="javascript">changeSetorder.getStatus().hasChangedFieldgetCode() in ["delivery_typeCancelMeaSoft") ] and changeSetorder.getOldValuegetDeliveryType("delivery_type").getCode() in ["outcity","incity"]and changeSet.hasChangedField("status")
</source>
#:где #* <code>CancelMeaSoft</code> — символьный код статуса заказа. Если нужно указать 2 статуса, напишите их через запятую в виде: <code>["CancelMeaSoft_1","CancelMeaSoft_2"]</code> вместо <code>[Файл:rcrm_trig8"SentMeaSoft"]</code>;#* <code>outcity</code>, <code>incity</code> — символьные коды типа доставки.png|190px|thumb|right|рис.8 выбор меню Если нужно указать 1 тип доставки, напишите его в виде <code>["Добавить действиеincity"]</code> вместо <code>["outcity","incity"]</code>.Где# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:#* '''Адрес''' — https: //home.courierexe.ru/reintegrations/requests/cancelbystatus/retailcrm;#* '''HTTP метод''' — '''POST''';#*значения '''"outcity"Передавать параметры''' — '''В теле запроса (urlencode)''',;# Нажмите на кнопку '''"incity"Добавить параметр''' 3 раза подряд и заполните появившиеся поля следующими данными::::{|class="wikitable"!Параметр!Значение|-|id||<nowiki>{{ order.getNumber() }}</nowiki>|- это |key||<span style="color: red;nowiki>символьные коды Типа доставки{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</spannowiki>|}::*Если у вас будет 1 Тип доставки, то нужно вписать в таком виде'''Примечание'''. Переносы строк не допускаются.: 6. В панели '''["incity”]Действия''' вместо нажмите '''["outcity","incity"]Сохранить''', затем сохраните триггер.
3:[[Файл:Новый триггер.Далее нужно нажать '''Добавить действие''' (1) -> '''Выполнить HTTP-запрос''' (2) (рис.8 выбор меню "Добавить действие"), чтобы появились дополнительные поля настроек (рис.9 Дополнительные поля настроек). png|600 px|none]]
4Триггер настроен.В поле '''"Адрес"''' прописываем адрес: https://home.courierexe.ru/reintegrations/requests/cancel/retailcrm
[[Файл:rcrm_trig9.png|190px|thumb|right|рис.9 Дополнительные поля настроек]]=== Отмена заказа при смене типа доставки ===
Запрос отмены предназначен для заказов, которые еще не приняты в работу: не было изменений статуса доставки, статуса корреспонденции, времени доставки.
5Возможность отмены заказа есть только у курьерских служб с тарифом «Премиум» или «Максимум».В списке По умолчанию она выключена, ее нужно включить в [[Личный кабинет курьерской службы#Параметры|личном кабинете курьерской службы]]: '''"HTTP метод"Управление ЛК''' выбираем > '''"POST"Параметры''' > '''Расширенные''' > '''Разрешить отмену и изменение заказов'''.
При отмене заказа поле '''Инфо о доставке''' получает значение '''Отменено заказчиком''', поле '''Дата доставки''' заполняется текущей датой, а в поле '''Вручил курьер''' появляется системная запись '''Отмена'''.
6.Чтобы настроить триггер:# В списке RetailCRM выберите '''Настройки'''> ''"Передавать параметры"'Справочники'' выбираем '> ''"В теле запроса (urlencode)"'Типы доставок'''. [[Файл:Rcrm_trig104.png|600 px|none]]Получим пример заполнения, как на #: Запишите символьный код типа доставки (рис.9 Дополнительные поля настроекдоставок), заказы которой отправляются в MeaSoft. 7# Перейдите в раздел '''Продажи''' и нажмите на кнопку '''Новый заказ'''.Жмите кнопку В разделе '''"Добавить"Доставка''' параметр 2 разавыберите тип доставки, заказы которой отправляются в MeaSoft, укажите город, вес и тариф. 8.Теперь снова жмите кнопку # В разделе '''Доставка''' появится поле '''"Добавить параметр"API ключ службы доставки''' столько раз, сколько . Запишите его значение. В результате у вас было сопоставленных пар <span style="color: red;>символьный есть пара «символьный код Типа доставки - API типа доставки» — «API ключслужбы доставки».</span>[[Файл:rcrm_trig10# Повторите действия пп.png|200px|thumb|right|рис2-3 для каждой доставки, заказы по которой отправляются в MeaSoft.10 Добавление параметров]]# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».#: Заполните поля:#* '''Название'''. Название триггера, например «Отмена заказа в MeaSoft»;#* В нашем случае было 2 парыразделе '''Событие''' нажмите на кнопку '''+ Событие''', поэтому мы опять нажмем 2 разавыберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''. Итого у нас будет 4 нажатия #* В разделе '''Условие''' установите переключатель '''Редактор''' и мы увидим следующее добавьте следующий скрипт:#:<source lang="javascript">changeSet.hasChangedField(рис"delivery_type") and changeSet.10 Добавление параметровgetOldValue("delivery_type").getCode() in ["outcity","incity"] </source>9#:где <code>outcity</code>, <code>incity</code> — символьные коды типа доставки.Теперь нам Если нужно эти поля заполнить следующими данными:указать один тип доставки, напишите его в виде <code>[[Файл:rcrm_trig11.png|200px|thumb|right|рис.11 Заполнили параметры данными]]{| class="wikitableincity" cellpadding=]</code> вместо <code>["10outcity" cellspacing=,"0" border="2incity"]</code>.# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:|#* '''ПараметрАдрес'''— https://home.courierexe.ru/reintegrations/requests/cancel/retailcrm;|#* '''HTTP метод''' — '''ЗначениеPOST''';|-#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';|# Нажмите на кнопку '''idДобавить параметр'''2 раза подряд и потом еще столько раз, сколько у вас сопоставленных пар «символьный код типа доставки» - «API ключ службы доставки». Заполните появившиеся поля следующими данными::::{|<source langclass="javascriptwikitable">{{ order.getNumber() }}</source>!Параметр!Значение
|-
|'''code'''id||<source lang="javascript"nowiki>{{ changeSet.getOldValue("delivery_type")order.getCodegetNumber() }}</sourcenowiki>
|-
|code||<span style=nowiki>{{ changeSet.getOldValue("color: red;>символьный код Типа доставки</span> из 1-ой пары сопоставлений|<span style=delivery_type"color: red;>API ключ).getCode() }}</spannowiki> из 1-ой пары сопоставлений
|-
|<span style="color: red;>символьный Cимвольный код Типа типа доставки</span> из 2-ой пары сопоставлений1||<span style="color: red;>API -ключ</span> из 2-ой пары сопоставленийслужбы доставки 1
|-
|Cимвольный код типа доставки 2||API-ключ службы доставки 2
|}
::'''Примечание'''. Переносы строк не допускаются.
:8. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.
:[[Файл:Новый триггер2.png|600 px|none]]
Триггер настроен.
=== Передача изменений заказа ===
Изменять заказ могут только курьерские службы с тарифом «Премиум» или «Максимум». По итогу мы получим следующее (см. рис.11 Заполнили параметры данными). Обратите вниманиеумолчанию опция выключена, что <span style="colorее нужно включить в [[Личный кабинет курьерской службы#Параметры|личном кабинете курьерской службы]]: red;'''Управление ЛК''' >ВО ВСЕХ СЛУЧАЯХ ДАННЫЕ ЗАПИСАНЫ В ОДНОЙ СТРОКЕ, ПЕРЕНОСОВ СТРОК БЫТЬ НЕ ДОЛЖНО!</span'''Параметры''' > '''Расширенные''' >'''Разрешить отмену и изменение заказов'''.
Чтобы настроить триггер:
# В RetailCRM выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. [[Файл:Rcrm_trig104.png|600 px|none]]
#: Запишите символьный код доставки (доставок), заказы которой отправляются в MeaSoft.
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».
#: Заполните поля:
#* '''Название'''. Название триггера, например «Передача изменений заказа в MeaSoft»;
#* В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.
#* В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:
#:<source lang="javascript">
changeSet.isUpdate() and
(
changeSet.hasChangedField("first_name") or
changeSet.hasChangedField("last_name") or
changeSet.hasChangedField("patronymic") or
changeSet.hasChangedField("phone") or
changeSet.hasChangedField("site") or
changeSet.hasChangedField("additional_phone") or
changeSet.hasChangedField("email") or
changeSet.hasChangedField("customer.phones") or
changeSet.hasChangedField("order_product") or
changeSet.hasChangedField("total_summ") or
changeSet.hasChangedField("delivery_date") or
changeSet.hasChangedField("delivery_time") or
changeSet.hasChangedField("payments") or
changeSet.hasChangedField("prepay_sum") or
changeSet.hasChangedField("weight") or
changeSet.hasChangedField("length") or
changeSet.hasChangedField("width") or
changeSet.hasChangedField("height") or
changeSet.hasChangedField("payments.id") or
changeSet.hasChangedField("payments.status") or
changeSet.hasChangedField("payments.type") or
changeSet.hasChangedField("payments.external_id") or
changeSet.hasChangedField("payments.amount") or
changeSet.hasChangedField("payments.paid_at") or
changeSet.hasChangedField("payments.comment") or
changeSet.hasChangedField("discount_manual_amount") or
changeSet.hasChangedField("discount_manual_percent")
)
and
order.getDeliveryType().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/update/retailcrm;
#* '''HTTP метод''' — '''POST''';
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';
# Нажмите на кнопку '''Добавить параметр''' 3 раза подряд и заполните появившиеся поля следующими данными:
:::{|class="wikitable"
!Параметр
!Значение
|-
|id||<nowiki>{{ order.getNumber() }}</nowiki>
|-
|sum||<nowiki>{{ order.getIntegrationDeliveryData().getDeclaredSum() }}</nowiki>
|-
|key||<nowiki>{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</nowiki>
|}
::'''Примечание'''. Переносы строк не допускаются.
:5. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.
:[[Файл:Новый триггер3.png|600 px|none]]
Триггер настроен.
10.Последнее действие - нажатие кнопки '''"Сохранить"'''. Настройка триггера завершена== Передача габаритов ==Габариты из retailCRM передаются стандартными средствами retailCRM.
==Триггер “Передача заказа при смене Статуса заказа”==Они берутся, либо из раздела "Габариты и вес", либо из раздела "Упаковки", где вы можете распределить товары между упаковками, указав габариты и вес каждой упаковки.
{|align="right" |-valign="top" |[[Файл:rcrm_trig101.png|200px|thumb|right|рис.1 Настройки]] |[[Файл:rcrm_trig102.png|200px|thumb|right|рис.2 Кнопка "Добавить"]] |- |[[Файл:rcrm_trig103Gab.png|200pxnone|thumb|right|рис.3 Настройки полей статуса800 px]] |[[Файл:rcrm_trig104.png|200px|thumb|right|рис.4 настройки Типов доставок]] |- |[[Файл:rcrm_trig105.png|200px|thumb|right|рис.5 Тип доставки город]] |[[Файл:rcrm_trig106.png|200px|thumb|right|рис.6 Тип доставки межгород]] |}
1Дополнительно можете изучить информацию здесь https://docs.Для начала нужно создать '''Статус заказа''' (или статусы, если вам нужно передавать заказы при двух или более статусах)Заходим в настройки (рисretailcrm.1). ru/Users/OperatingActivity/Orders/OrderPage/WorkOrderPage/WorkDeliveryOrder раздел "Оформление упаковок"
== Передача признака необходимости возврата ==
1) В retailCRM создайте справочник со значениями "no", "yes", "only".
2.Кнопка '''"Добавить"''' (рис.2)[[Файл:Return.png|none|800 px]]
3.Указываем поля '''"Название"''', '''"Символьный код"''', '''"Группа"'''.
<span style=2) В retailCRM создайте пользовательское поле с типом "color: red;>'''Справочник"Символьный код"''' необходимо записать, так как он понадобится в дальнейшем!</span>. Справочником выберите справочник из 1ого пункта.
Символьный код желательно вбивать латинскими буквами и цифрами, без пробелов, например '''"ks2008send'''" (рис[[Файл:Return2.3). png|none|800 px]]
4.Следующим шагом потребуется найти и сопоставить пары
<span style="color: red;>символьный код Типа доставки - API ключ.</span>
{|align="right"
|-valign="top"
|} 3) В заказе выбирайте нужный элемент справочника и он будет уходить вместе с заказом.
5.Переходим 4) В настройках интеграции в ЛК вам нужно в настройки Типов доставок: '''"Настройки"''' (1) -> '''"Справочники"''' (2) -> '''опции "Типы доставокПризнак необходимости возврата"''' (3) (рис. 4)выбрать созданное вами поле.
== Ошибка "Не удалось загрузить список служб доставки" ==6.Находим нужные нам Существует известная проблема на стороне retailCRM, когда вместо получения тарифов вы видите сообщение "Не удалось загрузить список служб доставки (или доставку)".На примере выше мы видим 2 Типа доставок:
'''"Доставка межгород"'''Суть проблемы в том, символьный код <span style="color: red;>'''outcity'''</span>что retailCRM не может принять большое число ПВЗ. У retailCRM просто не хватает мощностей на обработку большого числа информации.
'''"Доставка по городу"'''Если у вас много ПВЗ для многих подрядчиков (СДЭК, символьный код <span style="color: red;>'''incity'''</span>ПОЧТА РОССИИ, 5POST и тд), то вы иногда можете наблюдать данную ошибку.
<span style="color: red;>'''Запишем эти значенияИзбавиться от данной ошибки можно за счет снижения получаемой информации.'''</span>
То есть, вам нужно либо уменьшить кол-во получаемых ПВЗ, либо уменьшить кол-во информации о ПВЗ.
Вот варианты того, как можно убрать данную ошибку:
7.Теперь#Если вы не используете ПВЗ, имея <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время работы/reintegrations/requests/trigger/retailcrm 5.В списке '''"HTTP метод"''' выбираем '''"POST"'''. 6.В списке как добраться, то у опции '''"Передавать параметры"Отсылать информацию о ПВЗ''' выбираем выберите '''"В теле запроса (urlencode)"Нет'''.Получим следующие настройки полей (рис. 12). 7.Нажимаем кнопку '''"Добавить параметр"''' 3 раза подряд. 8.Теперь нам нужно эти поля заполнить следующими данными: {| class="wikitable" cellpadding="10" cellspacing="0" border="2"|'''Параметр'''|'''Значение'''|-|'''id'''|<source lang="javascript">{{ order.getNumber() }}</source>|-|'''sum'''|<source lang="javascript">{{ order.getIntegrationDeliveryData().getDeclaredSum() }}</source>|-|'''key'''|<source lang="javascript">{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</source>|-|}
== Передача артикулов ==
По итогу мы получим следующее заполнение полей (рис.14):=== Постоянно ===Если вы планируете передавать артикулы на каждый заказ, то используйте настройку '''Использовать артикулы'''
Обратите внимание, что <span style="color: red;>ВО ВСЕХ СЛУЧАЯХ ДАННЫЕ ЗАПИСАНЫ В ОДНОЙ СТРОКЕ== На некоторые заказы ===Если вы планируете передавать артикулы только на некоторые заказы, ПЕРЕНОСОВ СТРОК БЫТЬ НЕ ДОЛЖНО!</span>то используйте настройку '''Переодическая передача артикула по заказу'''.
10.Последнее действие - нажатие кнопки #Сначала создайте кастомное поле в retailCRM с типом '''"Сохранить"Флажок (да/нет)'''. Настройка триггера завершена.#Сопоставьте этого поле в настройке '''Переодическая передача артикула по заказу'''#Для передачи артикула, ставьте галку в созданного поле в нужном заказе и тогда артикулы будут передаваться по данному заказу
