Изменения

# В RetailСRM cоздайте API-ключ. Для этого откройте '''АдминистрированиеНастройки''' > '''Интеграция''' > '''Ключи доступа к API''' и нажмите на кнопку '''Добавить'''. Откроется страница «Новый ключ API». На этой странице:

## Выберите пункт основного меню '''АвтоматизацияНастройки''' > '''Интеграция''', перейдите на вкладку '''Обратная интеграцияНастройки интеграции''' и на странице «Список всех обратных интеграций» в списке «Все интеграции» в строке RetailCRM «RetailCRM» нажмите '''Добавить'''. ## В окне «Настройка интеграции RetailCRM» укажите название интеграции, домен RetailCRM, созданный выше API-ключ. При необходимости укажите значения других полей.Описание некоторых полей:#: Если нужно#* '''Получать статусы доставки''' — выберите '''Получать''', чтобы в RetailCRM отображался статус платежа после доставки передавались статусы заказа из MeaSoft. Настройки передачи статусов для RetailCRM см. в разделе [[#Передача статусов из MeaSoft|«Передача статусов из MeaSoft»]];##* '''Получать тип и сумму оплаты''' — выберите значение '''Получать''', чтобы получать тип и сумму оплаты из MeaSoft. Если тип оплаты, указанный в заказе, не совпадает с типом оплаты в MeaSoft и цена заказане равна нулю, заполните поле платеж в RetailCRM удаляется, создается новый платеж с суммой и типом оплаты из MeaSoft. Данные передаются, если в заказе осталась только одна сумма к оплате;##* '''Код поля для имени курьера'''Получать статус платежа (— укажите символьный код пользовательского поля в заказе RetailCRM, в которое будет передано имя курьера. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM];##* '''Код статуса платежа)оплаты'''— укажите символьный код статуса платежа, чтобы в RetailCRM отображался статус платежа после доставки заказа. Чтобы увидеть символьный код платежастатуса, в RetailCRM выберите '''АдминистрированиеНастройки''' > '''Справочники''' > '''Статусы оплат'''.Статус платежа передается, если на момент закрытия заказа оставалась только одна сумма к оплате;##* '''Использовать данные склада как отправителя''' — если выбрано значение '''Использовать''', данные отправителя заполняются следующей информацией о складе: Если нужноадрес, название склада, телефон контактного лица ('''Настройки''' > '''Магазины''' > '''Склады''');##* '''Передавать ФИО получателя из пользовательского поля''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое вводится имя фактического получателя. Чтобы создать поле или увидеть символьный код, чтобы в RetailCRM передавались статусы заказа выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM];##* '''Передавать телефон получателя из MeaSoftпользовательского поля''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое вводится телефон фактического получателя. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Получать статусы доставкиСистемные''' укажите > '''ПолучатьПользовательские поля'''. Настройки передачи статусов для RetailCRM Подробнее о настройке пользовательских полей см. в разделе [[https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM].##Передача статусов из * '''Обновлять заказ при изменении''' — определяет, будет ли заказ в MeaSoft|«Передача статусов из MeaSoft»]]обновлен при изменении данных на стороне RetailCRM. Возможные значения: '''Да''', '''Нет'''.

## Откройте '''АдминистрированиеНастройки''' > '''Справочники''' и на вкладке > '''Типы доставок''' и на странице «Типы доставок» нажмите на кнопку '''Добавить'''. Откроется окно «Новая доставка»:[[Файл:Retail1.png|none|700 1000 px|]]## В этом окне заполните обязательные поля и в выпадающем списке '''Интегрировать с''' выберите значение '''"Курьерская служба 2008"MeaSoft'''.

# Откройте '''АдминистрированиеНастройки''' > '''Интеграция''' и выберите модуль MEASOFT.# На странице «Настройки интеграции с Курьерская служба 2008» MeaSoft» перейдите на вкладку '''Доставка''' и на панели справа выберите пункт '''Способы оплаты'''.# Установите флажки для способов оплаты, которые могут использоваться для передачи наложенного платежа, и нажмите '''Сохранить '''.[[Файл:Retail5.png|none|800 1000 px]]

# Откройте '''АдминистрированиеНастройки''' > '''Интеграция''' и выберите модуль MEASOFT.# На странице «Настройки интеграции с Курьерская служба 2008» MeaSoft» перейдите на вкладку '''Доставка''' и на панели справа выберите пункт '''Статусы'''.# Настройте сопоставление статусов MeaSoft и RetailCRM. Для этого в столбце «Статус в RetailCRM» из выпадающего списка выберите соответствие для каждого статуса службы доставки. ''' [[Файл:Retail передача статусов.png|none|800 1000 px]]

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

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

## В RetailCRM выберите '''АдминистрированиеНастройки''' > '''Статусы''' и нажмите на кнопку '''Добавить'''. Откроется окно «Новый статус»: [[Файл:Rcrm trig103.png|600 px|none]]

# Выберите '''АдминистрированиеНастройки''' > '''Справочники''' > '''Типы доставок'''. Запишите символьные коды доставок, которые будут использоваться в триггере. В примере ниже используются коды outcity и incity.[[Файл:rcrm_trig104.png|600px|none]]# Откройте '''Администрирование''' > '''КоммуникацииНастройки''' > '''Триггеры''' и нажмите на кнопку '''Добавить+ Триггер'''. Откроется окно «Новый триггер».

