Изменения

<div style==Введение=="font-size: 18px; color: #a92424; background-color: #ffdede; border: 1px solid #ebccd1; padding: 3px 10px 10px;Триггер">:Хранимая процедура специального типаОбратите внимание, RetailCRM не передает Услуги, автоматически выполняющаяся при наступлении заданного событияне используйте их.</div>

Для RetailCRM предусмотрены следующие триггеры:* [[== Настройка триггеров для RetailCRM#Передача заказа при смене статуса|«Отправка заказа в КС2008»]] — при наступлении события «Смена статуса заказа на "Отправлен в КС2008"». При установке статуса, означающего, что заказ отправлен в курьерскую службу, срабатывает триггер, и заказ передается в MeaSoft;* «Отмена заказа в КС2008» — при наступлении события «Смена типа доставки у заказа». При изменении типа доставки с доставки MeaSoft на доставку, например, Почтой России, заказ в MeaSoft отменяется, если он туда передан и имеет статус «Новый» или «Ожидает синхронизации»;* «Изменения заказа в КС2008» — при наступлении события «Изменение заказа в RetailCRM». При изменении заказа в RetailCRM новые данные отправляются в MeSoft, если заказ передан и имеет статус «Новый» или «Ожидает синхронизации».интеграции ==

== Передача заказа при смене статуса == Чтобы настроить триггер:# Cоздайте пользовательский статус заказа, при установке которого заказ будет автоматически передаваться в курьерскую службуВ RetailСRM cоздайте API-ключ. Можно создать любое количество статусов.## В RetailCRM выберите Для этого откройте '''Настройки''' > '''АдминистрированиеИнтеграция''' > '''СтатусыКлючи доступа к API''' и нажмите на кнопку '''Добавить'''. Откроется окно страница «Новый статус»: [[Файлключ API». На этой странице:Rcrm trig103.png|600 px|none]]## Заполните поля формы. В поле '''Символьный кодКомментарий''' используйте только цифры и латинские буквы без пробелов. Запишите созданный символьный кодвведите краткое описание интеграции, он понадобится на следующих шагахнапример «По городу».# Выберите # В поле '''Тип доступа''' выберите '''АдминистрированиеДоступ ко всем магазинам''' > .## В списке '''СправочникиРазрешенные методы API''' > установите все флажки.## Нажмите на кнопку '''Типы доставокСохранить'''. Запишите символьные коды доставок#: API-ключей может быть несколько, которые будут использоваться в триггереи для каждого API-ключа необходимо выполнить эти настройки. В примере ниже используются коды outcity и incityПодробнее об управлении API-ключами см.[[Файлhttps:rcrm_trig104//help.pngretailcrm.ru/Users/ApiKeys документацию RetailCRM].# Настройте интеграцию в [[Личный кабинет клиента#Интеграция|600px|noneличном кабинете клиента MeaSoft]]:# Откройте # Выберите пункт основного меню '''АдминистрированиеНастройки''' > '''КоммуникацииИнтеграция''' > , перейдите на вкладку '''ТриггерыНастройки интеграции''' и в списке «Все интеграции» в строке «RetailCRM» нажмите на кнопку '''Добавить'''. Откроется окно «Новый триггер». #:Заполните поля# В окне «Настройка интеграции RetailCRM» укажите название интеграции, домен RetailCRM, созданный выше API-ключ. При необходимости укажите значения других полей. Описание некоторых полей:#: #* '''Получать статусы доставки''' — выберите '''НазваниеПолучать'''. Название триггера, например «Отправка чтобы в RetailCRM передавались статусы заказа из MeaSoft. Настройки передачи статусов для RetailCRM см. в разделе [[#Передача статусов из MeaSoft|«Передача статусов из MeaSoft».]];#: #* '''СобытиеПолучать тип и сумму оплаты'''. Выберите — выберите значение '''Изменение заказаПолучать''', чтобы получать тип и сумму оплаты из MeaSoft. Если тип оплаты, указанный в заказе, не совпадает с типом оплаты в MeaSoft и цена заказа не равна нулю, платеж в RetailCRM удаляется, создается новый платеж с суммой и типом оплаты из MeaSoft.Данные передаются, если в заказе осталась только одна сумма к оплате;#: #* '''Условие применения триггераКод поля для имени курьера'''— укажите символьный код пользовательского поля в заказе RetailCRM, в которое будет передано имя курьера. Добавьте следующий скрипт: <codeЧтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' >order'''Пользовательские поля'''.getStatus()Подробнее о настройке пользовательских полей см.getCode() in ["SentMeaSoft"] and orderhttps://help.getDeliveryType()retailcrm.getCode() in ["outcity","incity"ru/Users/CustomFields документацию RetailCRM]</code>, где ;##* <code>SentMeaSoft</code> '''Код статуса оплаты''' — укажите символьный код статуса платежа, чтобы в RetailCRM отображался статус платежа после доставки заказа. Если нужно указать 2 Чтобы увидеть символьный код статуса, напишите их через запятую в виде: <codeRetailCRM выберите '''Настройки''' > '''Справочники''' >["SentMeaSoft"'''Статусы оплат'''. Статус платежа передается,"SentMeaSoft_2"]</code> вместо <code>["SentMeaSoft"]</code>если на момент закрытия заказа оставалась только одна сумма к оплате;##* <code>outcity</code>'''Использовать данные склада как отправителя''' — если выбрано значение '''Использовать''', <code>incity</code> — символьные коды типа доставки. Если нужно указать 1 тип доставкиданные отправителя заполняются следующей информацией о складе: адрес, напишите его в виде <code>["incity"]</code> вместо <code>["outcity"название склада,"incity"]</codeтелефон контактного лица ('''Настройки''' >.# Нажмите '''Добавить действиеМагазины''' > '''Выполнить HTTP-запросСклады'''. Появятся дополнительные поля настроек. Заполните их следующим образом:);##* '''АдресПередавать ФИО получателя из пользовательского поля''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое вводится имя фактического получателя. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://homehelp.courierexeretailcrm.ru/reintegrationsUsers/requests/trigger/retailcrmCustomFields документацию RetailCRM];##* '''HTTP методПередавать телефон получателя из пользовательского поля''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое вводится телефон фактического получателя. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''POST'> '';'Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM]. Интеграция не передает электронную почту получателя. ##* '''Передавать параметрыОбновлять заказ при изменении''' — определяет, будет ли заказ в MeaSoft обновлен при изменении данных на стороне RetailCRM. Возможные значения: '''Да'В теле запроса (urlencode)'', '''Нет''';.# Нажмите на кнопку : По завершении настройки нажмите '''Добавить параметрСохранить''' 3 раза подряд и заполните появившиеся поля следующими данными.# Настройте интеграцию в RetailCRM:#* # Откройте '''idНастройки''' — <nowiki>{{ order.getNumber() }}</nowiki'''Справочники''' >;#* '''sumТипы доставок''' и на странице «Типы доставок» нажмите на кнопку '''Добавить''' — <nowiki>{{ order.getIntegrationDeliveryData()Откроется окно «Новая доставка»:[[Файл:Retail1.getDeclaredSum() }}</nowiki>;png|none|1000 px|]]#* # В этом окне заполните обязательные поля и в выпадающем списке '''keyИнтегрировать с''' — <nowiki>{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</nowiki>.#:выберите значение '''ПримечаниеMeaSoft'''. Переносы строк не допускаются.## Нажмите '''Сохранить'''.

Триггер настроен'''Примечание'''. Интеграция привязана к личному кабинету клиента курьерской службы. При необходимости работать из другого личного кабинета создайте новую интеграцию, начиная с пункта настройки в личном кабинете.

==Триггер “Отмена заказа Чтобы отправлять заказы в курьерскую службу по статусам и отменять при смене Типа доставки”==изменении типа доставки, используйте [[RetailCRM#Настройка триггеров|триггеры]].

Запрос отмены предназначен для отмены тех заказов, по которым не было произведено изменений - статуса доставки, статуса корреспонденции, времени доставки - то есть заказов, которые ещё не находятся в работе.== Исключение печати чеков ==Возможность отмены заказа В настройках интеграции есть только у курьерских служб с тарифом настройка '''"Премиум"Не печатать чеки для способа оплаты''' и по-умолчанию она выключена, ее нужно отдельно включить: [[Личный кабинет курьерской службы#Дополнительные настройки]].

При отмене заказа поле '''"Инфо о доставке"''' получает значение '''"Отменено заказчиком"''', поле '''"Дата доставки"''' - текущую дату, а '''"Вручил курьер"''' - системную запись '''"ОТМЕНА"'''Данная настройка выводит список способов оплаты из retailCRM.</div>[[Файл:rcrm_trig1.png|190px|thumb|right|рис.1 Типы доставок]]1.Для начала потребуется найти и сопоставить пары:<span style="color: red;>символьный код Типа доставки - API ключ</span>

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

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

Чтобы получать статусы заказа из MeaSoft:# Откройте '''Настройки''' > '''Интеграция''' и выберите модуль MEASOFT.# На странице «Настройки интеграции с MeaSoft» перейдите на вкладку '''Доставка по городу''', символьный код <span style="colorи на панели справа выберите пункт '''Статусы'''.# Настройте сопоставление статусов MeaSoft и RetailCRM. Для этого в столбце «Статус в RetailCRM» из выпадающего списка выберите соответствие для каждого статуса службы доставки. ''' [[Файл: red;>Retail передача статусов.png|none|1000 px]]# Нажмите на кнопку '''incityСохранить'''</span>.

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

4.Создаем тестовые заказы на каждый == Проверка интеграции ==Чтобы проверить настройки интеграции:# Перейдите в форму создания заказа и убедитесь, что в списке '''Тип доставки''' появилось соответствующее значение:[[Файл:Retail2.png|none|1000 px]]# Нажмите '''Выбрать тариф'''. Тарифы должны передаваться из настроек курьерской службы:[[Файл:Retail3.png|none|800 px]]<br>В случае ошибки обратитесь в курьерскую службу для настройки тарифов. Проверить тарифы можно в ЛК MeaSoft в разделе '''Калькулятор'''.

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

Создав 2 заказаЧтобы в RetailCRM формировать печатные формы, <span style="colorаналогичные формам в Личном кабинете MeaSoft, используйте один из следующих способов: 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;>Типа доставки каждый месяц 1- API ключ</span> нужно записатьго числа списывается абонентская плата за интернет. Текстовые наименования Типа доставки нам больше НЕ нужныТриггер «1-ый день месяца» — это событие, при наступлении которого срабатывает процедура «списание абонентской платы».

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

Идем в настройки Триггеров: '''Настройки (1) -> Коммуникации (2) -> Триггеры (3)Примечание.''' Триггеры отправки и обновления данных заказа не учитывают [[#Передача наложенного платежа|типы оплат для наложенного платежа]]. Поэтому если наложенный платеж для неоплаченного заказа равен нулю (риснапример, при оплате на сайте), триггер все равно передаст сумму к оплате. Для корректной отправки таких заказов не используйте триггеры.4 Настройки Триггеров)

Чтобы настроить триггер:# 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_typeSentMeaSoft") ] and changeSetorder.getOldValuegetDeliveryType("delivery_type").getCode() in ["outcity","incity"]and changeSet.hasChangedField("status")

#:где #* <code>SentMeaSoft</code> — символьный код статуса заказа. Если нужно указать 2 статуса, напишите их через запятую в виде: <code>["SentMeaSoft","SentMeaSoft_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/trigger/retailcrm;#* '''HTTP метод''' — '''POST''';#*значения '''"outcity"Передавать параметры''' — '''В теле запроса (urlencode)''',;# Нажмите на кнопку '''"incity"Добавить параметр''' 3 раза подряд и заполните появившиеся поля следующими данными::::{|class="wikitable"!Параметр!Значение|- это |id||<nowiki>{{ order.getNumber() }}<span style="color: red;/nowiki>|-|sum||<nowiki>{{ order.getIntegrationDeliveryData().getDeclaredSum() }}</nowiki>|-|key||<nowiki>символьные коды Типа доставки{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</spannowiki>|}:*Если у вас будет 1 Тип доставки, то нужно вписать в таком виде: '''["incity”]Примечание'''. Переносы строк не допускаются.:6. В панели '''Действия''' вместо нажмите '''["outcity","incity"]Сохранить''', затем сохраните триггер.

3:[[Файл:Новый триггер.Далее нужно нажать '''Добавить действие''' (1) -> '''Выполнить HTTP-запрос''' (2) (рис.8 выбор меню "Добавить действие"), чтобы появились дополнительные поля настроек (рис.9 Дополнительные поля настроек). png|600 px|none]]

4Триггер настроен.В поле '''"Адрес"''' прописываем адрес: https://home.courierexe.ru/reintegrations/requests/cancel/retailcrm

5.В списке '''"HTTP метод"''' выбираем '''"POST"''':[[Файл:Новый триггер.png|600 px|none]]

7.Жмите кнопку '''"Добавить"''' параметр 2 разаЗапрос отмены предназначен для заказов, которые еще не приняты в работу: не было изменений статуса доставки, статуса корреспонденции, времени доставки.

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

Чтобы настроить триггер:# В нашем случае было 2 парыRetailCRM выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. [[Файл:Rcrm_trig104.png|600 px|none]]#: Запишите символьный код типа доставки (доставок), поэтому мы опять нажмем 2 разазаказы которой отправляются в MeaSoft.# Перейдите в раздел '''Продажи''' и нажмите на кнопку '''Новый заказ'''. Итого у нас будет 4 нажатия В разделе '''Доставка''' выберите тип доставки, заказы которой отправляются в MeaSoft, укажите город, вес и мы увидим следующее (ристариф.# В разделе '''Доставка''' появится поле '''API ключ службы доставки'''. Запишите его значение.10 Добавление параметров)В результате у вас есть пара «символьный код типа доставки» — «API ключ службы доставки». # Повторите действия пп. 2-3 для каждой доставки, заказы по которой отправляются в MeaSoft.9# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''.Теперь нам нужно эти Откроется окно «Новый триггер».#: Заполните поля заполнить следующими данными:[[Файл:rcrm_trig11#* '''Название'''.png|200px|thumb|right|рисНазвание триггера, например «Отмена заказа в MeaSoft»;#* В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.11 Заполнили параметры данными]]{| class#* В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:#:<source lang="wikitablejavascript">changeSet.hasChangedField("delivery_type") and changeSet.getOldValue("delivery_type").getCode() in ["outcity","incity" cellpadding=]</source>#:где <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать один тип доставки, напишите его в виде <code>["10incity" cellspacing=]</code> вместо <code>["0outcity" border=,"2incity"]</code>.|# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/cancel/retailcrm;#* '''HTTP метод''' — '''POST''';#* '''Передавать параметры''' — '''ПараметрВ теле запроса (urlencode)''';|# Нажмите на кнопку '''ЗначениеДобавить параметр'''2 раза подряд и потом еще столько раз, сколько у вас сопоставленных пар «символьный код типа доставки» - «API ключ службы доставки». Заполните появившиеся поля следующими данными::::{|class="wikitable"!Параметр!Значение

|'''id'''||<source lang="javascript"nowiki>{{ order.getNumber() }}</sourcenowiki>

|'''code'''||<source lang="javascript"nowiki>{{ changeSet.getOldValue("delivery_type").getCode() }}</sourcenowiki>

|<span style="color: red;>символьный Cимвольный код Типа типа доставки</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.Последнее действие - нажатие кнопки # В RetailCRM выберите '''"Сохранить"Настройки'''. Настройка триггера завершена.   ==Триггер “Передача изменений заказа”==  <div style="font-size: 16px; color: #a92424; background-color: #ffdede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">'''Примечание:Справочники''' Возможность изменения заказа есть только у курьерских служб с тарифом > '''"Премиум"Типы доставок''' и по-умолчанию она выключена, ее нужно отдельно включить: [[Личный кабинет курьерской службы#Дополнительные настройки]]. </div> {|align="right" |-valign="top" |[[Файл:rcrm_trig101Rcrm_trig104.png|200px600 px|thumb|right|рис.1 Настройкиnone]] |[[Файл#:rcrm_trig102.png|200px|thumb|right|рис.2 Кнопка "Добавить"]] |- |[[Файл:rcrm_trig104.png|200px|thumb|right|рис.4 настройки Типов Запишите символьный код доставки (доставок]] |- |[[Файл:rcrm_trig105), заказы которой отправляются в MeaSoft.png|200px|thumb|right|рис.5 Тип доставки город]] |[[Файл:rcrm_trig106.png|200px|thumb|right|рис.6 Тип доставки межгород]] |} 1.Переходим в настройки Типов доставок: # Откройте '''"Настройки"''' (1) -> '''"Справочники"Триггеры''' (2) -> и нажмите на кнопку '''"Типы доставок"+ Триггер''' (3) (рис. 4)Откроется окно «Новый триггер».  2.Находим нужные нам доставки (или доставку).На примере выше мы видим 2 Типа доставок#: '''"Доставка межгород"''', символьный код <span style="colorЗаполните поля: red;>'''outcity'''</span> #* '''"Доставка по городу"Название'''. Название триггера, символьный код <span style="color: redнапример «Передача изменений заказа в MeaSoft»;>'''incity'''</span> <span style="color: red;>#* В разделе '''Запишем эти значения.Событие'''</span>  3.Теперь переходим в настройки Триггеров: нажмите на кнопку '''"Настройки"+ Событие''' (1) -> , выберите значение '''"Коммуникации"Изменение заказа''' (2) -> и нажмите на кнопку '''"Триггеры"''' (3) (рис.7).  4.Кнопка '''"Добавить"''' (рис.8). #* В появившемся окне нужно заполнить и настроить несколько полей: 1.Поле разделе '''"Название"Условие''' (рис.9). 2.В поле установите переключатель '''"Условие применения триггера"Редактор''' добавляем и добавьте следующий скрипт (рис.10):#:<source lang="javascript">

order.getDeliveryType().getCode() in ["outcity","incity"]

#:где <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 раза подряд и заполните появившиеся поля следующими данными::::{|alignclass="rightwikitable" !Параметр!Значение|-valign="top" |[[Файл:rcrm_trig111id||<nowiki>{{ order.pnggetNumber() }}</nowiki>|200px-|thumbsum|right|рис<nowiki>{{ order.getIntegrationDeliveryData().11 выбор меню "Добавить действие"]]getDeclaredSum() }}</nowiki> |[[Файл:rcrm_1_1.png-|200pxkey|thumb|right|рис<nowiki>{{ order.getIntegrationDeliveryData().getExtraData().12 Дополнительные поля настроек]]deliveryApiKey }}</nowiki> |} Где: *:'''"outcity"Примечание''',. Переносы строк не допускаются.:5. В панели '''"incity"Действия''' - это <span style="color: red;>символьные коды Типа доставки</span>.:*Если у вас будет 1 Тип доставки, то нужно вписать в таком виде нажмите '''["incity”]''' вместо Сохранить''', затем сохраните триггер.:[[Файл:Новый триггер3.png|600 px|none]]Триггер настроен. == Передача габаритов ==Габариты из retailCRM передаются стандартными средствами retailCRM. Они берутся, либо из раздела "outcityГабариты и вес",либо из раздела "incityУпаковки"]''', где вы можете распределить товары между упаковками, указав габариты и вес каждой упаковки.

3.Далее нужно нажать '''Добавить действие''' (1) -> '''Выполнить HTTP-запрос''' (2) чтобы появились дополнительные поля настроек (рис.11). 4.В поле '''"Адрес"''' прописываем[[Файл: https://home.courierexeGab.ru/reintegrations/requests/update/retailcrmpng|none|800 px]]

5Дополнительно можете изучить информацию здесь https://docs.В списке '''"HTTP метод"''' выбираем '''retailcrm.ru/Users/OperatingActivity/Orders/OrderPage/WorkOrderPage/WorkDeliveryOrder раздел "POSTОформление упаковок"'''.

6.== Передача признака необходимости возврата ==1) В списке '''retailCRM создайте справочник со значениями "no", "Передавать параметрыyes"''' выбираем ''', "В теле запроса (urlencode)only"'''.Получим следующие настройки полей (рис. 12).

7.Нажимаем кнопку '''"Добавить параметр"''' 3 раза подряд[[Файл:Return.png|none|800 px]]

{2) В retailCRM создайте пользовательское поле с типом "Справочник". Справочником выберите справочник из 1ого пункта. [[Файл:Return2.png|none| class=800 px]]  3) В заказе выбирайте нужный элемент справочника и он будет уходить вместе с заказом.  4) В настройках интеграции в ЛК вам нужно в опции "wikitableПризнак необходимости возврата" cellpaddingвыбрать созданное вами поле. ==Ошибка "10Не удалось загрузить список служб доставки" cellspacing="0" border=Существует известная проблема на стороне retailCRM, когда вместо получения тарифов вы видите сообщение "2Не удалось загрузить список служб доставки". Суть проблемы в том, что retailCRM не может принять большое число ПВЗ. У retailCRM просто не хватает мощностей на обработку большого числа информации. Если у вас много ПВЗ для многих подрядчиков (СДЭК, ПОЧТА РОССИИ, 5POST и тд), то вы иногда можете наблюдать данную ошибку. Избавиться от данной ошибки можно за счет снижения получаемой информации.  То есть, вам нужно либо уменьшить кол-во получаемых ПВЗ, либо уменьшить кол-во информации о ПВЗ. Вот варианты того, как можно убрать данную ошибку:|'''Параметр'''|#Если вы не используете ПВЗ, то в настройках интеграции в ЛК у опции *Получать ПВЗ для выбора* выберите '''ЗначениеНе получать'''|-|#Если вы не используете все режимы срочности, то в настройках интеграции в ЛК у опции '''idРежимы срочности'''выберите только нужные вам режимы|<source lang="javascript">{{ order.getNumber() }}<#Если вам не нужна такая информация о ПВЗ, как адрес/телефон/время работы/source>|-|как добраться, то у опции '''sumОтсылать информацию о ПВЗ'''|<source lang="javascript">{{ order.getIntegrationDeliveryData().getDeclaredSum() }}</source>|-|выберите '''keyНет'''|<source lang="javascript">{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</source>|-|}

Обратите внимание, что <span style="color: red;>ВО ВСЕХ СЛУЧАЯХ ДАННЫЕ ЗАПИСАНЫ В ОДНОЙ СТРОКЕ== На некоторые заказы ===Если вы планируете передавать артикулы только на некоторые заказы, ПЕРЕНОСОВ СТРОК БЫТЬ НЕ ДОЛЖНО!</span>то используйте настройку '''Переодическая передача артикула по заказу'''.

10.Последнее действие - нажатие кнопки #Сначала создайте кастомное поле в retailCRM с типом '''"Сохранить"Флажок (да/нет)'''. Настройка триггера завершена.#Сопоставьте этого поле в настройке '''Переодическая передача артикула по заказу'''#Для передачи артикула, ставьте галку в созданного поле в нужном заказе и тогда артикулы будут передаваться по данному заказу