<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 ==
Чтобы получать статусы заказа из MeaSoft:
# Откройте '''Настройки''' > '''Интеграция''' и выберите модуль MEASOFT.
# На странице «Настройки интеграции с MeaSoft» перейдите на вкладку '''Доставка''' и на панели справа выберите пункт '''Статусы'''.
# Настройте сопоставление статусов MeaSoft и RetailCRM. Для этого в столбце «Статус в RetailCRM» из выпадающего списка выберите соответствие для каждого статуса службы доставки. ''' [[Файл:Retail передача статусов.png|none|1000 px]]
# Нажмите на кнопку '''Сохранить'''.
2.Идем Статус из MeaSoft в настройки Типов доставок: '''Настройки (RetailCRM передается 1) -> Справочники (2) -> Типы доставок (3)''' (рисраз в 30 минут.1 Типы доставок)Поэтому некоторые промежуточные статусы для заказа могут быть пропущены, и будет показан последний выставленный на момент синхронизации статус заказа.
== Проверка интеграции ==
Чтобы проверить настройки интеграции:
# Перейдите в форму создания заказа и убедитесь, что в списке '''Тип доставки''' появилось соответствующее значение:[[Файл:Retail2.png|none|1000 px]]
# Нажмите '''Выбрать тариф'''. Тарифы должны передаваться из настроек курьерской службы:[[Файл:Retail3.png|none|800 px]]<br>В случае ошибки обратитесь в курьерскую службу для настройки тарифов. Проверить тарифы можно в ЛК MeaSoft в разделе '''Калькулятор'''.
3.Находим нужные нам доставки (или доставку).На примере мы видим 2 Типа доставок:==Печатные формы ==
Чтобы в RetailCRM формировать печатные формы, аналогичные формам в Личном кабинете MeaSoft, используйте один из следующих способов:* в сохраненном заказе на панели действий сверху нажмите '''Доставка межгородПечать'''и выберите нужную печатную форму «Курьерская служба»;* в списке заказов отметьте заказы флажками, символьный код <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 Тип доставки межгород]] |}
Пример: каждый месяц 1-го числа списывается абонентская плата за интернет. Триггер «1-ый день месяца» — это событие, при наступлении которого срабатывает процедура «списание абонентской платы».
4Триггеры используются для автоматической отправки заказов в курьерскую службу и необязательны для работы модуля.Создаем тестовые Вы можете отправлять заказы вручную, снимая флажок '''Не синхронизировать со службой доставки''' в разделе '''Доставка''' на каждый Тип доставкистранице заказа перед его сохранением.
У нас Для RetailCRM предусмотрены следующие триггеры:* [[Настройка триггеров для RetailCRM#Передача заказа при смене статуса|«Отправка заказа в MeaSoft»]] — при наступлении события «Смена статуса заказа на "Отправлен в MeaSoft"». При установке статуса, означающего, что заказ отправлен в курьерскую службу, срабатывает триггер, и заказ передается в MeaSoft;* [[Настройка триггеров для RetailCRM#Отмена заказа при смене типа доставки|«Отмена заказа в примере 2 MeaSoft»]] — при наступлении события «Смена типа доставки у заказа». При изменении типа доставкис доставки MeaSoft на доставку, например, Почтой России, заказ в MeaSoft отменяется, поэтому создадим 2 тестовых если он туда передан и имеет статус «Новый» или «Ожидает синхронизации»;* [[Настройка триггеров для RetailCRM#Передача изменений заказа|«Изменения заказа в MeaSoft»]] — при наступлении события «Изменение заказа в RetailCRM». При изменении заказа в RetailCRM новые данные отправляются в MeSoft, <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>= Передача заказа при смене статуса ===
Доставка по городуЧтобы настроить триггер:# Cоздайте пользовательский статус заказа, при установке которого заказ будет автоматически передаваться в курьерскую службу. Можно создать любое количество статусов.## В RetailCRM выберите '''Настройки''' > '''Статусы''' и нажмите на кнопку '''Добавить'''. Откроется окно «Новый статус»: [[Файл:Rcrm trig103.png|600 px|none]]## Заполните поля формы. В поле '''Символьный код''' используйте только цифры и латинские буквы без пробелов. Запишите созданный символьный код <span style="color, он понадобится на следующих шагах.# Выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. Запишите символьные коды доставок, которые будут использоваться в триггере. В примере ниже используются коды outcity и incity.[[Файл: red;rcrm_trig104.png|600px|none]]# Откройте '''Настройки''' >'''incityТриггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».#:Заполните поля:#: '''Название'''. Название триггера, например «Отправка заказа в MeaSoft».#: В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.#: В разделе '''Условие''' установите переключатель '''Редактор'''и добавьте следующий скрипт:#:<source lang="javascript">order.getStatus().getCode() in ["SentMeaSoft"] and order.getDeliveryType().getCode() in ["outcity","incity"] and changeSet.hasChangedField("status")</source>#:где #* <code>SentMeaSoft</spancode>— символьный код статуса заказа. Если нужно указать 2 статуса, API ключнапишите их через запятую в виде:<code>["SentMeaSoft","SentMeaSoft_2"]</code> вместо <code>["SentMeaSoft"]</code>;#* <code>outcity</code>, <span style=code>incity</code> — символьные коды типа доставки. Если нужно указать 1 тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"color]</code>.# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:#* '''Адрес''' — https: red//home.courierexe.ru/reintegrations/requests/trigger/retailcrm;>#* '''HTTP метод''' — '''POST''';#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';# Нажмите на кнопку '''fVJ4dO1h8xxxxxxxxxxxxxxxxxxxxxxxДобавить параметр'''3 раза подряд и заполните появившиеся поля следующими данными::::{|class="wikitable"!Параметр!Значение|-|id||<nowiki>{{ order.getNumber() }}</nowiki>|-|sum||<nowiki>{{ order.getIntegrationDeliveryData().getDeclaredSum() }}</nowiki>|-|key||<nowiki>{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</spannowiki>|}::'''Примечание'''. Переносы строк не допускаются.:6. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.
Пары символьный код <span style="color: red;>Типа доставки - API ключ</span> нужно записать. Текстовые наименования Типа доставки нам больше НЕ нужны[[Файл:Новый триггер.png|600 px|none]]
Триггер настроен.
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 Поле "Условие применения триггера"]] |}Отмена заказа при смене статуса ===
Идем в настройки ТриггеровЧтобы настроить триггер: # Cоздайте пользовательский статус заказа, при установке которого заказ будет автоматически отменяться. Можно создать любое количество статусов. ## В RetailCRM выберите '''Настройки (1) -''' > Коммуникации (2) -> Триггеры (3)''' (рисСтатусы''' и нажмите на кнопку '''Добавить'''. Откроется окно «Новый статус»: [[Файл:Rcrm trig103.4 Настройки Триггеров) png|600 px|none]]6## Заполните поля формы.Жмем В поле '''“Добавить”Символьный код''' (рисиспользуйте только цифры и латинские буквы без пробелов. Запишите созданный символьный код, он понадобится на следующих шагах.5 Кнопка "Добавить") # Выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. Запишите символьные коды доставок, которые будут использоваться в триггере. В появившемся окне нужно заполнить примере ниже используются коды outcity и настроить несколько полейincity.[[Файл:rcrm_trig104.png|600px|none]]# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».#:Заполните поля:1.Поле #: '''"Название"''' (рис.6 Поле "Название")триггера, например «Отмена заказа в MeaSoft». #: В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.2.Поле #: В разделе '''"Условие применения триггера"''' (рис.7 Поле "Условие применения триггера")установите переключатель '''Редактор''' и добавьте следующий скрипт: Вбиваем скрипт#:<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.
<div style=Они берутся, либо из раздела "Габариты и вес", либо из раздела "font-size: 24px; color: #a92424; background-color: #ffdede; border: 1px solid #ebccd1; padding: 3px 10px 10px;Упаковки">Если у вас уже есть интеграция, то сначала напишите в службу поддержкигде вы можете распределить товары между упаковками, для активации нового режима для вашего аккаунтауказав габариты и вес каждой упаковки.</div>
==Триггер “Передача заказа при смене Статуса заказа”==[[Файл:Gab.png|none|800 px]]
{|align="right" |-valign="top" |[[Файл:rcrm_trig101.png|200px|thumb|right|рис.1 Настройки]] |[[ФайлДополнительно можете изучить информацию здесь https:rcrm_trig102//docs.png|200px|thumb|right|рисretailcrm.2 Кнопка ru/Users/OperatingActivity/Orders/OrderPage/WorkOrderPage/WorkDeliveryOrder раздел "ДобавитьОформление упаковок"]] |- |[[Файл: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)В retailCRM создайте справочник со значениями "no", "yes", "only".
[[Файл:Return.png|none|800 px]]
2.Кнопка '''"Добавить"''' (рис.2).
3.Указываем поля '''2) В retailCRM создайте пользовательское поле с типом "НазваниеСправочник"''', '''"Символьный код"''', '''"Группа"'''. Справочником выберите справочник из 1ого пункта.
<span style="color[[Файл: red;>'''"Символьный код"''' необходимо записать, так как он понадобится в дальнейшем!</span>Return2.png|none|800 px]]
Символьный код желательно вбивать латинскими буквами и цифрами, без пробелов, например '''"ks2008send'''" (рис.3).
4.Следующим шагом потребуется найти 3) В заказе выбирайте нужный элемент справочника и сопоставить пары <span style="color: red;>символьный код Типа доставки - API ключон будет уходить вместе с заказом.</span>{|align="right" |-valign="top"
|}
4) В настройках интеграции в ЛК вам нужно в опции "Признак необходимости возврата" выбрать созданное вами поле.
5.Переходим в настройки Типов доставок: '''== Ошибка "НастройкиНе удалось загрузить список служб доставки"''' (1) -> '''==Существует известная проблема на стороне retailCRM, когда вместо получения тарифов вы видите сообщение "СправочникиНе удалось загрузить список служб доставки"''' (2) -> '''"Типы доставок"''' (3) (рис. 4).
6Суть проблемы в том, что retailCRM не может принять большое число ПВЗ.Находим нужные нам доставки (или доставку)У retailCRM просто не хватает мощностей на обработку большого числа информации.На примере выше мы видим 2 Типа доставок:
'''"Доставка межгород"''', символьный код <span style="color: red;>'''outcity'''</span> '''"Доставка по городу"''', символьный код <span style="color: red;>'''incity'''</span> <span style="color: red;>'''Запишем эти значения.'''</span> 7.Теперь, имея <span style="color: red;>символьный код Статуса заказа</span> Если у вас много ПВЗ для многих подрядчиков (или статусовСДЭК, если вам нужно передавать заказы при двух и более статусах) и сопоставленные пары <span style="color: red;>символьный код Типа доставки - API ключ</span>ПОЧТА РОССИИ, мы можем создать сам триггер: Переходим в настройки Триггеров: '''"Настройки"''' (1) -> '''"Коммуникации"''' (2) -> '''"Триггеры"''' (3) (рис.7). 9.Кнопка '''"Добавить"''' (рис.8). В появившемся окне нужно заполнить 5POST и настроить несколько полей: 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.Последнее действие - нажатие кнопки #Если вы не используете ПВЗ, то в настройках интеграции в ЛК у опции *Получать ПВЗ для выбора* выберите '''"Сохранить"Не получать'''#Если вы не используете все режимы срочности, то в настройках интеграции в ЛК у опции '''Режимы срочности''' выберите только нужные вам режимы#Если вам не нужна такая информация о ПВЗ, как адрес/телефон/время работы/как добраться, то у опции '''Отсылать информацию о ПВЗ''' выберите '''Нет'''. Настройка триггера завершена.