#: В разделе '''Событие'''. Выберите нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.#: В разделе '''Условие применения триггера'''. Добавьте установите переключатель '''Редактор''' и добавьте следующий скрипт:

order.getStatus().getCode() in ["SentMeaSoft"] and order.getDeliveryType().getCode() in ["outcity","incity"]and changeSet.hasChangedField("status")

# Нажмите В разделе '''Добавить действиеДействие''' > нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:

:6. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер. :[[Файл:Новый триггер.png|600 px|none]] Триггер настроен. === Отмена заказа при смене статуса === Чтобы настроить триггер:# Cоздайте пользовательский статус заказа, при установке которого заказ будет автоматически отменяться. Можно создать любое количество статусов. ## В RetailCRM выберите '''Настройки''' > '''Статусы''' и нажмите на кнопку '''Добавить'''. Откроется окно «Новый статус»: [[Файл:Rcrm trig103.png|600 px|none]]## Заполните поля формы. В поле '''Символьный код''' используйте только цифры и латинские буквы без пробелов. Запишите созданный символьный код, он понадобится на следующих шагах.# Выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. Запишите символьные коды доставок, которые будут использоваться в триггере. В примере ниже используются коды outcity и incity.[[Файл:rcrm_trig104.png|600px|none]]# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».#:Заполните поля:#: '''Название'''. Название триггера, например «Отмена заказа в MeaSoft».#: В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.#: В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:#:<source lang="javascript">order.getStatus().getCode() in ["CancelMeaSoft"] and order.getDeliveryType().getCode() in ["outcity","incity"] and changeSet.hasChangedField("status")</source>#:где #* <code>CancelMeaSoft</code> — символьный код статуса заказа. Если нужно указать 2 статуса, напишите их через запятую в виде: <code>["CancelMeaSoft_1","CancelMeaSoft_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/cancelbystatus/retailcrm;#* '''HTTP метод''' — '''POST''';#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';# Нажмите на кнопку '''Добавить параметр''' 3 раза подряд и заполните появившиеся поля следующими данными::::{|class="wikitable"!Параметр!Значение|-|id||<nowiki>{{ order.getNumber() }}</nowiki>|-|key||<nowiki>{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</nowiki>|}::'''Примечание'''. Переносы строк не допускаются.:6. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.

Возможность отмены заказа есть только у курьерских служб с тарифом '''Премиум'''«Премиум» или «Максимум». По умолчанию она выключена, ее нужно включить в [[Личный кабинет курьерской службы#Дополнительные настройкиПараметры|личном кабинете курьерской службы]]: '''Управление ЛК''' > '''Параметры''' > '''Расширенные''' > '''Разрешить отмену и изменение заказов'''.

# В RetailCRM выберите '''АдминистрированиеНастройки''' > '''Справочники''' > '''Типы доставок'''. [[Файл:Rcrm_trig104.png|600 px|none]]

# Перейдите в раздел '''Операционная деятельностьПродажи''' и нажмите на кнопку '''Новый заказ'''. В разделе '''Доставка''' выберите тип доставки, заказы которой отправляются в MeaSoft, укажите город, вес и тариф.# В разделе '''Доставка''' появится поле '''API ключ службы доставки'''. Запишите его значение. В результате у вас есть пара «символьный код типа доставки» - — «API ключ службы доставки».

# Откройте '''Администрирование''' > '''КоммуникацииНастройки''' > '''Триггеры''' и нажмите на кнопку '''Добавить+ Триггер'''. Откроется окно «Новый триггер».

#* В разделе '''Событие'''. Выберите нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''';и нажмите на кнопку '''Добавить'''.#* В разделе '''Условие применения триггера'''. Добавьте установите переключатель '''Редактор''' и добавьте следующий скрипт:

# Нажмите В разделе '''Добавить действиеДействие''' > нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:

|sumcode||<nowiki>{{ orderchangeSet.getIntegrationDeliveryDatagetOldValue("delivery_type").getDeclaredSumgetCode() }}</nowiki>

:8. Нажмите В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.

Изменять заказ могут только курьерские службы с тарифом '''Премиум'''«Премиум» или «Максимум». По умолчанию опция выключена, ее нужно включить в [[Личный кабинет курьерской службы#Дополнительные настройкиПараметры|личном кабинете курьерской службы]]: '''Управление ЛК''' > '''Параметры''' > '''Расширенные''' > '''Разрешить отмену и изменение заказов'''.

# В RetailCRM выберите '''АдминистрированиеНастройки''' > '''Справочники''' > '''Типы доставок'''. [[Файл:Rcrm_trig104.png|600 px|none]]

# Откройте '''Администрирование''' > '''КоммуникацииНастройки''' > '''Триггеры''' и нажмите на кнопку '''Добавить+ Триггер'''. Откроется окно «Новый триггер».

#* В разделе '''Событие'''. Выберите нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''';и нажмите на кнопку '''Добавить'''.#* В разделе '''Условие применения триггера'''. Добавьте установите переключатель '''Редактор''' и добавьте следующий скрипт:

# Нажмите В разделе '''Добавить действиеДействие''' > нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:

:5. Нажмите В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.

:: Если это ошибка заполнения формы, исправьте внесенные данные и попробуйте отправить заказ снова. Пример ошибки: «Ошибка сервиса доставки "Курьерская служба 2008MeaSoft": field [receiver phone] has no valid phone number».