https://wiki.courierexe.ru/api.php?action=feedcontributions&user=%D0%91%D1%83%D1%82%D1%83%D1%81%D0%BE%D0%B2&feedformat=atomМеасофт - Вклад участника [ru]2024-03-28T15:29:27ZВклад участникаMediaWiki 1.30.0https://wiki.courierexe.ru/index.php?title=RetailCRM&diff=14968RetailCRM2024-03-26T11:48:23Z<p>Бутусов: /* Передача признака необходимости возврата */</p>
<hr />
<div>== Настройка интеграции ==<br />
<br />
# В RetailСRM cоздайте API-ключ. Для этого откройте '''Настройки''' > '''Интеграция''' > '''Ключи доступа к API''' и нажмите на кнопку '''Добавить'''. Откроется страница «Новый ключ API». На этой странице:<br />
## В поле '''Комментарий''' введите краткое описание интеграции, например «По городу».<br />
## В поле '''Тип доступа''' выберите '''Доступ ко всем магазинам'''.<br />
## В списке '''Разрешенные методы API''' установите все флажки.<br />
## Нажмите на кнопку '''Сохранить'''.<br />
#: API-ключей может быть несколько, и для каждого API-ключа необходимо выполнить эти настройки. Подробнее об управлении API-ключами см. [https://help.retailcrm.ru/Users/ApiKeys документацию RetailCRM].<br />
# Настройте интеграцию в [[Личный кабинет клиента#Интеграция|личном кабинете клиента MeaSoft]]:<br />
## Выберите пункт основного меню '''Настройки''' > '''Интеграция''', перейдите на вкладку '''Настройки интеграции''' и в списке «Все интеграции» в строке «RetailCRM» нажмите '''Добавить'''. <br />
## В окне «Настройка интеграции RetailCRM» укажите название интеграции, домен RetailCRM, созданный выше API-ключ. При необходимости укажите значения других полей. Описание некоторых полей:<br />
##* '''Получать статусы доставки''' — выберите '''Получать''', чтобы в RetailCRM передавались статусы заказа из MeaSoft. Настройки передачи статусов для RetailCRM см. в разделе [[#Передача статусов из MeaSoft|«Передача статусов из MeaSoft»]];<br />
##* '''Получать тип и сумму оплаты''' — выберите значение '''Получать''', чтобы получать тип и сумму оплаты из MeaSoft. Если тип оплаты, указанный в заказе, не совпадает с типом оплаты в MeaSoft и цена заказа не равна нулю, платеж в RetailCRM удаляется, создается новый платеж с суммой и типом оплаты из MeaSoft. Данные передаются, если в заказе осталась только одна сумма к оплате;<br />
##* '''Код поля для имени курьера''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое будет передано имя курьера. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM];<br />
##* '''Код статуса оплаты''' — укажите символьный код статуса платежа, чтобы в RetailCRM отображался статус платежа после доставки заказа. Чтобы увидеть символьный код статуса, в RetailCRM выберите '''Настройки''' > '''Справочники''' > '''Статусы оплат'''. Статус платежа передается, если на момент закрытия заказа оставалась только одна сумма к оплате;<br />
##* '''Использовать данные склада как отправителя''' — если выбрано значение '''Использовать''', данные отправителя заполняются следующей информацией о складе: адрес, название склада, телефон контактного лица ('''Настройки''' > '''Магазины''' > '''Склады''');<br />
##* '''Передавать ФИО получателя из пользовательского поля''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое вводится имя фактического получателя. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM];<br />
##* '''Передавать телефон получателя из пользовательского поля''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое вводится телефон фактического получателя. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM].<br />
##* '''Обновлять заказ при изменении''' — определяет, будет ли заказ в MeaSoft обновлен при изменении данных на стороне RetailCRM. Возможные значения: '''Да''', '''Нет'''.<br />
#: По завершении настройки нажмите '''Сохранить'''.<br />
# Настройте интеграцию в RetailCRM:<br />
## Откройте '''Настройки''' > '''Справочники''' > '''Типы доставок''' и на странице «Типы доставок» нажмите на кнопку '''Добавить'''. Откроется окно «Новая доставка»:[[Файл:Retail1.png|none|1000 px|]]<br />
## В этом окне заполните обязательные поля и в выпадающем списке '''Интегрировать с''' выберите значение '''MeaSoft'''.<br />
## Нажмите '''Сохранить'''.<br />
<br />
'''Примечание'''. Интеграция привязана к личному кабинету клиента курьерской службы. При необходимости работать из другого личного кабинета создайте новую интеграцию, начиная с пункта настройки в личном кабинете.<br />
<br />
Чтобы отправлять заказы в курьерскую службу по статусам и отменять при изменении типа доставки, используйте [[RetailCRM#Настройка триггеров|триггеры]].<br />
<br />
== Передача типа платежа в ЛК из retailCRM ==<br />
Если символьный код передаваемого платежа содержит вхождение слова "card", то платеж передается как Карта, иначе Наличные.<br />
Если заказ будет оплачен, то передается NO.<br />
<br />
<br />
== Исключение печати чеков ==<br />
В настройках интеграции есть настройка '''Не печатать чеки для способа оплаты'''.<br />
<br />
Данная настройка выводит список способов оплаты из retailCRM.<br />
<br />
Вы можете выбрать те способы оплаты, при наличии которых в заказе в систему MeaSoft будет передана нулевая цена по товарам и нулевая сумма по заказу. Это полезно для оплаты заказа безналом по счету юр.лицами и для перемещения товаров между своими складами без оплаты.<br />
<br />
== Передача наложенного платежа ==<br />
<br />
Чтобы настроить корректную передачу наложенного платежа:<br />
# Откройте '''Настройки''' > '''Интеграция''' и выберите модуль MEASOFT.<br />
# На странице «Настройки интеграции с MeaSoft» перейдите на вкладку '''Доставка''' и на панели справа выберите пункт '''Способы оплаты'''.<br />
# Установите флажки для способов оплаты, которые могут использоваться для передачи наложенного платежа, и нажмите '''Сохранить '''.[[Файл:Retail5.png|none|1000 px]]<br />
<br />
== Передача статусов из MeaSoft ==<br />
<br />
Чтобы получать статусы заказа из MeaSoft:<br />
# Откройте '''Настройки''' > '''Интеграция''' и выберите модуль MEASOFT.<br />
# На странице «Настройки интеграции с MeaSoft» перейдите на вкладку '''Доставка''' и на панели справа выберите пункт '''Статусы'''.<br />
# Настройте сопоставление статусов MeaSoft и RetailCRM. Для этого в столбце «Статус в RetailCRM» из выпадающего списка выберите соответствие для каждого статуса службы доставки. ''' [[Файл:Retail передача статусов.png|none|1000 px]]<br />
# Нажмите на кнопку '''Сохранить'''.<br />
<br />
Статус из MeaSoft в RetailCRM передается 1 раз в 30 минут. Поэтому некоторые промежуточные статусы для заказа могут быть пропущены, и будет показан последний выставленный на момент синхронизации статус заказа.<br />
<br />
== Проверка интеграции ==<br />
Чтобы проверить настройки интеграции:<br />
# Перейдите в форму создания заказа и убедитесь, что в списке '''Тип доставки''' появилось соответствующее значение:[[Файл:Retail2.png|none|1000 px]]<br />
# Нажмите '''Выбрать тариф'''. Тарифы должны передаваться из настроек курьерской службы:[[Файл:Retail3.png|none|800 px]]<br>В случае ошибки обратитесь в курьерскую службу для настройки тарифов. Проверить тарифы можно в ЛК MeaSoft в разделе '''Калькулятор'''.<br />
<br />
==Печатные формы ==<br />
<br />
Чтобы в RetailCRM формировать печатные формы, аналогичные формам в Личном кабинете MeaSoft, используйте один из следующих способов:<br />
* в сохраненном заказе на панели действий сверху нажмите '''Печать''' и выберите нужную печатную форму «Курьерская служба»;<br />
* в списке заказов отметьте заказы флажками, внизу страницы нажмите '''Действия''' > '''Распечатать документы''' и выберите печатную форму «Курьерская служба».<br />
<br />
== Настройка триггеров ==<br />
<br />
;Триггер<br />
:Хранимая процедура специального типа, автоматически выполняющаяся при наступлении заданного события.<br />
<br />
Пример: каждый месяц 1-го числа списывается абонентская плата за интернет. Триггер «1-ый день месяца» — это событие, при наступлении которого срабатывает процедура «списание абонентской платы».<br />
<br />
Триггеры используются для автоматической отправки заказов в курьерскую службу и необязательны для работы модуля. Вы можете отправлять заказы вручную, снимая флажок '''Не синхронизировать со службой доставки''' в разделе '''Доставка''' на странице заказа перед его сохранением. <br />
<br />
Для RetailCRM предусмотрены следующие триггеры:<br />
* [[Настройка триггеров для RetailCRM#Передача заказа при смене статуса|«Отправка заказа в MeaSoft»]] — при наступлении события «Смена статуса заказа на "Отправлен в MeaSoft"». При установке статуса, означающего, что заказ отправлен в курьерскую службу, срабатывает триггер, и заказ передается в MeaSoft;<br />
* [[Настройка триггеров для RetailCRM#Отмена заказа при смене типа доставки|«Отмена заказа в MeaSoft»]] — при наступлении события «Смена типа доставки у заказа». При изменении типа доставки с доставки MeaSoft на доставку, например, Почтой России, заказ в MeaSoft отменяется, если он туда передан и имеет статус «Новый» или «Ожидает синхронизации»;<br />
* [[Настройка триггеров для RetailCRM#Передача изменений заказа|«Изменения заказа в MeaSoft»]] — при наступлении события «Изменение заказа в RetailCRM». При изменении заказа в RetailCRM новые данные отправляются в MeSoft, если заказ передан и имеет статус «Новый» или «Ожидает синхронизации».<br />
<br />
'''Примечание.''' Триггеры отправки и обновления данных заказа не учитывают [[#Передача наложенного платежа|типы оплат для наложенного платежа]]. Поэтому если наложенный платеж для неоплаченного заказа равен нулю (например, при оплате на сайте), триггер все равно передаст сумму к оплате. Для корректной отправки таких заказов не используйте триггеры.<br />
<br />
=== Передача заказа при смене статуса ===<br />
<br />
Чтобы настроить триггер:<br />
# Cоздайте пользовательский статус заказа, при установке которого заказ будет автоматически передаваться в курьерскую службу. Можно создать любое количество статусов.<br />
## В RetailCRM выберите '''Настройки''' > '''Статусы''' и нажмите на кнопку '''Добавить'''. Откроется окно «Новый статус»: [[Файл:Rcrm trig103.png|600 px|none]]<br />
## Заполните поля формы. В поле '''Символьный код''' используйте только цифры и латинские буквы без пробелов. Запишите созданный символьный код, он понадобится на следующих шагах.<br />
# Выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. Запишите символьные коды доставок, которые будут использоваться в триггере. В примере ниже используются коды outcity и incity.[[Файл:rcrm_trig104.png|600px|none]]<br />
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».<br />
#:Заполните поля:<br />
#: '''Название'''. Название триггера, например «Отправка заказа в MeaSoft».<br />
#: В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.<br />
#: В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:<br />
#:<source lang="javascript"><br />
order.getStatus().getCode() in ["SentMeaSoft"] and order.getDeliveryType().getCode() in ["outcity","incity"] and changeSet.hasChangedField("status")<br />
</source><br />
#:где <br />
#* <code>SentMeaSoft</code> — символьный код статуса заказа. Если нужно указать 2 статуса, напишите их через запятую в виде: <code>["SentMeaSoft","SentMeaSoft_2"]</code> вместо <code>["SentMeaSoft"]</code>;<br />
#* <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать 1 тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.<br />
# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:<br />
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/trigger/retailcrm;<br />
#* '''HTTP метод''' — '''POST''';<br />
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';<br />
# Нажмите на кнопку '''Добавить параметр''' 3 раза подряд и заполните появившиеся поля следующими данными:<br />
:::{|class="wikitable"<br />
!Параметр<br />
!Значение<br />
|-<br />
|id||<nowiki>{{ order.getNumber() }}</nowiki><br />
|-<br />
|sum||<nowiki>{{ order.getIntegrationDeliveryData().getDeclaredSum() }}</nowiki><br />
|-<br />
|key||<nowiki>{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</nowiki><br />
|}<br />
::'''Примечание'''. Переносы строк не допускаются.<br />
:6. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.<br />
<br />
:[[Файл:Новый триггер.png|600 px|none]]<br />
<br />
Триггер настроен.<br />
<br />
=== Отмена заказа при смене статуса ===<br />
<br />
Чтобы настроить триггер:<br />
# Cоздайте пользовательский статус заказа, при установке которого заказ будет автоматически отменяться. Можно создать любое количество статусов. <br />
## В RetailCRM выберите '''Настройки''' > '''Статусы''' и нажмите на кнопку '''Добавить'''. Откроется окно «Новый статус»: [[Файл:Rcrm trig103.png|600 px|none]]<br />
## Заполните поля формы. В поле '''Символьный код''' используйте только цифры и латинские буквы без пробелов. Запишите созданный символьный код, он понадобится на следующих шагах.<br />
# Выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. Запишите символьные коды доставок, которые будут использоваться в триггере. В примере ниже используются коды outcity и incity.[[Файл:rcrm_trig104.png|600px|none]]<br />
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».<br />
#:Заполните поля:<br />
#: '''Название'''. Название триггера, например «Отмена заказа в MeaSoft».<br />
#: В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.<br />
#: В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:<br />
#:<source lang="javascript"><br />
order.getStatus().getCode() in ["CancelMeaSoft"] and order.getDeliveryType().getCode() in ["outcity","incity"] and changeSet.hasChangedField("status")<br />
</source><br />
#:где <br />
#* <code>CancelMeaSoft</code> — символьный код статуса заказа. Если нужно указать 2 статуса, напишите их через запятую в виде: <code>["CancelMeaSoft_1","CancelMeaSoft_2"]</code> вместо <code>["SentMeaSoft"]</code>;<br />
#* <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать 1 тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.<br />
# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:<br />
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/cancelbystatus/retailcrm;<br />
#* '''HTTP метод''' — '''POST''';<br />
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';<br />
# Нажмите на кнопку '''Добавить параметр''' 3 раза подряд и заполните появившиеся поля следующими данными:<br />
:::{|class="wikitable"<br />
!Параметр<br />
!Значение<br />
|-<br />
|id||<nowiki>{{ order.getNumber() }}</nowiki><br />
|-<br />
|key||<nowiki>{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</nowiki><br />
|}<br />
::'''Примечание'''. Переносы строк не допускаются.<br />
:6. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.<br />
<br />
:[[Файл:Новый триггер.png|600 px|none]]<br />
<br />
Триггер настроен.<br />
<br />
=== Отмена заказа при смене типа доставки ===<br />
<br />
Запрос отмены предназначен для заказов, которые еще не приняты в работу: не было изменений статуса доставки, статуса корреспонденции, времени доставки.<br />
<br />
Возможность отмены заказа есть только у курьерских служб с тарифом «Премиум» или «Максимум». По умолчанию она выключена, ее нужно включить в [[Личный кабинет курьерской службы#Параметры|личном кабинете курьерской службы]]: '''Управление ЛК''' > '''Параметры''' > '''Расширенные''' > '''Разрешить отмену и изменение заказов'''.<br />
<br />
При отмене заказа поле '''Инфо о доставке''' получает значение '''Отменено заказчиком''', поле '''Дата доставки''' заполняется текущей датой, а в поле '''Вручил курьер''' появляется системная запись '''Отмена'''.<br />
<br />
Чтобы настроить триггер:<br />
# В RetailCRM выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. [[Файл:Rcrm_trig104.png|600 px|none]]<br />
#: Запишите символьный код типа доставки (доставок), заказы которой отправляются в MeaSoft.<br />
# Перейдите в раздел '''Продажи''' и нажмите на кнопку '''Новый заказ'''. В разделе '''Доставка''' выберите тип доставки, заказы которой отправляются в MeaSoft, укажите город, вес и тариф.<br />
# В разделе '''Доставка''' появится поле '''API ключ службы доставки'''. Запишите его значение. В результате у вас есть пара «символьный код типа доставки» — «API ключ службы доставки».<br />
# Повторите действия пп. 2-3 для каждой доставки, заказы по которой отправляются в MeaSoft.<br />
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».<br />
#: Заполните поля:<br />
#* '''Название'''. Название триггера, например «Отмена заказа в MeaSoft»;<br />
#* В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.<br />
#* В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:<br />
#:<source lang="javascript"><br />
changeSet.hasChangedField("delivery_type") and changeSet.getOldValue("delivery_type").getCode() in ["outcity","incity"]<br />
</source><br />
#:где <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать один тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.<br />
# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:<br />
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/cancel/retailcrm;<br />
#* '''HTTP метод''' — '''POST''';<br />
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';<br />
# Нажмите на кнопку '''Добавить параметр''' 2 раза подряд и потом еще столько раз, сколько у вас сопоставленных пар «символьный код типа доставки» - «API ключ службы доставки». Заполните появившиеся поля следующими данными:<br />
:::{|class="wikitable"<br />
!Параметр<br />
!Значение<br />
|-<br />
|id||<nowiki>{{ order.getNumber() }}</nowiki><br />
|-<br />
|code||<nowiki>{{ changeSet.getOldValue("delivery_type").getCode() }}</nowiki><br />
|-<br />
|Cимвольный код типа доставки 1||API-ключ службы доставки 1<br />
|-<br />
|Cимвольный код типа доставки 2||API-ключ службы доставки 2<br />
|}<br />
::'''Примечание'''. Переносы строк не допускаются.<br />
:8. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.<br />
:[[Файл:Новый триггер2.png|600 px|none]]<br />
Триггер настроен.<br />
<br />
=== Передача изменений заказа ===<br />
<br />
Изменять заказ могут только курьерские службы с тарифом «Премиум» или «Максимум». По умолчанию опция выключена, ее нужно включить в [[Личный кабинет курьерской службы#Параметры|личном кабинете курьерской службы]]: '''Управление ЛК''' > '''Параметры''' > '''Расширенные''' > '''Разрешить отмену и изменение заказов'''.<br />
<br />
Чтобы настроить триггер:<br />
# В RetailCRM выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. [[Файл:Rcrm_trig104.png|600 px|none]]<br />
#: Запишите символьный код доставки (доставок), заказы которой отправляются в MeaSoft.<br />
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».<br />
#: Заполните поля:<br />
#* '''Название'''. Название триггера, например «Передача изменений заказа в MeaSoft»;<br />
#* В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.<br />
#* В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:<br />
#:<source lang="javascript"><br />
changeSet.isUpdate() and <br />
(<br />
changeSet.hasChangedField("first_name") or <br />
changeSet.hasChangedField("last_name") or <br />
changeSet.hasChangedField("patronymic") or <br />
changeSet.hasChangedField("phone") or <br />
changeSet.hasChangedField("site") or <br />
changeSet.hasChangedField("additional_phone") or<br />
changeSet.hasChangedField("email") or <br />
changeSet.hasChangedField("customer.phones") or <br />
changeSet.hasChangedField("order_product") or <br />
changeSet.hasChangedField("total_summ") or <br />
changeSet.hasChangedField("delivery_date") or <br />
changeSet.hasChangedField("delivery_time") or <br />
changeSet.hasChangedField("payments") or <br />
changeSet.hasChangedField("prepay_sum") or <br />
changeSet.hasChangedField("weight") or <br />
changeSet.hasChangedField("length") or <br />
changeSet.hasChangedField("width") or <br />
changeSet.hasChangedField("height") or <br />
changeSet.hasChangedField("payments.id") or <br />
changeSet.hasChangedField("payments.status") or <br />
changeSet.hasChangedField("payments.type") or <br />
changeSet.hasChangedField("payments.external_id") or <br />
changeSet.hasChangedField("payments.amount") or <br />
changeSet.hasChangedField("payments.paid_at") or <br />
changeSet.hasChangedField("payments.comment") or <br />
changeSet.hasChangedField("discount_manual_amount") or <br />
changeSet.hasChangedField("discount_manual_percent") <br />
)<br />
and <br />
order.getDeliveryType().getCode() in ["outcity","incity"]<br />
</source><br />
#:где <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать один тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.<br />
# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:<br />
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/update/retailcrm;<br />
#* '''HTTP метод''' — '''POST''';<br />
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';<br />
# Нажмите на кнопку '''Добавить параметр''' 3 раза подряд и заполните появившиеся поля следующими данными:<br />
:::{|class="wikitable"<br />
!Параметр<br />
!Значение<br />
|-<br />
|id||<nowiki>{{ order.getNumber() }}</nowiki><br />
|-<br />
|sum||<nowiki>{{ order.getIntegrationDeliveryData().getDeclaredSum() }}</nowiki><br />
|-<br />
|key||<nowiki>{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</nowiki><br />
|}<br />
::'''Примечание'''. Переносы строк не допускаются.<br />
:5. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.<br />
:[[Файл:Новый триггер3.png|600 px|none]]<br />
Триггер настроен.<br />
<br />
== Передача габаритов ==<br />
Габариты из retailCRM передаются стандартными средствами retailCRM.<br />
<br />
Они берутся, либо из раздела "Габариты и вес", либо из раздела "Упаковки", где вы можете распределить товары между упаковками, указав габариты и вес каждой упаковки.<br />
<br />
[[Файл:Gab.png|none|800 px]]<br />
<br />
Дополнительно можете изучить информацию здесь https://docs.retailcrm.ru/Users/OperatingActivity/Orders/OrderPage/WorkOrderPage/WorkDeliveryOrder раздел "Оформление упаковок"<br />
<br />
== Передача признака необходимости возврата ==<br />
1) В retailCRM создайте справочник со значениями "no", "yes", "only".<br />
<br />
[[Файл:Return.png|none|800 px]]<br />
<br />
<br />
2) В retailCRM создайте пользовательское поле с типом "Справочник". Справочником выберите справочник из 1ого пункта.<br />
<br />
[[Файл:Return2.png|none|800 px]]<br />
<br />
<br />
3) В заказе выбирайте нужный элемент справочника и он будет уходить вместе с заказом.<br />
<br />
<br />
4) В настройках интеграции в ЛК вам нужно в опции "Признак необходимости возврата" выбрать созданное вами поле.<br />
<br />
== Проверка работоспособности интеграции ==<br />
<br />
# Убедитесь, что выполнены все шаги [[RetailCRM#Настройка интеграции|инструкции по настройке интеграции]].<br />
# Если используются триггеры, убедитесь, что они настроены согласно [[RetailCRM#Настройка триггеров|инструкции]].<br />
# Создайте заказ, заполните требуемые данные.<br />
# Нажмите на кнопку '''Сохранить''' внизу страницы, флажок '''Не отправлять данные в службу доставки''' должен быть снят.<br>Заказ должен отправиться в курьерскую службу. Если заказ отправлен без ошибок и отображается в ЛК, значит интеграция настроена.<br />
# Если возникает ошибка, ее текст отображается наверху страницы.<br />
:: Если это ошибка заполнения формы, исправьте внесенные данные и попробуйте отправить заказ снова. Пример ошибки: «Ошибка сервиса доставки "MeaSoft": field [receiver phone] has no valid phone number».<br />
:: Если это ошибка ответа курьерской службы, сообщите об этом разработчику. Пример ошибки: «Служба доставки прислала ответ в неверном формате».<br />
Текст ошибки можно увидеть через [[Личный кабинет#Отладка|отладку]] в личном кабинете. Чтобы найти свой заказ в запросах, нажмите CTRL+F и введите в строку поиска номер заказа или ориентируйтесь на время создания заказа.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=RetailCRM&diff=14964RetailCRM2024-03-25T08:28:20Z<p>Бутусов: /* Передача признака необходимости возврата */</p>
<hr />
<div>== Настройка интеграции ==<br />
<br />
# В RetailСRM cоздайте API-ключ. Для этого откройте '''Настройки''' > '''Интеграция''' > '''Ключи доступа к API''' и нажмите на кнопку '''Добавить'''. Откроется страница «Новый ключ API». На этой странице:<br />
## В поле '''Комментарий''' введите краткое описание интеграции, например «По городу».<br />
## В поле '''Тип доступа''' выберите '''Доступ ко всем магазинам'''.<br />
## В списке '''Разрешенные методы API''' установите все флажки.<br />
## Нажмите на кнопку '''Сохранить'''.<br />
#: API-ключей может быть несколько, и для каждого API-ключа необходимо выполнить эти настройки. Подробнее об управлении API-ключами см. [https://help.retailcrm.ru/Users/ApiKeys документацию RetailCRM].<br />
# Настройте интеграцию в [[Личный кабинет клиента#Интеграция|личном кабинете клиента MeaSoft]]:<br />
## Выберите пункт основного меню '''Настройки''' > '''Интеграция''', перейдите на вкладку '''Настройки интеграции''' и в списке «Все интеграции» в строке «RetailCRM» нажмите '''Добавить'''. <br />
## В окне «Настройка интеграции RetailCRM» укажите название интеграции, домен RetailCRM, созданный выше API-ключ. При необходимости укажите значения других полей. Описание некоторых полей:<br />
##* '''Получать статусы доставки''' — выберите '''Получать''', чтобы в RetailCRM передавались статусы заказа из MeaSoft. Настройки передачи статусов для RetailCRM см. в разделе [[#Передача статусов из MeaSoft|«Передача статусов из MeaSoft»]];<br />
##* '''Получать тип и сумму оплаты''' — выберите значение '''Получать''', чтобы получать тип и сумму оплаты из MeaSoft. Если тип оплаты, указанный в заказе, не совпадает с типом оплаты в MeaSoft и цена заказа не равна нулю, платеж в RetailCRM удаляется, создается новый платеж с суммой и типом оплаты из MeaSoft. Данные передаются, если в заказе осталась только одна сумма к оплате;<br />
##* '''Код поля для имени курьера''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое будет передано имя курьера. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM];<br />
##* '''Код статуса оплаты''' — укажите символьный код статуса платежа, чтобы в RetailCRM отображался статус платежа после доставки заказа. Чтобы увидеть символьный код статуса, в RetailCRM выберите '''Настройки''' > '''Справочники''' > '''Статусы оплат'''. Статус платежа передается, если на момент закрытия заказа оставалась только одна сумма к оплате;<br />
##* '''Использовать данные склада как отправителя''' — если выбрано значение '''Использовать''', данные отправителя заполняются следующей информацией о складе: адрес, название склада, телефон контактного лица ('''Настройки''' > '''Магазины''' > '''Склады''');<br />
##* '''Передавать ФИО получателя из пользовательского поля''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое вводится имя фактического получателя. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM];<br />
##* '''Передавать телефон получателя из пользовательского поля''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое вводится телефон фактического получателя. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM].<br />
##* '''Обновлять заказ при изменении''' — определяет, будет ли заказ в MeaSoft обновлен при изменении данных на стороне RetailCRM. Возможные значения: '''Да''', '''Нет'''.<br />
#: По завершении настройки нажмите '''Сохранить'''.<br />
# Настройте интеграцию в RetailCRM:<br />
## Откройте '''Настройки''' > '''Справочники''' > '''Типы доставок''' и на странице «Типы доставок» нажмите на кнопку '''Добавить'''. Откроется окно «Новая доставка»:[[Файл:Retail1.png|none|1000 px|]]<br />
## В этом окне заполните обязательные поля и в выпадающем списке '''Интегрировать с''' выберите значение '''MeaSoft'''.<br />
## Нажмите '''Сохранить'''.<br />
<br />
'''Примечание'''. Интеграция привязана к личному кабинету клиента курьерской службы. При необходимости работать из другого личного кабинета создайте новую интеграцию, начиная с пункта настройки в личном кабинете.<br />
<br />
Чтобы отправлять заказы в курьерскую службу по статусам и отменять при изменении типа доставки, используйте [[RetailCRM#Настройка триггеров|триггеры]].<br />
<br />
== Передача типа платежа в ЛК из retailCRM ==<br />
Если символьный код передаваемого платежа содержит вхождение слова "card", то платеж передается как Карта, иначе Наличные.<br />
Если заказ будет оплачен, то передается NO.<br />
<br />
<br />
== Исключение печати чеков ==<br />
В настройках интеграции есть настройка '''Не печатать чеки для способа оплаты'''.<br />
<br />
Данная настройка выводит список способов оплаты из retailCRM.<br />
<br />
Вы можете выбрать те способы оплаты, при наличии которых в заказе в систему MeaSoft будет передана нулевая цена по товарам и нулевая сумма по заказу. Это полезно для оплаты заказа безналом по счету юр.лицами и для перемещения товаров между своими складами без оплаты.<br />
<br />
== Передача наложенного платежа ==<br />
<br />
Чтобы настроить корректную передачу наложенного платежа:<br />
# Откройте '''Настройки''' > '''Интеграция''' и выберите модуль MEASOFT.<br />
# На странице «Настройки интеграции с MeaSoft» перейдите на вкладку '''Доставка''' и на панели справа выберите пункт '''Способы оплаты'''.<br />
# Установите флажки для способов оплаты, которые могут использоваться для передачи наложенного платежа, и нажмите '''Сохранить '''.[[Файл:Retail5.png|none|1000 px]]<br />
<br />
== Передача статусов из MeaSoft ==<br />
<br />
Чтобы получать статусы заказа из MeaSoft:<br />
# Откройте '''Настройки''' > '''Интеграция''' и выберите модуль MEASOFT.<br />
# На странице «Настройки интеграции с MeaSoft» перейдите на вкладку '''Доставка''' и на панели справа выберите пункт '''Статусы'''.<br />
# Настройте сопоставление статусов MeaSoft и RetailCRM. Для этого в столбце «Статус в RetailCRM» из выпадающего списка выберите соответствие для каждого статуса службы доставки. ''' [[Файл:Retail передача статусов.png|none|1000 px]]<br />
# Нажмите на кнопку '''Сохранить'''.<br />
<br />
Статус из MeaSoft в RetailCRM передается 1 раз в 30 минут. Поэтому некоторые промежуточные статусы для заказа могут быть пропущены, и будет показан последний выставленный на момент синхронизации статус заказа.<br />
<br />
== Проверка интеграции ==<br />
Чтобы проверить настройки интеграции:<br />
# Перейдите в форму создания заказа и убедитесь, что в списке '''Тип доставки''' появилось соответствующее значение:[[Файл:Retail2.png|none|1000 px]]<br />
# Нажмите '''Выбрать тариф'''. Тарифы должны передаваться из настроек курьерской службы:[[Файл:Retail3.png|none|800 px]]<br>В случае ошибки обратитесь в курьерскую службу для настройки тарифов. Проверить тарифы можно в ЛК MeaSoft в разделе '''Калькулятор'''.<br />
<br />
==Печатные формы ==<br />
<br />
Чтобы в RetailCRM формировать печатные формы, аналогичные формам в Личном кабинете MeaSoft, используйте один из следующих способов:<br />
* в сохраненном заказе на панели действий сверху нажмите '''Печать''' и выберите нужную печатную форму «Курьерская служба»;<br />
* в списке заказов отметьте заказы флажками, внизу страницы нажмите '''Действия''' > '''Распечатать документы''' и выберите печатную форму «Курьерская служба».<br />
<br />
== Настройка триггеров ==<br />
<br />
;Триггер<br />
:Хранимая процедура специального типа, автоматически выполняющаяся при наступлении заданного события.<br />
<br />
Пример: каждый месяц 1-го числа списывается абонентская плата за интернет. Триггер «1-ый день месяца» — это событие, при наступлении которого срабатывает процедура «списание абонентской платы».<br />
<br />
Триггеры используются для автоматической отправки заказов в курьерскую службу и необязательны для работы модуля. Вы можете отправлять заказы вручную, снимая флажок '''Не синхронизировать со службой доставки''' в разделе '''Доставка''' на странице заказа перед его сохранением. <br />
<br />
Для RetailCRM предусмотрены следующие триггеры:<br />
* [[Настройка триггеров для RetailCRM#Передача заказа при смене статуса|«Отправка заказа в MeaSoft»]] — при наступлении события «Смена статуса заказа на "Отправлен в MeaSoft"». При установке статуса, означающего, что заказ отправлен в курьерскую службу, срабатывает триггер, и заказ передается в MeaSoft;<br />
* [[Настройка триггеров для RetailCRM#Отмена заказа при смене типа доставки|«Отмена заказа в MeaSoft»]] — при наступлении события «Смена типа доставки у заказа». При изменении типа доставки с доставки MeaSoft на доставку, например, Почтой России, заказ в MeaSoft отменяется, если он туда передан и имеет статус «Новый» или «Ожидает синхронизации»;<br />
* [[Настройка триггеров для RetailCRM#Передача изменений заказа|«Изменения заказа в MeaSoft»]] — при наступлении события «Изменение заказа в RetailCRM». При изменении заказа в RetailCRM новые данные отправляются в MeSoft, если заказ передан и имеет статус «Новый» или «Ожидает синхронизации».<br />
<br />
'''Примечание.''' Триггеры отправки и обновления данных заказа не учитывают [[#Передача наложенного платежа|типы оплат для наложенного платежа]]. Поэтому если наложенный платеж для неоплаченного заказа равен нулю (например, при оплате на сайте), триггер все равно передаст сумму к оплате. Для корректной отправки таких заказов не используйте триггеры.<br />
<br />
=== Передача заказа при смене статуса ===<br />
<br />
Чтобы настроить триггер:<br />
# Cоздайте пользовательский статус заказа, при установке которого заказ будет автоматически передаваться в курьерскую службу. Можно создать любое количество статусов.<br />
## В RetailCRM выберите '''Настройки''' > '''Статусы''' и нажмите на кнопку '''Добавить'''. Откроется окно «Новый статус»: [[Файл:Rcrm trig103.png|600 px|none]]<br />
## Заполните поля формы. В поле '''Символьный код''' используйте только цифры и латинские буквы без пробелов. Запишите созданный символьный код, он понадобится на следующих шагах.<br />
# Выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. Запишите символьные коды доставок, которые будут использоваться в триггере. В примере ниже используются коды outcity и incity.[[Файл:rcrm_trig104.png|600px|none]]<br />
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».<br />
#:Заполните поля:<br />
#: '''Название'''. Название триггера, например «Отправка заказа в MeaSoft».<br />
#: В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.<br />
#: В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:<br />
#:<source lang="javascript"><br />
order.getStatus().getCode() in ["SentMeaSoft"] and order.getDeliveryType().getCode() in ["outcity","incity"] and changeSet.hasChangedField("status")<br />
</source><br />
#:где <br />
#* <code>SentMeaSoft</code> — символьный код статуса заказа. Если нужно указать 2 статуса, напишите их через запятую в виде: <code>["SentMeaSoft","SentMeaSoft_2"]</code> вместо <code>["SentMeaSoft"]</code>;<br />
#* <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать 1 тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.<br />
# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:<br />
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/trigger/retailcrm;<br />
#* '''HTTP метод''' — '''POST''';<br />
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';<br />
# Нажмите на кнопку '''Добавить параметр''' 3 раза подряд и заполните появившиеся поля следующими данными:<br />
:::{|class="wikitable"<br />
!Параметр<br />
!Значение<br />
|-<br />
|id||<nowiki>{{ order.getNumber() }}</nowiki><br />
|-<br />
|sum||<nowiki>{{ order.getIntegrationDeliveryData().getDeclaredSum() }}</nowiki><br />
|-<br />
|key||<nowiki>{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</nowiki><br />
|}<br />
::'''Примечание'''. Переносы строк не допускаются.<br />
:6. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.<br />
<br />
:[[Файл:Новый триггер.png|600 px|none]]<br />
<br />
Триггер настроен.<br />
<br />
=== Отмена заказа при смене статуса ===<br />
<br />
Чтобы настроить триггер:<br />
# Cоздайте пользовательский статус заказа, при установке которого заказ будет автоматически отменяться. Можно создать любое количество статусов. <br />
## В RetailCRM выберите '''Настройки''' > '''Статусы''' и нажмите на кнопку '''Добавить'''. Откроется окно «Новый статус»: [[Файл:Rcrm trig103.png|600 px|none]]<br />
## Заполните поля формы. В поле '''Символьный код''' используйте только цифры и латинские буквы без пробелов. Запишите созданный символьный код, он понадобится на следующих шагах.<br />
# Выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. Запишите символьные коды доставок, которые будут использоваться в триггере. В примере ниже используются коды outcity и incity.[[Файл:rcrm_trig104.png|600px|none]]<br />
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».<br />
#:Заполните поля:<br />
#: '''Название'''. Название триггера, например «Отмена заказа в MeaSoft».<br />
#: В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.<br />
#: В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:<br />
#:<source lang="javascript"><br />
order.getStatus().getCode() in ["CancelMeaSoft"] and order.getDeliveryType().getCode() in ["outcity","incity"] and changeSet.hasChangedField("status")<br />
</source><br />
#:где <br />
#* <code>CancelMeaSoft</code> — символьный код статуса заказа. Если нужно указать 2 статуса, напишите их через запятую в виде: <code>["CancelMeaSoft_1","CancelMeaSoft_2"]</code> вместо <code>["SentMeaSoft"]</code>;<br />
#* <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать 1 тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.<br />
# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:<br />
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/cancelbystatus/retailcrm;<br />
#* '''HTTP метод''' — '''POST''';<br />
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';<br />
# Нажмите на кнопку '''Добавить параметр''' 3 раза подряд и заполните появившиеся поля следующими данными:<br />
:::{|class="wikitable"<br />
!Параметр<br />
!Значение<br />
|-<br />
|id||<nowiki>{{ order.getNumber() }}</nowiki><br />
|-<br />
|key||<nowiki>{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</nowiki><br />
|}<br />
::'''Примечание'''. Переносы строк не допускаются.<br />
:6. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.<br />
<br />
:[[Файл:Новый триггер.png|600 px|none]]<br />
<br />
Триггер настроен.<br />
<br />
=== Отмена заказа при смене типа доставки ===<br />
<br />
Запрос отмены предназначен для заказов, которые еще не приняты в работу: не было изменений статуса доставки, статуса корреспонденции, времени доставки.<br />
<br />
Возможность отмены заказа есть только у курьерских служб с тарифом «Премиум» или «Максимум». По умолчанию она выключена, ее нужно включить в [[Личный кабинет курьерской службы#Параметры|личном кабинете курьерской службы]]: '''Управление ЛК''' > '''Параметры''' > '''Расширенные''' > '''Разрешить отмену и изменение заказов'''.<br />
<br />
При отмене заказа поле '''Инфо о доставке''' получает значение '''Отменено заказчиком''', поле '''Дата доставки''' заполняется текущей датой, а в поле '''Вручил курьер''' появляется системная запись '''Отмена'''.<br />
<br />
Чтобы настроить триггер:<br />
# В RetailCRM выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. [[Файл:Rcrm_trig104.png|600 px|none]]<br />
#: Запишите символьный код типа доставки (доставок), заказы которой отправляются в MeaSoft.<br />
# Перейдите в раздел '''Продажи''' и нажмите на кнопку '''Новый заказ'''. В разделе '''Доставка''' выберите тип доставки, заказы которой отправляются в MeaSoft, укажите город, вес и тариф.<br />
# В разделе '''Доставка''' появится поле '''API ключ службы доставки'''. Запишите его значение. В результате у вас есть пара «символьный код типа доставки» — «API ключ службы доставки».<br />
# Повторите действия пп. 2-3 для каждой доставки, заказы по которой отправляются в MeaSoft.<br />
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».<br />
#: Заполните поля:<br />
#* '''Название'''. Название триггера, например «Отмена заказа в MeaSoft»;<br />
#* В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.<br />
#* В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:<br />
#:<source lang="javascript"><br />
changeSet.hasChangedField("delivery_type") and changeSet.getOldValue("delivery_type").getCode() in ["outcity","incity"]<br />
</source><br />
#:где <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать один тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.<br />
# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:<br />
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/cancel/retailcrm;<br />
#* '''HTTP метод''' — '''POST''';<br />
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';<br />
# Нажмите на кнопку '''Добавить параметр''' 2 раза подряд и потом еще столько раз, сколько у вас сопоставленных пар «символьный код типа доставки» - «API ключ службы доставки». Заполните появившиеся поля следующими данными:<br />
:::{|class="wikitable"<br />
!Параметр<br />
!Значение<br />
|-<br />
|id||<nowiki>{{ order.getNumber() }}</nowiki><br />
|-<br />
|code||<nowiki>{{ changeSet.getOldValue("delivery_type").getCode() }}</nowiki><br />
|-<br />
|Cимвольный код типа доставки 1||API-ключ службы доставки 1<br />
|-<br />
|Cимвольный код типа доставки 2||API-ключ службы доставки 2<br />
|}<br />
::'''Примечание'''. Переносы строк не допускаются.<br />
:8. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.<br />
:[[Файл:Новый триггер2.png|600 px|none]]<br />
Триггер настроен.<br />
<br />
=== Передача изменений заказа ===<br />
<br />
Изменять заказ могут только курьерские службы с тарифом «Премиум» или «Максимум». По умолчанию опция выключена, ее нужно включить в [[Личный кабинет курьерской службы#Параметры|личном кабинете курьерской службы]]: '''Управление ЛК''' > '''Параметры''' > '''Расширенные''' > '''Разрешить отмену и изменение заказов'''.<br />
<br />
Чтобы настроить триггер:<br />
# В RetailCRM выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. [[Файл:Rcrm_trig104.png|600 px|none]]<br />
#: Запишите символьный код доставки (доставок), заказы которой отправляются в MeaSoft.<br />
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».<br />
#: Заполните поля:<br />
#* '''Название'''. Название триггера, например «Передача изменений заказа в MeaSoft»;<br />
#* В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.<br />
#* В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:<br />
#:<source lang="javascript"><br />
changeSet.isUpdate() and <br />
(<br />
changeSet.hasChangedField("first_name") or <br />
changeSet.hasChangedField("last_name") or <br />
changeSet.hasChangedField("patronymic") or <br />
changeSet.hasChangedField("phone") or <br />
changeSet.hasChangedField("site") or <br />
changeSet.hasChangedField("additional_phone") or<br />
changeSet.hasChangedField("email") or <br />
changeSet.hasChangedField("customer.phones") or <br />
changeSet.hasChangedField("order_product") or <br />
changeSet.hasChangedField("total_summ") or <br />
changeSet.hasChangedField("delivery_date") or <br />
changeSet.hasChangedField("delivery_time") or <br />
changeSet.hasChangedField("payments") or <br />
changeSet.hasChangedField("prepay_sum") or <br />
changeSet.hasChangedField("weight") or <br />
changeSet.hasChangedField("length") or <br />
changeSet.hasChangedField("width") or <br />
changeSet.hasChangedField("height") or <br />
changeSet.hasChangedField("payments.id") or <br />
changeSet.hasChangedField("payments.status") or <br />
changeSet.hasChangedField("payments.type") or <br />
changeSet.hasChangedField("payments.external_id") or <br />
changeSet.hasChangedField("payments.amount") or <br />
changeSet.hasChangedField("payments.paid_at") or <br />
changeSet.hasChangedField("payments.comment") or <br />
changeSet.hasChangedField("discount_manual_amount") or <br />
changeSet.hasChangedField("discount_manual_percent") <br />
)<br />
and <br />
order.getDeliveryType().getCode() in ["outcity","incity"]<br />
</source><br />
#:где <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать один тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.<br />
# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:<br />
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/update/retailcrm;<br />
#* '''HTTP метод''' — '''POST''';<br />
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';<br />
# Нажмите на кнопку '''Добавить параметр''' 3 раза подряд и заполните появившиеся поля следующими данными:<br />
:::{|class="wikitable"<br />
!Параметр<br />
!Значение<br />
|-<br />
|id||<nowiki>{{ order.getNumber() }}</nowiki><br />
|-<br />
|sum||<nowiki>{{ order.getIntegrationDeliveryData().getDeclaredSum() }}</nowiki><br />
|-<br />
|key||<nowiki>{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</nowiki><br />
|}<br />
::'''Примечание'''. Переносы строк не допускаются.<br />
:5. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.<br />
:[[Файл:Новый триггер3.png|600 px|none]]<br />
Триггер настроен.<br />
<br />
== Передача габаритов ==<br />
Габариты из retailCRM передаются стандартными средствами retailCRM.<br />
<br />
Они берутся, либо из раздела "Габариты и вес", либо из раздела "Упаковки", где вы можете распределить товары между упаковками, указав габариты и вес каждой упаковки.<br />
<br />
[[Файл:Gab.png|none|800 px]]<br />
<br />
Дополнительно можете изучить информацию здесь https://docs.retailcrm.ru/Users/OperatingActivity/Orders/OrderPage/WorkOrderPage/WorkDeliveryOrder раздел "Оформление упаковок"<br />
<br />
== Передача признака необходимости возврата ==<br />
1) В retailCRM создайте справочник со значениями "no", "yes", "only".<br />
<br />
[[Файл:Return.png|none|800 px]]<br />
<br />
<br />
2) В retailCRM создайте пользовательское поле с типом "Справочник". Справочником выберите справочник из 1ого пункта.<br />
<br />
[[Файл:Return2.png|none|800 px]]<br />
<br />
<br />
3) В заказе выбирайте нужный элемент справочника и он будет уходить вместе с заказом.<br />
<br />
== Проверка работоспособности интеграции ==<br />
<br />
# Убедитесь, что выполнены все шаги [[RetailCRM#Настройка интеграции|инструкции по настройке интеграции]].<br />
# Если используются триггеры, убедитесь, что они настроены согласно [[RetailCRM#Настройка триггеров|инструкции]].<br />
# Создайте заказ, заполните требуемые данные.<br />
# Нажмите на кнопку '''Сохранить''' внизу страницы, флажок '''Не отправлять данные в службу доставки''' должен быть снят.<br>Заказ должен отправиться в курьерскую службу. Если заказ отправлен без ошибок и отображается в ЛК, значит интеграция настроена.<br />
# Если возникает ошибка, ее текст отображается наверху страницы.<br />
:: Если это ошибка заполнения формы, исправьте внесенные данные и попробуйте отправить заказ снова. Пример ошибки: «Ошибка сервиса доставки "MeaSoft": field [receiver phone] has no valid phone number».<br />
:: Если это ошибка ответа курьерской службы, сообщите об этом разработчику. Пример ошибки: «Служба доставки прислала ответ в неверном формате».<br />
Текст ошибки можно увидеть через [[Личный кабинет#Отладка|отладку]] в личном кабинете. Чтобы найти свой заказ в запросах, нажмите CTRL+F и введите в строку поиска номер заказа или ориентируйтесь на время создания заказа.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Return2.png&diff=14963Файл:Return2.png2024-03-25T08:27:50Z<p>Бутусов: </p>
<hr />
<div></div>Бутусовhttps://wiki.courierexe.ru/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Return.png&diff=14962Файл:Return.png2024-03-25T08:24:34Z<p>Бутусов: </p>
<hr />
<div></div>Бутусовhttps://wiki.courierexe.ru/index.php?title=RetailCRM&diff=14961RetailCRM2024-03-25T08:22:32Z<p>Бутусов: </p>
<hr />
<div>== Настройка интеграции ==<br />
<br />
# В RetailСRM cоздайте API-ключ. Для этого откройте '''Настройки''' > '''Интеграция''' > '''Ключи доступа к API''' и нажмите на кнопку '''Добавить'''. Откроется страница «Новый ключ API». На этой странице:<br />
## В поле '''Комментарий''' введите краткое описание интеграции, например «По городу».<br />
## В поле '''Тип доступа''' выберите '''Доступ ко всем магазинам'''.<br />
## В списке '''Разрешенные методы API''' установите все флажки.<br />
## Нажмите на кнопку '''Сохранить'''.<br />
#: API-ключей может быть несколько, и для каждого API-ключа необходимо выполнить эти настройки. Подробнее об управлении API-ключами см. [https://help.retailcrm.ru/Users/ApiKeys документацию RetailCRM].<br />
# Настройте интеграцию в [[Личный кабинет клиента#Интеграция|личном кабинете клиента MeaSoft]]:<br />
## Выберите пункт основного меню '''Настройки''' > '''Интеграция''', перейдите на вкладку '''Настройки интеграции''' и в списке «Все интеграции» в строке «RetailCRM» нажмите '''Добавить'''. <br />
## В окне «Настройка интеграции RetailCRM» укажите название интеграции, домен RetailCRM, созданный выше API-ключ. При необходимости укажите значения других полей. Описание некоторых полей:<br />
##* '''Получать статусы доставки''' — выберите '''Получать''', чтобы в RetailCRM передавались статусы заказа из MeaSoft. Настройки передачи статусов для RetailCRM см. в разделе [[#Передача статусов из MeaSoft|«Передача статусов из MeaSoft»]];<br />
##* '''Получать тип и сумму оплаты''' — выберите значение '''Получать''', чтобы получать тип и сумму оплаты из MeaSoft. Если тип оплаты, указанный в заказе, не совпадает с типом оплаты в MeaSoft и цена заказа не равна нулю, платеж в RetailCRM удаляется, создается новый платеж с суммой и типом оплаты из MeaSoft. Данные передаются, если в заказе осталась только одна сумма к оплате;<br />
##* '''Код поля для имени курьера''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое будет передано имя курьера. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM];<br />
##* '''Код статуса оплаты''' — укажите символьный код статуса платежа, чтобы в RetailCRM отображался статус платежа после доставки заказа. Чтобы увидеть символьный код статуса, в RetailCRM выберите '''Настройки''' > '''Справочники''' > '''Статусы оплат'''. Статус платежа передается, если на момент закрытия заказа оставалась только одна сумма к оплате;<br />
##* '''Использовать данные склада как отправителя''' — если выбрано значение '''Использовать''', данные отправителя заполняются следующей информацией о складе: адрес, название склада, телефон контактного лица ('''Настройки''' > '''Магазины''' > '''Склады''');<br />
##* '''Передавать ФИО получателя из пользовательского поля''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое вводится имя фактического получателя. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM];<br />
##* '''Передавать телефон получателя из пользовательского поля''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое вводится телефон фактического получателя. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM].<br />
##* '''Обновлять заказ при изменении''' — определяет, будет ли заказ в MeaSoft обновлен при изменении данных на стороне RetailCRM. Возможные значения: '''Да''', '''Нет'''.<br />
#: По завершении настройки нажмите '''Сохранить'''.<br />
# Настройте интеграцию в RetailCRM:<br />
## Откройте '''Настройки''' > '''Справочники''' > '''Типы доставок''' и на странице «Типы доставок» нажмите на кнопку '''Добавить'''. Откроется окно «Новая доставка»:[[Файл:Retail1.png|none|1000 px|]]<br />
## В этом окне заполните обязательные поля и в выпадающем списке '''Интегрировать с''' выберите значение '''MeaSoft'''.<br />
## Нажмите '''Сохранить'''.<br />
<br />
'''Примечание'''. Интеграция привязана к личному кабинету клиента курьерской службы. При необходимости работать из другого личного кабинета создайте новую интеграцию, начиная с пункта настройки в личном кабинете.<br />
<br />
Чтобы отправлять заказы в курьерскую службу по статусам и отменять при изменении типа доставки, используйте [[RetailCRM#Настройка триггеров|триггеры]].<br />
<br />
== Передача типа платежа в ЛК из retailCRM ==<br />
Если символьный код передаваемого платежа содержит вхождение слова "card", то платеж передается как Карта, иначе Наличные.<br />
Если заказ будет оплачен, то передается NO.<br />
<br />
<br />
== Исключение печати чеков ==<br />
В настройках интеграции есть настройка '''Не печатать чеки для способа оплаты'''.<br />
<br />
Данная настройка выводит список способов оплаты из retailCRM.<br />
<br />
Вы можете выбрать те способы оплаты, при наличии которых в заказе в систему MeaSoft будет передана нулевая цена по товарам и нулевая сумма по заказу. Это полезно для оплаты заказа безналом по счету юр.лицами и для перемещения товаров между своими складами без оплаты.<br />
<br />
== Передача наложенного платежа ==<br />
<br />
Чтобы настроить корректную передачу наложенного платежа:<br />
# Откройте '''Настройки''' > '''Интеграция''' и выберите модуль MEASOFT.<br />
# На странице «Настройки интеграции с MeaSoft» перейдите на вкладку '''Доставка''' и на панели справа выберите пункт '''Способы оплаты'''.<br />
# Установите флажки для способов оплаты, которые могут использоваться для передачи наложенного платежа, и нажмите '''Сохранить '''.[[Файл:Retail5.png|none|1000 px]]<br />
<br />
== Передача статусов из MeaSoft ==<br />
<br />
Чтобы получать статусы заказа из MeaSoft:<br />
# Откройте '''Настройки''' > '''Интеграция''' и выберите модуль MEASOFT.<br />
# На странице «Настройки интеграции с MeaSoft» перейдите на вкладку '''Доставка''' и на панели справа выберите пункт '''Статусы'''.<br />
# Настройте сопоставление статусов MeaSoft и RetailCRM. Для этого в столбце «Статус в RetailCRM» из выпадающего списка выберите соответствие для каждого статуса службы доставки. ''' [[Файл:Retail передача статусов.png|none|1000 px]]<br />
# Нажмите на кнопку '''Сохранить'''.<br />
<br />
Статус из MeaSoft в RetailCRM передается 1 раз в 30 минут. Поэтому некоторые промежуточные статусы для заказа могут быть пропущены, и будет показан последний выставленный на момент синхронизации статус заказа.<br />
<br />
== Проверка интеграции ==<br />
Чтобы проверить настройки интеграции:<br />
# Перейдите в форму создания заказа и убедитесь, что в списке '''Тип доставки''' появилось соответствующее значение:[[Файл:Retail2.png|none|1000 px]]<br />
# Нажмите '''Выбрать тариф'''. Тарифы должны передаваться из настроек курьерской службы:[[Файл:Retail3.png|none|800 px]]<br>В случае ошибки обратитесь в курьерскую службу для настройки тарифов. Проверить тарифы можно в ЛК MeaSoft в разделе '''Калькулятор'''.<br />
<br />
==Печатные формы ==<br />
<br />
Чтобы в RetailCRM формировать печатные формы, аналогичные формам в Личном кабинете MeaSoft, используйте один из следующих способов:<br />
* в сохраненном заказе на панели действий сверху нажмите '''Печать''' и выберите нужную печатную форму «Курьерская служба»;<br />
* в списке заказов отметьте заказы флажками, внизу страницы нажмите '''Действия''' > '''Распечатать документы''' и выберите печатную форму «Курьерская служба».<br />
<br />
== Настройка триггеров ==<br />
<br />
;Триггер<br />
:Хранимая процедура специального типа, автоматически выполняющаяся при наступлении заданного события.<br />
<br />
Пример: каждый месяц 1-го числа списывается абонентская плата за интернет. Триггер «1-ый день месяца» — это событие, при наступлении которого срабатывает процедура «списание абонентской платы».<br />
<br />
Триггеры используются для автоматической отправки заказов в курьерскую службу и необязательны для работы модуля. Вы можете отправлять заказы вручную, снимая флажок '''Не синхронизировать со службой доставки''' в разделе '''Доставка''' на странице заказа перед его сохранением. <br />
<br />
Для RetailCRM предусмотрены следующие триггеры:<br />
* [[Настройка триггеров для RetailCRM#Передача заказа при смене статуса|«Отправка заказа в MeaSoft»]] — при наступлении события «Смена статуса заказа на "Отправлен в MeaSoft"». При установке статуса, означающего, что заказ отправлен в курьерскую службу, срабатывает триггер, и заказ передается в MeaSoft;<br />
* [[Настройка триггеров для RetailCRM#Отмена заказа при смене типа доставки|«Отмена заказа в MeaSoft»]] — при наступлении события «Смена типа доставки у заказа». При изменении типа доставки с доставки MeaSoft на доставку, например, Почтой России, заказ в MeaSoft отменяется, если он туда передан и имеет статус «Новый» или «Ожидает синхронизации»;<br />
* [[Настройка триггеров для RetailCRM#Передача изменений заказа|«Изменения заказа в MeaSoft»]] — при наступлении события «Изменение заказа в RetailCRM». При изменении заказа в RetailCRM новые данные отправляются в MeSoft, если заказ передан и имеет статус «Новый» или «Ожидает синхронизации».<br />
<br />
'''Примечание.''' Триггеры отправки и обновления данных заказа не учитывают [[#Передача наложенного платежа|типы оплат для наложенного платежа]]. Поэтому если наложенный платеж для неоплаченного заказа равен нулю (например, при оплате на сайте), триггер все равно передаст сумму к оплате. Для корректной отправки таких заказов не используйте триггеры.<br />
<br />
=== Передача заказа при смене статуса ===<br />
<br />
Чтобы настроить триггер:<br />
# Cоздайте пользовательский статус заказа, при установке которого заказ будет автоматически передаваться в курьерскую службу. Можно создать любое количество статусов.<br />
## В RetailCRM выберите '''Настройки''' > '''Статусы''' и нажмите на кнопку '''Добавить'''. Откроется окно «Новый статус»: [[Файл:Rcrm trig103.png|600 px|none]]<br />
## Заполните поля формы. В поле '''Символьный код''' используйте только цифры и латинские буквы без пробелов. Запишите созданный символьный код, он понадобится на следующих шагах.<br />
# Выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. Запишите символьные коды доставок, которые будут использоваться в триггере. В примере ниже используются коды outcity и incity.[[Файл:rcrm_trig104.png|600px|none]]<br />
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».<br />
#:Заполните поля:<br />
#: '''Название'''. Название триггера, например «Отправка заказа в MeaSoft».<br />
#: В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.<br />
#: В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:<br />
#:<source lang="javascript"><br />
order.getStatus().getCode() in ["SentMeaSoft"] and order.getDeliveryType().getCode() in ["outcity","incity"] and changeSet.hasChangedField("status")<br />
</source><br />
#:где <br />
#* <code>SentMeaSoft</code> — символьный код статуса заказа. Если нужно указать 2 статуса, напишите их через запятую в виде: <code>["SentMeaSoft","SentMeaSoft_2"]</code> вместо <code>["SentMeaSoft"]</code>;<br />
#* <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать 1 тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.<br />
# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:<br />
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/trigger/retailcrm;<br />
#* '''HTTP метод''' — '''POST''';<br />
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';<br />
# Нажмите на кнопку '''Добавить параметр''' 3 раза подряд и заполните появившиеся поля следующими данными:<br />
:::{|class="wikitable"<br />
!Параметр<br />
!Значение<br />
|-<br />
|id||<nowiki>{{ order.getNumber() }}</nowiki><br />
|-<br />
|sum||<nowiki>{{ order.getIntegrationDeliveryData().getDeclaredSum() }}</nowiki><br />
|-<br />
|key||<nowiki>{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</nowiki><br />
|}<br />
::'''Примечание'''. Переносы строк не допускаются.<br />
:6. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.<br />
<br />
:[[Файл:Новый триггер.png|600 px|none]]<br />
<br />
Триггер настроен.<br />
<br />
=== Отмена заказа при смене статуса ===<br />
<br />
Чтобы настроить триггер:<br />
# Cоздайте пользовательский статус заказа, при установке которого заказ будет автоматически отменяться. Можно создать любое количество статусов. <br />
## В RetailCRM выберите '''Настройки''' > '''Статусы''' и нажмите на кнопку '''Добавить'''. Откроется окно «Новый статус»: [[Файл:Rcrm trig103.png|600 px|none]]<br />
## Заполните поля формы. В поле '''Символьный код''' используйте только цифры и латинские буквы без пробелов. Запишите созданный символьный код, он понадобится на следующих шагах.<br />
# Выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. Запишите символьные коды доставок, которые будут использоваться в триггере. В примере ниже используются коды outcity и incity.[[Файл:rcrm_trig104.png|600px|none]]<br />
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».<br />
#:Заполните поля:<br />
#: '''Название'''. Название триггера, например «Отмена заказа в MeaSoft».<br />
#: В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.<br />
#: В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:<br />
#:<source lang="javascript"><br />
order.getStatus().getCode() in ["CancelMeaSoft"] and order.getDeliveryType().getCode() in ["outcity","incity"] and changeSet.hasChangedField("status")<br />
</source><br />
#:где <br />
#* <code>CancelMeaSoft</code> — символьный код статуса заказа. Если нужно указать 2 статуса, напишите их через запятую в виде: <code>["CancelMeaSoft_1","CancelMeaSoft_2"]</code> вместо <code>["SentMeaSoft"]</code>;<br />
#* <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать 1 тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.<br />
# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:<br />
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/cancelbystatus/retailcrm;<br />
#* '''HTTP метод''' — '''POST''';<br />
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';<br />
# Нажмите на кнопку '''Добавить параметр''' 3 раза подряд и заполните появившиеся поля следующими данными:<br />
:::{|class="wikitable"<br />
!Параметр<br />
!Значение<br />
|-<br />
|id||<nowiki>{{ order.getNumber() }}</nowiki><br />
|-<br />
|key||<nowiki>{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</nowiki><br />
|}<br />
::'''Примечание'''. Переносы строк не допускаются.<br />
:6. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.<br />
<br />
:[[Файл:Новый триггер.png|600 px|none]]<br />
<br />
Триггер настроен.<br />
<br />
=== Отмена заказа при смене типа доставки ===<br />
<br />
Запрос отмены предназначен для заказов, которые еще не приняты в работу: не было изменений статуса доставки, статуса корреспонденции, времени доставки.<br />
<br />
Возможность отмены заказа есть только у курьерских служб с тарифом «Премиум» или «Максимум». По умолчанию она выключена, ее нужно включить в [[Личный кабинет курьерской службы#Параметры|личном кабинете курьерской службы]]: '''Управление ЛК''' > '''Параметры''' > '''Расширенные''' > '''Разрешить отмену и изменение заказов'''.<br />
<br />
При отмене заказа поле '''Инфо о доставке''' получает значение '''Отменено заказчиком''', поле '''Дата доставки''' заполняется текущей датой, а в поле '''Вручил курьер''' появляется системная запись '''Отмена'''.<br />
<br />
Чтобы настроить триггер:<br />
# В RetailCRM выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. [[Файл:Rcrm_trig104.png|600 px|none]]<br />
#: Запишите символьный код типа доставки (доставок), заказы которой отправляются в MeaSoft.<br />
# Перейдите в раздел '''Продажи''' и нажмите на кнопку '''Новый заказ'''. В разделе '''Доставка''' выберите тип доставки, заказы которой отправляются в MeaSoft, укажите город, вес и тариф.<br />
# В разделе '''Доставка''' появится поле '''API ключ службы доставки'''. Запишите его значение. В результате у вас есть пара «символьный код типа доставки» — «API ключ службы доставки».<br />
# Повторите действия пп. 2-3 для каждой доставки, заказы по которой отправляются в MeaSoft.<br />
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».<br />
#: Заполните поля:<br />
#* '''Название'''. Название триггера, например «Отмена заказа в MeaSoft»;<br />
#* В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.<br />
#* В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:<br />
#:<source lang="javascript"><br />
changeSet.hasChangedField("delivery_type") and changeSet.getOldValue("delivery_type").getCode() in ["outcity","incity"]<br />
</source><br />
#:где <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать один тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.<br />
# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:<br />
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/cancel/retailcrm;<br />
#* '''HTTP метод''' — '''POST''';<br />
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';<br />
# Нажмите на кнопку '''Добавить параметр''' 2 раза подряд и потом еще столько раз, сколько у вас сопоставленных пар «символьный код типа доставки» - «API ключ службы доставки». Заполните появившиеся поля следующими данными:<br />
:::{|class="wikitable"<br />
!Параметр<br />
!Значение<br />
|-<br />
|id||<nowiki>{{ order.getNumber() }}</nowiki><br />
|-<br />
|code||<nowiki>{{ changeSet.getOldValue("delivery_type").getCode() }}</nowiki><br />
|-<br />
|Cимвольный код типа доставки 1||API-ключ службы доставки 1<br />
|-<br />
|Cимвольный код типа доставки 2||API-ключ службы доставки 2<br />
|}<br />
::'''Примечание'''. Переносы строк не допускаются.<br />
:8. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.<br />
:[[Файл:Новый триггер2.png|600 px|none]]<br />
Триггер настроен.<br />
<br />
=== Передача изменений заказа ===<br />
<br />
Изменять заказ могут только курьерские службы с тарифом «Премиум» или «Максимум». По умолчанию опция выключена, ее нужно включить в [[Личный кабинет курьерской службы#Параметры|личном кабинете курьерской службы]]: '''Управление ЛК''' > '''Параметры''' > '''Расширенные''' > '''Разрешить отмену и изменение заказов'''.<br />
<br />
Чтобы настроить триггер:<br />
# В RetailCRM выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. [[Файл:Rcrm_trig104.png|600 px|none]]<br />
#: Запишите символьный код доставки (доставок), заказы которой отправляются в MeaSoft.<br />
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».<br />
#: Заполните поля:<br />
#* '''Название'''. Название триггера, например «Передача изменений заказа в MeaSoft»;<br />
#* В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.<br />
#* В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:<br />
#:<source lang="javascript"><br />
changeSet.isUpdate() and <br />
(<br />
changeSet.hasChangedField("first_name") or <br />
changeSet.hasChangedField("last_name") or <br />
changeSet.hasChangedField("patronymic") or <br />
changeSet.hasChangedField("phone") or <br />
changeSet.hasChangedField("site") or <br />
changeSet.hasChangedField("additional_phone") or<br />
changeSet.hasChangedField("email") or <br />
changeSet.hasChangedField("customer.phones") or <br />
changeSet.hasChangedField("order_product") or <br />
changeSet.hasChangedField("total_summ") or <br />
changeSet.hasChangedField("delivery_date") or <br />
changeSet.hasChangedField("delivery_time") or <br />
changeSet.hasChangedField("payments") or <br />
changeSet.hasChangedField("prepay_sum") or <br />
changeSet.hasChangedField("weight") or <br />
changeSet.hasChangedField("length") or <br />
changeSet.hasChangedField("width") or <br />
changeSet.hasChangedField("height") or <br />
changeSet.hasChangedField("payments.id") or <br />
changeSet.hasChangedField("payments.status") or <br />
changeSet.hasChangedField("payments.type") or <br />
changeSet.hasChangedField("payments.external_id") or <br />
changeSet.hasChangedField("payments.amount") or <br />
changeSet.hasChangedField("payments.paid_at") or <br />
changeSet.hasChangedField("payments.comment") or <br />
changeSet.hasChangedField("discount_manual_amount") or <br />
changeSet.hasChangedField("discount_manual_percent") <br />
)<br />
and <br />
order.getDeliveryType().getCode() in ["outcity","incity"]<br />
</source><br />
#:где <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать один тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.<br />
# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:<br />
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/update/retailcrm;<br />
#* '''HTTP метод''' — '''POST''';<br />
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';<br />
# Нажмите на кнопку '''Добавить параметр''' 3 раза подряд и заполните появившиеся поля следующими данными:<br />
:::{|class="wikitable"<br />
!Параметр<br />
!Значение<br />
|-<br />
|id||<nowiki>{{ order.getNumber() }}</nowiki><br />
|-<br />
|sum||<nowiki>{{ order.getIntegrationDeliveryData().getDeclaredSum() }}</nowiki><br />
|-<br />
|key||<nowiki>{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</nowiki><br />
|}<br />
::'''Примечание'''. Переносы строк не допускаются.<br />
:5. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.<br />
:[[Файл:Новый триггер3.png|600 px|none]]<br />
Триггер настроен.<br />
<br />
== Передача габаритов ==<br />
Габариты из retailCRM передаются стандартными средствами retailCRM.<br />
<br />
Они берутся, либо из раздела "Габариты и вес", либо из раздела "Упаковки", где вы можете распределить товары между упаковками, указав габариты и вес каждой упаковки.<br />
<br />
[[Файл:Gab.png|none|800 px]]<br />
<br />
Дополнительно можете изучить информацию здесь https://docs.retailcrm.ru/Users/OperatingActivity/Orders/OrderPage/WorkOrderPage/WorkDeliveryOrder раздел "Оформление упаковок"<br />
<br />
== Передача признака необходимости возврата ==<br />
1) В retailCRM создайте справочник со значениями "no", "yes", "only".<br />
<br />
2) В retailCRM создайте пользовательское поле с типом "Справочник". Справочником выберите справочник из 1ого пункта.<br />
<br />
3) В заказе выбирайте нужный элемент справочника и он будет уходить вместе с заказом.<br />
<br />
== Проверка работоспособности интеграции ==<br />
<br />
# Убедитесь, что выполнены все шаги [[RetailCRM#Настройка интеграции|инструкции по настройке интеграции]].<br />
# Если используются триггеры, убедитесь, что они настроены согласно [[RetailCRM#Настройка триггеров|инструкции]].<br />
# Создайте заказ, заполните требуемые данные.<br />
# Нажмите на кнопку '''Сохранить''' внизу страницы, флажок '''Не отправлять данные в службу доставки''' должен быть снят.<br>Заказ должен отправиться в курьерскую службу. Если заказ отправлен без ошибок и отображается в ЛК, значит интеграция настроена.<br />
# Если возникает ошибка, ее текст отображается наверху страницы.<br />
:: Если это ошибка заполнения формы, исправьте внесенные данные и попробуйте отправить заказ снова. Пример ошибки: «Ошибка сервиса доставки "MeaSoft": field [receiver phone] has no valid phone number».<br />
:: Если это ошибка ответа курьерской службы, сообщите об этом разработчику. Пример ошибки: «Служба доставки прислала ответ в неверном формате».<br />
Текст ошибки можно увидеть через [[Личный кабинет#Отладка|отладку]] в личном кабинете. Чтобы найти свой заказ в запросах, нажмите CTRL+F и введите в строку поиска номер заказа или ориентируйтесь на время создания заказа.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=RetailCRM&diff=14935RetailCRM2024-02-19T06:36:21Z<p>Бутусов: </p>
<hr />
<div>== Настройка интеграции ==<br />
<br />
# В RetailСRM cоздайте API-ключ. Для этого откройте '''Настройки''' > '''Интеграция''' > '''Ключи доступа к API''' и нажмите на кнопку '''Добавить'''. Откроется страница «Новый ключ API». На этой странице:<br />
## В поле '''Комментарий''' введите краткое описание интеграции, например «По городу».<br />
## В поле '''Тип доступа''' выберите '''Доступ ко всем магазинам'''.<br />
## В списке '''Разрешенные методы API''' установите все флажки.<br />
## Нажмите на кнопку '''Сохранить'''.<br />
#: API-ключей может быть несколько, и для каждого API-ключа необходимо выполнить эти настройки. Подробнее об управлении API-ключами см. [https://help.retailcrm.ru/Users/ApiKeys документацию RetailCRM].<br />
# Настройте интеграцию в [[Личный кабинет клиента#Интеграция|личном кабинете клиента MeaSoft]]:<br />
## Выберите пункт основного меню '''Настройки''' > '''Интеграция''', перейдите на вкладку '''Настройки интеграции''' и в списке «Все интеграции» в строке «RetailCRM» нажмите '''Добавить'''. <br />
## В окне «Настройка интеграции RetailCRM» укажите название интеграции, домен RetailCRM, созданный выше API-ключ. При необходимости укажите значения других полей. Описание некоторых полей:<br />
##* '''Получать статусы доставки''' — выберите '''Получать''', чтобы в RetailCRM передавались статусы заказа из MeaSoft. Настройки передачи статусов для RetailCRM см. в разделе [[#Передача статусов из MeaSoft|«Передача статусов из MeaSoft»]];<br />
##* '''Получать тип и сумму оплаты''' — выберите значение '''Получать''', чтобы получать тип и сумму оплаты из MeaSoft. Если тип оплаты, указанный в заказе, не совпадает с типом оплаты в MeaSoft и цена заказа не равна нулю, платеж в RetailCRM удаляется, создается новый платеж с суммой и типом оплаты из MeaSoft. Данные передаются, если в заказе осталась только одна сумма к оплате;<br />
##* '''Код поля для имени курьера''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое будет передано имя курьера. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM];<br />
##* '''Код статуса оплаты''' — укажите символьный код статуса платежа, чтобы в RetailCRM отображался статус платежа после доставки заказа. Чтобы увидеть символьный код статуса, в RetailCRM выберите '''Настройки''' > '''Справочники''' > '''Статусы оплат'''. Статус платежа передается, если на момент закрытия заказа оставалась только одна сумма к оплате;<br />
##* '''Использовать данные склада как отправителя''' — если выбрано значение '''Использовать''', данные отправителя заполняются следующей информацией о складе: адрес, название склада, телефон контактного лица ('''Настройки''' > '''Магазины''' > '''Склады''');<br />
##* '''Передавать ФИО получателя из пользовательского поля''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое вводится имя фактического получателя. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM];<br />
##* '''Передавать телефон получателя из пользовательского поля''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое вводится телефон фактического получателя. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM].<br />
##* '''Обновлять заказ при изменении''' — определяет, будет ли заказ в MeaSoft обновлен при изменении данных на стороне RetailCRM. Возможные значения: '''Да''', '''Нет'''.<br />
#: По завершении настройки нажмите '''Сохранить'''.<br />
# Настройте интеграцию в RetailCRM:<br />
## Откройте '''Настройки''' > '''Справочники''' > '''Типы доставок''' и на странице «Типы доставок» нажмите на кнопку '''Добавить'''. Откроется окно «Новая доставка»:[[Файл:Retail1.png|none|1000 px|]]<br />
## В этом окне заполните обязательные поля и в выпадающем списке '''Интегрировать с''' выберите значение '''MeaSoft'''.<br />
## Нажмите '''Сохранить'''.<br />
<br />
'''Примечание'''. Интеграция привязана к личному кабинету клиента курьерской службы. При необходимости работать из другого личного кабинета создайте новую интеграцию, начиная с пункта настройки в личном кабинете.<br />
<br />
Чтобы отправлять заказы в курьерскую службу по статусам и отменять при изменении типа доставки, используйте [[RetailCRM#Настройка триггеров|триггеры]].<br />
<br />
== Передача типа платежа в ЛК из retailCRM ==<br />
Если символьный код передаваемого платежа содержит вхождение слова "card", то платеж передается как Карта, иначе Наличные.<br />
Если заказ будет оплачен, то передается NO.<br />
<br />
<br />
== Исключение печати чеков ==<br />
В настройках интеграции есть настройка '''Не печатать чеки для способа оплаты'''.<br />
<br />
Данная настройка выводит список способов оплаты из retailCRM.<br />
<br />
Вы можете выбрать те способы оплаты, при наличии которых в заказе в систему MeaSoft будет передана нулевая цена по товарам и нулевая сумма по заказу. Это полезно для оплаты заказа безналом по счету юр.лицами и для перемещения товаров между своими складами без оплаты.<br />
<br />
== Передача наложенного платежа ==<br />
<br />
Чтобы настроить корректную передачу наложенного платежа:<br />
# Откройте '''Настройки''' > '''Интеграция''' и выберите модуль MEASOFT.<br />
# На странице «Настройки интеграции с MeaSoft» перейдите на вкладку '''Доставка''' и на панели справа выберите пункт '''Способы оплаты'''.<br />
# Установите флажки для способов оплаты, которые могут использоваться для передачи наложенного платежа, и нажмите '''Сохранить '''.[[Файл:Retail5.png|none|1000 px]]<br />
<br />
== Передача статусов из MeaSoft ==<br />
<br />
Чтобы получать статусы заказа из MeaSoft:<br />
# Откройте '''Настройки''' > '''Интеграция''' и выберите модуль MEASOFT.<br />
# На странице «Настройки интеграции с MeaSoft» перейдите на вкладку '''Доставка''' и на панели справа выберите пункт '''Статусы'''.<br />
# Настройте сопоставление статусов MeaSoft и RetailCRM. Для этого в столбце «Статус в RetailCRM» из выпадающего списка выберите соответствие для каждого статуса службы доставки. ''' [[Файл:Retail передача статусов.png|none|1000 px]]<br />
# Нажмите на кнопку '''Сохранить'''.<br />
<br />
Статус из MeaSoft в RetailCRM передается 1 раз в 30 минут. Поэтому некоторые промежуточные статусы для заказа могут быть пропущены, и будет показан последний выставленный на момент синхронизации статус заказа.<br />
<br />
== Проверка интеграции ==<br />
Чтобы проверить настройки интеграции:<br />
# Перейдите в форму создания заказа и убедитесь, что в списке '''Тип доставки''' появилось соответствующее значение:[[Файл:Retail2.png|none|1000 px]]<br />
# Нажмите '''Выбрать тариф'''. Тарифы должны передаваться из настроек курьерской службы:[[Файл:Retail3.png|none|800 px]]<br>В случае ошибки обратитесь в курьерскую службу для настройки тарифов. Проверить тарифы можно в ЛК MeaSoft в разделе '''Калькулятор'''.<br />
<br />
==Печатные формы ==<br />
<br />
Чтобы в RetailCRM формировать печатные формы, аналогичные формам в Личном кабинете MeaSoft, используйте один из следующих способов:<br />
* в сохраненном заказе на панели действий сверху нажмите '''Печать''' и выберите нужную печатную форму «Курьерская служба»;<br />
* в списке заказов отметьте заказы флажками, внизу страницы нажмите '''Действия''' > '''Распечатать документы''' и выберите печатную форму «Курьерская служба».<br />
<br />
== Настройка триггеров ==<br />
<br />
;Триггер<br />
:Хранимая процедура специального типа, автоматически выполняющаяся при наступлении заданного события.<br />
<br />
Пример: каждый месяц 1-го числа списывается абонентская плата за интернет. Триггер «1-ый день месяца» — это событие, при наступлении которого срабатывает процедура «списание абонентской платы».<br />
<br />
Триггеры используются для автоматической отправки заказов в курьерскую службу и необязательны для работы модуля. Вы можете отправлять заказы вручную, снимая флажок '''Не синхронизировать со службой доставки''' в разделе '''Доставка''' на странице заказа перед его сохранением. <br />
<br />
Для RetailCRM предусмотрены следующие триггеры:<br />
* [[Настройка триггеров для RetailCRM#Передача заказа при смене статуса|«Отправка заказа в MeaSoft»]] — при наступлении события «Смена статуса заказа на "Отправлен в MeaSoft"». При установке статуса, означающего, что заказ отправлен в курьерскую службу, срабатывает триггер, и заказ передается в MeaSoft;<br />
* [[Настройка триггеров для RetailCRM#Отмена заказа при смене типа доставки|«Отмена заказа в MeaSoft»]] — при наступлении события «Смена типа доставки у заказа». При изменении типа доставки с доставки MeaSoft на доставку, например, Почтой России, заказ в MeaSoft отменяется, если он туда передан и имеет статус «Новый» или «Ожидает синхронизации»;<br />
* [[Настройка триггеров для RetailCRM#Передача изменений заказа|«Изменения заказа в MeaSoft»]] — при наступлении события «Изменение заказа в RetailCRM». При изменении заказа в RetailCRM новые данные отправляются в MeSoft, если заказ передан и имеет статус «Новый» или «Ожидает синхронизации».<br />
<br />
'''Примечание.''' Триггеры отправки и обновления данных заказа не учитывают [[#Передача наложенного платежа|типы оплат для наложенного платежа]]. Поэтому если наложенный платеж для неоплаченного заказа равен нулю (например, при оплате на сайте), триггер все равно передаст сумму к оплате. Для корректной отправки таких заказов не используйте триггеры.<br />
<br />
=== Передача заказа при смене статуса ===<br />
<br />
Чтобы настроить триггер:<br />
# Cоздайте пользовательский статус заказа, при установке которого заказ будет автоматически передаваться в курьерскую службу. Можно создать любое количество статусов.<br />
## В RetailCRM выберите '''Настройки''' > '''Статусы''' и нажмите на кнопку '''Добавить'''. Откроется окно «Новый статус»: [[Файл:Rcrm trig103.png|600 px|none]]<br />
## Заполните поля формы. В поле '''Символьный код''' используйте только цифры и латинские буквы без пробелов. Запишите созданный символьный код, он понадобится на следующих шагах.<br />
# Выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. Запишите символьные коды доставок, которые будут использоваться в триггере. В примере ниже используются коды outcity и incity.[[Файл:rcrm_trig104.png|600px|none]]<br />
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».<br />
#:Заполните поля:<br />
#: '''Название'''. Название триггера, например «Отправка заказа в MeaSoft».<br />
#: В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.<br />
#: В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:<br />
#:<source lang="javascript"><br />
order.getStatus().getCode() in ["SentMeaSoft"] and order.getDeliveryType().getCode() in ["outcity","incity"] and changeSet.hasChangedField("status")<br />
</source><br />
#:где <br />
#* <code>SentMeaSoft</code> — символьный код статуса заказа. Если нужно указать 2 статуса, напишите их через запятую в виде: <code>["SentMeaSoft","SentMeaSoft_2"]</code> вместо <code>["SentMeaSoft"]</code>;<br />
#* <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать 1 тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.<br />
# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:<br />
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/trigger/retailcrm;<br />
#* '''HTTP метод''' — '''POST''';<br />
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';<br />
# Нажмите на кнопку '''Добавить параметр''' 3 раза подряд и заполните появившиеся поля следующими данными:<br />
:::{|class="wikitable"<br />
!Параметр<br />
!Значение<br />
|-<br />
|id||<nowiki>{{ order.getNumber() }}</nowiki><br />
|-<br />
|sum||<nowiki>{{ order.getIntegrationDeliveryData().getDeclaredSum() }}</nowiki><br />
|-<br />
|key||<nowiki>{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</nowiki><br />
|}<br />
::'''Примечание'''. Переносы строк не допускаются.<br />
:6. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.<br />
<br />
:[[Файл:Новый триггер.png|600 px|none]]<br />
<br />
Триггер настроен.<br />
<br />
=== Отмена заказа при смене статуса ===<br />
<br />
Чтобы настроить триггер:<br />
# Cоздайте пользовательский статус заказа, при установке которого заказ будет автоматически отменяться. Можно создать любое количество статусов. <br />
## В RetailCRM выберите '''Настройки''' > '''Статусы''' и нажмите на кнопку '''Добавить'''. Откроется окно «Новый статус»: [[Файл:Rcrm trig103.png|600 px|none]]<br />
## Заполните поля формы. В поле '''Символьный код''' используйте только цифры и латинские буквы без пробелов. Запишите созданный символьный код, он понадобится на следующих шагах.<br />
# Выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. Запишите символьные коды доставок, которые будут использоваться в триггере. В примере ниже используются коды outcity и incity.[[Файл:rcrm_trig104.png|600px|none]]<br />
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».<br />
#:Заполните поля:<br />
#: '''Название'''. Название триггера, например «Отмена заказа в MeaSoft».<br />
#: В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.<br />
#: В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:<br />
#:<source lang="javascript"><br />
order.getStatus().getCode() in ["CancelMeaSoft"] and order.getDeliveryType().getCode() in ["outcity","incity"] and changeSet.hasChangedField("status")<br />
</source><br />
#:где <br />
#* <code>CancelMeaSoft</code> — символьный код статуса заказа. Если нужно указать 2 статуса, напишите их через запятую в виде: <code>["CancelMeaSoft_1","CancelMeaSoft_2"]</code> вместо <code>["SentMeaSoft"]</code>;<br />
#* <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать 1 тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.<br />
# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:<br />
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/cancelbystatus/retailcrm;<br />
#* '''HTTP метод''' — '''POST''';<br />
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';<br />
# Нажмите на кнопку '''Добавить параметр''' 3 раза подряд и заполните появившиеся поля следующими данными:<br />
:::{|class="wikitable"<br />
!Параметр<br />
!Значение<br />
|-<br />
|id||<nowiki>{{ order.getNumber() }}</nowiki><br />
|-<br />
|key||<nowiki>{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</nowiki><br />
|}<br />
::'''Примечание'''. Переносы строк не допускаются.<br />
:6. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.<br />
<br />
:[[Файл:Новый триггер.png|600 px|none]]<br />
<br />
Триггер настроен.<br />
<br />
=== Отмена заказа при смене типа доставки ===<br />
<br />
Запрос отмены предназначен для заказов, которые еще не приняты в работу: не было изменений статуса доставки, статуса корреспонденции, времени доставки.<br />
<br />
Возможность отмены заказа есть только у курьерских служб с тарифом «Премиум» или «Максимум». По умолчанию она выключена, ее нужно включить в [[Личный кабинет курьерской службы#Параметры|личном кабинете курьерской службы]]: '''Управление ЛК''' > '''Параметры''' > '''Расширенные''' > '''Разрешить отмену и изменение заказов'''.<br />
<br />
При отмене заказа поле '''Инфо о доставке''' получает значение '''Отменено заказчиком''', поле '''Дата доставки''' заполняется текущей датой, а в поле '''Вручил курьер''' появляется системная запись '''Отмена'''.<br />
<br />
Чтобы настроить триггер:<br />
# В RetailCRM выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. [[Файл:Rcrm_trig104.png|600 px|none]]<br />
#: Запишите символьный код типа доставки (доставок), заказы которой отправляются в MeaSoft.<br />
# Перейдите в раздел '''Продажи''' и нажмите на кнопку '''Новый заказ'''. В разделе '''Доставка''' выберите тип доставки, заказы которой отправляются в MeaSoft, укажите город, вес и тариф.<br />
# В разделе '''Доставка''' появится поле '''API ключ службы доставки'''. Запишите его значение. В результате у вас есть пара «символьный код типа доставки» — «API ключ службы доставки».<br />
# Повторите действия пп. 2-3 для каждой доставки, заказы по которой отправляются в MeaSoft.<br />
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».<br />
#: Заполните поля:<br />
#* '''Название'''. Название триггера, например «Отмена заказа в MeaSoft»;<br />
#* В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.<br />
#* В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:<br />
#:<source lang="javascript"><br />
changeSet.hasChangedField("delivery_type") and changeSet.getOldValue("delivery_type").getCode() in ["outcity","incity"]<br />
</source><br />
#:где <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать один тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.<br />
# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:<br />
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/cancel/retailcrm;<br />
#* '''HTTP метод''' — '''POST''';<br />
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';<br />
# Нажмите на кнопку '''Добавить параметр''' 2 раза подряд и потом еще столько раз, сколько у вас сопоставленных пар «символьный код типа доставки» - «API ключ службы доставки». Заполните появившиеся поля следующими данными:<br />
:::{|class="wikitable"<br />
!Параметр<br />
!Значение<br />
|-<br />
|id||<nowiki>{{ order.getNumber() }}</nowiki><br />
|-<br />
|code||<nowiki>{{ changeSet.getOldValue("delivery_type").getCode() }}</nowiki><br />
|-<br />
|Cимвольный код типа доставки 1||API-ключ службы доставки 1<br />
|-<br />
|Cимвольный код типа доставки 2||API-ключ службы доставки 2<br />
|}<br />
::'''Примечание'''. Переносы строк не допускаются.<br />
:8. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.<br />
:[[Файл:Новый триггер2.png|600 px|none]]<br />
Триггер настроен.<br />
<br />
=== Передача изменений заказа ===<br />
<br />
Изменять заказ могут только курьерские службы с тарифом «Премиум» или «Максимум». По умолчанию опция выключена, ее нужно включить в [[Личный кабинет курьерской службы#Параметры|личном кабинете курьерской службы]]: '''Управление ЛК''' > '''Параметры''' > '''Расширенные''' > '''Разрешить отмену и изменение заказов'''.<br />
<br />
Чтобы настроить триггер:<br />
# В RetailCRM выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. [[Файл:Rcrm_trig104.png|600 px|none]]<br />
#: Запишите символьный код доставки (доставок), заказы которой отправляются в MeaSoft.<br />
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».<br />
#: Заполните поля:<br />
#* '''Название'''. Название триггера, например «Передача изменений заказа в MeaSoft»;<br />
#* В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.<br />
#* В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:<br />
#:<source lang="javascript"><br />
changeSet.isUpdate() and <br />
(<br />
changeSet.hasChangedField("first_name") or <br />
changeSet.hasChangedField("last_name") or <br />
changeSet.hasChangedField("patronymic") or <br />
changeSet.hasChangedField("phone") or <br />
changeSet.hasChangedField("site") or <br />
changeSet.hasChangedField("additional_phone") or<br />
changeSet.hasChangedField("email") or <br />
changeSet.hasChangedField("customer.phones") or <br />
changeSet.hasChangedField("order_product") or <br />
changeSet.hasChangedField("total_summ") or <br />
changeSet.hasChangedField("delivery_date") or <br />
changeSet.hasChangedField("delivery_time") or <br />
changeSet.hasChangedField("payments") or <br />
changeSet.hasChangedField("prepay_sum") or <br />
changeSet.hasChangedField("weight") or <br />
changeSet.hasChangedField("length") or <br />
changeSet.hasChangedField("width") or <br />
changeSet.hasChangedField("height") or <br />
changeSet.hasChangedField("payments.id") or <br />
changeSet.hasChangedField("payments.status") or <br />
changeSet.hasChangedField("payments.type") or <br />
changeSet.hasChangedField("payments.external_id") or <br />
changeSet.hasChangedField("payments.amount") or <br />
changeSet.hasChangedField("payments.paid_at") or <br />
changeSet.hasChangedField("payments.comment") or <br />
changeSet.hasChangedField("discount_manual_amount") or <br />
changeSet.hasChangedField("discount_manual_percent") <br />
)<br />
and <br />
order.getDeliveryType().getCode() in ["outcity","incity"]<br />
</source><br />
#:где <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать один тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.<br />
# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:<br />
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/update/retailcrm;<br />
#* '''HTTP метод''' — '''POST''';<br />
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';<br />
# Нажмите на кнопку '''Добавить параметр''' 3 раза подряд и заполните появившиеся поля следующими данными:<br />
:::{|class="wikitable"<br />
!Параметр<br />
!Значение<br />
|-<br />
|id||<nowiki>{{ order.getNumber() }}</nowiki><br />
|-<br />
|sum||<nowiki>{{ order.getIntegrationDeliveryData().getDeclaredSum() }}</nowiki><br />
|-<br />
|key||<nowiki>{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</nowiki><br />
|}<br />
::'''Примечание'''. Переносы строк не допускаются.<br />
:5. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.<br />
:[[Файл:Новый триггер3.png|600 px|none]]<br />
Триггер настроен.<br />
<br />
== Передача габаритов ==<br />
Габариты из retailCRM передаются стандартными средствами retailCRM.<br />
<br />
Они берутся, либо из раздела "Габариты и вес", либо из раздела "Упаковки", где вы можете распределить товары между упаковками, указав габариты и вес каждой упаковки.<br />
<br />
[[Файл:Gab.png|none|800 px]]<br />
<br />
Дополнительно можете изучить информацию здесь https://docs.retailcrm.ru/Users/OperatingActivity/Orders/OrderPage/WorkOrderPage/WorkDeliveryOrder раздел "Оформление упаковок"<br />
<br />
<br />
== Проверка работоспособности интеграции ==<br />
<br />
# Убедитесь, что выполнены все шаги [[RetailCRM#Настройка интеграции|инструкции по настройке интеграции]].<br />
# Если используются триггеры, убедитесь, что они настроены согласно [[RetailCRM#Настройка триггеров|инструкции]].<br />
# Создайте заказ, заполните требуемые данные.<br />
# Нажмите на кнопку '''Сохранить''' внизу страницы, флажок '''Не отправлять данные в службу доставки''' должен быть снят.<br>Заказ должен отправиться в курьерскую службу. Если заказ отправлен без ошибок и отображается в ЛК, значит интеграция настроена.<br />
# Если возникает ошибка, ее текст отображается наверху страницы.<br />
:: Если это ошибка заполнения формы, исправьте внесенные данные и попробуйте отправить заказ снова. Пример ошибки: «Ошибка сервиса доставки "MeaSoft": field [receiver phone] has no valid phone number».<br />
:: Если это ошибка ответа курьерской службы, сообщите об этом разработчику. Пример ошибки: «Служба доставки прислала ответ в неверном формате».<br />
Текст ошибки можно увидеть через [[Личный кабинет#Отладка|отладку]] в личном кабинете. Чтобы найти свой заказ в запросах, нажмите CTRL+F и введите в строку поиска номер заказа или ориентируйтесь на время создания заказа.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=Wordpress&diff=14934Wordpress2024-02-13T11:30:31Z<p>Бутусов: </p>
<hr />
<div>= Требования к сайту =<br />
<br />
* CMS WordPress версии 5 или более новая;<br />
* WooCommerce версии 3.9 или более новая;<br />
* PHP версии 7 или более новая;<br />
* сайт должен использовать SSL-сертификат.<br />
<br />
= Установка плагина и вывод нового способа доставки в корзину =<br />
<br />
# В панели администратора сайта откройте страницу '''Плагины''' > '''Добавить новый''' и нажмите на кнопку '''Загрузить плагин'''.<br />
# В появившейся форме выберите архив с плагином на вашем компьютере и нажмите кнопку '''Установить'''.<br />
# После загрузки и установки плагина вы можете его активировать нажав на соответствующую кнопку.<br />
# После активации плагина в меню появится ссылка на страницу настроек плагина. Заполните все необходимые поля и нажмите кнопку '''Сохранить изменения'''.<br />
# Откройте настройки WooCommerce и переключите на вкладку '''Доставка'''.<br />
# Выберите необходимую зону доставки или создайте её.<br />
# Нажмите на кнопку '''Добавить метод доставки''' и выберите из списка '''MeaSoft'''.<br />
# После создания заказа в панели администратора в форме изменения заказа справа появится блок модуля '''Отправить в курьерскую службу''' с кнопкой '''Отправить заказ в MeaSoft''', при нажатии на которую заказ будет отправлен в курьерскую службу.<br />
<br />
= Обновление статусов =<br />
Обновление статусов заказов происходит через технологию WP_Cron каждые 30 минут.<br />
<br />
Если статус заказа в курьерской службе изменен на '''Доставлен''', то статус заказа в вашем магазине также будет изменен на '''Выполнен'''.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=OpenCart&diff=14930OpenCart2024-02-12T14:53:21Z<p>Бутусов: </p>
<hr />
<div>= Описание =<br />
Модуль дает возможность отображать в корзине магазина способ доставки Курьером и Самовывоз, с выбором ПВЗ на карте<br />
<br />
= OpenCart 1.5.5.1 =<br />
<br />
Важно! Перед любыми изменениями настроек рекомендуется сделать резервную копию сайта.<br />
Для настройки синхронизации:<br />
# Загрузите содержимое папки upload из архива в папку сайта по FTP. При необходимости подтвердите замену файлов.<br />
# Зайдите в панель администратора OpenСart. Подробнее см. в [https://docs.ocstore.com/index.php?title=Панель_Администратора документации OpenCart].<br />
# В меню панели управления выберите '''Дополнения''', раздел '''Модули'''. В открывшемся списке найдите '''MeaSoft''' и нажмите на кнопку '''Установить'''.<br />
# В меню панели управления выберите '''Дополнения''', раздел '''Доставка'''. В открывшемся списке найдите '''Основные настройки интеграции MeaSoft''' и нажмите на кнопку '''Установить'''. Рядом появится кнопка '''Изменить'''.<br />
# Нажмите на кнопку '''Изменить'''. Откроется страница «Основные настройки интеграции MeaSoft»:[[Файл:OpenCart.png|900px|none]]<br>Заполните обязательные поля:<br />
#* '''Логин''' — логин пользователя, выдается курьерской службой.<br />
#* '''Пароль''' — пароль пользователя, выдается курьерской службой.<br />
#* '''Код курьерской службы''' — выдается курьерской службой.<br />
#* '''Город отправителя'''. После ввода убедитесь, что в названии населенного пункта нет ошибок.<br>При необходимости заполните остальные поля. Нажмите на кнопку '''Сохранить'''.<br />
# В меню панели управления выберите '''Дополнения''', раздел '''Доставка'''. В открывшемся списке найдите '''Настройки доставки курьером MeaSoft''' и нажмите на кнопку '''Установить'''. Рядом появится кнопка '''Изменить'''.<br />
# Нажмите на кнопку '''Изменить''' и в поле '''Тариф для расчета стоимости доставки''' выберите нужный тариф. По умолчанию используется первое значение выпадающего списка.<br />
<br />
= OpenCart 2.0 и выше =<br />
<br />
== Настройка интеграции ==<br />
# Скачайте [[API#Готовые интеграции|установочный файл]] для нужной версии OpenCart.<br />
# Зайдите в панель администратора OpenСart. Подробнее см. в [https://docs.ocstore.com/index.php?title=Панель_Администратора документации OpenCart].<br />
# В панели управления OpenCart выберите '''Установка дополнений''' ('''Установка расширений''') и на странице «Установщик дополнений OCMOD» нажмите на кнопку '''Загрузить'''.<br />
# В открывшемся диалоговом окне выберите загруженный файл в формате ZIP и нажмите на кнопку '''Продолжить'''.<br>Когда загрузка будет окончена, индикатор загрузки в поле '''Выполнение''' станет зеленым.<br>'''Примечание'''. Убедитесь, что название файла оканчивается на «ocmod.zip». Названия вида «ocmod(2).zip» и подобные приведут к ошибкам загрузки файла.<br />
# В панели управления выберите '''Менеджер дополнений''' ('''Модификаторы''') и в правом верхнем углу страницы нажмите на кнопку '''Обновить'''.<br />
# Для OpenCart 2.0 и выше: в панели управления выберите '''Дополнения''' ('''Расширения'''), раздел '''Доставка'''.<br>Для OpenCart 3.0 и выше: в меню панели управления в разделе '''Расширения''' выберите '''Расширения''' и на странице '''Список расширений''' в выпадающем списке выберите '''Доставка'''.<br>В открывшемся списке найдите '''Основные настройки интеграции MeaSoft''' и нажмите на кнопку '''Установить'''. Рядом станет активна кнопка '''Редактировать'''.<br />
# Нажмите на кнопку '''Редактировать'''. Откроется страница «Основные настройки интеграции MeaSoft».<br />
# Заполните обязательные поля:<br />
#* '''Логин''' — логин пользователя, выдается курьерской службой.<br />
#* '''Пароль''' — пароль пользователя, выдается курьерской службой.<br />
#* '''Код курьерской службы''' — выдается курьерской службой.<br />
#* '''Наценка на доставку (множитель)''' — множитель наценки на стоимости доставки. Если наценки нет, установите 1.<br />
#* '''Наценка на доставку (добавочная)''' — конкретная величина наценки на стоимость доставки. Если наценки нет, установите 0.<br />
#* '''Ваш город''' — город отправителя. После ввода убедитесь, что в названии населенного пункта нет ошибок.<br>При необходимости заполните остальные поля. Нажмите на кнопку '''Сохранить''' в правом верхнем углу.<br />
# В разделе '''Доставка''' найдите '''Настройки доставки курьером MeaSoft''' и нажмите на кнопку '''Установить'''. Рядом станет активна кнопка '''Редактировать'''. <br />
# Нажмите на кнопку '''Редактировать''' и в поле '''Тариф для расчета стоимости доставки''' выберите нужный тариф. По умолчанию используется первое значение выпадающего списка.<br />
<br />
== Изменение данных заказа ==<br />
# В административной части сайта откройте заказ и вверху справа нажмите на кнопку [[Файл:OpenCartEdit.png|25 px]].<br />
# В режиме редактирования данные заказа представлены на пяти вкладках. Измените данные, для перемещения по вкладкам используйте кнопки '''Продолжить''' и '''Назад'''.<br />
# На вкладке '''Итоги''' проверьте введенные данные и нажмите на кнопку '''Применить''' для сохранения изменений в каждой строке.<br />
# Нажмите на кнопку '''Сохранить'''.<br />
<br />
== Передача заказа в ЛК ==<br />
# Передача заказа в ЛК доступна в режиме редактирования заказа.<br />
# Передача заказов работает только если модуль "Основные настройки интеграции MeaSoft" активен<br />
<br />
== Список настроек модуля Основные настройки интеграции MeaSoft ==<br />
# У вас может не быть какой-то настройки, здесь перечислены все возможные<br />
# Логин: ваш логин от ЛК курьерской службы<br />
# Пароль: ваш пароль от ЛК курьерской службы<br />
# Код курьерской службы: Код курьерской службы<br />
# Код клиента: ваш код клиента в курьерской службы<br />
# Город отправитель: Город-отправления заказа<br />
# Префикс номера заказа: Префикс, который будет подставлен в начале номера заказа<br />
# Длина номера заказа: Максимальная длина передаваемого номера заказа<br />
# Заголовок ПВЗ: Заголовок службы доставки Самовывоз<br />
# Описание ПВЗ: Описание службы доставки Самовывоз<br />
# Заголовок доставки: Заголовок службы доставки Курьером<br />
# Описание доставки: Описание службы доставки Курьером<br />
# Использовать артикулы: Передавать ли артикулы для службы учета складом<br />
# Отключить ПВЗ: Отключить способ доставки Самовывоз<br />
# Вес по умолчанию (кг): Минимальный вес заказа<br />
# Коэффициент стоимости доставки: <br />
# Добавочная стоимость доставки:<br />
# Наложенный платеж наличными: Настройка сопоставления передачи типа платежа наличными<br />
# Наложенный платеж картой: Настройка сопоставления передачи типа платежа картой<br />
# Без оплаты / предоплата: Настройка сопоставления передачи типа платежа без оплаты<br />
# Ширина блока карты: Ширина отображаемой карты выбора ПВЗ<br />
# Выстота блока карты: Высота отображаемой карты выбора ПВЗ<br />
# Налоги: Настройка налогов для модуля<br />
# Статус: Статус активности модуля<br />
# Гео Зоны: Настройка Гео зон для модуля<br />
# Порядок вывода: Сортировка вывода способов доставки Самовывоз в корзине <br />
<br />
== Список настроек модуля Настройки доставки курьером интеграции MeaSoft ==<br />
# Режим доставки: Режим с которым передается заказ в ЛК курьерской службы<br />
# Статус: Статус активности модуля передачи Курьером<br />
# Гео зоны: Настройка Гео зон для модуля<br />
# Порядок сортировки: Сортировка вывода способов доставки Курьером в корзине<br />
<br />
= Возможные ошибки =<br />
* Ошибка локализации. Чтобы переключить язык сайта на русский, сверьте названия папок локализации в скачанном архиве модуля (\upload\admin\language) и в созданном после установки модуля каталоге. Названия папок должны быть одинаковыми, например ru-ru и en-gb. Если в результате установки появилась папка с другим именем, перенесите ее содержимое в нужную папку.<br />
* При возникновении ошибок:<br />
*# В панели управления выберите '''Менеджер дополнений''' ('''Модификаторы''') и в правом верхнем углу страницы нажмите на кнопку '''Обновить'''.<br />
*# Очистите кэш везде — в панели состояния, в дополнительных модулях, в браузере и т. п.<br />
*# Проверьте работу модуля.<br />
*: Для OpenCart 3.0 и выше с установленным модулем Simple установите [https://courierexe.ru/download/api/liveopencart.modtwigfix30356.ocmod.zip | модификатор] и выполните шаги 1-3.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=InSales&diff=14929InSales2024-02-12T14:52:38Z<p>Бутусов: </p>
<hr />
<div>Для удобства работы до настройки интеграции создайте в InSales следующие пользовательские статусы:<br />
* статус для автоматической передачи заказов в курьерскую службу,<br />
* статус для обозначения заказа с ошибкой передачи данных.<br />
Чтобы настроить статусы, в панели администрирования InSales выберите '''Настройки''' > '''Оформление заказа''' > '''Пользовательские статусы''' и создайте статусы, например «Передано в КС» и «Ошибка».<br />
<br />
<br />
== Настройка интеграции ==<br />
<br />
# В личном кабинете InSales откройте '''Приложения''' > '''Центр приложений''', с помощью строки поиска найдите модуль «MeaSoft» и нажмите на кнопку '''Установить'''.<br />
# Откроется личный кабинет InSales. На странице «Установка приложения» нажмите на кнопку '''Установить'''.<br />
# В списке установленных приложений выберите «Модуль "MeaSoft"». Откроется страница авторизации личного кабинета клиента курьерской службы. Если вы авторизованы в ЛК курьерской службы, то сразу откроется страница настроек, см. п. 5.<br />
# Введите учетные данные личного кабинета в поля '''Логин''', '''Пароль''' и '''Код курьерской службы'''. Запросите эти данные у курьерской службы, с которой настраивается интеграция.<br />
# На странице «Настройка интеграции Insales» выполните настройку интеграции.<br>Особенности заполнения полей:<br />
#* '''Статус заказа для автоматической отправки в курьерскую службу'''. Выберите из выпадающего списка заранее созданный статус, при установке которого заказ автоматически отправляется в курьерскую службу, или значение '''Не отправлять'''.<br />
#* '''Отправлять артикулы (для привязки к складу)'''. Если опция включена, артикулы товаров из InSales передаются в MeaSoft. <br />
#* '''Название доставки курьером на странице заказа'''. Укажите название доставки, которое будет отображаться в заказе вместо «Курьерская доставка МЕАСОФТ» при выборе способа доставки. Можно оставить поле пустым, тогда список будет выглядеть следующим образом:[[Файл:Insales Delivery.png|none|800 px]]<br />
#* '''Описание доставки курьером на странице заказа'''. Укажите описание вида доставки. Можно оставить поле пустым.<br />
#* '''Синхронизировать остатки по складам'''. Если опция включена, данные по складским остаткам из курьерской службы передаются в InSales.<br />
#* '''Используется мультисклад?'''. Определяет, используется ли выбор товаров с одного склада или из нескольких. Возможные значения: '''Да''', '''Нет'''. В случае работы с несколькими складами убедитесь, что в настройках InSales ('''Настройки''' > '''Настройки магазина''' > '''Мультисклад'''.) указано такое же количество складов, как в системе MeaSoft.<br />
#* '''Статус заказа при ошибке передачи в курьерскую службу'''. Выберите из выпадающего списка заранее созданный статус, который будет использоваться для обозначения заказов с ошибкой передачи данных, или укажите значение '''Не отправлять'''.<br />
#* '''Производить расчет без адреса?'''. Если выбрано значение '''Нет''', расчет стоимости доставки возможен только после ввода полного адреса получателя.<br />
# По заполнении нужных полей нажмите '''Сохранить'''.<br />
<br />
В результате в InSales в окне создания заказа появляется блок «Модуль "MeaSoft"»:<br />
::[[Файл:Insales Module KS.png|none|300 px]]<br />
<br />
== Настройка интеграции на несколько аккаунтов ==<br />
Настройку интеграции на несколько аккаунтов можно провести через копирование интеграции. Затем вы можете в скопированной интеграции поменять такие настройки как '''Статус заказа''', '''Оплата заказа'''(опалченные, неоплаченные) чтобы разделить заказы по разным ЛК.<br />
<br />
Копирование интеграции проходит в первой настроенной интеграции. В самом низу формы настроек находится форма копирования, где вам потребуется указать логин, пароль, экстра код от ЛК, куда нужно скопировать интеграцию.<br />
<br />
== Настройка типов оплаты ==<br />
<br />
Тип оплаты заказа определяется следующим образом:<br />
* если заказ оплачен, то передается тип оплаты '''Оплачен''';<br />
* тип оплаты '''Банковская карта''' передается, если в InSales используется один из следующих типов:<br />
** '''Оплата банковской картой''';<br />
** '''Банковской картой при получении''';<br />
** '''Оплата банковской картой курьеру'''.<br />
: Создайте эти типы оплаты в InSales: '''Настройки''' > '''Оформление заказа''' > '''Оплата''';<br />
* если название типа оплаты не совпадает с вышеперечисленными, передается тип оплаты '''Наличными'''.<br />
В системе MeaSoft в карточке [[Клиенты и партнеры#Финансы|интернет-магазина]] есть флажок '''Спрашивать тип оплаты у получателя'''. Если он установлен, то независимо от переданного типа оплаты '''Наличными''' или '''Банковская карта''' покупателю будет предложен выбор способа оплаты.<br />
<br />
Настройки интеграции можно изменить в разделе '''Настройки''' > '''Интеграция''' [[Личный кабинет клиента#Интеграция|личного кабинета MeaSoft]].</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=AmoCRM&diff=14928AmoCRM2024-02-12T14:52:02Z<p>Бутусов: </p>
<hr />
<div>Интеграция реализована через виджет «MeaSoft», предназначенный для передачи заказов из amoCRM в MeaSoft и возврата статусов.<br />
<br />
Чтобы начать отправлять заказы в курьерскую службу, настройте интеграцию с MeaSoft и сопоставьте поля amoCRM и виджета для корректной передачи данных в MeaSoft.<br />
<br />
= Настройка интеграции =<br />
Для удобства работы перед настройкой интеграции добавьте дополнительные поля в сделке: выберите '''Сделки''' > '''Новая сделка''' и на вкладке '''Настроить''' добавьте в любую группу новые поля '''Стоимость доставки''', '''Стоимость товаров''', '''Закупка'''.<br />
<br />
[[Файл:Amo Settings.png|none|500 px]]<br />
<br />
Чтобы настроить интеграцию с amoCRM:<br />
# Этот этап можно делать из [[Личный кабинет клиента#Интеграция|личного кабинета MeaSoft]] '''ИЛИ''' из административной части amoCRM:<br />
#* В личном кабинете MeaSoft:<br />
#*# В разделе '''Настройки''' выберите '''Интеграция''', перейдите на вкладку '''Настройки интеграции''' и в таблице «Ваши интеграции» в строке «AmoCRM» нажмите '''Добавить'''.<br />
#*#Укажите название интеграции и префикс и нажмите на кнопку '''Сохранить'''.<br />
#*#Укажите аккаунт amoCRM, в котором будет установлен виджет «MeaSoft» и нажмите '''Разрешить'''. Виджет установлен.<br />
#* В административной части amoCRM:<br />
#*# В меню выберите '''Настройки''' > '''Интеграции''' и в строке поиска введите «MeaSoft».<br />
#*#Щелкните по найденному модулю, нажмите на кнопку '''Установить'''. Виджет установлен.<br />
# В amoCRM выберите '''Настройки''' > '''Интеграции''' и в разделе '''Установленные интеграции''' откройте «MeaSoft».<br />
# Введите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.<br />
# Нажмите на кнопку '''Настройки виджета'''. В окне «Настройки интеграции с MeaSoft»:<br />
## Установите параметры товаров и доставки.<br />
## Установите поля для сохранения данных заказа. Например, в выпадающем списке поля '''Сохранять стоимость товаров в отдельное поле''' укажите значение '''Сохранять в поле: Стоимость товаров'''.<br />
## Укажите, откуда будут добавляться товары к заказу. Если это список в amoCRM, настройте соответствие полей. Списки amoCRM доступны начиная с тарифного плана «Расширенный».<br />
## Установите соответствие между статусами в личном кабинете клиента курьерской службы и статусами amoCRM.<br />
## Нажмите '''Сохранить настройки'''.<br />
# В окне ввода учетных данных интеграции нажмите '''Сохранить'''.<br />
<br />
= Сопоставление полей =<br />
{|class="wikitable"<br />
!Поле виджета<br />
!Данные amoCRM<br />
!Где настраивается сопоставление<br />
|-<br />
|'''Имя отправителя''', '''Телефон отправителя''', '''Компания отправителя''', '''Дата забора''', '''Город отправителя''', '''Адрес отправителя'''||• Поля карточки контакта<br>• Поля сделки||'''Настройки виджета''' > '''Настройки интеграции с MeaSoft'''<br />
|-<br />
|'''Имя получателя''', '''Телефон получателя''', '''Компания получателя''', '''Дата доставки''', '''Индекс получателя''', '''Город получателя''', '''Адрес получателя'''||• Поля карточки контакта<br>• Поля сделки||'''Настройки виджета''' > '''Настройки интеграции с MeaSoft'''<br />
|-<br />
|'''Номер заказа'''||• Название сделки<br>• ID сделки<br>• пользовательское поле||'''Настройки виджета''' > '''Настройки интеграции с MeaSoft'''<br />
|-<br />
|'''Примечание''', '''Забор'''|| Поля сделки|| '''Настройки виджета''' > '''Настройки интеграции с MeaSoft'''<br />
|-<br />
|'''Вес''', '''Сумма''', '''Объявленная ценность''', название и количество товара||Карточка товара||• Если товар добавляется вручную или из каталога MeaSoft, сопоставление не требуется;<br>• если товар добавляется из списка amoCRM, настройте сопоставление в '''Настройки виджета''' > '''Настройка товаров'''<br />
|-<br />
|'''Количество мест'''|| - ||Заполняется в виджете вручную<br />
|-<br />
|'''Габариты мест'''|| Карточка товара ||• Товар добавляется из списка amoCRM, настройте сопоставление в '''Настройки виджета''' > '''Настройка мест''', и затем прикрепляйте места в самой сделке через списки<br />
|}<br />
<br />
= Устранение неполадок =<br />
<br />
== "Данные заказа не подставляются в поля виджета" или "Не отображается виджет" ==<br />
В данный момент у АМО наблюдается проблема, из-за которой интеграция в АМО может "сломаться", то есть виджет может пропасть.<br />
<br />
Для решения сделайте следующее: <br />
<br />
# В личном кабинете MeaSoft в пункте основного меню '''Настройки''' выберите '''Интеграция''', перейдите на вкладку '''Настройки интеграции''' и в таблице «Ваши интеграции» в строке «AmoCRM» нажмите '''Изменить'''.<br />
# На странице «Настройка интеграции AmoCRM» нажмите на кнопку '''Сохранить'''.<br />
# Укажите аккаунт amoCRM, в котором наблюдается проблема виджета «MeaSoft» и нажмите '''Разрешить'''.<br />
# Повторно сохраните настройки в AmoCRM. Для этого откройте настройки модуля интеграции в amoCRM и нажмите на кнопку '''Сохранить изменения''', затем нажмите на кнопку '''Сохранить''' для сохранения настроек.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=AmoCRM&diff=14925AmoCRM2024-02-12T06:35:14Z<p>Бутусов: </p>
<hr />
<div>Интеграция реализована через виджет «MeaSoft», предназначенный для передачи заказов из amoCRM в MeaSoft и возврата статусов.<br />
<br />
Чтобы начать отправлять заказы в курьерскую службу, настройте интеграцию с MeaSoft и сопоставьте поля amoCRM и виджета для корректной передачи данных в MeaSoft.<br />
<br />
= Настройка интеграции =<br />
Для удобства работы перед настройкой интеграции добавьте дополнительные поля в сделке: выберите '''Сделки''' > '''Новая сделка''' и на вкладке '''Настроить''' добавьте в любую группу новые поля '''Стоимость доставки''', '''Стоимость товаров''', '''Закупка'''.<br />
<br />
[[Файл:Amo Settings.png|none|500 px]]<br />
<br />
Чтобы настроить интеграцию с amoCRM:<br />
# Этот этап можно делать из [[Личный кабинет клиента#Интеграция|личного кабинета MeaSoft]] '''ИЛИ''' из административной части amoCRM:<br />
#* В личном кабинете MeaSoft:<br />
#*# В разделе '''Настройки''' выберите '''Интеграция''', перейдите на вкладку '''Настройки интеграции''' и в таблице «Ваши интеграции» в строке «AmoCRM» нажмите '''Добавить'''.<br />
#*#Укажите название интеграции и префикс и нажмите на кнопку '''Сохранить'''.<br />
#*#Укажите аккаунт amoCRM, в котором будет установлен виджет «MeaSoft» и нажмите '''Разрешить'''. Виджет установлен.<br />
#* В административной части amoCRM:<br />
#*# В меню выберите '''Настройки''' > '''Интеграции''' и в строке поиска введите «MeaSoft».<br />
#*#Щелкните по найденному модулю, нажмите на кнопку '''Установить'''. Виджет установлен.<br />
# В amoCRM выберите '''Настройки''' > '''Интеграции''' и в разделе '''Установленные интеграции''' откройте «MeaSoft».<br />
# Введите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.<br />
# Нажмите на кнопку '''Настройки виджета'''. В окне «Настройки интеграции с MeaSoft»:<br />
## Установите параметры товаров и доставки.<br />
## Установите поля для сохранения данных заказа. Например, в выпадающем списке поля '''Сохранять стоимость товаров в отдельное поле''' укажите значение '''Сохранять в поле: Стоимость товаров'''.<br />
## Укажите, откуда будут добавляться товары к заказу. Если это список в amoCRM, настройте соответствие полей. Списки amoCRM доступны начиная с тарифного плана «Расширенный».<br />
## Установите соответствие между статусами в личном кабинете клиента курьерской службы и статусами amoCRM.<br />
## Нажмите '''Сохранить настройки'''.<br />
# В окне ввода учетных данных интеграции нажмите '''Сохранить'''.<br />
<br />
= Сопоставление полей =<br />
{|class="wikitable"<br />
!Поле виджета<br />
!Данные amoCRM<br />
!Где настраивается сопоставление<br />
|-<br />
|'''Имя отправителя''', '''Телефон отправителя''', '''Компания отправителя''', '''Дата забора''', '''Город отправителя''', '''Адрес отправителя'''||• Поля карточки контакта<br>• Поля сделки||'''Настройки виджета''' > '''Настройки интеграции с MeaSoft'''<br />
|-<br />
|'''Имя получателя''', '''Телефон получателя''', '''Компания получателя''', '''Дата доставки''', '''Индекс получателя''', '''Город получателя''', '''Адрес получателя'''||• Поля карточки контакта<br>• Поля сделки||'''Настройки виджета''' > '''Настройки интеграции с MeaSoft'''<br />
|-<br />
|'''Номер заказа'''||• Название сделки<br>• ID сделки<br>• пользовательское поле||'''Настройки виджета''' > '''Настройки интеграции с MeaSoft'''<br />
|-<br />
|'''Примечание''', '''Забор'''|| Поля сделки|| '''Настройки виджета''' > '''Настройки интеграции с MeaSoft'''<br />
|-<br />
|'''Вес''', '''Сумма''', '''Объявленная ценность''', название и количество товара||Карточка товара||• Если товар добавляется вручную или из каталога Курьерской службы 2008, сопоставление не требуется;<br>• если товар добавляется из списка amoCRM, настройте сопоставление в '''Настройки виджета''' > '''Настройка товаров'''<br />
|-<br />
|'''Количество мест'''|| - ||Заполняется в виджете вручную<br />
|-<br />
|'''Габариты мест'''|| Карточка товара ||• Товар добавляется из списка amoCRM, настройте сопоставление в '''Настройки виджета''' > '''Настройка мест''', и затем прикрепляйте места в самой сделке через списки<br />
|}<br />
<br />
= Устранение неполадок =<br />
<br />
== "Данные заказа не подставляются в поля виджета" или "Не отображается виджет" ==<br />
В данный момент у АМО наблюдается проблема, из-за которой интеграция в АМО может "сломаться", то есть виджет может пропасть.<br />
<br />
Для решения сделайте следующее: <br />
<br />
# В личном кабинете MeaSoft в пункте основного меню '''Настройки''' выберите '''Интеграция''', перейдите на вкладку '''Настройки интеграции''' и в таблице «Ваши интеграции» в строке «AmoCRM» нажмите '''Изменить'''.<br />
# На странице «Настройка интеграции AmoCRM» нажмите на кнопку '''Сохранить'''.<br />
# Укажите аккаунт amoCRM, в котором наблюдается проблема виджета «MeaSoft» и нажмите '''Разрешить'''.<br />
# Повторно сохраните настройки в AmoCRM. Для этого откройте настройки модуля интеграции в amoCRM и нажмите на кнопку '''Сохранить изменения''', затем нажмите на кнопку '''Сохранить''' для сохранения настроек.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=1C-%D0%91%D0%B8%D1%82%D1%80%D0%B8%D0%BA%D1%81&diff=149241C-Битрикс2024-02-12T05:37:11Z<p>Бутусов: </p>
<hr />
<div>= Настройка интеграции =<br />
<br />
# В личном кабинете 1C-Битрикс на вкладке '''Администрирование''' в панели слева выберите '''Marketplace''' > '''Каталог решений''' и на странице «Каталог Маркетплейс» с помощью строки поиска найдите '''Модуль интеграции MEASoft'''.<br />
# Щелкните по ссылке «Установить».<br />
# Убедитесь, что в строке '''Модуль интеграции MEASoft''' установлен флажок, и нажмите на кнопку '''Загрузить'''. Далее примите лицензионное соглашение и нажмите '''Применить'''.<br />
# После окончания загрузки нажмите на кнопку '''Установить'''.<br />
# В панели слева выберите '''Магазин''' > '''Настройки''' > '''Службы доставки''', затем на странице «Список служб доставок» раскройте выпадающий список кнопки '''Добавить''' и выберите пункт '''Автоматизированная служба доставки'''. Откроется страница «Новая служба доставки».<br />
# На странице «Новая служба доставки» перейдите на вкладку '''Настройки обработчика''' и в выпадающем списке '''Служба доставки''' выберите '''«MeaSoft» — сервис доставки'''. Нажмите на кнопку '''Применить'''.<br />
# Перейдите на вкладку '''Настройки интеграции''': [[Файл:Bitrix_-_options.png|none|800px]]<br />
#: На этой вкладке:<br />
#* в разделе '''Настройки доступа''' введите учетные данные личного кабинета в поля '''Логин''', '''Пароль''' и '''Код клиента'''. Запросите эти данные у курьерской службы, с которой настраивается интеграция. Кнопка '''Проверить''' предназначена для проверки введенных учетных данных.<br />
#* в разделе '''Основные настройки''':<br />
#** в поле '''Оплата картой''' выберите тип оплаты, который будет соответствовать оплате картой (если оплата картой возможна);<br />
#** установите флажок '''Использовать артикулы''', если артикулы будут использоваться для привязки номенклатуры к складу курьерской службы;<br />
#* в разделе '''Соответствующие поля покупателя''' настройте соответствие полей получателя (ФИО, города, адреса и др.) полям в форме создания заказа;<br />
#* для работы с товарами, [[Маркировка|маркированными]] кодом «Честный ЗНАК», в разделе '''Соответствующие поля товаров''' укажите поле для хранения кода;<br />
#* в разделе '''Статусы отправки заказа''' выберите статусы, при которых заказ будет автоматически отправлен в курьерскую службу.<br />
# На вкладке '''Ценовая политика доставки''' при необходимости настройте стоимость доставки для покупателя в зависимости от стоимости заказа.<br />
# На вкладке '''Ограничения''' при необходимости укажите ограничения работы модуля по географии, типам оплаты и т. п.<br />
# По завершении настройки нажмите на кнопку '''Сохранить'''.<br />
# В настройках магазина укажите его местоположение для определения города отправителя.<br />
#: Если нужно производить расчет для другого города отправителя (например, физически магазин находится в области, а курьерская служба должна считать доставку, как по городу):<br />
#* в разделе '''Рабочий стол''' > '''Настройки''' > '''Настройки продукта''' > '''Настройки модулей''' > '''MeaSoft''' в поле '''Города-отправители''' добавьте город отправителя;<br />
#* в разделе '''Рабочий стол''' > '''Магазин''' > '''Настройки''' > '''Службы доставки''' > Нужная служба > '''Настройки интеграции''' > '''Город отправитель''' укажите добавленный выше город.<br />
<br />
Проверить работу модуля можно в форме оформления доставки. При этом должна корректно считаться стоимость доставки.<br />
<br />
Чтобы настроить интеграцию для другого режима или другой курьерской службы, повторите приведенные выше действия, начиная с шага 5.<br />
<br />
= Настройки модуля =<br />
<br />
# У модуля есть отдельные настройки, которые работают для всех служб доставки. Чтобы увидеть настройки в личном кабинете 1C-Битрикс на вкладке '''Администрирование''' в панели слева выберите '''Настройки''' > '''Настройки продукта''' > '''Настройки модулей''' и на странице «Настройки модуля» в выпадающем списке выберите значение '''MeaSoft'''.<br />
<br />
[[Файл:Bitrix_-_options_module.png|none|800px]]<br />
<br />
* В настройки входят<br />
** Настройки сопоставления способов оплат<br />
** Настройки сопоставления синхронизации статусов ЛК и статусов заказов 1С-Битрикс<br />
** Дополнительные настройки, которые описаны ниже<br />
<br />
== Перенос даты доставки ==<br />
<br />
Вы можете настроить перенос даты доставки на нужное количество дней перед от даты, получаемой от курьерской службы, если заказ оформлен позже определенного часа.<br />
<br />
Чтобы настроить перенос даты доставки:<br />
# Поставьте галку у опции '''measoft_check_fill_deliverydate'''<br />
# Укажите нужное время переноса у опции '''measoft_check_fill_deliverydate_hour'''. Возможные значения для второй строки: целое число от 1 до 24. Если оформить заказ после указанного часа, к дате доставки, получаемой от курьерской службы, прибавляется один день.<br />
# Укажите количество дней у опции '''ADD_DELIVERTY_DAYES_COUNT'''<br />
<br />
== Отключение синхронизации статусов == <br />
<br />
Поставьте галку рядом с опцией '''measoft_sync_disable''', чтобы статусы не синхронизировались.<br />
<br />
== Количество заказов, статусы которых проверяем за 1 раз == <br />
<br />
Установите нужное количество проверяемых заказов у опции '''measoft_sync_order_cnt'''. По-умолчанию 5<br />
* Проверка статусов влияет на нагрузку на сервер, поэтому мы даем возможность изменять количество проверяем заказов<br />
<br />
== Валидация даты доставки ==<br />
<br />
Опция '''measoft_check_date_format''' позволяет добавить проверку на корректность передаваемой даты из корзины. Эта опция позволяет запрещать создание заказа, если клиент указал неправильную дату. <br />
* Верный формат ДД.ММ.ГГГГ, например 05.12.2023<br />
<br />
== Запрет создания заказа в Субботу и Воскресенье ==<br />
<br />
Опция '''measoft_check_date_weekend''' позволяет запрещать создание заказов в субботу и воскресенье.<br />
<br />
== Настройки сопоставления способов оплат ==<br />
<br />
Данная настройка регулирует передачу наложенного платежа<br />
<br />
# Установите флажки в списке способа оплаты для сопоставления типов оплаты наложенного платежа.<br />
# Нажмите на кнопку '''Сохранить'''.<br />
<br />
Для предоплаченных заказов в карточке корреспонденции отображается сумма к оплате 0, при наличии товарных вложений добавляется вложение «Предоплата» с типом вложения '''Предоплата''' и ценой, равной сумме предоплаты, со знаком «минус». Поддерживается только полная предоплата.<br />
<br />
= Отправка заказа в курьерскую службу =<br />
<br />
Чтобы отправить заказ в курьерскую службу, зайдите в карточку заказа, укажите настроенное значение в поле '''Статус отправки заказа''' и нажмите на кнопку '''Сохранить'''.<br />
<br />
'''Примечание'''. Значения полей '''Комментарий покупателя к заказу''' и '''Комментарий менеджера''' передаются из 1С-Битрикс в поле '''Комментарий''' заказа в системе MeaSoft.<br />
<br />
Если статус уже установлен, но заказ не отправлен в курьерскую службу (связано с техническими особенностями):<br />
# Выберите статус заказа по умолчанию после его создания (например, '''Новый''').<br />
# Перезагрузите страницу.<br />
# Выберите статус отправки и сохраните его.<br />
При отправке заказа появится сообщение об успешной отправке или об ошибке.<br />
Статус заказа можно проверить в карточке заказа, в правом верхнем углу.<br />
<br />
= Возможные ошибки =<br />
<br />
# Если не рассчитывается стоимость, возможные причины:<br />
#* некорректно установлен модуль;<br />
#* введены некорректные учетные данные;<br />
#* в курьерской службе не настроен тариф. Обратитесь в курьерскую службу для настройки тарифа. После настройки тарифы можно проверить в личном кабинете, на вкладке '''Калькулятор'''.<br />
# По умолчанию при оформлении заказа должны появиться поля даты и времени желаемой доставки. Если они отсутствуют, то у формы были изменены стили. Также возможно обновление формы в системе Битрикс.[[Файл:Bitrix2.png|none|700 px]]<br />
# Проверьте правильность привязки свойств. Для этого в разделе '''Рабочий стол''' > '''Магазин''' > '''Настройки''' > '''Свойства заказа''' > '''Список свойств''' найдите свойство, связанное с ошибкой, щелкните по нему правой кнопкой мыши и выберите '''Изменить параметры свойства'''.<br>На вкладке '''Привязка свойства''' настраиваются условия, при которых поле будет показываться клиенту. Если у свойства заказа настроена привязка, то оно будет показываться ТОЛЬКО в том случае, когда покупатель выберет хотя бы один из указанных критериев:[[Файл:Битрикс Связь свойства.png|none|500px]]<br />
<br />
В этом примере покупатель при оформлении заказа увидит созданное поле для заполнения только в том случае, если на предыдущих шагах он выбрал оплату '''Наличными курьеру''' (при любой службе доставки), или же если захотел расплатиться любым способом, но выбрал в качестве службы доставки '''Воздушный транспорт'''.<br />
<br />
Свойство будет показано всегда, если привязка не выбрана или если выбраны все варианты платежных систем или служб доставки.<br />
<br />
Подробнее см. [https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=42&LESSON_ID=3073&LESSON_PATH=3912.4580.4828.3073 документацию 1С-Битрикс].</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=%D0%9C%D0%BE%D0%B9%D0%A1%D0%BA%D0%BB%D0%B0%D0%B4&diff=14917МойСклад2024-02-07T10:25:07Z<p>Бутусов: /* Известные проблемы */</p>
<hr />
<div>Интеграция предназначена для передачи заказов с товарными вложениями из системы МойСклад в MeaSoft. Обратно в МойСклад будут приходить статусы, стоимость доставки и общая сумма заказа с учетом частичной доставки.<br />
<br />
= Настройка интеграции =<br />
# Установка интеграции МойСклад производится в Личном Кабинете клиента в разделе "Настройки" -> "Интеграция". В настройке интеграции ведите логин и пароль от учетной записи системы «МойСклад» с правами администратора.<br><br>'''Примечание'''. Запрещено изменять данные этой учетной записи — это приведет к сбою интеграции. В будущем при обращении в техническую поддержку MeaSoft указывайте данные этой учетной записи для получения помощи по вопросам интеграции.<br>Если все же есть необходимость сменить учетные данные, после сообщите новый пароль от «МойСклад» в техподдержку MeaSoft для внесения изменений в настройки интеграции.<br><br><br />
# Укажите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.<br />
# Нажмите на кнопку '''Сохранить'''.<br>В случае ошибки «Данный пользователь „Мой склад“ уже зарегистрирован.» нажмите на кнопку '''Сбросить'''.<br />
# Дождитесь окончания синхронизации справочников. Не закрывайте и не перезагружайте страницу. Процесс может занять продолжительное время (от 10 минут).<br>Когда синхронизация окончится, автоматически откроется страница следующего шага.<br />
# В системе МойСклад создайте дополнительные поля в заказах. Для этого перейдите в '''Продажи''' > '''Заказы покупателей''', в правой части экрана нажмите на кнопку с шестеренкой и в разделе '''Дополнительные поля''' нажмите на кнопку '''+Поле'''. Подробнее см. в [https://support.moysklad.ru/hc/ru/articles/204653178-%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5-%D0%BF%D0%BE%D0%BB%D1%8F документации МойСклад].<br />
# Создайте следующие поля:<br />
#* с типом «Строка»:<br />
#** '''Город''' — для указания населенного пункта получателя; ''Можно не создавать, а использовать стандартное поле "Город" из поля "Адрес доставки" МойСклад''<br />
#** '''Адрес''' — для указания адреса получателя; ''Можно не создавать, а использовать стандартное поле "Адрес" из поля "Адрес доставки" МойСклад''<br />
#** '''Индекс''' — для указания индекса получателя; ''Можно не создавать, а использовать стандартное поле "Индекс" из поля "Адрес доставки" МойСклад''<br />
#** '''Дата доставки''' — для указания даты доставки наряду со временем;<br />
#** '''Сумма заказа''' — для получения суммы заказа от курьерской службы;<br />
#** '''Стоимость доставки''' — для получения стоимости доставки от курьерской службы;<br />
#** '''Строка для сохранения информации об ошибках''' — для получения текста ошибки;<br />
#** '''Количество мест''' — для возможности указания количества мест;<br />
#* с типом «Файл»:<br />
#** '''Файл''' — необязательное поле для передачи файлов. Максимальный размер файла — 1 МБ;<br />
#* с типом «Флажок»:<br />
#** '''Необходимость возврата''' — необязательное поле. Используется для передачи признака «необходимость возврата»;<br />
#** '''Оплата получателем''' — необязательное поле. Используется для передачи признака «оплата получателем»;<br />
#* с типом «Справочник»:<br />
#** '''Виды срочности''' — одноименный справочник;<br />
#** '''Временные интервалы''' — одноименный справочник;<br />
#** '''Способы доставки''' — одноименный справочник;<br />
#** '''Тип оплаты''' — одноименный справочник;<br />
#** '''Время доставки с''' — справочник '''Часы доставки''';<br />
#** '''Время доставки по''' — справочник '''Часы доставки'''.<br />
# В ЛК клиента MeaSoft обновите открытую страницу и настройте статусы отправки, соответствие статусов и полей. В выпадающем списке значений поля контрагента соответствуют следующим полям раздела '''Контрагенты''' в «МойСклад»:<br />
:::{|class="wikitable"<br />
!Поля контрагента в MeaSoft<br />
!Настройки МойСклад > Контрагенты<br />
|-<br />
|'''Наименование'''<br />
|'''Наименование'''<br />
|-<br />
|'''Email'''<br />
|'''Электронный адрес'''<br />
|-<br />
|'''Телефон'''<br />
|'''Телефон'''<br />
|-<br />
|'''Полное наименование'''<br />
|для юр. лица — '''Полное наименование'''<br> для ИП — в формате [ИП '''Фамилия''' '''Имя''' '''Отчество''']<br>для физ. лица — '''Фамилия''' '''Имя''' '''Отчество'''<br />
|-<br />
|'''Юридический адрес'''<br />
|для юр. лица — '''Юридический адрес'''<br>для ИП — '''Адрес регистрации'''<br>для физ. лица — '''Адрес регистрации'''<br />
|-<br />
|'''Фактический адрес'''<br />
|'''Фактический адрес'''<br />
|-<br />
|}<br />
: 8. Чтобы передавать заказ от имени заказчика, а не отправителя (склад, магазин), в полях '''ФИО отправителя''' и '''Телефон отправителя''' выберите значение '''Не передавать'''.<br />
: 9. Сохраните настройки.<br />
<br />
Для отправки заказа обязательно должен быть заполнен вес хотя бы одного товара.<br />
<br />
Поля '''Cтоимость доставки''', '''Сумма''' и '''Ошибка''' заполнять не нужно. Они заполнятся автоматически после синхронизации с курьерской службой.<br />
<br />
Если нужна доставка по адресу, оставьте поле '''Тип доставки''' пустым. Иначе выберите ПВЗ из списка.<br />
<br />
Поле '''Комментарий к заказу''', сопоставляется либо со стандартным полем, которое находится под списком товаров, либо к кастомному полю заказа.<br />
<br />
Поле '''Комментарий к доставке''', сопоставляется либо со стандартным полем, которое находится над списком товаров, либо к кастомному полю заказа.<br />
<br />
Чтобы отправить заказ, присвойте заказу статус для передачи в курьерскую службу.<br />
<br />
Если после сохранения заказа в статусе для передачи в курьерскую службу статус не изменился, проверьте поле '''Ошибка'''. Заполните поля, указанные в поле '''Ошибка''', очистите поле '''Ошибка''' и сохраните заказ.<br />
<br />
Чтобы проверить, передан ли заказ в курьерскую службу, зайдите в [[личный кабинет клиента]] и на вкладке '''Отслеживание''' проверьте, существует ли отправленный заказ.<br />
<br />
= Обновление данных из ЛК =<br />
<br />
Уже после того, как вы настроили интеграцию, в ЛК Курьерской Службы могут появиться новые ПВЗ, новые режимы доставки и тд.<br />
<br />
Чтобы перенести эти данные в МойСклад в настройках интеграции вам нужно нажать кнопку "Запустить перезагрузку" в разделе "Перезагрузить данные в МойСклад" и дождаться перезагрузки данных.<br />
<br />
= Передача дробных значений количества =<br />
<br />
Если вам нужно передавать кол-во товара в дробном значении, например 1.5 единицы рыбы, каждая весом 1кг.<br />
<br />
Для этого в настройках интеграции вам нужно заполнить 2 поля<br />
<br />
- Тип единицы измерения весового товара. Здесь вам нужно выбрать единицу измерения товара, который передает в единицах, отличных от "шт", например "кг"<br />
<br />
- Минимальное кол-во весового заказа (в кг, например 0.001 для 1г). Здесь вам нужно указать миинимальное значение передаваемого количества.<br />
<br />
Если вы передает минимум 100г, то вам нужно указать 0.1, если 1г то укажите 0.001<br />
<br />
= Передача данных из ЛК в МойСклад =<br />
<br />
Интеграция может передавать в ваши кастомные поля заказа МойСклад следующие значения:<br />
<br />
1) Статус заказа<br />
<br />
2) Сумму заказа<br />
<br />
3) Стоимость доставки<br />
<br />
4) Внешний код подрядчика<br />
<br />
5) Дату и время доставки (для получения создайте поле с типом "строка")<br />
<br />
Передача этих данных осуществляется через сопоставление полей в настройках интеграции.<br />
<br />
= Известные проблемы =<br />
<br />
Модуль интеграции не работает на бесплатном тарифе.<br />
<br />
Если заказ не уходит, попробуйте поставить ему какой-то любой статус, а потом снова тот, в котором он должен уходить и подождите 10 минут.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=%D0%9C%D0%BE%D0%B9%D0%A1%D0%BA%D0%BB%D0%B0%D0%B4&diff=14916МойСклад2024-02-06T03:48:27Z<p>Бутусов: /* Передача данных из ЛК в МойСклад */</p>
<hr />
<div>Интеграция предназначена для передачи заказов с товарными вложениями из системы МойСклад в MeaSoft. Обратно в МойСклад будут приходить статусы, стоимость доставки и общая сумма заказа с учетом частичной доставки.<br />
<br />
= Настройка интеграции =<br />
# Установка интеграции МойСклад производится в Личном Кабинете клиента в разделе "Настройки" -> "Интеграция". В настройке интеграции ведите логин и пароль от учетной записи системы «МойСклад» с правами администратора.<br><br>'''Примечание'''. Запрещено изменять данные этой учетной записи — это приведет к сбою интеграции. В будущем при обращении в техническую поддержку MeaSoft указывайте данные этой учетной записи для получения помощи по вопросам интеграции.<br>Если все же есть необходимость сменить учетные данные, после сообщите новый пароль от «МойСклад» в техподдержку MeaSoft для внесения изменений в настройки интеграции.<br><br><br />
# Укажите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.<br />
# Нажмите на кнопку '''Сохранить'''.<br>В случае ошибки «Данный пользователь „Мой склад“ уже зарегистрирован.» нажмите на кнопку '''Сбросить'''.<br />
# Дождитесь окончания синхронизации справочников. Не закрывайте и не перезагружайте страницу. Процесс может занять продолжительное время (от 10 минут).<br>Когда синхронизация окончится, автоматически откроется страница следующего шага.<br />
# В системе МойСклад создайте дополнительные поля в заказах. Для этого перейдите в '''Продажи''' > '''Заказы покупателей''', в правой части экрана нажмите на кнопку с шестеренкой и в разделе '''Дополнительные поля''' нажмите на кнопку '''+Поле'''. Подробнее см. в [https://support.moysklad.ru/hc/ru/articles/204653178-%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5-%D0%BF%D0%BE%D0%BB%D1%8F документации МойСклад].<br />
# Создайте следующие поля:<br />
#* с типом «Строка»:<br />
#** '''Город''' — для указания населенного пункта получателя; ''Можно не создавать, а использовать стандартное поле "Город" из поля "Адрес доставки" МойСклад''<br />
#** '''Адрес''' — для указания адреса получателя; ''Можно не создавать, а использовать стандартное поле "Адрес" из поля "Адрес доставки" МойСклад''<br />
#** '''Индекс''' — для указания индекса получателя; ''Можно не создавать, а использовать стандартное поле "Индекс" из поля "Адрес доставки" МойСклад''<br />
#** '''Дата доставки''' — для указания даты доставки наряду со временем;<br />
#** '''Сумма заказа''' — для получения суммы заказа от курьерской службы;<br />
#** '''Стоимость доставки''' — для получения стоимости доставки от курьерской службы;<br />
#** '''Строка для сохранения информации об ошибках''' — для получения текста ошибки;<br />
#** '''Количество мест''' — для возможности указания количества мест;<br />
#* с типом «Файл»:<br />
#** '''Файл''' — необязательное поле для передачи файлов. Максимальный размер файла — 1 МБ;<br />
#* с типом «Флажок»:<br />
#** '''Необходимость возврата''' — необязательное поле. Используется для передачи признака «необходимость возврата»;<br />
#** '''Оплата получателем''' — необязательное поле. Используется для передачи признака «оплата получателем»;<br />
#* с типом «Справочник»:<br />
#** '''Виды срочности''' — одноименный справочник;<br />
#** '''Временные интервалы''' — одноименный справочник;<br />
#** '''Способы доставки''' — одноименный справочник;<br />
#** '''Тип оплаты''' — одноименный справочник;<br />
#** '''Время доставки с''' — справочник '''Часы доставки''';<br />
#** '''Время доставки по''' — справочник '''Часы доставки'''.<br />
# В ЛК клиента MeaSoft обновите открытую страницу и настройте статусы отправки, соответствие статусов и полей. В выпадающем списке значений поля контрагента соответствуют следующим полям раздела '''Контрагенты''' в «МойСклад»:<br />
:::{|class="wikitable"<br />
!Поля контрагента в MeaSoft<br />
!Настройки МойСклад > Контрагенты<br />
|-<br />
|'''Наименование'''<br />
|'''Наименование'''<br />
|-<br />
|'''Email'''<br />
|'''Электронный адрес'''<br />
|-<br />
|'''Телефон'''<br />
|'''Телефон'''<br />
|-<br />
|'''Полное наименование'''<br />
|для юр. лица — '''Полное наименование'''<br> для ИП — в формате [ИП '''Фамилия''' '''Имя''' '''Отчество''']<br>для физ. лица — '''Фамилия''' '''Имя''' '''Отчество'''<br />
|-<br />
|'''Юридический адрес'''<br />
|для юр. лица — '''Юридический адрес'''<br>для ИП — '''Адрес регистрации'''<br>для физ. лица — '''Адрес регистрации'''<br />
|-<br />
|'''Фактический адрес'''<br />
|'''Фактический адрес'''<br />
|-<br />
|}<br />
: 8. Чтобы передавать заказ от имени заказчика, а не отправителя (склад, магазин), в полях '''ФИО отправителя''' и '''Телефон отправителя''' выберите значение '''Не передавать'''.<br />
: 9. Сохраните настройки.<br />
<br />
Для отправки заказа обязательно должен быть заполнен вес хотя бы одного товара.<br />
<br />
Поля '''Cтоимость доставки''', '''Сумма''' и '''Ошибка''' заполнять не нужно. Они заполнятся автоматически после синхронизации с курьерской службой.<br />
<br />
Если нужна доставка по адресу, оставьте поле '''Тип доставки''' пустым. Иначе выберите ПВЗ из списка.<br />
<br />
Поле '''Комментарий к заказу''', сопоставляется либо со стандартным полем, которое находится под списком товаров, либо к кастомному полю заказа.<br />
<br />
Поле '''Комментарий к доставке''', сопоставляется либо со стандартным полем, которое находится над списком товаров, либо к кастомному полю заказа.<br />
<br />
Чтобы отправить заказ, присвойте заказу статус для передачи в курьерскую службу.<br />
<br />
Если после сохранения заказа в статусе для передачи в курьерскую службу статус не изменился, проверьте поле '''Ошибка'''. Заполните поля, указанные в поле '''Ошибка''', очистите поле '''Ошибка''' и сохраните заказ.<br />
<br />
Чтобы проверить, передан ли заказ в курьерскую службу, зайдите в [[личный кабинет клиента]] и на вкладке '''Отслеживание''' проверьте, существует ли отправленный заказ.<br />
<br />
= Обновление данных из ЛК =<br />
<br />
Уже после того, как вы настроили интеграцию, в ЛК Курьерской Службы могут появиться новые ПВЗ, новые режимы доставки и тд.<br />
<br />
Чтобы перенести эти данные в МойСклад в настройках интеграции вам нужно нажать кнопку "Запустить перезагрузку" в разделе "Перезагрузить данные в МойСклад" и дождаться перезагрузки данных.<br />
<br />
= Передача дробных значений количества =<br />
<br />
Если вам нужно передавать кол-во товара в дробном значении, например 1.5 единицы рыбы, каждая весом 1кг.<br />
<br />
Для этого в настройках интеграции вам нужно заполнить 2 поля<br />
<br />
- Тип единицы измерения весового товара. Здесь вам нужно выбрать единицу измерения товара, который передает в единицах, отличных от "шт", например "кг"<br />
<br />
- Минимальное кол-во весового заказа (в кг, например 0.001 для 1г). Здесь вам нужно указать миинимальное значение передаваемого количества.<br />
<br />
Если вы передает минимум 100г, то вам нужно указать 0.1, если 1г то укажите 0.001<br />
<br />
= Передача данных из ЛК в МойСклад =<br />
<br />
Интеграция может передавать в ваши кастомные поля заказа МойСклад следующие значения:<br />
<br />
1) Статус заказа<br />
<br />
2) Сумму заказа<br />
<br />
3) Стоимость доставки<br />
<br />
4) Внешний код подрядчика<br />
<br />
5) Дату и время доставки (для получения создайте поле с типом "строка")<br />
<br />
Передача этих данных осуществляется через сопоставление полей в настройках интеграции.<br />
<br />
= Известные проблемы =<br />
<br />
Модуль интеграции не работает на бесплатном тарифе.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=%D0%9C%D0%BE%D0%B9%D0%A1%D0%BA%D0%BB%D0%B0%D0%B4&diff=14913МойСклад2024-02-05T18:05:46Z<p>Бутусов: </p>
<hr />
<div>Интеграция предназначена для передачи заказов с товарными вложениями из системы МойСклад в MeaSoft. Обратно в МойСклад будут приходить статусы, стоимость доставки и общая сумма заказа с учетом частичной доставки.<br />
<br />
= Настройка интеграции =<br />
# Установка интеграции МойСклад производится в Личном Кабинете клиента в разделе "Настройки" -> "Интеграция". В настройке интеграции ведите логин и пароль от учетной записи системы «МойСклад» с правами администратора.<br><br>'''Примечание'''. Запрещено изменять данные этой учетной записи — это приведет к сбою интеграции. В будущем при обращении в техническую поддержку MeaSoft указывайте данные этой учетной записи для получения помощи по вопросам интеграции.<br>Если все же есть необходимость сменить учетные данные, после сообщите новый пароль от «МойСклад» в техподдержку MeaSoft для внесения изменений в настройки интеграции.<br><br><br />
# Укажите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.<br />
# Нажмите на кнопку '''Сохранить'''.<br>В случае ошибки «Данный пользователь „Мой склад“ уже зарегистрирован.» нажмите на кнопку '''Сбросить'''.<br />
# Дождитесь окончания синхронизации справочников. Не закрывайте и не перезагружайте страницу. Процесс может занять продолжительное время (от 10 минут).<br>Когда синхронизация окончится, автоматически откроется страница следующего шага.<br />
# В системе МойСклад создайте дополнительные поля в заказах. Для этого перейдите в '''Продажи''' > '''Заказы покупателей''', в правой части экрана нажмите на кнопку с шестеренкой и в разделе '''Дополнительные поля''' нажмите на кнопку '''+Поле'''. Подробнее см. в [https://support.moysklad.ru/hc/ru/articles/204653178-%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5-%D0%BF%D0%BE%D0%BB%D1%8F документации МойСклад].<br />
# Создайте следующие поля:<br />
#* с типом «Строка»:<br />
#** '''Город''' — для указания населенного пункта получателя; ''Можно не создавать, а использовать стандартное поле "Город" из поля "Адрес доставки" МойСклад''<br />
#** '''Адрес''' — для указания адреса получателя; ''Можно не создавать, а использовать стандартное поле "Адрес" из поля "Адрес доставки" МойСклад''<br />
#** '''Индекс''' — для указания индекса получателя; ''Можно не создавать, а использовать стандартное поле "Индекс" из поля "Адрес доставки" МойСклад''<br />
#** '''Дата доставки''' — для указания даты доставки наряду со временем;<br />
#** '''Сумма заказа''' — для получения суммы заказа от курьерской службы;<br />
#** '''Стоимость доставки''' — для получения стоимости доставки от курьерской службы;<br />
#** '''Строка для сохранения информации об ошибках''' — для получения текста ошибки;<br />
#** '''Количество мест''' — для возможности указания количества мест;<br />
#* с типом «Файл»:<br />
#** '''Файл''' — необязательное поле для передачи файлов. Максимальный размер файла — 1 МБ;<br />
#* с типом «Флажок»:<br />
#** '''Необходимость возврата''' — необязательное поле. Используется для передачи признака «необходимость возврата»;<br />
#** '''Оплата получателем''' — необязательное поле. Используется для передачи признака «оплата получателем»;<br />
#* с типом «Справочник»:<br />
#** '''Виды срочности''' — одноименный справочник;<br />
#** '''Временные интервалы''' — одноименный справочник;<br />
#** '''Способы доставки''' — одноименный справочник;<br />
#** '''Тип оплаты''' — одноименный справочник;<br />
#** '''Время доставки с''' — справочник '''Часы доставки''';<br />
#** '''Время доставки по''' — справочник '''Часы доставки'''.<br />
# В ЛК клиента MeaSoft обновите открытую страницу и настройте статусы отправки, соответствие статусов и полей. В выпадающем списке значений поля контрагента соответствуют следующим полям раздела '''Контрагенты''' в «МойСклад»:<br />
:::{|class="wikitable"<br />
!Поля контрагента в MeaSoft<br />
!Настройки МойСклад > Контрагенты<br />
|-<br />
|'''Наименование'''<br />
|'''Наименование'''<br />
|-<br />
|'''Email'''<br />
|'''Электронный адрес'''<br />
|-<br />
|'''Телефон'''<br />
|'''Телефон'''<br />
|-<br />
|'''Полное наименование'''<br />
|для юр. лица — '''Полное наименование'''<br> для ИП — в формате [ИП '''Фамилия''' '''Имя''' '''Отчество''']<br>для физ. лица — '''Фамилия''' '''Имя''' '''Отчество'''<br />
|-<br />
|'''Юридический адрес'''<br />
|для юр. лица — '''Юридический адрес'''<br>для ИП — '''Адрес регистрации'''<br>для физ. лица — '''Адрес регистрации'''<br />
|-<br />
|'''Фактический адрес'''<br />
|'''Фактический адрес'''<br />
|-<br />
|}<br />
: 8. Чтобы передавать заказ от имени заказчика, а не отправителя (склад, магазин), в полях '''ФИО отправителя''' и '''Телефон отправителя''' выберите значение '''Не передавать'''.<br />
: 9. Сохраните настройки.<br />
<br />
Для отправки заказа обязательно должен быть заполнен вес хотя бы одного товара.<br />
<br />
Поля '''Cтоимость доставки''', '''Сумма''' и '''Ошибка''' заполнять не нужно. Они заполнятся автоматически после синхронизации с курьерской службой.<br />
<br />
Если нужна доставка по адресу, оставьте поле '''Тип доставки''' пустым. Иначе выберите ПВЗ из списка.<br />
<br />
Поле '''Комментарий к заказу''', сопоставляется либо со стандартным полем, которое находится под списком товаров, либо к кастомному полю заказа.<br />
<br />
Поле '''Комментарий к доставке''', сопоставляется либо со стандартным полем, которое находится над списком товаров, либо к кастомному полю заказа.<br />
<br />
Чтобы отправить заказ, присвойте заказу статус для передачи в курьерскую службу.<br />
<br />
Если после сохранения заказа в статусе для передачи в курьерскую службу статус не изменился, проверьте поле '''Ошибка'''. Заполните поля, указанные в поле '''Ошибка''', очистите поле '''Ошибка''' и сохраните заказ.<br />
<br />
Чтобы проверить, передан ли заказ в курьерскую службу, зайдите в [[личный кабинет клиента]] и на вкладке '''Отслеживание''' проверьте, существует ли отправленный заказ.<br />
<br />
= Обновление данных из ЛК =<br />
<br />
Уже после того, как вы настроили интеграцию, в ЛК Курьерской Службы могут появиться новые ПВЗ, новые режимы доставки и тд.<br />
<br />
Чтобы перенести эти данные в МойСклад в настройках интеграции вам нужно нажать кнопку "Запустить перезагрузку" в разделе "Перезагрузить данные в МойСклад" и дождаться перезагрузки данных.<br />
<br />
= Передача дробных значений количества =<br />
<br />
Если вам нужно передавать кол-во товара в дробном значении, например 1.5 единицы рыбы, каждая весом 1кг.<br />
<br />
Для этого в настройках интеграции вам нужно заполнить 2 поля<br />
<br />
- Тип единицы измерения весового товара. Здесь вам нужно выбрать единицу измерения товара, который передает в единицах, отличных от "шт", например "кг"<br />
<br />
- Минимальное кол-во весового заказа (в кг, например 0.001 для 1г). Здесь вам нужно указать миинимальное значение передаваемого количества.<br />
<br />
Если вы передает минимум 100г, то вам нужно указать 0.1, если 1г то укажите 0.001<br />
<br />
= Передача данных из ЛК в МойСклад =<br />
<br />
Интеграция может передавать в ваши кастомные поля заказа МойСклад следующие значения:<br />
<br />
1) Статус заказа<br />
<br />
2) Сумму заказа<br />
<br />
3) Стоимость доставки<br />
<br />
4) Внешний код подрядчика<br />
<br />
5) Дату и время доставки<br />
<br />
Передача этих данных осуществляется через сопоставление полей в настройках интеграции. <br />
<br />
= Известные проблемы =<br />
<br />
Модуль интеграции не работает на бесплатном тарифе.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=OpenCart&diff=14891OpenCart2023-12-27T06:29:35Z<p>Бутусов: /* Описание */</p>
<hr />
<div>= Описание =<br />
Модуль дает возможность отображать в корзине магазина способ доставки Курьером и Самовывоз, с выбором ПВЗ на карте<br />
<br />
= OpenCart 1.5.5.1 =<br />
<br />
Важно! Перед любыми изменениями настроек рекомендуется сделать резервную копию сайта.<br />
Для настройки синхронизации:<br />
# Загрузите содержимое папки upload из архива в папку сайта по FTP. При необходимости подтвердите замену файлов.<br />
# Зайдите в панель администратора OpenСart. Подробнее см. в [https://docs.ocstore.com/index.php?title=Панель_Администратора документации OpenCart].<br />
# В меню панели управления выберите '''Дополнения''', раздел '''Модули'''. В открывшемся списке найдите '''КС2008''' и нажмите на кнопку '''Установить'''.<br />
# В меню панели управления выберите '''Дополнения''', раздел '''Доставка'''. В открывшемся списке найдите '''Основные настройки интеграции КС2008''' и нажмите на кнопку '''Установить'''. Рядом появится кнопка '''Изменить'''.<br />
# Нажмите на кнопку '''Изменить'''. Откроется страница «Основные настройки интеграции КС2008»:[[Файл:OpenCart.png|900px|none]]<br>Заполните обязательные поля:<br />
#* '''Логин''' — логин пользователя, выдается курьерской службой.<br />
#* '''Пароль''' — пароль пользователя, выдается курьерской службой.<br />
#* '''Код курьерской службы''' — выдается курьерской службой.<br />
#* '''Город отправителя'''. После ввода убедитесь, что в названии населенного пункта нет ошибок.<br>При необходимости заполните остальные поля. Нажмите на кнопку '''Сохранить'''.<br />
# В меню панели управления выберите '''Дополнения''', раздел '''Доставка'''. В открывшемся списке найдите '''Настройки доставки курьером КС2008''' и нажмите на кнопку '''Установить'''. Рядом появится кнопка '''Изменить'''.<br />
# Нажмите на кнопку '''Изменить''' и в поле '''Тариф для расчета стоимости доставки''' выберите нужный тариф. По умолчанию используется первое значение выпадающего списка.<br />
<br />
= OpenCart 2.0 и выше =<br />
<br />
== Настройка интеграции ==<br />
# Скачайте [[API#Готовые интеграции|установочный файл]] для нужной версии OpenCart.<br />
# Зайдите в панель администратора OpenСart. Подробнее см. в [https://docs.ocstore.com/index.php?title=Панель_Администратора документации OpenCart].<br />
# В панели управления OpenCart выберите '''Установка дополнений''' ('''Установка расширений''') и на странице «Установщик дополнений OCMOD» нажмите на кнопку '''Загрузить'''.<br />
# В открывшемся диалоговом окне выберите загруженный файл в формате ZIP и нажмите на кнопку '''Продолжить'''.<br>Когда загрузка будет окончена, индикатор загрузки в поле '''Выполнение''' станет зеленым.<br>'''Примечание'''. Убедитесь, что название файла оканчивается на «ocmod.zip». Названия вида «ocmod(2).zip» и подобные приведут к ошибкам загрузки файла.<br />
# В панели управления выберите '''Менеджер дополнений''' ('''Модификаторы''') и в правом верхнем углу страницы нажмите на кнопку '''Обновить'''.<br />
# Для OpenCart 2.0 и выше: в панели управления выберите '''Дополнения''' ('''Расширения'''), раздел '''Доставка'''.<br>Для OpenCart 3.0 и выше: в меню панели управления в разделе '''Расширения''' выберите '''Расширения''' и на странице '''Список расширений''' в выпадающем списке выберите '''Доставка'''.<br>В открывшемся списке найдите '''Основные настройки интеграции КС2008''' и нажмите на кнопку '''Установить'''. Рядом станет активна кнопка '''Редактировать'''.<br />
# Нажмите на кнопку '''Редактировать'''. Откроется страница «Основные настройки интеграции КС2008».<br />
# Заполните обязательные поля:<br />
#* '''Логин''' — логин пользователя, выдается курьерской службой.<br />
#* '''Пароль''' — пароль пользователя, выдается курьерской службой.<br />
#* '''Код курьерской службы''' — выдается курьерской службой.<br />
#* '''Наценка на доставку (множитель)''' — множитель наценки на стоимости доставки. Если наценки нет, установите 1.<br />
#* '''Наценка на доставку (добавочная)''' — конкретная величина наценки на стоимость доставки. Если наценки нет, установите 0.<br />
#* '''Ваш город''' — город отправителя. После ввода убедитесь, что в названии населенного пункта нет ошибок.<br>При необходимости заполните остальные поля. Нажмите на кнопку '''Сохранить''' в правом верхнем углу.<br />
# В разделе '''Доставка''' найдите '''Настройки доставки курьером КС2008''' и нажмите на кнопку '''Установить'''. Рядом станет активна кнопка '''Редактировать'''. <br />
# Нажмите на кнопку '''Редактировать''' и в поле '''Тариф для расчета стоимости доставки''' выберите нужный тариф. По умолчанию используется первое значение выпадающего списка.<br />
<br />
== Изменение данных заказа ==<br />
# В административной части сайта откройте заказ и вверху справа нажмите на кнопку [[Файл:OpenCartEdit.png|25 px]].<br />
# В режиме редактирования данные заказа представлены на пяти вкладках. Измените данные, для перемещения по вкладкам используйте кнопки '''Продолжить''' и '''Назад'''.<br />
# На вкладке '''Итоги''' проверьте введенные данные и нажмите на кнопку '''Применить''' для сохранения изменений в каждой строке.<br />
# Нажмите на кнопку '''Сохранить'''.<br />
<br />
== Передача заказа в ЛК ==<br />
# Передача заказа в ЛК доступна в режиме редактирования заказа.<br />
# Передача заказов работает только если модуль "Основные настройки интеграции КС2008" активен<br />
<br />
== Список настроек модуля Основные настройки интеграции КС2008 ==<br />
# У вас может не быть какой-то настройки, здесь перечислены все возможные<br />
# Логин: ваш логин от ЛК курьерской службы<br />
# Пароль: ваш пароль от ЛК курьерской службы<br />
# Код курьерской службы: Код курьерской службы<br />
# Код клиента: ваш код клиента в курьерской службы<br />
# Город отправитель: Город-отправления заказа<br />
# Префикс номера заказа: Префикс, который будет подставлен в начале номера заказа<br />
# Длина номера заказа: Максимальная длина передаваемого номера заказа<br />
# Заголовок ПВЗ: Заголовок службы доставки Самовывоз<br />
# Описание ПВЗ: Описание службы доставки Самовывоз<br />
# Заголовок доставки: Заголовок службы доставки Курьером<br />
# Описание доставки: Описание службы доставки Курьером<br />
# Использовать артикулы: Передавать ли артикулы для службы учета складом<br />
# Отключить ПВЗ: Отключить способ доставки Самовывоз<br />
# Вес по умолчанию (кг): Минимальный вес заказа<br />
# Коэффициент стоимости доставки: <br />
# Добавочная стоимость доставки:<br />
# Наложенный платеж наличными: Настройка сопоставления передачи типа платежа наличными<br />
# Наложенный платеж картой: Настройка сопоставления передачи типа платежа картой<br />
# Без оплаты / предоплата: Настройка сопоставления передачи типа платежа без оплаты<br />
# Ширина блока карты: Ширина отображаемой карты выбора ПВЗ<br />
# Выстота блока карты: Высота отображаемой карты выбора ПВЗ<br />
# Налоги: Настройка налогов для модуля<br />
# Статус: Статус активности модуля<br />
# Гео Зоны: Настройка Гео зон для модуля<br />
# Порядок вывода: Сортировка вывода способов доставки Самовывоз в корзине <br />
<br />
== Список настроек модуля Настройки доставки курьером интеграции КС2008 ==<br />
# Режим доставки: Режим с которым передается заказ в ЛК курьерской службы<br />
# Статус: Статус активности модуля передачи Курьером<br />
# Гео зоны: Настройка Гео зон для модуля<br />
# Порядок сортировки: Сортировка вывода способов доставки Курьером в корзине<br />
<br />
= Возможные ошибки =<br />
* Ошибка локализации. Чтобы переключить язык сайта на русский, сверьте названия папок локализации в скачанном архиве модуля (\upload\admin\language) и в созданном после установки модуля каталоге. Названия папок должны быть одинаковыми, например ru-ru и en-gb. Если в результате установки появилась папка с другим именем, перенесите ее содержимое в нужную папку.<br />
* При возникновении ошибок:<br />
*# В панели управления выберите '''Менеджер дополнений''' ('''Модификаторы''') и в правом верхнем углу страницы нажмите на кнопку '''Обновить'''.<br />
*# Очистите кэш везде — в панели состояния, в дополнительных модулях, в браузере и т. п.<br />
*# Проверьте работу модуля.<br />
*: Для OpenCart 3.0 и выше с установленным модулем Simple установите [https://courierexe.ru/download/api/liveopencart.modtwigfix30356.ocmod.zip | модификатор] и выполните шаги 1-3.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=OpenCart&diff=14890OpenCart2023-12-27T06:29:15Z<p>Бутусов: </p>
<hr />
<div>= Описание =<br />
Модуль дает возможность отображать в корзине магазиа способ доставки Курьером и Самовывоз, с выбором ПВЗ на карте<br />
<br />
= OpenCart 1.5.5.1 =<br />
<br />
Важно! Перед любыми изменениями настроек рекомендуется сделать резервную копию сайта.<br />
Для настройки синхронизации:<br />
# Загрузите содержимое папки upload из архива в папку сайта по FTP. При необходимости подтвердите замену файлов.<br />
# Зайдите в панель администратора OpenСart. Подробнее см. в [https://docs.ocstore.com/index.php?title=Панель_Администратора документации OpenCart].<br />
# В меню панели управления выберите '''Дополнения''', раздел '''Модули'''. В открывшемся списке найдите '''КС2008''' и нажмите на кнопку '''Установить'''.<br />
# В меню панели управления выберите '''Дополнения''', раздел '''Доставка'''. В открывшемся списке найдите '''Основные настройки интеграции КС2008''' и нажмите на кнопку '''Установить'''. Рядом появится кнопка '''Изменить'''.<br />
# Нажмите на кнопку '''Изменить'''. Откроется страница «Основные настройки интеграции КС2008»:[[Файл:OpenCart.png|900px|none]]<br>Заполните обязательные поля:<br />
#* '''Логин''' — логин пользователя, выдается курьерской службой.<br />
#* '''Пароль''' — пароль пользователя, выдается курьерской службой.<br />
#* '''Код курьерской службы''' — выдается курьерской службой.<br />
#* '''Город отправителя'''. После ввода убедитесь, что в названии населенного пункта нет ошибок.<br>При необходимости заполните остальные поля. Нажмите на кнопку '''Сохранить'''.<br />
# В меню панели управления выберите '''Дополнения''', раздел '''Доставка'''. В открывшемся списке найдите '''Настройки доставки курьером КС2008''' и нажмите на кнопку '''Установить'''. Рядом появится кнопка '''Изменить'''.<br />
# Нажмите на кнопку '''Изменить''' и в поле '''Тариф для расчета стоимости доставки''' выберите нужный тариф. По умолчанию используется первое значение выпадающего списка.<br />
<br />
= OpenCart 2.0 и выше =<br />
<br />
== Настройка интеграции ==<br />
# Скачайте [[API#Готовые интеграции|установочный файл]] для нужной версии OpenCart.<br />
# Зайдите в панель администратора OpenСart. Подробнее см. в [https://docs.ocstore.com/index.php?title=Панель_Администратора документации OpenCart].<br />
# В панели управления OpenCart выберите '''Установка дополнений''' ('''Установка расширений''') и на странице «Установщик дополнений OCMOD» нажмите на кнопку '''Загрузить'''.<br />
# В открывшемся диалоговом окне выберите загруженный файл в формате ZIP и нажмите на кнопку '''Продолжить'''.<br>Когда загрузка будет окончена, индикатор загрузки в поле '''Выполнение''' станет зеленым.<br>'''Примечание'''. Убедитесь, что название файла оканчивается на «ocmod.zip». Названия вида «ocmod(2).zip» и подобные приведут к ошибкам загрузки файла.<br />
# В панели управления выберите '''Менеджер дополнений''' ('''Модификаторы''') и в правом верхнем углу страницы нажмите на кнопку '''Обновить'''.<br />
# Для OpenCart 2.0 и выше: в панели управления выберите '''Дополнения''' ('''Расширения'''), раздел '''Доставка'''.<br>Для OpenCart 3.0 и выше: в меню панели управления в разделе '''Расширения''' выберите '''Расширения''' и на странице '''Список расширений''' в выпадающем списке выберите '''Доставка'''.<br>В открывшемся списке найдите '''Основные настройки интеграции КС2008''' и нажмите на кнопку '''Установить'''. Рядом станет активна кнопка '''Редактировать'''.<br />
# Нажмите на кнопку '''Редактировать'''. Откроется страница «Основные настройки интеграции КС2008».<br />
# Заполните обязательные поля:<br />
#* '''Логин''' — логин пользователя, выдается курьерской службой.<br />
#* '''Пароль''' — пароль пользователя, выдается курьерской службой.<br />
#* '''Код курьерской службы''' — выдается курьерской службой.<br />
#* '''Наценка на доставку (множитель)''' — множитель наценки на стоимости доставки. Если наценки нет, установите 1.<br />
#* '''Наценка на доставку (добавочная)''' — конкретная величина наценки на стоимость доставки. Если наценки нет, установите 0.<br />
#* '''Ваш город''' — город отправителя. После ввода убедитесь, что в названии населенного пункта нет ошибок.<br>При необходимости заполните остальные поля. Нажмите на кнопку '''Сохранить''' в правом верхнем углу.<br />
# В разделе '''Доставка''' найдите '''Настройки доставки курьером КС2008''' и нажмите на кнопку '''Установить'''. Рядом станет активна кнопка '''Редактировать'''. <br />
# Нажмите на кнопку '''Редактировать''' и в поле '''Тариф для расчета стоимости доставки''' выберите нужный тариф. По умолчанию используется первое значение выпадающего списка.<br />
<br />
== Изменение данных заказа ==<br />
# В административной части сайта откройте заказ и вверху справа нажмите на кнопку [[Файл:OpenCartEdit.png|25 px]].<br />
# В режиме редактирования данные заказа представлены на пяти вкладках. Измените данные, для перемещения по вкладкам используйте кнопки '''Продолжить''' и '''Назад'''.<br />
# На вкладке '''Итоги''' проверьте введенные данные и нажмите на кнопку '''Применить''' для сохранения изменений в каждой строке.<br />
# Нажмите на кнопку '''Сохранить'''.<br />
<br />
== Передача заказа в ЛК ==<br />
# Передача заказа в ЛК доступна в режиме редактирования заказа.<br />
# Передача заказов работает только если модуль "Основные настройки интеграции КС2008" активен<br />
<br />
== Список настроек модуля Основные настройки интеграции КС2008 ==<br />
# У вас может не быть какой-то настройки, здесь перечислены все возможные<br />
# Логин: ваш логин от ЛК курьерской службы<br />
# Пароль: ваш пароль от ЛК курьерской службы<br />
# Код курьерской службы: Код курьерской службы<br />
# Код клиента: ваш код клиента в курьерской службы<br />
# Город отправитель: Город-отправления заказа<br />
# Префикс номера заказа: Префикс, который будет подставлен в начале номера заказа<br />
# Длина номера заказа: Максимальная длина передаваемого номера заказа<br />
# Заголовок ПВЗ: Заголовок службы доставки Самовывоз<br />
# Описание ПВЗ: Описание службы доставки Самовывоз<br />
# Заголовок доставки: Заголовок службы доставки Курьером<br />
# Описание доставки: Описание службы доставки Курьером<br />
# Использовать артикулы: Передавать ли артикулы для службы учета складом<br />
# Отключить ПВЗ: Отключить способ доставки Самовывоз<br />
# Вес по умолчанию (кг): Минимальный вес заказа<br />
# Коэффициент стоимости доставки: <br />
# Добавочная стоимость доставки:<br />
# Наложенный платеж наличными: Настройка сопоставления передачи типа платежа наличными<br />
# Наложенный платеж картой: Настройка сопоставления передачи типа платежа картой<br />
# Без оплаты / предоплата: Настройка сопоставления передачи типа платежа без оплаты<br />
# Ширина блока карты: Ширина отображаемой карты выбора ПВЗ<br />
# Выстота блока карты: Высота отображаемой карты выбора ПВЗ<br />
# Налоги: Настройка налогов для модуля<br />
# Статус: Статус активности модуля<br />
# Гео Зоны: Настройка Гео зон для модуля<br />
# Порядок вывода: Сортировка вывода способов доставки Самовывоз в корзине <br />
<br />
== Список настроек модуля Настройки доставки курьером интеграции КС2008 ==<br />
# Режим доставки: Режим с которым передается заказ в ЛК курьерской службы<br />
# Статус: Статус активности модуля передачи Курьером<br />
# Гео зоны: Настройка Гео зон для модуля<br />
# Порядок сортировки: Сортировка вывода способов доставки Курьером в корзине<br />
<br />
= Возможные ошибки =<br />
* Ошибка локализации. Чтобы переключить язык сайта на русский, сверьте названия папок локализации в скачанном архиве модуля (\upload\admin\language) и в созданном после установки модуля каталоге. Названия папок должны быть одинаковыми, например ru-ru и en-gb. Если в результате установки появилась папка с другим именем, перенесите ее содержимое в нужную папку.<br />
* При возникновении ошибок:<br />
*# В панели управления выберите '''Менеджер дополнений''' ('''Модификаторы''') и в правом верхнем углу страницы нажмите на кнопку '''Обновить'''.<br />
*# Очистите кэш везде — в панели состояния, в дополнительных модулях, в браузере и т. п.<br />
*# Проверьте работу модуля.<br />
*: Для OpenCart 3.0 и выше с установленным модулем Simple установите [https://courierexe.ru/download/api/liveopencart.modtwigfix30356.ocmod.zip | модификатор] и выполните шаги 1-3.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=OpenCart&diff=14889OpenCart2023-12-27T06:28:04Z<p>Бутусов: /* Изменение данных заказа */</p>
<hr />
<div>= OpenCart 1.5.5.1 =<br />
<br />
Важно! Перед любыми изменениями настроек рекомендуется сделать резервную копию сайта.<br />
Для настройки синхронизации:<br />
# Загрузите содержимое папки upload из архива в папку сайта по FTP. При необходимости подтвердите замену файлов.<br />
# Зайдите в панель администратора OpenСart. Подробнее см. в [https://docs.ocstore.com/index.php?title=Панель_Администратора документации OpenCart].<br />
# В меню панели управления выберите '''Дополнения''', раздел '''Модули'''. В открывшемся списке найдите '''КС2008''' и нажмите на кнопку '''Установить'''.<br />
# В меню панели управления выберите '''Дополнения''', раздел '''Доставка'''. В открывшемся списке найдите '''Основные настройки интеграции КС2008''' и нажмите на кнопку '''Установить'''. Рядом появится кнопка '''Изменить'''.<br />
# Нажмите на кнопку '''Изменить'''. Откроется страница «Основные настройки интеграции КС2008»:[[Файл:OpenCart.png|900px|none]]<br>Заполните обязательные поля:<br />
#* '''Логин''' — логин пользователя, выдается курьерской службой.<br />
#* '''Пароль''' — пароль пользователя, выдается курьерской службой.<br />
#* '''Код курьерской службы''' — выдается курьерской службой.<br />
#* '''Город отправителя'''. После ввода убедитесь, что в названии населенного пункта нет ошибок.<br>При необходимости заполните остальные поля. Нажмите на кнопку '''Сохранить'''.<br />
# В меню панели управления выберите '''Дополнения''', раздел '''Доставка'''. В открывшемся списке найдите '''Настройки доставки курьером КС2008''' и нажмите на кнопку '''Установить'''. Рядом появится кнопка '''Изменить'''.<br />
# Нажмите на кнопку '''Изменить''' и в поле '''Тариф для расчета стоимости доставки''' выберите нужный тариф. По умолчанию используется первое значение выпадающего списка.<br />
<br />
= OpenCart 2.0 и выше =<br />
<br />
== Настройка интеграции ==<br />
# Скачайте [[API#Готовые интеграции|установочный файл]] для нужной версии OpenCart.<br />
# Зайдите в панель администратора OpenСart. Подробнее см. в [https://docs.ocstore.com/index.php?title=Панель_Администратора документации OpenCart].<br />
# В панели управления OpenCart выберите '''Установка дополнений''' ('''Установка расширений''') и на странице «Установщик дополнений OCMOD» нажмите на кнопку '''Загрузить'''.<br />
# В открывшемся диалоговом окне выберите загруженный файл в формате ZIP и нажмите на кнопку '''Продолжить'''.<br>Когда загрузка будет окончена, индикатор загрузки в поле '''Выполнение''' станет зеленым.<br>'''Примечание'''. Убедитесь, что название файла оканчивается на «ocmod.zip». Названия вида «ocmod(2).zip» и подобные приведут к ошибкам загрузки файла.<br />
# В панели управления выберите '''Менеджер дополнений''' ('''Модификаторы''') и в правом верхнем углу страницы нажмите на кнопку '''Обновить'''.<br />
# Для OpenCart 2.0 и выше: в панели управления выберите '''Дополнения''' ('''Расширения'''), раздел '''Доставка'''.<br>Для OpenCart 3.0 и выше: в меню панели управления в разделе '''Расширения''' выберите '''Расширения''' и на странице '''Список расширений''' в выпадающем списке выберите '''Доставка'''.<br>В открывшемся списке найдите '''Основные настройки интеграции КС2008''' и нажмите на кнопку '''Установить'''. Рядом станет активна кнопка '''Редактировать'''.<br />
# Нажмите на кнопку '''Редактировать'''. Откроется страница «Основные настройки интеграции КС2008».<br />
# Заполните обязательные поля:<br />
#* '''Логин''' — логин пользователя, выдается курьерской службой.<br />
#* '''Пароль''' — пароль пользователя, выдается курьерской службой.<br />
#* '''Код курьерской службы''' — выдается курьерской службой.<br />
#* '''Наценка на доставку (множитель)''' — множитель наценки на стоимости доставки. Если наценки нет, установите 1.<br />
#* '''Наценка на доставку (добавочная)''' — конкретная величина наценки на стоимость доставки. Если наценки нет, установите 0.<br />
#* '''Ваш город''' — город отправителя. После ввода убедитесь, что в названии населенного пункта нет ошибок.<br>При необходимости заполните остальные поля. Нажмите на кнопку '''Сохранить''' в правом верхнем углу.<br />
# В разделе '''Доставка''' найдите '''Настройки доставки курьером КС2008''' и нажмите на кнопку '''Установить'''. Рядом станет активна кнопка '''Редактировать'''. <br />
# Нажмите на кнопку '''Редактировать''' и в поле '''Тариф для расчета стоимости доставки''' выберите нужный тариф. По умолчанию используется первое значение выпадающего списка.<br />
<br />
== Изменение данных заказа ==<br />
# В административной части сайта откройте заказ и вверху справа нажмите на кнопку [[Файл:OpenCartEdit.png|25 px]].<br />
# В режиме редактирования данные заказа представлены на пяти вкладках. Измените данные, для перемещения по вкладкам используйте кнопки '''Продолжить''' и '''Назад'''.<br />
# На вкладке '''Итоги''' проверьте введенные данные и нажмите на кнопку '''Применить''' для сохранения изменений в каждой строке.<br />
# Нажмите на кнопку '''Сохранить'''.<br />
<br />
<br />
== Передача заказа в ЛК ==<br />
# Передача заказа в ЛК доступна в режиме редактирования заказа.<br />
# Передача заказов работает только если модуль "Основные настройки интеграции КС2008" активен<br />
<br />
<br />
== Список настроек модуля Основные настройки интеграции КС2008 ==<br />
# У вас может не быть какой-то настройки, здесь перечислены все возможные<br />
# Логин: ваш логин от ЛК курьерской службы<br />
# Пароль: ваш пароль от ЛК курьерской службы<br />
# Код курьерской службы: Код курьерской службы<br />
# Код клиента: ваш код клиента в курьерской службы<br />
# Город отправитель: Город-отправления заказа<br />
# Префикс номера заказа: Префикс, который будет подставлен в начале номера заказа<br />
# Длина номера заказа: Максимальная длина передаваемого номера заказа<br />
# Заголовок ПВЗ: Заголовок службы доставки Самовывоз<br />
# Описание ПВЗ: Описание службы доставки Самовывоз<br />
# Заголовок доставки: Заголовок службы доставки Курьером<br />
# Описание доставки: Описание службы доставки Курьером<br />
# Использовать артикулы: Передавать ли артикулы для службы учета складом<br />
# Отключить ПВЗ: Отключить способ доставки Самовывоз<br />
# Вес по умолчанию (кг): Минимальный вес заказа<br />
# Коэффициент стоимости доставки: <br />
# Добавочная стоимость доставки:<br />
# Наложенный платеж наличными: Настройка сопоставления передачи типа платежа наличными<br />
# Наложенный платеж картой: Настройка сопоставления передачи типа платежа картой<br />
# Без оплаты / предоплата: Настройка сопоставления передачи типа платежа без оплаты<br />
# Ширина блока карты: Ширина отображаемой карты выбора ПВЗ<br />
# Выстота блока карты: Высота отображаемой карты выбора ПВЗ<br />
# Налоги: Настройка налогов для модуля<br />
# Статус: Статус активности модуля<br />
# Гео Зоны: Настройка Гео зон для модуля<br />
# Порядок вывода: Сортировка вывода способов доставки Самовывоз в корзине <br />
<br />
<br />
== Список настроек модуля Настройки доставки курьером интеграции КС2008 ==<br />
# Режим доставки: Режим с которым передается заказ в ЛК курьерской службы<br />
# Статус: Статус активности модуля передачи Курьером<br />
# Гео зоны: Настройка Гео зон для модуля<br />
# Порядок сортировки: Сортировка вывода способов доставки Курьером в корзине<br />
<br />
= Возможные ошибки =<br />
* Ошибка локализации. Чтобы переключить язык сайта на русский, сверьте названия папок локализации в скачанном архиве модуля (\upload\admin\language) и в созданном после установки модуля каталоге. Названия папок должны быть одинаковыми, например ru-ru и en-gb. Если в результате установки появилась папка с другим именем, перенесите ее содержимое в нужную папку.<br />
* При возникновении ошибок:<br />
*# В панели управления выберите '''Менеджер дополнений''' ('''Модификаторы''') и в правом верхнем углу страницы нажмите на кнопку '''Обновить'''.<br />
*# Очистите кэш везде — в панели состояния, в дополнительных модулях, в браузере и т. п.<br />
*# Проверьте работу модуля.<br />
*: Для OpenCart 3.0 и выше с установленным модулем Simple установите [https://courierexe.ru/download/api/liveopencart.modtwigfix30356.ocmod.zip | модификатор] и выполните шаги 1-3.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=%D0%9C%D0%BE%D0%B9%D0%A1%D0%BA%D0%BB%D0%B0%D0%B4&diff=14876МойСклад2023-11-20T12:19:15Z<p>Бутусов: </p>
<hr />
<div>Интеграция предназначена для передачи заказов с товарными вложениями из системы МойСклад в MeaSoft. Обратно в МойСклад будут приходить статусы, стоимость доставки и общая сумма заказа с учетом частичной доставки.<br />
<br />
= Настройка интеграции =<br />
# Установка интеграции МойСклад производится в Личном Кабинете Курьерской службы в разделе "Настройки" -> "Интеграция". В настройке интеграции ведите логин и пароль от учетной записи системы «МойСклад» с правами администратора.<br><br>'''Примечание'''. Запрещено изменять данные этой учетной записи — это приведет к сбою интеграции. В будущем при обращении в техническую поддержку MeaSoft указывайте данные этой учетной записи для получения помощи по вопросам интеграции.<br>Если все же есть необходимость сменить учетные данные, после сообщите новый пароль от «МойСклад» в техподдержку MeaSoft для внесения изменений в настройки интеграции.<br><br><br />
# Укажите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.<br />
# Нажмите на кнопку '''Сохранить'''.<br>В случае ошибки «Данный пользователь „Мой склад“ уже зарегистрирован.» нажмите на кнопку '''Сбросить'''.<br />
# Дождитесь окончания синхронизации справочников. Не закрывайте и не перезагружайте страницу. Процесс может занять продолжительное время (от 10 минут).<br>Когда синхронизация окончится, автоматически откроется страница следующего шага.<br />
# В системе МойСклад создайте дополнительные поля в заказах. Для этого перейдите в '''Продажи''' > '''Заказы покупателей''', в правой части экрана нажмите на кнопку с шестеренкой и в разделе '''Дополнительные поля''' нажмите на кнопку '''+Поле'''. Подробнее см. в [https://support.moysklad.ru/hc/ru/articles/204653178-%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5-%D0%BF%D0%BE%D0%BB%D1%8F документации МойСклад].<br />
# Создайте следующие поля:<br />
#* с типом «Строка»:<br />
#** '''Город''' — для указания населенного пункта получателя; ''Можно не создавать, а использовать стандартное поле "Город" из поля "Адрес доставки" МойСклад''<br />
#** '''Адрес''' — для указания адреса получателя; ''Можно не создавать, а использовать стандартное поле "Адрес" из поля "Адрес доставки" МойСклад''<br />
#** '''Индекс''' — для указания индекса получателя; ''Можно не создавать, а использовать стандартное поле "Индекс" из поля "Адрес доставки" МойСклад''<br />
#** '''Дата доставки''' — для указания даты доставки наряду со временем;<br />
#** '''Сумма заказа''' — для получения суммы заказа от курьерской службы;<br />
#** '''Стоимость доставки''' — для получения стоимости доставки от курьерской службы;<br />
#** '''Строка для сохранения информации об ошибках''' — для получения текста ошибки;<br />
#** '''Количество мест''' — для возможности указания количества мест;<br />
#* с типом «Файл»:<br />
#** '''Файл''' — необязательное поле для передачи файлов. Максимальный размер файла — 1 МБ;<br />
#* с типом «Флажок»:<br />
#** '''Необходимость возврата''' — необязательное поле. Используется для передачи признака «необходимость возврата»;<br />
#** '''Оплата получателем''' — необязательное поле. Используется для передачи признака «оплата получателем»;<br />
#* с типом «Справочник»:<br />
#** '''Виды срочности''' — одноименный справочник;<br />
#** '''Временные интервалы''' — одноименный справочник;<br />
#** '''Способы доставки''' — одноименный справочник;<br />
#** '''Тип оплаты''' — одноименный справочник;<br />
#** '''Время доставки с''' — справочник '''Часы доставки''';<br />
#** '''Время доставки по''' — справочник '''Часы доставки'''.<br />
# В ЛК клиента MeaSoft обновите открытую страницу и настройте статусы отправки, соответствие статусов и полей. В выпадающем списке значений поля контрагента соответствуют следующим полям раздела '''Контрагенты''' в «МойСклад»:<br />
:::{|class="wikitable"<br />
!Поля контрагента в MeaSoft<br />
!Настройки МойСклад > Контрагенты<br />
|-<br />
|'''Наименование'''<br />
|'''Наименование'''<br />
|-<br />
|'''Email'''<br />
|'''Электронный адрес'''<br />
|-<br />
|'''Телефон'''<br />
|'''Телефон'''<br />
|-<br />
|'''Полное наименование'''<br />
|для юр. лица — '''Полное наименование'''<br> для ИП — в формате [ИП '''Фамилия''' '''Имя''' '''Отчество''']<br>для физ. лица — '''Фамилия''' '''Имя''' '''Отчество'''<br />
|-<br />
|'''Юридический адрес'''<br />
|для юр. лица — '''Юридический адрес'''<br>для ИП — '''Адрес регистрации'''<br>для физ. лица — '''Адрес регистрации'''<br />
|-<br />
|'''Фактический адрес'''<br />
|'''Фактический адрес'''<br />
|-<br />
|}<br />
: 8. Чтобы передавать заказ от имени заказчика, а не отправителя (склад, магазин), в полях '''ФИО отправителя''' и '''Телефон отправителя''' выберите значение '''Не передавать'''.<br />
: 9. Сохраните настройки.<br />
<br />
Для отправки заказа обязательно должен быть заполнен вес хотя бы одного товара.<br />
<br />
Поля '''Cтоимость доставки''', '''Сумма''' и '''Ошибка''' заполнять не нужно. Они заполнятся автоматически после синхронизации с курьерской службой.<br />
<br />
Если нужна доставка по адресу, оставьте поле '''Тип доставки''' пустым. Иначе выберите ПВЗ из списка.<br />
<br />
Поле '''Комментарий к заказу''', сопоставляется либо со стандартным полем, которое находится под списком товаров, либо к кастомному полю заказа.<br />
<br />
Поле '''Комментарий к доставке''', сопоставляется либо со стандартным полем, которое находится над списком товаров, либо к кастомному полю заказа.<br />
<br />
Чтобы отправить заказ, присвойте заказу статус для передачи в курьерскую службу.<br />
<br />
Если после сохранения заказа в статусе для передачи в курьерскую службу статус не изменился, проверьте поле '''Ошибка'''. Заполните поля, указанные в поле '''Ошибка''', очистите поле '''Ошибка''' и сохраните заказ.<br />
<br />
Чтобы проверить, передан ли заказ в курьерскую службу, зайдите в [[личный кабинет клиента]] и на вкладке '''Отслеживание''' проверьте, существует ли отправленный заказ.<br />
<br />
= Обновление данных из ЛК =<br />
<br />
Уже после того, как вы настроили интеграцию, в ЛК Курьерской Службы могут появиться новые ПВЗ, новые режимы доставки и тд.<br />
<br />
Чтобы перенести эти данные в МойСклад в настройках интеграции вам нужно нажать кнопку "Запустить перезагрузку" в разделе "Перезагрузить данные в МойСклад" и дождаться перезагрузки данных.<br />
<br />
= Передача дробных значений количества =<br />
<br />
Если вам нужно передавать кол-во товара в дробном значении, например 1.5 единицы рыбы, каждая весом 1кг.<br />
<br />
Для этого в настройках интеграции вам нужно заполнить 2 поля<br />
<br />
- Тип единицы измерения весового товара. Здесь вам нужно выбрать единицу измерения товара, который передает в единицах, отличных от "шт", например "кг"<br />
<br />
- Минимальное кол-во весового заказа (в кг, например 0.001 для 1г). Здесь вам нужно указать миинимальное значение передаваемого количества.<br />
<br />
Если вы передает минимум 100г, то вам нужно указать 0.1, если 1г то укажите 0.001<br />
<br />
= Известные проблемы =<br />
<br />
Модуль интеграции не работает на бесплатном тарифе.<br />
<br />
При установке приложения в «МойСклад» регистрируется <rspoiler text="событие">веб-хук</rspoiler> на изменение заказа, чтобы «МойСклад» передавал изменения в MeaSoft. Так работают все модули служб доставки для «МойСклад». «МойСклад» поддерживает только одно событие для заказа, поэтому, если оно занято другим <rspoiler text="установленным модулем">Или модуль может быть удален или не до конца установлен, а зарегистрированное событие от него осталось</rspoiler>, MeaSoft не сможет его занять, и отправка заказов работать не будет. Если у вас не отправляются заказы и вы уверены, что у вас нет других модулей, использующих это событие, обратитесь к нам в службу поддержки, мы сможем проверить занятость события и при необходимости его освободить.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=%D0%9C%D0%BE%D0%B9%D0%A1%D0%BA%D0%BB%D0%B0%D0%B4&diff=14870МойСклад2023-11-14T13:39:09Z<p>Бутусов: </p>
<hr />
<div>Интеграция предназначена для передачи заказов с товарными вложениями из системы МойСклад в MeaSoft. Обратно в МойСклад будут приходить статусы, стоимость доставки и общая сумма заказа с учетом частичной доставки.<br />
<br />
= Настройка интеграции =<br />
# Установка интеграции МойСклад производится в Личном Кабинете Курьерской службы в разделе "Настройки" -> "Интеграция". В настройке интеграции ведите логин и пароль от учетной записи системы «МойСклад» с правами администратора.<br><br>'''Примечание'''. Запрещено изменять данные этой учетной записи — это приведет к сбою интеграции. В будущем при обращении в техническую поддержку MeaSoft указывайте данные этой учетной записи для получения помощи по вопросам интеграции.<br>Если все же есть необходимость сменить учетные данные, после сообщите новый пароль от «МойСклад» в техподдержку MeaSoft для внесения изменений в настройки интеграции.<br><br><br />
# Укажите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.<br />
# Нажмите на кнопку '''Сохранить'''.<br>В случае ошибки «Данный пользователь „Мой склад“ уже зарегистрирован.» нажмите на кнопку '''Сбросить'''.<br />
# Дождитесь окончания синхронизации справочников. Не закрывайте и не перезагружайте страницу. Процесс может занять продолжительное время (от 10 минут).<br>Когда синхронизация окончится, автоматически откроется страница следующего шага.<br />
# В системе МойСклад создайте дополнительные поля в заказах. Для этого перейдите в '''Продажи''' > '''Заказы покупателей''', в правой части экрана нажмите на кнопку с шестеренкой и в разделе '''Дополнительные поля''' нажмите на кнопку '''+Поле'''. Подробнее см. в [https://support.moysklad.ru/hc/ru/articles/204653178-%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5-%D0%BF%D0%BE%D0%BB%D1%8F документации МойСклад].<br />
# Создайте следующие поля:<br />
#* с типом «Строка»:<br />
#** '''Город''' — для указания населенного пункта получателя; ''Можно не создавать, а использовать стандартное поле "Город" из поля "Адрес доставки" МойСклад''<br />
#** '''Адрес''' — для указания адреса получателя; ''Можно не создавать, а использовать стандартное поле "Адрес" из поля "Адрес доставки" МойСклад''<br />
#** '''Индекс''' — для указания индекса получателя; ''Можно не создавать, а использовать стандартное поле "Индекс" из поля "Адрес доставки" МойСклад''<br />
#** '''Дата доставки''' — для указания даты доставки наряду со временем;<br />
#** '''Сумма заказа''' — для получения суммы заказа от курьерской службы;<br />
#** '''Стоимость доставки''' — для получения стоимости доставки от курьерской службы;<br />
#** '''Строка для сохранения информации об ошибках''' — для получения текста ошибки;<br />
#** '''Количество мест''' — для возможности указания количества мест;<br />
#* с типом «Файл»:<br />
#** '''Файл''' — необязательное поле для передачи файлов. Максимальный размер файла — 1 МБ;<br />
#* с типом «Флажок»:<br />
#** '''Необходимость возврата''' — необязательное поле. Используется для передачи признака «необходимость возврата»;<br />
#** '''Оплата получателем''' — необязательное поле. Используется для передачи признака «оплата получателем»;<br />
#* с типом «Справочник»:<br />
#** '''Виды срочности''' — одноименный справочник;<br />
#** '''Временные интервалы''' — одноименный справочник;<br />
#** '''Способы доставки''' — одноименный справочник;<br />
#** '''Тип оплаты''' — одноименный справочник;<br />
#** '''Время доставки с''' — справочник '''Часы доставки''';<br />
#** '''Время доставки по''' — справочник '''Часы доставки'''.<br />
# В ЛК клиента MeaSoft обновите открытую страницу и настройте статусы отправки, соответствие статусов и полей. В выпадающем списке значений поля контрагента соответствуют следующим полям раздела '''Контрагенты''' в «МойСклад»:<br />
:::{|class="wikitable"<br />
!Поля контрагента в MeaSoft<br />
!Настройки МойСклад > Контрагенты<br />
|-<br />
|'''Наименование'''<br />
|'''Наименование'''<br />
|-<br />
|'''Email'''<br />
|'''Электронный адрес'''<br />
|-<br />
|'''Телефон'''<br />
|'''Телефон'''<br />
|-<br />
|'''Полное наименование'''<br />
|для юр. лица — '''Полное наименование'''<br> для ИП — в формате [ИП '''Фамилия''' '''Имя''' '''Отчество''']<br>для физ. лица — '''Фамилия''' '''Имя''' '''Отчество'''<br />
|-<br />
|'''Юридический адрес'''<br />
|для юр. лица — '''Юридический адрес'''<br>для ИП — '''Адрес регистрации'''<br>для физ. лица — '''Адрес регистрации'''<br />
|-<br />
|'''Фактический адрес'''<br />
|'''Фактический адрес'''<br />
|-<br />
|}<br />
: 8. Чтобы передавать заказ от имени заказчика, а не отправителя (склад, магазин), в полях '''ФИО отправителя''' и '''Телефон отправителя''' выберите значение '''Не передавать'''.<br />
: 9. Сохраните настройки.<br />
<br />
Для отправки заказа обязательно должен быть заполнен вес хотя бы одного товара.<br />
<br />
Поля '''Cтоимость доставки''', '''Сумма''' и '''Ошибка''' заполнять не нужно. Они заполнятся автоматически после синхронизации с курьерской службой.<br />
<br />
Если нужна доставка по адресу, оставьте поле '''Тип доставки''' пустым. Иначе выберите ПВЗ из списка.<br />
<br />
Поле '''Комментарий к заказу''', сопоставляется либо со стандартным полем, которое находится под списком товаров, либо к кастомному полю заказа.<br />
<br />
Поле '''Комментарий к доставке''', сопоставляется либо со стандартным полем, которое находится над списком товаров, либо к кастомному полю заказа.<br />
<br />
Чтобы отправить заказ, присвойте заказу статус для передачи в курьерскую службу.<br />
<br />
Если после сохранения заказа в статусе для передачи в курьерскую службу статус не изменился, проверьте поле '''Ошибка'''. Заполните поля, указанные в поле '''Ошибка''', очистите поле '''Ошибка''' и сохраните заказ.<br />
<br />
Чтобы проверить, передан ли заказ в курьерскую службу, зайдите в [[личный кабинет клиента]] и на вкладке '''Отслеживание''' проверьте, существует ли отправленный заказ.<br />
<br />
= Обновление данных из ЛК =<br />
<br />
Уже после того, как вы настроили интеграцию, в ЛК Курьерской Службы могут появиться новые ПВЗ, новые режимы доставки и тд.<br />
<br />
Чтобы перенести эти данные в МойСклад в настройках интеграции вам нужно нажать кнопку "Запустить перезагрузку" в разделе "Перезагрузить данные в МойСклад" и дождаться перезагрузки данных.<br />
<br />
= Известные проблемы =<br />
<br />
Модуль интеграции не работает на бесплатном тарифе.<br />
<br />
При установке приложения в «МойСклад» регистрируется <rspoiler text="событие">веб-хук</rspoiler> на изменение заказа, чтобы «МойСклад» передавал изменения в MeaSoft. Так работают все модули служб доставки для «МойСклад». «МойСклад» поддерживает только одно событие для заказа, поэтому, если оно занято другим <rspoiler text="установленным модулем">Или модуль может быть удален или не до конца установлен, а зарегистрированное событие от него осталось</rspoiler>, MeaSoft не сможет его занять, и отправка заказов работать не будет. Если у вас не отправляются заказы и вы уверены, что у вас нет других модулей, использующих это событие, обратитесь к нам в службу поддержки, мы сможем проверить занятость события и при необходимости его освободить.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=Iiko&diff=14868Iiko2023-10-26T11:36:27Z<p>Бутусов: /* Настройка интеграции состоит из 10 несложных последовательных шагов */</p>
<hr />
<div><br />
== Настройка интеграции состоит из 10 несложных последовательных шагов ==<br />
<br />
<br />
<br />
'''1ый шаг''' - вам нужно зайти в раздел '''Настройки Cloud API'''<br />
<br />
Этот раздел находится на главной странице административного раздела Iikoweb.<br />
[[Файл:Iiko1.png|none|1000 px|]]<br />
<br />
<br />
'''2ой шаг''' - в блоке "Интеграции" нажмите кнопку "Добавить"<br />
[[Файл:Iiko2.png|none|1000 px|]]<br />
<br />
<br />
'''3ий шаг''' - в появившемся блоке заполните все поля<br />
[[Файл:Iiko3.png|none|1000 px|]]<br />
<br />
<br />
'''Имя api логина''' - любое название, например, "measoft"<br />
<br />
'''API - ключ''' - не меняем, этот ключ нам еще потребуется. Запишите его куда-то.<br />
<br />
'''Активный''' - галку не трогаем, она должна быть.<br />
<br />
'''Шаблон прав''' - все права.<br />
<br />
'''Источник заказа''' - пусто, не трогаем.<br />
<br />
'''Внешние меню''' - нажмите на данное поле, появится список меню. Отметьте галками все меню.<br />
<br />
'''Источник цен''' - внешнее меню.<br />
<br />
'''Email''' - укажите ваш Email.<br />
<br />
'''Подключенные точки''' - нажмите '''Добавить'''.<br />
<br />
Появится блок, в котором нужно будет отметить галочками все ваши рестораны и нажать сохранить.<br />
[[Файл:Iiko5.png|none|1000 px|]]<br />
<br />
<br />
По итогу у вас будет нечто такое:<br />
[[Файл:Iiko7.png|none|1000 px|]]<br />
<br />
<br />
'''4ый шаг''' - нажмите кнопку Сохранить. Если вы записали '''API - ключ''', то страницу можно закрыть.<br />
<br />
<br />
'''5ый шаг''' - создание интеграции в [[Личный кабинет клиента|ЛК пользователя]].<br />
<br />
<br />
В ЛК пользователя в разделе '''Интеграция''' -> '''Список интеграций''' напротив интеграции '''Iiko''' нажмите кнопку '''Добавить'''<br />
[[Файл:Iiko8.png|none|1000 px|]]<br />
<br />
<br />
'''6ой шаг''' - в '''поле API - ключ''' запишите '''API - ключ''' и нажмите кнопку Сохранить, которая находится внизу страницы.<br />
[[Файл:Iiko9.png|none|1000 px|]]<br />
<br />
<br />
<br />
'''6ой шаг''' - заполните поля интеграции.<br />
<br />
'''Префикс заказов''' - это префис, который будет добавлен к номеру заказа, если вам это требуется, можно оставить пустым.<br />
<br />
'''Используемые организации''' - отметьте галками организации, которые работают с доставкой.<br />
<br />
'''Используемые курьеры''' - отметьте галками тех курьеров, чьи заказы будут передаваться в ЛК.<br />
<br />
'''Настройка соответствия статусов''' - здесь вам нужно сопоставить статусы в ЛК Курьерской службы и статусы в Iiko<br />
<br />
Например '''статус Доставлен Курьерской службы''' и '''статус Доставлено Iiko'''.<br />
<br />
Все соответствия заполнять не требуется.<br />
[[Файл:Iiko13.png|none|1000 px|]]<br />
<br />
<br />
7ый шаг - нажмите '''кнопку Сохранить''' в самом низу страницы и на этом настройка завершена.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=Iiko&diff=14867Iiko2023-10-26T11:33:15Z<p>Бутусов: /* Настройка интеграции состоит из 10 несложных последовательных шагов */</p>
<hr />
<div><br />
== Настройка интеграции состоит из 10 несложных последовательных шагов ==<br />
<br />
<br />
<br />
'''1ый шаг''' - вам нужно зайти в раздел '''Настройки Cloud API'''<br />
<br />
Этот раздел находится на главной странице административного раздела Iikoweb.<br />
[[Файл:Iiko1.png|none|1000 px|]]<br />
<br />
<br />
'''2ой шаг''' - в блоке "Интеграции" нажмите кнопку "Добавить"<br />
[[Файл:Iiko2.png|none|1000 px|]]<br />
<br />
<br />
'''3ий шаг''' - в появившемся блоке заполните все поля<br />
[[Файл:Iiko3.png|none|1000 px|]]<br />
<br />
<br />
'''Имя api логина''' - любое название, например, "measoft"<br />
<br />
'''API - ключ''' - не меняем, этот ключ нам еще потребуется. Запишите его куда-то.<br />
<br />
'''Активный''' - галку не трогаем, она должна быть.<br />
<br />
'''Шаблон прав''' - все права.<br />
<br />
'''Источник заказа''' - пусто, не трогаем.<br />
<br />
'''Внешние меню''' - нажмите на данное поле, появится список меню. Отметьте галками все меню.<br />
<br />
'''Источник цен''' - внешнее меню.<br />
<br />
'''Email''' - укажите ваш Email.<br />
<br />
'''Подключенные точки''' - нажмите '''Добавить'''.<br />
<br />
Появится блок, в котором нужно будет отметить галочками все ваши рестораны и нажать сохранить.<br />
[[Файл:Iiko5.png|none|1000 px|]]<br />
<br />
<br />
По итогу у вас будет нечто такое:<br />
[[Файл:Iiko7.png|none|1000 px|]]<br />
<br />
<br />
'''4ый шаг''' - нажмите кнопку Сохранить. Если вы записали '''API - ключ''', то страницу можно закрыть.<br />
<br />
<br />
'''5ый шаг''' - создание интеграции в [[Личный кабинет клиента|ЛК пользователя]].<br />
<br />
<br />
В ЛК пользователя в разделе '''Интеграция''' -> '''Список интеграций''' напротив интеграции '''Iiko''' нажмите кнопку '''Добавить'''<br />
[[Файл:Iiko8.png|none|1000 px|]]<br />
<br />
<br />
'''6ой шаг''' - в '''поле API - ключ''' запишите '''API - ключ''' и нажмите кнопку Сохранить, которая находится внизу страницы.<br />
[[Файл:Iiko9.png|none|1000 px|]]<br />
<br />
<br />
<br />
'''6ой шаг''' - заполните поля интеграции.<br />
<br />
'''Префикс заказов''' - это префис, который будет добавлен к номеру заказа, если вам это требуется, можно оставить пустым.<br />
<br />
'''Используемые организации''' - отметьте галками организации, которые работают с доставкой.<br />
<br />
'''Используемые курьеры''' - отметьте галками тех курьеров, чьи заказы будут передаваться в ЛК.<br />
<br />
'''Настройка соответствия статусов''' - здесь вам нужно сопоставить статусы в ЛК Курьерской службы и статусы в Iiko<br />
<br />
Например '''статус Доставлен Курьерской службы''' и '''статус Доставлено Iiko'''.<br />
<br />
Все соответствия заполнять не требуется.<br />
[[Файл:Iiko13.png|none|1000 px|]]<br />
<br />
<br />
10ый шаг - нажмите '''кнопку Сохранить''' в самом низу страницы и на этом настройка завершена.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=%D0%9C%D0%BE%D0%B9%D0%A1%D0%BA%D0%BB%D0%B0%D0%B4&diff=14866МойСклад2023-10-26T03:41:29Z<p>Бутусов: /* Настройка интеграции */</p>
<hr />
<div>Интеграция предназначена для передачи заказов с товарными вложениями из системы МойСклад в MeaSoft. Обратно в МойСклад будут приходить статусы, стоимость доставки и общая сумма заказа с учетом частичной доставки.<br />
<br />
= Настройка интеграции =<br />
# Установка интеграции МойСклад производится в Личном Кабинете Курьерской службы в разделе "Настройки" -> "Интеграция". В настройке интеграции ведите логин и пароль от учетной записи системы «МойСклад» с правами администратора.<br><br>'''Примечание'''. Запрещено изменять данные этой учетной записи — это приведет к сбою интеграции. В будущем при обращении в техническую поддержку MeaSoft указывайте данные этой учетной записи для получения помощи по вопросам интеграции.<br>Если все же есть необходимость сменить учетные данные, после сообщите новый пароль от «МойСклад» в техподдержку MeaSoft для внесения изменений в настройки интеграции.<br><br><br />
# Укажите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.<br />
# Нажмите на кнопку '''Сохранить'''.<br>В случае ошибки «Данный пользователь „Мой склад“ уже зарегистрирован.» нажмите на кнопку '''Сбросить'''.<br />
# Дождитесь окончания синхронизации справочников. Не закрывайте и не перезагружайте страницу. Процесс может занять продолжительное время (от 10 минут).<br>Когда синхронизация окончится, автоматически откроется страница следующего шага.<br />
# В системе МойСклад создайте дополнительные поля в заказах. Для этого перейдите в '''Продажи''' > '''Заказы покупателей''', в правой части экрана нажмите на кнопку с шестеренкой и в разделе '''Дополнительные поля''' нажмите на кнопку '''+Поле'''. Подробнее см. в [https://support.moysklad.ru/hc/ru/articles/204653178-%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5-%D0%BF%D0%BE%D0%BB%D1%8F документации МойСклад].<br />
# Создайте следующие поля:<br />
#* с типом «Строка»:<br />
#** '''Город''' — для указания населенного пункта получателя; ''Можно не создавать, а использовать стандартное поле "Город" из поля "Адрес доставки" МойСклад''<br />
#** '''Адрес''' — для указания адреса получателя; ''Можно не создавать, а использовать стандартное поле "Адрес" из поля "Адрес доставки" МойСклад''<br />
#** '''Индекс''' — для указания индекса получателя; ''Можно не создавать, а использовать стандартное поле "Индекс" из поля "Адрес доставки" МойСклад''<br />
#** '''Дата доставки''' — для указания даты доставки наряду со временем;<br />
#** '''Сумма заказа''' — для получения суммы заказа от курьерской службы;<br />
#** '''Стоимость доставки''' — для получения стоимости доставки от курьерской службы;<br />
#** '''Строка для сохранения информации об ошибках''' — для получения текста ошибки;<br />
#** '''Количество мест''' — для возможности указания количества мест;<br />
#* с типом «Файл»:<br />
#** '''Файл''' — необязательное поле для передачи файлов. Максимальный размер файла — 1 МБ;<br />
#* с типом «Флажок»:<br />
#** '''Необходимость возврата''' — необязательное поле для передачи признака «необходимость возврата»;<br />
#* с типом «Справочник»:<br />
#** '''Виды срочности''' — одноименный справочник;<br />
#** '''Временные интервалы''' — одноименный справочник;<br />
#** '''Способы доставки''' — одноименный справочник;<br />
#** '''Тип оплаты''' — одноименный справочник;<br />
#** '''Время доставки с''' — справочник '''Часы доставки''';<br />
#** '''Время доставки по''' — справочник '''Часы доставки'''.<br />
# В ЛК клиента MeaSoft обновите открытую страницу и настройте статусы отправки, соответствие статусов и полей. В выпадающем списке значений поля контрагента соответствуют следующим полям раздела '''Контрагенты''' в «МойСклад»:<br />
:::{|class="wikitable"<br />
!Поля контрагента в MeaSoft<br />
!Настройки МойСклад > Контрагенты<br />
|-<br />
|'''Наименование'''<br />
|'''Наименование'''<br />
|-<br />
|'''Email'''<br />
|'''Электронный адрес'''<br />
|-<br />
|'''Телефон'''<br />
|'''Телефон'''<br />
|-<br />
|'''Полное наименование'''<br />
|для юр. лица — '''Полное наименование'''<br> для ИП — в формате [ИП '''Фамилия''' '''Имя''' '''Отчество''']<br>для физ. лица — '''Фамилия''' '''Имя''' '''Отчество'''<br />
|-<br />
|'''Юридический адрес'''<br />
|для юр. лица — '''Юридический адрес'''<br>для ИП — '''Адрес регистрации'''<br>для физ. лица — '''Адрес регистрации'''<br />
|-<br />
|'''Фактический адрес'''<br />
|'''Фактический адрес'''<br />
|-<br />
|}<br />
: 8. Чтобы передавать заказ от имени заказчика, а не отправителя (склад, магазин), в полях '''ФИО отправителя''' и '''Телефон отправителя''' выберите значение '''Не передавать'''.<br />
: 9. Сохраните настройки.<br />
<br />
Для отправки заказа обязательно должен быть заполнен вес хотя бы одного товара.<br />
<br />
Поля '''Cтоимость доставки''', '''Сумма''' и '''Ошибка''' заполнять не нужно. Они заполнятся автоматически после синхронизации с курьерской службой.<br />
<br />
Если нужна доставка по адресу, оставьте поле '''Тип доставки''' пустым. Иначе выберите ПВЗ из списка.<br />
<br />
Поле '''Комментарий к заказу''', сопоставляется либо со стандартным полем, которое находится под списком товаров, либо к кастомному полю заказа.<br />
<br />
Поле '''Комментарий к доставке''', сопоставляется либо со стандартным полем, которое находится над списком товаров, либо к кастомному полю заказа.<br />
<br />
Чтобы отправить заказ, присвойте заказу статус для передачи в курьерскую службу.<br />
<br />
Если после сохранения заказа в статусе для передачи в курьерскую службу статус не изменился, проверьте поле '''Ошибка'''. Заполните поля, указанные в поле '''Ошибка''', очистите поле '''Ошибка''' и сохраните заказ.<br />
<br />
Чтобы проверить, передан ли заказ в курьерскую службу, зайдите в [[личный кабинет клиента]] и на вкладке '''Отслеживание''' проверьте, существует ли отправленный заказ.<br />
<br />
= Обновление данных из ЛК =<br />
<br />
Уже после того, как вы настроили интеграцию, в ЛК Курьерской Службы могут появиться новые ПВЗ, новые режимы доставки и тд.<br />
<br />
Чтобы перенести эти данные в МойСклад в настройках интеграции вам нужно нажать кнопку "Запустить перезагрузку" в разделе "Перезагрузить данные в МойСклад" и дождаться перезагрузки данных.<br />
<br />
= Известные проблемы =<br />
<br />
Модуль интеграции не работает на бесплатном тарифе.<br />
<br />
При установке приложения в «МойСклад» регистрируется <rspoiler text="событие">веб-хук</rspoiler> на изменение заказа, чтобы «МойСклад» передавал изменения в MeaSoft. Так работают все модули служб доставки для «МойСклад». «МойСклад» поддерживает только одно событие для заказа, поэтому, если оно занято другим <rspoiler text="установленным модулем">Или модуль может быть удален или не до конца установлен, а зарегистрированное событие от него осталось</rspoiler>, MeaSoft не сможет его занять, и отправка заказов работать не будет. Если у вас не отправляются заказы и вы уверены, что у вас нет других модулей, использующих это событие, обратитесь к нам в службу поддержки, мы сможем проверить занятость события и при необходимости его освободить.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=%D0%9C%D0%BE%D0%B9%D0%A1%D0%BA%D0%BB%D0%B0%D0%B4&diff=14865МойСклад2023-10-26T03:39:52Z<p>Бутусов: /* Настройка интеграции */</p>
<hr />
<div>Интеграция предназначена для передачи заказов с товарными вложениями из системы МойСклад в MeaSoft. Обратно в МойСклад будут приходить статусы, стоимость доставки и общая сумма заказа с учетом частичной доставки.<br />
<br />
= Настройка интеграции =<br />
# Установка интеграции МойСклад производится в Личном Кабинете Курьерской службы в разделе "Настройки" -> "Интеграция". В настройке интеграции ведите логин и пароль от учетной записи системы «МойСклад» с правами администратора.<br><br>'''Примечание'''. Запрещено изменять данные этой учетной записи — это приведет к сбою интеграции. В будущем при обращении в техническую поддержку MeaSoft указывайте данные этой учетной записи для получения помощи по вопросам интеграции.<br>Если все же есть необходимость сменить учетные данные, после сообщите новый пароль от «МойСклад» в техподдержку MeaSoft для внесения изменений в настройки интеграции.<br><br><br />
# Укажите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.<br />
# Нажмите на кнопку '''Сохранить'''.<br>В случае ошибки «Данный пользователь „Мой склад“ уже зарегистрирован.» нажмите на кнопку '''Сбросить'''.<br />
# Дождитесь окончания синхронизации справочников. Не закрывайте и не перезагружайте страницу. Процесс может занять продолжительное время (от 10 минут).<br>Когда синхронизация окончится, автоматически откроется страница следующего шага.<br />
# В системе МойСклад создайте дополнительные поля в заказах. Для этого перейдите в '''Продажи''' > '''Заказы покупателей''', в правой части экрана нажмите на кнопку с шестеренкой и в разделе '''Дополнительные поля''' нажмите на кнопку '''+Поле'''. Подробнее см. в [https://support.moysklad.ru/hc/ru/articles/204653178-%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5-%D0%BF%D0%BE%D0%BB%D1%8F документации МойСклад].<br />
# Создайте следующие поля:<br />
#* с типом «Строка»:<br />
#** '''Город''' — для указания населенного пункта получателя; ''Можно не создавать, а использовать стандартное поле Город из Адрес доставки МойСклад''<br />
#** '''Адрес''' — для указания адреса получателя; ''Можно не создавать, а использовать стандартное поле Адрес из Адрес доставки МойСклад''<br />
#** '''Индекс''' — для указания индекса получателя; ''Можно не создавать, а использовать стандартное поле Индекс из Адрес доставки МойСклад''<br />
#** '''Дата доставки''' — для указания даты доставки наряду со временем;<br />
#** '''Сумма заказа''' — для получения суммы заказа от курьерской службы;<br />
#** '''Стоимость доставки''' — для получения стоимости доставки от курьерской службы;<br />
#** '''Строка для сохранения информации об ошибках''' — для получения текста ошибки;<br />
#** '''Количество мест''' — для возможности указания количества мест;<br />
#* с типом «Файл»:<br />
#** '''Файл''' — необязательное поле для передачи файлов. Максимальный размер файла — 1 МБ;<br />
#* с типом «Флажок»:<br />
#** '''Необходимость возврата''' — необязательное поле для передачи признака «необходимость возврата»;<br />
#* с типом «Справочник»:<br />
#** '''Виды срочности''' — одноименный справочник;<br />
#** '''Временные интервалы''' — одноименный справочник;<br />
#** '''Способы доставки''' — одноименный справочник;<br />
#** '''Тип оплаты''' — одноименный справочник;<br />
#** '''Время доставки с''' — справочник '''Часы доставки''';<br />
#** '''Время доставки по''' — справочник '''Часы доставки'''.<br />
# В ЛК клиента MeaSoft обновите открытую страницу и настройте статусы отправки, соответствие статусов и полей. В выпадающем списке значений поля контрагента соответствуют следующим полям раздела '''Контрагенты''' в «МойСклад»:<br />
:::{|class="wikitable"<br />
!Поля контрагента в MeaSoft<br />
!Настройки МойСклад > Контрагенты<br />
|-<br />
|'''Наименование'''<br />
|'''Наименование'''<br />
|-<br />
|'''Email'''<br />
|'''Электронный адрес'''<br />
|-<br />
|'''Телефон'''<br />
|'''Телефон'''<br />
|-<br />
|'''Полное наименование'''<br />
|для юр. лица — '''Полное наименование'''<br> для ИП — в формате [ИП '''Фамилия''' '''Имя''' '''Отчество''']<br>для физ. лица — '''Фамилия''' '''Имя''' '''Отчество'''<br />
|-<br />
|'''Юридический адрес'''<br />
|для юр. лица — '''Юридический адрес'''<br>для ИП — '''Адрес регистрации'''<br>для физ. лица — '''Адрес регистрации'''<br />
|-<br />
|'''Фактический адрес'''<br />
|'''Фактический адрес'''<br />
|-<br />
|}<br />
: 8. Чтобы передавать заказ от имени заказчика, а не отправителя (склад, магазин), в полях '''ФИО отправителя''' и '''Телефон отправителя''' выберите значение '''Не передавать'''.<br />
: 9. Сохраните настройки.<br />
<br />
Для отправки заказа обязательно должен быть заполнен вес хотя бы одного товара.<br />
<br />
Поля '''Cтоимость доставки''', '''Сумма''' и '''Ошибка''' заполнять не нужно. Они заполнятся автоматически после синхронизации с курьерской службой.<br />
<br />
Если нужна доставка по адресу, оставьте поле '''Тип доставки''' пустым. Иначе выберите ПВЗ из списка.<br />
<br />
Поле '''Комментарий к заказу''', сопоставляется либо со стандартным полем, которое находится под списком товаров, либо к кастомному полю заказа.<br />
<br />
Поле '''Комментарий к доставке''', сопоставляется либо со стандартным полем, которое находится над списком товаров, либо к кастомному полю заказа.<br />
<br />
Чтобы отправить заказ, присвойте заказу статус для передачи в курьерскую службу.<br />
<br />
Если после сохранения заказа в статусе для передачи в курьерскую службу статус не изменился, проверьте поле '''Ошибка'''. Заполните поля, указанные в поле '''Ошибка''', очистите поле '''Ошибка''' и сохраните заказ.<br />
<br />
Чтобы проверить, передан ли заказ в курьерскую службу, зайдите в [[личный кабинет клиента]] и на вкладке '''Отслеживание''' проверьте, существует ли отправленный заказ.<br />
<br />
= Обновление данных из ЛК =<br />
<br />
Уже после того, как вы настроили интеграцию, в ЛК Курьерской Службы могут появиться новые ПВЗ, новые режимы доставки и тд.<br />
<br />
Чтобы перенести эти данные в МойСклад в настройках интеграции вам нужно нажать кнопку "Запустить перезагрузку" в разделе "Перезагрузить данные в МойСклад" и дождаться перезагрузки данных.<br />
<br />
= Известные проблемы =<br />
<br />
Модуль интеграции не работает на бесплатном тарифе.<br />
<br />
При установке приложения в «МойСклад» регистрируется <rspoiler text="событие">веб-хук</rspoiler> на изменение заказа, чтобы «МойСклад» передавал изменения в MeaSoft. Так работают все модули служб доставки для «МойСклад». «МойСклад» поддерживает только одно событие для заказа, поэтому, если оно занято другим <rspoiler text="установленным модулем">Или модуль может быть удален или не до конца установлен, а зарегистрированное событие от него осталось</rspoiler>, MeaSoft не сможет его занять, и отправка заказов работать не будет. Если у вас не отправляются заказы и вы уверены, что у вас нет других модулей, использующих это событие, обратитесь к нам в службу поддержки, мы сможем проверить занятость события и при необходимости его освободить.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=%D0%9C%D0%BE%D0%B9%D0%A1%D0%BA%D0%BB%D0%B0%D0%B4&diff=14864МойСклад2023-10-25T06:19:18Z<p>Бутусов: </p>
<hr />
<div>Интеграция предназначена для передачи заказов с товарными вложениями из системы МойСклад в MeaSoft. Обратно в МойСклад будут приходить статусы, стоимость доставки и общая сумма заказа с учетом частичной доставки.<br />
<br />
= Настройка интеграции =<br />
# Установка интеграции МойСклад производится в Личном Кабинете Курьерской службы в разделе "Настройки" -> "Интеграция". В настройке интеграции ведите логин и пароль от учетной записи системы «МойСклад» с правами администратора.<br><br>'''Примечание'''. Запрещено изменять данные этой учетной записи — это приведет к сбою интеграции. В будущем при обращении в техническую поддержку MeaSoft указывайте данные этой учетной записи для получения помощи по вопросам интеграции.<br>Если все же есть необходимость сменить учетные данные, после сообщите новый пароль от «МойСклад» в техподдержку MeaSoft для внесения изменений в настройки интеграции.<br><br><br />
# Укажите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.<br />
# Нажмите на кнопку '''Сохранить'''.<br>В случае ошибки «Данный пользователь „Мой склад“ уже зарегистрирован.» нажмите на кнопку '''Сбросить'''.<br />
# Дождитесь окончания синхронизации справочников. Не закрывайте и не перезагружайте страницу. Процесс может занять продолжительное время (от 10 минут).<br>Когда синхронизация окончится, автоматически откроется страница следующего шага.<br />
# В системе МойСклад создайте дополнительные поля в заказах. Для этого перейдите в '''Продажи''' > '''Заказы покупателей''', в правой части экрана нажмите на кнопку с шестеренкой и в разделе '''Дополнительные поля''' нажмите на кнопку '''+Поле'''. Подробнее см. в [https://support.moysklad.ru/hc/ru/articles/204653178-%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5-%D0%BF%D0%BE%D0%BB%D1%8F документации МойСклад].<br />
# Создайте следующие поля:<br />
#* с типом «Строка»:<br />
#** '''Город''' — для указания населенного пункта получателя;<br />
#** '''Дата доставки''' — для указания даты доставки наряду со временем;<br />
#** '''Сумма заказа''' — для получения суммы заказа от курьерской службы;<br />
#** '''Стоимость доставки''' — для получения стоимости доставки от курьерской службы;<br />
#** '''Строка для сохранения информации об ошибках''' — для получения текста ошибки;<br />
#** '''Количество мест''' — для возможности указания количества мест;<br />
#* с типом «Файл»:<br />
#** '''Файл''' — необязательное поле для передачи файлов. Максимальный размер файла — 1 МБ;<br />
#* с типом «Флажок»:<br />
#** '''Необходимость возврата''' — необязательное поле для передачи признака «необходимость возврата»;<br />
#* с типом «Справочник»:<br />
#** '''Виды срочности''' — одноименный справочник;<br />
#** '''Временные интервалы''' — одноименный справочник;<br />
#** '''Способы доставки''' — одноименный справочник;<br />
#** '''Тип оплаты''' — одноименный справочник;<br />
#** '''Время доставки с''' — справочник '''Часы доставки''';<br />
#** '''Время доставки по''' — справочник '''Часы доставки'''.<br />
# В ЛК клиента MeaSoft обновите открытую страницу и настройте статусы отправки, соответствие статусов и полей. В выпадающем списке значений поля контрагента соответствуют следующим полям раздела '''Контрагенты''' в «МойСклад»:<br />
:::{|class="wikitable"<br />
!Поля контрагента в MeaSoft<br />
!Настройки МойСклад > Контрагенты<br />
|-<br />
|'''Наименование'''<br />
|'''Наименование'''<br />
|-<br />
|'''Email'''<br />
|'''Электронный адрес'''<br />
|-<br />
|'''Телефон'''<br />
|'''Телефон'''<br />
|-<br />
|'''Полное наименование'''<br />
|для юр. лица — '''Полное наименование'''<br> для ИП — в формате [ИП '''Фамилия''' '''Имя''' '''Отчество''']<br>для физ. лица — '''Фамилия''' '''Имя''' '''Отчество'''<br />
|-<br />
|'''Юридический адрес'''<br />
|для юр. лица — '''Юридический адрес'''<br>для ИП — '''Адрес регистрации'''<br>для физ. лица — '''Адрес регистрации'''<br />
|-<br />
|'''Фактический адрес'''<br />
|'''Фактический адрес'''<br />
|-<br />
|}<br />
: 8. Чтобы передавать заказ от имени заказчика, а не отправителя (склад, магазин), в полях '''ФИО отправителя''' и '''Телефон отправителя''' выберите значение '''Не передавать'''.<br />
: 9. Сохраните настройки.<br />
<br />
Для отправки заказа обязательно должен быть заполнен вес хотя бы одного товара.<br />
<br />
Поля '''Cтоимость доставки''', '''Сумма''' и '''Ошибка''' заполнять не нужно. Они заполнятся автоматически после синхронизации с курьерской службой.<br />
<br />
Если нужна доставка по адресу, оставьте поле '''Тип доставки''' пустым. Иначе выберите ПВЗ из списка.<br />
<br />
Поле '''Комментарий к заказу''', сопоставляется либо со стандартным полем, которое находится под списком товаров, либо к кастомному полю заказа.<br />
<br />
Поле '''Комментарий к доставке''', сопоставляется либо со стандартным полем, которое находится над списком товаров, либо к кастомному полю заказа.<br />
<br />
Чтобы отправить заказ, присвойте заказу статус для передачи в курьерскую службу.<br />
<br />
Если после сохранения заказа в статусе для передачи в курьерскую службу статус не изменился, проверьте поле '''Ошибка'''. Заполните поля, указанные в поле '''Ошибка''', очистите поле '''Ошибка''' и сохраните заказ.<br />
<br />
Чтобы проверить, передан ли заказ в курьерскую службу, зайдите в [[личный кабинет клиента]] и на вкладке '''Отслеживание''' проверьте, существует ли отправленный заказ.<br />
<br />
<br />
= Обновление данных из ЛК =<br />
<br />
Уже после того, как вы настроили интеграцию, в ЛК Курьерской Службы могут появиться новые ПВЗ, новые режимы доставки и тд.<br />
<br />
Чтобы перенести эти данные в МойСклад в настройках интеграции вам нужно нажать кнопку "Запустить перезагрузку" в разделе "Перезагрузить данные в МойСклад" и дождаться перезагрузки данных.<br />
<br />
= Известные проблемы =<br />
<br />
Модуль интеграции не работает на бесплатном тарифе.<br />
<br />
При установке приложения в «МойСклад» регистрируется <rspoiler text="событие">веб-хук</rspoiler> на изменение заказа, чтобы «МойСклад» передавал изменения в MeaSoft. Так работают все модули служб доставки для «МойСклад». «МойСклад» поддерживает только одно событие для заказа, поэтому, если оно занято другим <rspoiler text="установленным модулем">Или модуль может быть удален или не до конца установлен, а зарегистрированное событие от него осталось</rspoiler>, MeaSoft не сможет его занять, и отправка заказов работать не будет. Если у вас не отправляются заказы и вы уверены, что у вас нет других модулей, использующих это событие, обратитесь к нам в службу поддержки, мы сможем проверить занятость события и при необходимости его освободить.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=%D0%9C%D0%BE%D0%B9%D0%A1%D0%BA%D0%BB%D0%B0%D0%B4&diff=14863МойСклад2023-10-25T06:19:06Z<p>Бутусов: </p>
<hr />
<div>Интеграция предназначена для передачи заказов с товарными вложениями из системы МойСклад в MeaSoft. Обратно в МойСклад будут приходить статусы, стоимость доставки и общая сумма заказа с учетом частичной доставки.<br />
<br />
= Настройка интеграции =<br />
# Установка интеграции МойСклад производится в Личном Кабинете Курьерской службы в разделе "Настройки" -> "Интеграция". В настройке интеграции ведите логин и пароль от учетной записи системы «МойСклад» с правами администратора.<br><br>'''Примечание'''. Запрещено изменять данные этой учетной записи — это приведет к сбою интеграции. В будущем при обращении в техническую поддержку MeaSoft указывайте данные этой учетной записи для получения помощи по вопросам интеграции.<br>Если все же есть необходимость сменить учетные данные, после сообщите новый пароль от «МойСклад» в техподдержку MeaSoft для внесения изменений в настройки интеграции.<br><br><br />
# Укажите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.<br />
# Нажмите на кнопку '''Сохранить'''.<br>В случае ошибки «Данный пользователь „Мой склад“ уже зарегистрирован.» нажмите на кнопку '''Сбросить'''.<br />
# Дождитесь окончания синхронизации справочников. Не закрывайте и не перезагружайте страницу. Процесс может занять продолжительное время (от 10 минут).<br>Когда синхронизация окончится, автоматически откроется страница следующего шага.<br />
# В системе МойСклад создайте дополнительные поля в заказах. Для этого перейдите в '''Продажи''' > '''Заказы покупателей''', в правой части экрана нажмите на кнопку с шестеренкой и в разделе '''Дополнительные поля''' нажмите на кнопку '''+Поле'''. Подробнее см. в [https://support.moysklad.ru/hc/ru/articles/204653178-%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5-%D0%BF%D0%BE%D0%BB%D1%8F документации МойСклад].<br />
# Создайте следующие поля:<br />
#* с типом «Строка»:<br />
#** '''Город''' — для указания населенного пункта получателя;<br />
#** '''Дата доставки''' — для указания даты доставки наряду со временем;<br />
#** '''Сумма заказа''' — для получения суммы заказа от курьерской службы;<br />
#** '''Стоимость доставки''' — для получения стоимости доставки от курьерской службы;<br />
#** '''Строка для сохранения информации об ошибках''' — для получения текста ошибки;<br />
#** '''Количество мест''' — для возможности указания количества мест;<br />
#* с типом «Файл»:<br />
#** '''Файл''' — необязательное поле для передачи файлов. Максимальный размер файла — 1 МБ;<br />
#* с типом «Флажок»:<br />
#** '''Необходимость возврата''' — необязательное поле для передачи признака «необходимость возврата»;<br />
#* с типом «Справочник»:<br />
#** '''Виды срочности''' — одноименный справочник;<br />
#** '''Временные интервалы''' — одноименный справочник;<br />
#** '''Способы доставки''' — одноименный справочник;<br />
#** '''Тип оплаты''' — одноименный справочник;<br />
#** '''Время доставки с''' — справочник '''Часы доставки''';<br />
#** '''Время доставки по''' — справочник '''Часы доставки'''.<br />
# В ЛК клиента MeaSoft обновите открытую страницу и настройте статусы отправки, соответствие статусов и полей. В выпадающем списке значений поля контрагента соответствуют следующим полям раздела '''Контрагенты''' в «МойСклад»:<br />
:::{|class="wikitable"<br />
!Поля контрагента в MeaSoft<br />
!Настройки МойСклад > Контрагенты<br />
|-<br />
|'''Наименование'''<br />
|'''Наименование'''<br />
|-<br />
|'''Email'''<br />
|'''Электронный адрес'''<br />
|-<br />
|'''Телефон'''<br />
|'''Телефон'''<br />
|-<br />
|'''Полное наименование'''<br />
|для юр. лица — '''Полное наименование'''<br> для ИП — в формате [ИП '''Фамилия''' '''Имя''' '''Отчество''']<br>для физ. лица — '''Фамилия''' '''Имя''' '''Отчество'''<br />
|-<br />
|'''Юридический адрес'''<br />
|для юр. лица — '''Юридический адрес'''<br>для ИП — '''Адрес регистрации'''<br>для физ. лица — '''Адрес регистрации'''<br />
|-<br />
|'''Фактический адрес'''<br />
|'''Фактический адрес'''<br />
|-<br />
|}<br />
: 8. Чтобы передавать заказ от имени заказчика, а не отправителя (склад, магазин), в полях '''ФИО отправителя''' и '''Телефон отправителя''' выберите значение '''Не передавать'''.<br />
: 9. Сохраните настройки.<br />
<br />
Для отправки заказа обязательно должен быть заполнен вес хотя бы одного товара.<br />
<br />
Поля '''Cтоимость доставки''', '''Сумма''' и '''Ошибка''' заполнять не нужно. Они заполнятся автоматически после синхронизации с курьерской службой.<br />
<br />
Если нужна доставка по адресу, оставьте поле '''Тип доставки''' пустым. Иначе выберите ПВЗ из списка.<br />
<br />
Поле '''Комментарий к заказу''', сопоставляется либо со стандартным полем, которое находится под списком товаров, либо к кастомному полю заказа.<br />
Поле '''Комментарий к доставке''', сопоставляется либо со стандартным полем, которое находится над списком товаров, либо к кастомному полю заказа.<br />
<br />
Чтобы отправить заказ, присвойте заказу статус для передачи в курьерскую службу.<br />
<br />
Если после сохранения заказа в статусе для передачи в курьерскую службу статус не изменился, проверьте поле '''Ошибка'''. Заполните поля, указанные в поле '''Ошибка''', очистите поле '''Ошибка''' и сохраните заказ.<br />
<br />
Чтобы проверить, передан ли заказ в курьерскую службу, зайдите в [[личный кабинет клиента]] и на вкладке '''Отслеживание''' проверьте, существует ли отправленный заказ.<br />
<br />
<br />
= Обновление данных из ЛК =<br />
<br />
Уже после того, как вы настроили интеграцию, в ЛК Курьерской Службы могут появиться новые ПВЗ, новые режимы доставки и тд.<br />
<br />
Чтобы перенести эти данные в МойСклад в настройках интеграции вам нужно нажать кнопку "Запустить перезагрузку" в разделе "Перезагрузить данные в МойСклад" и дождаться перезагрузки данных.<br />
<br />
= Известные проблемы =<br />
<br />
Модуль интеграции не работает на бесплатном тарифе.<br />
<br />
При установке приложения в «МойСклад» регистрируется <rspoiler text="событие">веб-хук</rspoiler> на изменение заказа, чтобы «МойСклад» передавал изменения в MeaSoft. Так работают все модули служб доставки для «МойСклад». «МойСклад» поддерживает только одно событие для заказа, поэтому, если оно занято другим <rspoiler text="установленным модулем">Или модуль может быть удален или не до конца установлен, а зарегистрированное событие от него осталось</rspoiler>, MeaSoft не сможет его занять, и отправка заказов работать не будет. Если у вас не отправляются заказы и вы уверены, что у вас нет других модулей, использующих это событие, обратитесь к нам в службу поддержки, мы сможем проверить занятость события и при необходимости его освободить.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=RetailCRM&diff=14862RetailCRM2023-10-23T15:41:58Z<p>Бутусов: </p>
<hr />
<div>== Настройка интеграции ==<br />
<br />
# В RetailСRM cоздайте API-ключ. Для этого откройте '''Настройки''' > '''Интеграция''' > '''Ключи доступа к API''' и нажмите на кнопку '''Добавить'''. Откроется страница «Новый ключ API». На этой странице:<br />
## В поле '''Комментарий''' введите краткое описание интеграции, например «По городу».<br />
## В поле '''Тип доступа''' выберите '''Доступ ко всем магазинам'''.<br />
## В списке '''Разрешенные методы API''' установите все флажки.<br />
## Нажмите на кнопку '''Сохранить'''.<br />
#: API-ключей может быть несколько, и для каждого API-ключа необходимо выполнить эти настройки. Подробнее об управлении API-ключами см. [https://help.retailcrm.ru/Users/ApiKeys документацию RetailCRM].<br />
# Настройте интеграцию в [[Личный кабинет клиента#Интеграция|личном кабинете клиента MeaSoft]]:<br />
## Выберите пункт основного меню '''Настройки''' > '''Интеграция''', перейдите на вкладку '''Настройки интеграции''' и в списке «Все интеграции» в строке «RetailCRM» нажмите '''Добавить'''. <br />
## В окне «Настройка интеграции RetailCRM» укажите название интеграции, домен RetailCRM, созданный выше API-ключ. При необходимости укажите значения других полей. Описание некоторых полей:<br />
##* '''Получать статусы доставки''' — выберите '''Получать''', чтобы в RetailCRM передавались статусы заказа из MeaSoft. Настройки передачи статусов для RetailCRM см. в разделе [[#Передача статусов из MeaSoft|«Передача статусов из MeaSoft»]];<br />
##* '''Получать тип и сумму оплаты''' — выберите значение '''Получать''', чтобы получать тип и сумму оплаты из MeaSoft. Если тип оплаты, указанный в заказе, не совпадает с типом оплаты в MeaSoft и цена заказа не равна нулю, платеж в RetailCRM удаляется, создается новый платеж с суммой и типом оплаты из MeaSoft. Данные передаются, если в заказе осталась только одна сумма к оплате;<br />
##* '''Код поля для имени курьера''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое будет передано имя курьера. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM];<br />
##* '''Код статуса оплаты''' — укажите символьный код статуса платежа, чтобы в RetailCRM отображался статус платежа после доставки заказа. Чтобы увидеть символьный код статуса, в RetailCRM выберите '''Настройки''' > '''Справочники''' > '''Статусы оплат'''. Статус платежа передается, если на момент закрытия заказа оставалась только одна сумма к оплате;<br />
##* '''Использовать данные склада как отправителя''' — если выбрано значение '''Использовать''', данные отправителя заполняются следующей информацией о складе: адрес, название склада, телефон контактного лица ('''Настройки''' > '''Магазины''' > '''Склады''');<br />
##* '''Передавать ФИО получателя из пользовательского поля''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое вводится имя фактического получателя. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM];<br />
##* '''Передавать телефон получателя из пользовательского поля''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое вводится телефон фактического получателя. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM].<br />
##* '''Обновлять заказ при изменении''' — определяет, будет ли заказ в MeaSoft обновлен при изменении данных на стороне RetailCRM. Возможные значения: '''Да''', '''Нет'''.<br />
#: По завершении настройки нажмите '''Сохранить'''.<br />
# Настройте интеграцию в RetailCRM:<br />
## Откройте '''Настройки''' > '''Справочники''' > '''Типы доставок''' и на странице «Типы доставок» нажмите на кнопку '''Добавить'''. Откроется окно «Новая доставка»:[[Файл:Retail1.png|none|1000 px|]]<br />
## В этом окне заполните обязательные поля и в выпадающем списке '''Интегрировать с''' выберите значение '''Курьерская служба 2008'''.<br />
## Нажмите '''Сохранить'''.<br />
<br />
'''Примечание'''. Интеграция привязана к личному кабинету клиента курьерской службы. При необходимости работать из другого личного кабинета создайте новую интеграцию, начиная с пункта настройки в личном кабинете.<br />
<br />
Чтобы отправлять заказы в курьерскую службу по статусам и отменять при изменении типа доставки, используйте [[RetailCRM#Настройка триггеров|триггеры]].<br />
<br />
== Передача типа платежа в ЛК из retailCRM ==<br />
Если символьный код передаваемого платежа содержит вхождение слова "card", то платеж передается как Карта, иначе Наличные.<br />
Если заказ будет оплачен, то передается NO.<br />
<br />
<br />
== Исключение печати чеков ==<br />
В настройках интеграции есть настройка '''Не печатать чеки для способа оплаты'''.<br />
<br />
Данная настройка выводит список способов оплаты из retailCRM.<br />
<br />
Вы можете выбрать те способы оплаты, при наличии которых в заказе в систему MeaSoft будет передана нулевая цена по товарам и нулевая сумма по заказу. Это полезно для оплаты заказа безналом по счету юр.лицами и для перемещения товаров между своими складами без оплаты.<br />
<br />
== Передача наложенного платежа ==<br />
<br />
Чтобы настроить корректную передачу наложенного платежа:<br />
# Откройте '''Настройки''' > '''Интеграция''' и выберите модуль MEASOFT.<br />
# На странице «Настройки интеграции с Курьерская служба 2008» перейдите на вкладку '''Доставка''' и на панели справа выберите пункт '''Способы оплаты'''.<br />
# Установите флажки для способов оплаты, которые могут использоваться для передачи наложенного платежа, и нажмите '''Сохранить '''.[[Файл:Retail5.png|none|1000 px]]<br />
<br />
== Передача статусов из MeaSoft ==<br />
<br />
Чтобы получать статусы заказа из MeaSoft:<br />
# Откройте '''Настройки''' > '''Интеграция''' и выберите модуль MEASOFT.<br />
# На странице «Настройки интеграции с Курьерская служба 2008» перейдите на вкладку '''Доставка''' и на панели справа выберите пункт '''Статусы'''.<br />
# Настройте сопоставление статусов MeaSoft и RetailCRM. Для этого в столбце «Статус в RetailCRM» из выпадающего списка выберите соответствие для каждого статуса службы доставки. ''' [[Файл:Retail передача статусов.png|none|1000 px]]<br />
# Нажмите на кнопку '''Сохранить'''.<br />
<br />
Статус из MeaSoft в RetailCRM передается 1 раз в 30 минут. Поэтому некоторые промежуточные статусы для заказа могут быть пропущены, и будет показан последний выставленный на момент синхронизации статус заказа.<br />
<br />
== Проверка интеграции ==<br />
Чтобы проверить настройки интеграции:<br />
# Перейдите в форму создания заказа и убедитесь, что в списке '''Тип доставки''' появилось соответствующее значение:[[Файл:Retail2.png|none|1000 px]]<br />
# Нажмите '''Выбрать тариф'''. Тарифы должны передаваться из настроек курьерской службы:[[Файл:Retail3.png|none|800 px]]<br>В случае ошибки обратитесь в курьерскую службу для настройки тарифов. Проверить тарифы можно в ЛК MeaSoft в разделе '''Калькулятор'''.<br />
<br />
==Печатные формы ==<br />
<br />
Чтобы в RetailCRM формировать печатные формы, аналогичные формам в Личном кабинете MeaSoft, используйте один из следующих способов:<br />
* в сохраненном заказе на панели действий сверху нажмите '''Печать''' и выберите нужную печатную форму «Курьерская служба»;<br />
* в списке заказов отметьте заказы флажками, внизу страницы нажмите '''Действия''' > '''Распечатать документы''' и выберите печатную форму «Курьерская служба».<br />
<br />
== Настройка триггеров ==<br />
<br />
;Триггер<br />
:Хранимая процедура специального типа, автоматически выполняющаяся при наступлении заданного события.<br />
<br />
Пример: каждый месяц 1-го числа списывается абонентская плата за интернет. Триггер «1-ый день месяца» — это событие, при наступлении которого срабатывает процедура «списание абонентской платы».<br />
<br />
Триггеры используются для автоматической отправки заказов в курьерскую службу и необязательны для работы модуля. Вы можете отправлять заказы вручную, снимая флажок '''Не синхронизировать со службой доставки''' в разделе '''Доставка''' на странице заказа перед его сохранением. <br />
<br />
Для RetailCRM предусмотрены следующие триггеры:<br />
* [[Настройка триггеров для RetailCRM#Передача заказа при смене статуса|«Отправка заказа в MeaSoft»]] — при наступлении события «Смена статуса заказа на "Отправлен в MeaSoft"». При установке статуса, означающего, что заказ отправлен в курьерскую службу, срабатывает триггер, и заказ передается в MeaSoft;<br />
* [[Настройка триггеров для RetailCRM#Отмена заказа при смене типа доставки|«Отмена заказа в MeaSoft»]] — при наступлении события «Смена типа доставки у заказа». При изменении типа доставки с доставки MeaSoft на доставку, например, Почтой России, заказ в MeaSoft отменяется, если он туда передан и имеет статус «Новый» или «Ожидает синхронизации»;<br />
* [[Настройка триггеров для RetailCRM#Передача изменений заказа|«Изменения заказа в MeaSoft»]] — при наступлении события «Изменение заказа в RetailCRM». При изменении заказа в RetailCRM новые данные отправляются в MeSoft, если заказ передан и имеет статус «Новый» или «Ожидает синхронизации».<br />
<br />
'''Примечание.''' Триггеры отправки и обновления данных заказа не учитывают [[#Передача наложенного платежа|типы оплат для наложенного платежа]]. Поэтому если наложенный платеж для неоплаченного заказа равен нулю (например, при оплате на сайте), триггер все равно передаст сумму к оплате. Для корректной отправки таких заказов не используйте триггеры.<br />
<br />
=== Передача заказа при смене статуса ===<br />
<br />
Чтобы настроить триггер:<br />
# Cоздайте пользовательский статус заказа, при установке которого заказ будет автоматически передаваться в курьерскую службу. Можно создать любое количество статусов.<br />
## В RetailCRM выберите '''Настройки''' > '''Статусы''' и нажмите на кнопку '''Добавить'''. Откроется окно «Новый статус»: [[Файл:Rcrm trig103.png|600 px|none]]<br />
## Заполните поля формы. В поле '''Символьный код''' используйте только цифры и латинские буквы без пробелов. Запишите созданный символьный код, он понадобится на следующих шагах.<br />
# Выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. Запишите символьные коды доставок, которые будут использоваться в триггере. В примере ниже используются коды outcity и incity.[[Файл:rcrm_trig104.png|600px|none]]<br />
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».<br />
#:Заполните поля:<br />
#: '''Название'''. Название триггера, например «Отправка заказа в MeaSoft».<br />
#: В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.<br />
#: В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:<br />
#:<source lang="javascript"><br />
order.getStatus().getCode() in ["SentMeaSoft"] and order.getDeliveryType().getCode() in ["outcity","incity"] and changeSet.hasChangedField("status")<br />
</source><br />
#:где <br />
#* <code>SentMeaSoft</code> — символьный код статуса заказа. Если нужно указать 2 статуса, напишите их через запятую в виде: <code>["SentMeaSoft","SentMeaSoft_2"]</code> вместо <code>["SentMeaSoft"]</code>;<br />
#* <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать 1 тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.<br />
# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:<br />
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/trigger/retailcrm;<br />
#* '''HTTP метод''' — '''POST''';<br />
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';<br />
# Нажмите на кнопку '''Добавить параметр''' 3 раза подряд и заполните появившиеся поля следующими данными:<br />
:::{|class="wikitable"<br />
!Параметр<br />
!Значение<br />
|-<br />
|id||<nowiki>{{ order.getNumber() }}</nowiki><br />
|-<br />
|sum||<nowiki>{{ order.getIntegrationDeliveryData().getDeclaredSum() }}</nowiki><br />
|-<br />
|key||<nowiki>{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</nowiki><br />
|}<br />
::'''Примечание'''. Переносы строк не допускаются.<br />
:6. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.<br />
<br />
:[[Файл:Новый триггер.png|600 px|none]]<br />
<br />
Триггер настроен.<br />
<br />
=== Отмена заказа при смене статуса ===<br />
<br />
Чтобы настроить триггер:<br />
# Cоздайте пользовательский статус заказа, при установке которого заказ будет автоматически отменяться. Можно создать любое количество статусов. <br />
## В RetailCRM выберите '''Настройки''' > '''Статусы''' и нажмите на кнопку '''Добавить'''. Откроется окно «Новый статус»: [[Файл:Rcrm trig103.png|600 px|none]]<br />
## Заполните поля формы. В поле '''Символьный код''' используйте только цифры и латинские буквы без пробелов. Запишите созданный символьный код, он понадобится на следующих шагах.<br />
# Выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. Запишите символьные коды доставок, которые будут использоваться в триггере. В примере ниже используются коды outcity и incity.[[Файл:rcrm_trig104.png|600px|none]]<br />
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».<br />
#:Заполните поля:<br />
#: '''Название'''. Название триггера, например «Отмена заказа в MeaSoft».<br />
#: В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.<br />
#: В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:<br />
#:<source lang="javascript"><br />
order.getStatus().getCode() in ["CancelMeaSoft"] and order.getDeliveryType().getCode() in ["outcity","incity"] and changeSet.hasChangedField("status")<br />
</source><br />
#:где <br />
#* <code>CancelMeaSoft</code> — символьный код статуса заказа. Если нужно указать 2 статуса, напишите их через запятую в виде: <code>["CancelMeaSoft_1","CancelMeaSoft_2"]</code> вместо <code>["SentMeaSoft"]</code>;<br />
#* <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать 1 тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.<br />
# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:<br />
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/cancelbystatus/retailcrm;<br />
#* '''HTTP метод''' — '''POST''';<br />
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';<br />
# Нажмите на кнопку '''Добавить параметр''' 3 раза подряд и заполните появившиеся поля следующими данными:<br />
:::{|class="wikitable"<br />
!Параметр<br />
!Значение<br />
|-<br />
|id||<nowiki>{{ order.getNumber() }}</nowiki><br />
|-<br />
|key||<nowiki>{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</nowiki><br />
|}<br />
::'''Примечание'''. Переносы строк не допускаются.<br />
:6. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.<br />
<br />
:[[Файл:Новый триггер.png|600 px|none]]<br />
<br />
Триггер настроен.<br />
<br />
=== Отмена заказа при смене типа доставки ===<br />
<br />
Запрос отмены предназначен для заказов, которые еще не приняты в работу: не было изменений статуса доставки, статуса корреспонденции, времени доставки.<br />
<br />
Возможность отмены заказа есть только у курьерских служб с тарифом «Премиум» или «Максимум». По умолчанию она выключена, ее нужно включить в [[Личный кабинет курьерской службы#Параметры|личном кабинете курьерской службы]]: '''Управление ЛК''' > '''Параметры''' > '''Расширенные''' > '''Разрешить отмену и изменение заказов'''.<br />
<br />
При отмене заказа поле '''Инфо о доставке''' получает значение '''Отменено заказчиком''', поле '''Дата доставки''' заполняется текущей датой, а в поле '''Вручил курьер''' появляется системная запись '''Отмена'''.<br />
<br />
Чтобы настроить триггер:<br />
# В RetailCRM выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. [[Файл:Rcrm_trig104.png|600 px|none]]<br />
#: Запишите символьный код типа доставки (доставок), заказы которой отправляются в MeaSoft.<br />
# Перейдите в раздел '''Продажи''' и нажмите на кнопку '''Новый заказ'''. В разделе '''Доставка''' выберите тип доставки, заказы которой отправляются в MeaSoft, укажите город, вес и тариф.<br />
# В разделе '''Доставка''' появится поле '''API ключ службы доставки'''. Запишите его значение. В результате у вас есть пара «символьный код типа доставки» — «API ключ службы доставки».<br />
# Повторите действия пп. 2-3 для каждой доставки, заказы по которой отправляются в MeaSoft.<br />
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».<br />
#: Заполните поля:<br />
#* '''Название'''. Название триггера, например «Отмена заказа в MeaSoft»;<br />
#* В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.<br />
#* В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:<br />
#:<source lang="javascript"><br />
changeSet.hasChangedField("delivery_type") and changeSet.getOldValue("delivery_type").getCode() in ["outcity","incity"]<br />
</source><br />
#:где <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать один тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.<br />
# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:<br />
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/cancel/retailcrm;<br />
#* '''HTTP метод''' — '''POST''';<br />
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';<br />
# Нажмите на кнопку '''Добавить параметр''' 2 раза подряд и потом еще столько раз, сколько у вас сопоставленных пар «символьный код типа доставки» - «API ключ службы доставки». Заполните появившиеся поля следующими данными:<br />
:::{|class="wikitable"<br />
!Параметр<br />
!Значение<br />
|-<br />
|id||<nowiki>{{ order.getNumber() }}</nowiki><br />
|-<br />
|code||<nowiki>{{ changeSet.getOldValue("delivery_type").getCode() }}</nowiki><br />
|-<br />
|Cимвольный код типа доставки 1||API-ключ службы доставки 1<br />
|-<br />
|Cимвольный код типа доставки 2||API-ключ службы доставки 2<br />
|}<br />
::'''Примечание'''. Переносы строк не допускаются.<br />
:8. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.<br />
:[[Файл:Новый триггер2.png|600 px|none]]<br />
Триггер настроен.<br />
<br />
=== Передача изменений заказа ===<br />
<br />
Изменять заказ могут только курьерские службы с тарифом «Премиум» или «Максимум». По умолчанию опция выключена, ее нужно включить в [[Личный кабинет курьерской службы#Параметры|личном кабинете курьерской службы]]: '''Управление ЛК''' > '''Параметры''' > '''Расширенные''' > '''Разрешить отмену и изменение заказов'''.<br />
<br />
Чтобы настроить триггер:<br />
# В RetailCRM выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. [[Файл:Rcrm_trig104.png|600 px|none]]<br />
#: Запишите символьный код доставки (доставок), заказы которой отправляются в MeaSoft.<br />
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».<br />
#: Заполните поля:<br />
#* '''Название'''. Название триггера, например «Передача изменений заказа в MeaSoft»;<br />
#* В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.<br />
#* В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:<br />
#:<source lang="javascript"><br />
changeSet.isUpdate() and <br />
(<br />
changeSet.hasChangedField("first_name") or <br />
changeSet.hasChangedField("last_name") or <br />
changeSet.hasChangedField("patronymic") or <br />
changeSet.hasChangedField("phone") or <br />
changeSet.hasChangedField("site") or <br />
changeSet.hasChangedField("additional_phone") or<br />
changeSet.hasChangedField("email") or <br />
changeSet.hasChangedField("customer.phones") or <br />
changeSet.hasChangedField("order_product") or <br />
changeSet.hasChangedField("total_summ") or <br />
changeSet.hasChangedField("delivery_date") or <br />
changeSet.hasChangedField("delivery_time") or <br />
changeSet.hasChangedField("payments") or <br />
changeSet.hasChangedField("prepay_sum") or <br />
changeSet.hasChangedField("weight") or <br />
changeSet.hasChangedField("length") or <br />
changeSet.hasChangedField("width") or <br />
changeSet.hasChangedField("height") or <br />
changeSet.hasChangedField("payments.id") or <br />
changeSet.hasChangedField("payments.status") or <br />
changeSet.hasChangedField("payments.type") or <br />
changeSet.hasChangedField("payments.external_id") or <br />
changeSet.hasChangedField("payments.amount") or <br />
changeSet.hasChangedField("payments.paid_at") or <br />
changeSet.hasChangedField("payments.comment") or <br />
changeSet.hasChangedField("discount_manual_amount") or <br />
changeSet.hasChangedField("discount_manual_percent") <br />
)<br />
and <br />
order.getDeliveryType().getCode() in ["outcity","incity"]<br />
</source><br />
#:где <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать один тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.<br />
# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:<br />
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/update/retailcrm;<br />
#* '''HTTP метод''' — '''POST''';<br />
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';<br />
# Нажмите на кнопку '''Добавить параметр''' 3 раза подряд и заполните появившиеся поля следующими данными:<br />
:::{|class="wikitable"<br />
!Параметр<br />
!Значение<br />
|-<br />
|id||<nowiki>{{ order.getNumber() }}</nowiki><br />
|-<br />
|sum||<nowiki>{{ order.getIntegrationDeliveryData().getDeclaredSum() }}</nowiki><br />
|-<br />
|key||<nowiki>{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</nowiki><br />
|}<br />
::'''Примечание'''. Переносы строк не допускаются.<br />
:5. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.<br />
:[[Файл:Новый триггер3.png|600 px|none]]<br />
Триггер настроен.<br />
<br />
== Передача габаритов ==<br />
Габариты из retailCRM передаются стандартными средствами retailCRM.<br />
<br />
Они берутся, либо из раздела "Габариты и вес", либо из раздела "Упаковки", где вы можете распределить товары между упаковками, указав габариты и вес каждой упаковки.<br />
<br />
[[Файл:Gab.png|none|800 px]]<br />
<br />
Дополнительно можете изучить информацию здесь https://docs.retailcrm.ru/Users/OperatingActivity/Orders/OrderPage/WorkOrderPage/WorkDeliveryOrder раздел "Оформление упаковок"<br />
<br />
<br />
== Проверка работоспособности интеграции ==<br />
<br />
# Убедитесь, что выполнены все шаги [[RetailCRM#Настройка интеграции|инструкции по настройке интеграции]].<br />
# Если используются триггеры, убедитесь, что они настроены согласно [[RetailCRM#Настройка триггеров|инструкции]].<br />
# Создайте заказ, заполните требуемые данные.<br />
# Нажмите на кнопку '''Сохранить''' внизу страницы, флажок '''Не отправлять данные в службу доставки''' должен быть снят.<br>Заказ должен отправиться в курьерскую службу. Если заказ отправлен без ошибок и отображается в ЛК, значит интеграция настроена.<br />
# Если возникает ошибка, ее текст отображается наверху страницы.<br />
:: Если это ошибка заполнения формы, исправьте внесенные данные и попробуйте отправить заказ снова. Пример ошибки: «Ошибка сервиса доставки "Курьерская служба 2008": field [receiver phone] has no valid phone number».<br />
:: Если это ошибка ответа курьерской службы, сообщите об этом разработчику. Пример ошибки: «Служба доставки прислала ответ в неверном формате».<br />
Текст ошибки можно увидеть через [[Личный кабинет#Отладка|отладку]] в личном кабинете. Чтобы найти свой заказ в запросах, нажмите CTRL+F и введите в строку поиска номер заказа или ориентируйтесь на время создания заказа.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=RetailCRM&diff=14856RetailCRM2023-10-02T10:39:05Z<p>Бутусов: </p>
<hr />
<div>== Настройка интеграции ==<br />
<br />
# В RetailСRM cоздайте API-ключ. Для этого откройте '''Настройки''' > '''Интеграция''' > '''Ключи доступа к API''' и нажмите на кнопку '''Добавить'''. Откроется страница «Новый ключ API». На этой странице:<br />
## В поле '''Комментарий''' введите краткое описание интеграции, например «По городу».<br />
## В поле '''Тип доступа''' выберите '''Доступ ко всем магазинам'''.<br />
## В списке '''Разрешенные методы API''' установите все флажки.<br />
## Нажмите на кнопку '''Сохранить'''.<br />
#: API-ключей может быть несколько, и для каждого API-ключа необходимо выполнить эти настройки. Подробнее об управлении API-ключами см. [https://help.retailcrm.ru/Users/ApiKeys документацию RetailCRM].<br />
# Настройте интеграцию в [[Личный кабинет клиента#Интеграция|личном кабинете клиента MeaSoft]]:<br />
## Выберите пункт основного меню '''Настройки''' > '''Интеграция''', перейдите на вкладку '''Настройки интеграции''' и в списке «Все интеграции» в строке «RetailCRM» нажмите '''Добавить'''. <br />
## В окне «Настройка интеграции RetailCRM» укажите название интеграции, домен RetailCRM, созданный выше API-ключ. При необходимости укажите значения других полей. Описание некоторых полей:<br />
##* '''Получать статусы доставки''' — выберите '''Получать''', чтобы в RetailCRM передавались статусы заказа из MeaSoft. Настройки передачи статусов для RetailCRM см. в разделе [[#Передача статусов из MeaSoft|«Передача статусов из MeaSoft»]];<br />
##* '''Получать тип и сумму оплаты''' — выберите значение '''Получать''', чтобы получать тип и сумму оплаты из MeaSoft. Если тип оплаты, указанный в заказе, не совпадает с типом оплаты в MeaSoft и цена заказа не равна нулю, платеж в RetailCRM удаляется, создается новый платеж с суммой и типом оплаты из MeaSoft. Данные передаются, если в заказе осталась только одна сумма к оплате;<br />
##* '''Код поля для имени курьера''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое будет передано имя курьера. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM];<br />
##* '''Код статуса оплаты''' — укажите символьный код статуса платежа, чтобы в RetailCRM отображался статус платежа после доставки заказа. Чтобы увидеть символьный код статуса, в RetailCRM выберите '''Настройки''' > '''Справочники''' > '''Статусы оплат'''. Статус платежа передается, если на момент закрытия заказа оставалась только одна сумма к оплате;<br />
##* '''Использовать данные склада как отправителя''' — если выбрано значение '''Использовать''', данные отправителя заполняются следующей информацией о складе: адрес, название склада, телефон контактного лица ('''Настройки''' > '''Магазины''' > '''Склады''');<br />
##* '''Передавать ФИО получателя из пользовательского поля''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое вводится имя фактического получателя. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM];<br />
##* '''Передавать телефон получателя из пользовательского поля''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое вводится телефон фактического получателя. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM].<br />
##* '''Обновлять заказ при изменении''' — определяет, будет ли заказ в MeaSoft обновлен при изменении данных на стороне RetailCRM. Возможные значения: '''Да''', '''Нет'''.<br />
#: По завершении настройки нажмите '''Сохранить'''.<br />
# Настройте интеграцию в RetailCRM:<br />
## Откройте '''Настройки''' > '''Справочники''' > '''Типы доставок''' и на странице «Типы доставок» нажмите на кнопку '''Добавить'''. Откроется окно «Новая доставка»:[[Файл:Retail1.png|none|1000 px|]]<br />
## В этом окне заполните обязательные поля и в выпадающем списке '''Интегрировать с''' выберите значение '''Курьерская служба 2008'''.<br />
## Нажмите '''Сохранить'''.<br />
<br />
'''Примечание'''. Интеграция привязана к личному кабинету клиента курьерской службы. При необходимости работать из другого личного кабинета создайте новую интеграцию, начиная с пункта настройки в личном кабинете.<br />
<br />
Чтобы отправлять заказы в курьерскую службу по статусам и отменять при изменении типа доставки, используйте [[RetailCRM#Настройка триггеров|триггеры]].<br />
<br />
== Исключение печати чеков ==<br />
В настройках интеграции есть настройка '''Не печатать чеки для способа оплаты'''.<br />
<br />
Данная настройка выводит список способов оплаты из retailCRM.<br />
<br />
Вы можете выбрать те способы оплаты, при наличии которых в заказе в систему MeaSoft будет передана нулевая цена по товарам и нулевая сумма по заказу. Это полезно для оплаты заказа безналом по счету юр.лицами и для перемещения товаров между своими складами без оплаты.<br />
<br />
== Передача наложенного платежа ==<br />
<br />
Чтобы настроить корректную передачу наложенного платежа:<br />
# Откройте '''Настройки''' > '''Интеграция''' и выберите модуль MEASOFT.<br />
# На странице «Настройки интеграции с Курьерская служба 2008» перейдите на вкладку '''Доставка''' и на панели справа выберите пункт '''Способы оплаты'''.<br />
# Установите флажки для способов оплаты, которые могут использоваться для передачи наложенного платежа, и нажмите '''Сохранить '''.[[Файл:Retail5.png|none|1000 px]]<br />
<br />
== Передача статусов из MeaSoft ==<br />
<br />
Чтобы получать статусы заказа из MeaSoft:<br />
# Откройте '''Настройки''' > '''Интеграция''' и выберите модуль MEASOFT.<br />
# На странице «Настройки интеграции с Курьерская служба 2008» перейдите на вкладку '''Доставка''' и на панели справа выберите пункт '''Статусы'''.<br />
# Настройте сопоставление статусов MeaSoft и RetailCRM. Для этого в столбце «Статус в RetailCRM» из выпадающего списка выберите соответствие для каждого статуса службы доставки. ''' [[Файл:Retail передача статусов.png|none|1000 px]]<br />
# Нажмите на кнопку '''Сохранить'''.<br />
<br />
Статус из MeaSoft в RetailCRM передается 1 раз в 30 минут. Поэтому некоторые промежуточные статусы для заказа могут быть пропущены, и будет показан последний выставленный на момент синхронизации статус заказа.<br />
<br />
== Проверка интеграции ==<br />
Чтобы проверить настройки интеграции:<br />
# Перейдите в форму создания заказа и убедитесь, что в списке '''Тип доставки''' появилось соответствующее значение:[[Файл:Retail2.png|none|1000 px]]<br />
# Нажмите '''Выбрать тариф'''. Тарифы должны передаваться из настроек курьерской службы:[[Файл:Retail3.png|none|800 px]]<br>В случае ошибки обратитесь в курьерскую службу для настройки тарифов. Проверить тарифы можно в ЛК MeaSoft в разделе '''Калькулятор'''.<br />
<br />
==Печатные формы ==<br />
<br />
Чтобы в RetailCRM формировать печатные формы, аналогичные формам в Личном кабинете MeaSoft, используйте один из следующих способов:<br />
* в сохраненном заказе на панели действий сверху нажмите '''Печать''' и выберите нужную печатную форму «Курьерская служба»;<br />
* в списке заказов отметьте заказы флажками, внизу страницы нажмите '''Действия''' > '''Распечатать документы''' и выберите печатную форму «Курьерская служба».<br />
<br />
== Настройка триггеров ==<br />
<br />
;Триггер<br />
:Хранимая процедура специального типа, автоматически выполняющаяся при наступлении заданного события.<br />
<br />
Пример: каждый месяц 1-го числа списывается абонентская плата за интернет. Триггер «1-ый день месяца» — это событие, при наступлении которого срабатывает процедура «списание абонентской платы».<br />
<br />
Триггеры используются для автоматической отправки заказов в курьерскую службу и необязательны для работы модуля. Вы можете отправлять заказы вручную, снимая флажок '''Не синхронизировать со службой доставки''' в разделе '''Доставка''' на странице заказа перед его сохранением. <br />
<br />
Для RetailCRM предусмотрены следующие триггеры:<br />
* [[Настройка триггеров для RetailCRM#Передача заказа при смене статуса|«Отправка заказа в MeaSoft»]] — при наступлении события «Смена статуса заказа на "Отправлен в MeaSoft"». При установке статуса, означающего, что заказ отправлен в курьерскую службу, срабатывает триггер, и заказ передается в MeaSoft;<br />
* [[Настройка триггеров для RetailCRM#Отмена заказа при смене типа доставки|«Отмена заказа в MeaSoft»]] — при наступлении события «Смена типа доставки у заказа». При изменении типа доставки с доставки MeaSoft на доставку, например, Почтой России, заказ в MeaSoft отменяется, если он туда передан и имеет статус «Новый» или «Ожидает синхронизации»;<br />
* [[Настройка триггеров для RetailCRM#Передача изменений заказа|«Изменения заказа в MeaSoft»]] — при наступлении события «Изменение заказа в RetailCRM». При изменении заказа в RetailCRM новые данные отправляются в MeSoft, если заказ передан и имеет статус «Новый» или «Ожидает синхронизации».<br />
<br />
'''Примечание.''' Триггеры отправки и обновления данных заказа не учитывают [[#Передача наложенного платежа|типы оплат для наложенного платежа]]. Поэтому если наложенный платеж для неоплаченного заказа равен нулю (например, при оплате на сайте), триггер все равно передаст сумму к оплате. Для корректной отправки таких заказов не используйте триггеры.<br />
<br />
=== Передача заказа при смене статуса ===<br />
<br />
Чтобы настроить триггер:<br />
# Cоздайте пользовательский статус заказа, при установке которого заказ будет автоматически передаваться в курьерскую службу. Можно создать любое количество статусов.<br />
## В RetailCRM выберите '''Настройки''' > '''Статусы''' и нажмите на кнопку '''Добавить'''. Откроется окно «Новый статус»: [[Файл:Rcrm trig103.png|600 px|none]]<br />
## Заполните поля формы. В поле '''Символьный код''' используйте только цифры и латинские буквы без пробелов. Запишите созданный символьный код, он понадобится на следующих шагах.<br />
# Выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. Запишите символьные коды доставок, которые будут использоваться в триггере. В примере ниже используются коды outcity и incity.[[Файл:rcrm_trig104.png|600px|none]]<br />
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».<br />
#:Заполните поля:<br />
#: '''Название'''. Название триггера, например «Отправка заказа в MeaSoft».<br />
#: В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.<br />
#: В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:<br />
#:<source lang="javascript"><br />
order.getStatus().getCode() in ["SentMeaSoft"] and order.getDeliveryType().getCode() in ["outcity","incity"] and changeSet.hasChangedField("status")<br />
</source><br />
#:где <br />
#* <code>SentMeaSoft</code> — символьный код статуса заказа. Если нужно указать 2 статуса, напишите их через запятую в виде: <code>["SentMeaSoft","SentMeaSoft_2"]</code> вместо <code>["SentMeaSoft"]</code>;<br />
#* <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать 1 тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.<br />
# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:<br />
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/trigger/retailcrm;<br />
#* '''HTTP метод''' — '''POST''';<br />
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';<br />
# Нажмите на кнопку '''Добавить параметр''' 3 раза подряд и заполните появившиеся поля следующими данными:<br />
:::{|class="wikitable"<br />
!Параметр<br />
!Значение<br />
|-<br />
|id||<nowiki>{{ order.getNumber() }}</nowiki><br />
|-<br />
|sum||<nowiki>{{ order.getIntegrationDeliveryData().getDeclaredSum() }}</nowiki><br />
|-<br />
|key||<nowiki>{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</nowiki><br />
|}<br />
::'''Примечание'''. Переносы строк не допускаются.<br />
:6. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.<br />
<br />
:[[Файл:Новый триггер.png|600 px|none]]<br />
<br />
Триггер настроен.<br />
<br />
=== Отмена заказа при смене статуса ===<br />
<br />
Чтобы настроить триггер:<br />
# Cоздайте пользовательский статус заказа, при установке которого заказ будет автоматически отменяться. Можно создать любое количество статусов. <br />
## В RetailCRM выберите '''Настройки''' > '''Статусы''' и нажмите на кнопку '''Добавить'''. Откроется окно «Новый статус»: [[Файл:Rcrm trig103.png|600 px|none]]<br />
## Заполните поля формы. В поле '''Символьный код''' используйте только цифры и латинские буквы без пробелов. Запишите созданный символьный код, он понадобится на следующих шагах.<br />
# Выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. Запишите символьные коды доставок, которые будут использоваться в триггере. В примере ниже используются коды outcity и incity.[[Файл:rcrm_trig104.png|600px|none]]<br />
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».<br />
#:Заполните поля:<br />
#: '''Название'''. Название триггера, например «Отмена заказа в MeaSoft».<br />
#: В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.<br />
#: В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:<br />
#:<source lang="javascript"><br />
order.getStatus().getCode() in ["CancelMeaSoft"] and order.getDeliveryType().getCode() in ["outcity","incity"] and changeSet.hasChangedField("status")<br />
</source><br />
#:где <br />
#* <code>CancelMeaSoft</code> — символьный код статуса заказа. Если нужно указать 2 статуса, напишите их через запятую в виде: <code>["CancelMeaSoft_1","CancelMeaSoft_2"]</code> вместо <code>["SentMeaSoft"]</code>;<br />
#* <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать 1 тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.<br />
# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:<br />
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/cancelbystatus/retailcrm;<br />
#* '''HTTP метод''' — '''POST''';<br />
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';<br />
# Нажмите на кнопку '''Добавить параметр''' 3 раза подряд и заполните появившиеся поля следующими данными:<br />
:::{|class="wikitable"<br />
!Параметр<br />
!Значение<br />
|-<br />
|id||<nowiki>{{ order.getNumber() }}</nowiki><br />
|-<br />
|key||<nowiki>{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</nowiki><br />
|}<br />
::'''Примечание'''. Переносы строк не допускаются.<br />
:6. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.<br />
<br />
:[[Файл:Новый триггер.png|600 px|none]]<br />
<br />
Триггер настроен.<br />
<br />
=== Отмена заказа при смене типа доставки ===<br />
<br />
Запрос отмены предназначен для заказов, которые еще не приняты в работу: не было изменений статуса доставки, статуса корреспонденции, времени доставки.<br />
<br />
Возможность отмены заказа есть только у курьерских служб с тарифом «Премиум» или «Максимум». По умолчанию она выключена, ее нужно включить в [[Личный кабинет курьерской службы#Параметры|личном кабинете курьерской службы]]: '''Управление ЛК''' > '''Параметры''' > '''Расширенные''' > '''Разрешить отмену и изменение заказов'''.<br />
<br />
При отмене заказа поле '''Инфо о доставке''' получает значение '''Отменено заказчиком''', поле '''Дата доставки''' заполняется текущей датой, а в поле '''Вручил курьер''' появляется системная запись '''Отмена'''.<br />
<br />
Чтобы настроить триггер:<br />
# В RetailCRM выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. [[Файл:Rcrm_trig104.png|600 px|none]]<br />
#: Запишите символьный код типа доставки (доставок), заказы которой отправляются в MeaSoft.<br />
# Перейдите в раздел '''Продажи''' и нажмите на кнопку '''Новый заказ'''. В разделе '''Доставка''' выберите тип доставки, заказы которой отправляются в MeaSoft, укажите город, вес и тариф.<br />
# В разделе '''Доставка''' появится поле '''API ключ службы доставки'''. Запишите его значение. В результате у вас есть пара «символьный код типа доставки» — «API ключ службы доставки».<br />
# Повторите действия пп. 2-3 для каждой доставки, заказы по которой отправляются в MeaSoft.<br />
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».<br />
#: Заполните поля:<br />
#* '''Название'''. Название триггера, например «Отмена заказа в MeaSoft»;<br />
#* В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.<br />
#* В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:<br />
#:<source lang="javascript"><br />
changeSet.hasChangedField("delivery_type") and changeSet.getOldValue("delivery_type").getCode() in ["outcity","incity"]<br />
</source><br />
#:где <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать один тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.<br />
# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:<br />
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/cancel/retailcrm;<br />
#* '''HTTP метод''' — '''POST''';<br />
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';<br />
# Нажмите на кнопку '''Добавить параметр''' 2 раза подряд и потом еще столько раз, сколько у вас сопоставленных пар «символьный код типа доставки» - «API ключ службы доставки». Заполните появившиеся поля следующими данными:<br />
:::{|class="wikitable"<br />
!Параметр<br />
!Значение<br />
|-<br />
|id||<nowiki>{{ order.getNumber() }}</nowiki><br />
|-<br />
|code||<nowiki>{{ changeSet.getOldValue("delivery_type").getCode() }}</nowiki><br />
|-<br />
|Cимвольный код типа доставки 1||API-ключ службы доставки 1<br />
|-<br />
|Cимвольный код типа доставки 2||API-ключ службы доставки 2<br />
|}<br />
::'''Примечание'''. Переносы строк не допускаются.<br />
:8. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.<br />
:[[Файл:Новый триггер2.png|600 px|none]]<br />
Триггер настроен.<br />
<br />
=== Передача изменений заказа ===<br />
<br />
Изменять заказ могут только курьерские службы с тарифом «Премиум» или «Максимум». По умолчанию опция выключена, ее нужно включить в [[Личный кабинет курьерской службы#Параметры|личном кабинете курьерской службы]]: '''Управление ЛК''' > '''Параметры''' > '''Расширенные''' > '''Разрешить отмену и изменение заказов'''.<br />
<br />
Чтобы настроить триггер:<br />
# В RetailCRM выберите '''Настройки''' > '''Справочники''' > '''Типы доставок'''. [[Файл:Rcrm_trig104.png|600 px|none]]<br />
#: Запишите символьный код доставки (доставок), заказы которой отправляются в MeaSoft.<br />
# Откройте '''Настройки''' > '''Триггеры''' и нажмите на кнопку '''+ Триггер'''. Откроется окно «Новый триггер».<br />
#: Заполните поля:<br />
#* '''Название'''. Название триггера, например «Передача изменений заказа в MeaSoft»;<br />
#* В разделе '''Событие''' нажмите на кнопку '''+ Событие''', выберите значение '''Изменение заказа''' и нажмите на кнопку '''Добавить'''.<br />
#* В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:<br />
#:<source lang="javascript"><br />
changeSet.isUpdate() and <br />
(<br />
changeSet.hasChangedField("first_name") or <br />
changeSet.hasChangedField("last_name") or <br />
changeSet.hasChangedField("patronymic") or <br />
changeSet.hasChangedField("phone") or <br />
changeSet.hasChangedField("site") or <br />
changeSet.hasChangedField("additional_phone") or<br />
changeSet.hasChangedField("email") or <br />
changeSet.hasChangedField("customer.phones") or <br />
changeSet.hasChangedField("order_product") or <br />
changeSet.hasChangedField("total_summ") or <br />
changeSet.hasChangedField("delivery_date") or <br />
changeSet.hasChangedField("delivery_time") or <br />
changeSet.hasChangedField("payments") or <br />
changeSet.hasChangedField("prepay_sum") or <br />
changeSet.hasChangedField("weight") or <br />
changeSet.hasChangedField("length") or <br />
changeSet.hasChangedField("width") or <br />
changeSet.hasChangedField("height") or <br />
changeSet.hasChangedField("payments.id") or <br />
changeSet.hasChangedField("payments.status") or <br />
changeSet.hasChangedField("payments.type") or <br />
changeSet.hasChangedField("payments.external_id") or <br />
changeSet.hasChangedField("payments.amount") or <br />
changeSet.hasChangedField("payments.paid_at") or <br />
changeSet.hasChangedField("payments.comment") or <br />
changeSet.hasChangedField("discount_manual_amount") or <br />
changeSet.hasChangedField("discount_manual_percent") <br />
)<br />
and <br />
order.getDeliveryType().getCode() in ["outcity","incity"]<br />
</source><br />
#:где <code>outcity</code>, <code>incity</code> — символьные коды типа доставки. Если нужно указать один тип доставки, напишите его в виде <code>["incity"]</code> вместо <code>["outcity","incity"]</code>.<br />
# В разделе '''Действие''' нажмите на кнопку '''+ Действие''', выберите '''Выполнить HTTP-запрос'''. Появятся дополнительные поля настроек. Заполните их следующим образом:<br />
#* '''Адрес''' — https://home.courierexe.ru/reintegrations/requests/update/retailcrm;<br />
#* '''HTTP метод''' — '''POST''';<br />
#* '''Передавать параметры''' — '''В теле запроса (urlencode)''';<br />
# Нажмите на кнопку '''Добавить параметр''' 3 раза подряд и заполните появившиеся поля следующими данными:<br />
:::{|class="wikitable"<br />
!Параметр<br />
!Значение<br />
|-<br />
|id||<nowiki>{{ order.getNumber() }}</nowiki><br />
|-<br />
|sum||<nowiki>{{ order.getIntegrationDeliveryData().getDeclaredSum() }}</nowiki><br />
|-<br />
|key||<nowiki>{{ order.getIntegrationDeliveryData().getExtraData().deliveryApiKey }}</nowiki><br />
|}<br />
::'''Примечание'''. Переносы строк не допускаются.<br />
:5. В панели '''Действия''' нажмите '''Сохранить''', затем сохраните триггер.<br />
:[[Файл:Новый триггер3.png|600 px|none]]<br />
Триггер настроен.<br />
<br />
== Передача габаритов ==<br />
Габариты из retailCRM передаются стандартными средствами retailCRM.<br />
<br />
Они берутся, либо из раздела "Габариты и вес", либо из раздела "Упаковки", где вы можете распределить товары между упаковками, указав габариты и вес каждой упаковки.<br />
<br />
[[Файл:Gab.png|none|800 px]]<br />
<br />
Дополнительно можете изучить информацию здесь https://docs.retailcrm.ru/Users/OperatingActivity/Orders/OrderPage/WorkOrderPage/WorkDeliveryOrder раздел "Оформление упаковок"<br />
<br />
<br />
== Проверка работоспособности интеграции ==<br />
<br />
# Убедитесь, что выполнены все шаги [[RetailCRM#Настройка интеграции|инструкции по настройке интеграции]].<br />
# Если используются триггеры, убедитесь, что они настроены согласно [[RetailCRM#Настройка триггеров|инструкции]].<br />
# Создайте заказ, заполните требуемые данные.<br />
# Нажмите на кнопку '''Сохранить''' внизу страницы, флажок '''Не отправлять данные в службу доставки''' должен быть снят.<br>Заказ должен отправиться в курьерскую службу. Если заказ отправлен без ошибок и отображается в ЛК, значит интеграция настроена.<br />
# Если возникает ошибка, ее текст отображается наверху страницы.<br />
:: Если это ошибка заполнения формы, исправьте внесенные данные и попробуйте отправить заказ снова. Пример ошибки: «Ошибка сервиса доставки "Курьерская служба 2008": field [receiver phone] has no valid phone number».<br />
:: Если это ошибка ответа курьерской службы, сообщите об этом разработчику. Пример ошибки: «Служба доставки прислала ответ в неверном формате».<br />
Текст ошибки можно увидеть через [[Личный кабинет#Отладка|отладку]] в личном кабинете. Чтобы найти свой заказ в запросах, нажмите CTRL+F и введите в строку поиска номер заказа или ориентируйтесь на время создания заказа.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Gab.png&diff=14855Файл:Gab.png2023-10-02T10:36:24Z<p>Бутусов: </p>
<hr />
<div></div>Бутусовhttps://wiki.courierexe.ru/index.php?title=AmoCRM&diff=14851AmoCRM2023-09-08T11:37:41Z<p>Бутусов: /* Сопоставление полей */</p>
<hr />
<div>Интеграция реализована через виджет «Курьерская служба 2008», предназначенный для передачи заказов из amoCRM в MeaSoft и возврата статусов.<br />
<br />
Чтобы начать отправлять заказы в курьерскую службу, настройте интеграцию с MeaSoft и сопоставьте поля amoCRM и виджета для корректной передачи данных в MeaSoft.<br />
<br />
= Настройка интеграции =<br />
Для удобства работы перед настройкой интеграции добавьте дополнительные поля в сделке: выберите '''Сделки''' > '''Новая сделка''' и на вкладке '''Настроить''' добавьте в любую группу новые поля '''Стоимость доставки''', '''Стоимость товаров''', '''Закупка'''.<br />
<br />
[[Файл:Amo Settings.png|none|500 px]]<br />
<br />
Чтобы настроить интеграцию с amoCRM:<br />
# Этот этап можно делать из [[Личный кабинет клиента#Интеграция|личного кабинета MeaSoft]] '''ИЛИ''' из административной части amoCRM:<br />
#* В личном кабинете MeaSoft:<br />
#*# В разделе '''Настройки''' выберите '''Интеграция''', перейдите на вкладку '''Настройки интеграции''' и в таблице «Ваши интеграции» в строке «AmoCRM» нажмите '''Добавить'''.<br />
#*#Укажите название интеграции и префикс и нажмите на кнопку '''Сохранить'''.<br />
#*#Укажите аккаунт amoCRM, в котором будет установлен виджет «Курьерская служба 2008» и нажмите '''Разрешить'''. Виджет установлен.<br />
#* В административной части amoCRM:<br />
#*# В меню выберите '''Настройки''' > '''Интеграции''' и в строке поиска введите «Курьерская служба 2008».<br />
#*#Щелкните по найденному модулю, нажмите на кнопку '''Установить'''. Виджет установлен.<br />
# В amoCRM выберите '''Настройки''' > '''Интеграции''' и в разделе '''Установленные интеграции''' откройте «Курьерская служба 2008».<br />
# Введите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.<br />
# Нажмите на кнопку '''Настройки виджета'''. В окне «Настройки интеграции с Курьерская служба 2008»:<br />
## Установите параметры товаров и доставки.<br />
## Установите поля для сохранения данных заказа. Например, в выпадающем списке поля '''Сохранять стоимость товаров в отдельное поле''' укажите значение '''Сохранять в поле: Стоимость товаров'''.<br />
## Укажите, откуда будут добавляться товары к заказу. Если это список в amoCRM, настройте соответствие полей. Списки amoCRM доступны начиная с тарифного плана «Расширенный».<br />
## Установите соответствие между статусами в личном кабинете клиента курьерской службы и статусами amoCRM.<br />
## Нажмите '''Сохранить настройки'''.<br />
# В окне ввода учетных данных интеграции нажмите '''Сохранить'''.<br />
<br />
= Сопоставление полей =<br />
{|class="wikitable"<br />
!Поле виджета<br />
!Данные amoCRM<br />
!Где настраивается сопоставление<br />
|-<br />
|'''Имя отправителя''', '''Телефон отправителя''', '''Компания отправителя''', '''Дата забора''', '''Город отправителя''', '''Адрес отправителя'''||• Поля карточки контакта<br>• Поля сделки||'''Настройки виджета''' > '''Настройки интеграции с Курьерская служба 2008'''<br />
|-<br />
|'''Имя получателя''', '''Телефон получателя''', '''Компания получателя''', '''Дата доставки''', '''Индекс получателя''', '''Город получателя''', '''Адрес получателя'''||• Поля карточки контакта<br>• Поля сделки||'''Настройки виджета''' > '''Настройки интеграции с Курьерская служба 2008'''<br />
|-<br />
|'''Номер заказа'''||• Название сделки<br>• ID сделки<br>• пользовательское поле||'''Настройки виджета''' > '''Настройки интеграции с Курьерская служба 2008'''<br />
|-<br />
|'''Примечание''', '''Забор'''|| Поля сделки|| '''Настройки виджета''' > '''Настройки интеграции с Курьерская служба 2008'''<br />
|-<br />
|'''Вес''', '''Сумма''', '''Объявленная ценность''', название и количество товара||Карточка товара||• Если товар добавляется вручную или из каталога Курьерской службы 2008, сопоставление не требуется;<br>• если товар добавляется из списка amoCRM, настройте сопоставление в '''Настройки виджета''' > '''Настройка товаров'''<br />
|-<br />
|'''Количество мест'''|| - ||Заполняется в виджете вручную<br />
|-<br />
|'''Габариты мест'''|| Карточка товара ||• Товар добавляется из списка amoCRM, настройте сопоставление в '''Настройки виджета''' > '''Настройка мест''', и затем прикрепляйте места в самой сделке через списки<br />
|}<br />
<br />
= Устранение неполадок =<br />
<br />
== "Данные заказа не подставляются в поля виджета" или "Не отображается виджет" ==<br />
В данный момент у АМО наблюдается проблема, из-за которой интеграция в АМО может "сломаться", то есть виджет может пропасть.<br />
<br />
Для решения сделайте следующее: <br />
<br />
# В личном кабинете MeaSoft в пункте основного меню '''Настройки''' выберите '''Интеграция''', перейдите на вкладку '''Настройки интеграции''' и в таблице «Ваши интеграции» в строке «AmoCRM» нажмите '''Изменить'''.<br />
# На странице «Настройка интеграции AmoCRM» нажмите на кнопку '''Сохранить'''.<br />
# Укажите аккаунт amoCRM, в котором наблюдается проблема виджета «Курьерская служба 2008» и нажмите '''Разрешить'''.<br />
# Повторно сохраните настройки в AmoCRM. Для этого откройте настройки модуля интеграции в amoCRM и нажмите на кнопку '''Сохранить изменения''', затем нажмите на кнопку '''Сохранить''' для сохранения настроек.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=AmoCRM&diff=14850AmoCRM2023-09-08T11:00:56Z<p>Бутусов: /* Сопоставление полей */</p>
<hr />
<div>Интеграция реализована через виджет «Курьерская служба 2008», предназначенный для передачи заказов из amoCRM в MeaSoft и возврата статусов.<br />
<br />
Чтобы начать отправлять заказы в курьерскую службу, настройте интеграцию с MeaSoft и сопоставьте поля amoCRM и виджета для корректной передачи данных в MeaSoft.<br />
<br />
= Настройка интеграции =<br />
Для удобства работы перед настройкой интеграции добавьте дополнительные поля в сделке: выберите '''Сделки''' > '''Новая сделка''' и на вкладке '''Настроить''' добавьте в любую группу новые поля '''Стоимость доставки''', '''Стоимость товаров''', '''Закупка'''.<br />
<br />
[[Файл:Amo Settings.png|none|500 px]]<br />
<br />
Чтобы настроить интеграцию с amoCRM:<br />
# Этот этап можно делать из [[Личный кабинет клиента#Интеграция|личного кабинета MeaSoft]] '''ИЛИ''' из административной части amoCRM:<br />
#* В личном кабинете MeaSoft:<br />
#*# В разделе '''Настройки''' выберите '''Интеграция''', перейдите на вкладку '''Настройки интеграции''' и в таблице «Ваши интеграции» в строке «AmoCRM» нажмите '''Добавить'''.<br />
#*#Укажите название интеграции и префикс и нажмите на кнопку '''Сохранить'''.<br />
#*#Укажите аккаунт amoCRM, в котором будет установлен виджет «Курьерская служба 2008» и нажмите '''Разрешить'''. Виджет установлен.<br />
#* В административной части amoCRM:<br />
#*# В меню выберите '''Настройки''' > '''Интеграции''' и в строке поиска введите «Курьерская служба 2008».<br />
#*#Щелкните по найденному модулю, нажмите на кнопку '''Установить'''. Виджет установлен.<br />
# В amoCRM выберите '''Настройки''' > '''Интеграции''' и в разделе '''Установленные интеграции''' откройте «Курьерская служба 2008».<br />
# Введите логин, пароль и код курьерской службы. Запросите эти данные у курьерской службы, с которой настраивается интеграция.<br />
# Нажмите на кнопку '''Настройки виджета'''. В окне «Настройки интеграции с Курьерская служба 2008»:<br />
## Установите параметры товаров и доставки.<br />
## Установите поля для сохранения данных заказа. Например, в выпадающем списке поля '''Сохранять стоимость товаров в отдельное поле''' укажите значение '''Сохранять в поле: Стоимость товаров'''.<br />
## Укажите, откуда будут добавляться товары к заказу. Если это список в amoCRM, настройте соответствие полей. Списки amoCRM доступны начиная с тарифного плана «Расширенный».<br />
## Установите соответствие между статусами в личном кабинете клиента курьерской службы и статусами amoCRM.<br />
## Нажмите '''Сохранить настройки'''.<br />
# В окне ввода учетных данных интеграции нажмите '''Сохранить'''.<br />
<br />
= Сопоставление полей =<br />
{|class="wikitable"<br />
!Поле виджета<br />
!Данные amoCRM<br />
!Где настраивается сопоставление<br />
|-<br />
|'''Имя отправителя''', '''Телефон отправителя''', '''Компания отправителя''', '''Дата забора''', '''Город отправителя''', '''Адрес отправителя'''||• Поля карточки контакта<br>• Поля сделки||'''Настройки виджета''' > '''Настройки интеграции с Курьерская служба 2008'''<br />
|-<br />
|'''Имя получателя''', '''Телефон получателя''', '''Компания получателя''', '''Дата доставки''', '''Индекс получателя''', '''Город получателя''', '''Адрес получателя'''||• Поля карточки контакта<br>• Поля сделки||'''Настройки виджета''' > '''Настройки интеграции с Курьерская служба 2008'''<br />
|-<br />
|'''Номер заказа'''||• Название сделки<br>• ID сделки<br>• пользовательское поле||'''Настройки виджета''' > '''Настройки интеграции с Курьерская служба 2008'''<br />
|-<br />
|'''Примечание''', '''Забор'''|| Поля сделки|| '''Настройки виджета''' > '''Настройки интеграции с Курьерская служба 2008'''<br />
|-<br />
|'''Вес''', '''Сумма''', '''Объявленная ценность''', название и количество товара||Карточка товара||• Если товар добавляется вручную или из каталога Курьерской службы 2008, сопоставление не требуется;<br>• если товар добавляется из списка amoCRM, настройте сопоставление в '''Настройки виджета''' > '''Настройка товаров'''<br />
|-<br />
|'''Количество мест'''|| - ||Заполняется в виджете вручную<br />
|-<br />
|'''Габариты мест'''|| Карточка товара ||• Товар добавляется из списка amoCRM, настройте сопоставление в '''Настройки виджета''' > '''Настройка меси''', и затем прикрепляйте места в самой сделке через списки<br />
|}<br />
<br />
= Устранение неполадок =<br />
<br />
== "Данные заказа не подставляются в поля виджета" или "Не отображается виджет" ==<br />
В данный момент у АМО наблюдается проблема, из-за которой интеграция в АМО может "сломаться", то есть виджет может пропасть.<br />
<br />
Для решения сделайте следующее: <br />
<br />
# В личном кабинете MeaSoft в пункте основного меню '''Настройки''' выберите '''Интеграция''', перейдите на вкладку '''Настройки интеграции''' и в таблице «Ваши интеграции» в строке «AmoCRM» нажмите '''Изменить'''.<br />
# На странице «Настройка интеграции AmoCRM» нажмите на кнопку '''Сохранить'''.<br />
# Укажите аккаунт amoCRM, в котором наблюдается проблема виджета «Курьерская служба 2008» и нажмите '''Разрешить'''.<br />
# Повторно сохраните настройки в AmoCRM. Для этого откройте настройки модуля интеграции в amoCRM и нажмите на кнопку '''Сохранить изменения''', затем нажмите на кнопку '''Сохранить''' для сохранения настроек.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=Iiko&diff=14823Iiko2023-08-07T06:20:08Z<p>Бутусов: /* Создание вебхука на стороне Iiko */</p>
<hr />
<div><br />
== Настройка интеграции состоит из 10 несложных последовательных шагов ==<br />
<br />
<br />
<br />
'''1ый шаг''' - вам нужно зайти в раздел '''Настройки Cloud API'''<br />
<br />
Этот раздел находится на главной странице административного раздела Iikoweb.<br />
[[Файл:Iiko1.png|none|1000 px|]]<br />
<br />
<br />
'''2ой шаг''' - в блоке "Интеграции" нажмите кнопку "Добавить"<br />
[[Файл:Iiko2.png|none|1000 px|]]<br />
<br />
<br />
'''3ий шаг''' - в появившемся блоке заполните все поля<br />
[[Файл:Iiko3.png|none|1000 px|]]<br />
<br />
<br />
'''Имя api логина''' - любое название, например, "measoft"<br />
<br />
'''API - ключ''' - не меняем, этот ключ нам еще потребуется.<br />
<br />
'''Активный''' - галку не трогаем, она должна быть.<br />
<br />
'''Шаблон прав''' - все права.<br />
<br />
'''Источник заказа''' - пусто, не трогаем.<br />
<br />
'''Внешние меню''' - нажмите на данное поле, появится список меню. Отметьте галками все меню.<br />
<br />
'''Источник цен''' - внешнее меню.<br />
<br />
'''Email''' - укажите ваш Email.<br />
<br />
'''Подключенные точки''' - нажмите '''Добавить'''.<br />
<br />
Появится блок, в котором нужно будет отметить галочками все ваши рестораны и нажать сохранить.<br />
[[Файл:Iiko5.png|none|1000 px|]]<br />
<br />
<br />
По итогу у вас будет нечто такое:<br />
[[Файл:Iiko7.png|none|1000 px|]]<br />
<br />
<br />
'''4ый шаг''' - нажмите кнопку Сохранить. Но не закрывайте вкладку с данной страницей, нам еще потребуется сюда вернуться.<br />
<br />
<br />
'''5ый шаг''' - создание интеграции в [[Личный кабинет клиента|ЛК пользователя]].<br />
<br />
Для данного шага запишите '''API - ключ''' из '''3ьего шага'''. <br />
<br />
В ЛК пользователя в разделе '''Интеграция''' -> '''Список интеграций''' напротив интеграции '''Iiko''' нажмите кнопку '''Добавить'''<br />
[[Файл:Iiko8.png|none|1000 px|]]<br />
<br />
<br />
'''6ой шаг''' - в '''поле API - ключ''' запишите '''API - ключ''' и нажмите кнопку Сохранить, которая находится внизу страницы.<br />
[[Файл:Iiko9.png|none|1000 px|]]<br />
<br />
<br />
'''7ой шаг''' - после сохранения страницы, вы увидите ссылку '''Api URL''' в самом верху страницы. <br />
<br />
Запишите ее.<br />
<br />
Страницу не закрывайте, мы сюда еще вернемся.<br />
<br />
[[Файл:Iiko10.png|none|1000 px|]]<br />
<br />
<br />
'''8ой шаг''' - вернитесь на страницу Iiko. <br />
<br />
В разделе '''Подключенные точки''' отметьте галкой ваши рестораны и нажмите кнопку '''Настройка веб-хуков'''<br />
<br />
Вы увидите нечто подобное, здесь уже заполнены нужны поля.<br />
[[Файл:Iiko12.png|none|1000 px|]]<br />
<br />
Заполните поля,<br />
<br />
'''Uri''' - запишите здесь Api URL из 7ого шага.<br />
<br />
'''Токен авторизации''' - запишите здесь любое слово, состоящее из латинских букв и цифр. Запомните его.<br />
<br />
В разделе '''Доставка''' отметьте галками '''статус Ждет отправки''' и '''статус Отправлен'''.<br />
<br />
Нажмите '''кнопку OK''', а затем '''кнопку Сохранить'''.<br />
<br />
С настройкой iiko закончено, страницу можно закрыть.<br />
<br />
<br />
'''9ый шаг''' - заполните поля интеграции.<br />
<br />
'''Префикс заказов''' - это префис, который будет добавлен к номеру заказа, если вам это требуется, можно оставить пустым.<br />
<br />
'''Токен авторизации''' - Токен авторизации из 8ого шага.<br />
<br />
'''Используемые организации''' - отметьте галками организации, которые работают с доставкой.<br />
<br />
'''Используемые курьеры''' - отметьте галками тех курьеров, чьи заказы будут передаваться в ЛК.<br />
<br />
'''Настройка соответствия статусов''' - здесь вам нужно сопоставить статусы в ЛК Курьерской службы и статусы в Iiko<br />
<br />
Например '''статус Доставлен Курьерской службы''' и '''статус Доставлено Iiko'''.<br />
<br />
Все соответствия заполнять не требуется.<br />
[[Файл:Iiko13.png|none|1000 px|]]<br />
<br />
<br />
10ый шаг - нажмите '''кнопку Сохранить''' в самом низу страницы и на этом настройка завершена.</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=Iiko&diff=14822Iiko2023-08-07T06:19:40Z<p>Бутусов: /* Настройка интеграции состоит из 10 несложных последовательных шагов */</p>
<hr />
<div><br />
== Настройка интеграции состоит из 10 несложных последовательных шагов ==<br />
<br />
<br />
<br />
'''1ый шаг''' - вам нужно зайти в раздел '''Настройки Cloud API'''<br />
<br />
Этот раздел находится на главной странице административного раздела Iikoweb.<br />
[[Файл:Iiko1.png|none|1000 px|]]<br />
<br />
<br />
'''2ой шаг''' - в блоке "Интеграции" нажмите кнопку "Добавить"<br />
[[Файл:Iiko2.png|none|1000 px|]]<br />
<br />
<br />
'''3ий шаг''' - в появившемся блоке заполните все поля<br />
[[Файл:Iiko3.png|none|1000 px|]]<br />
<br />
<br />
'''Имя api логина''' - любое название, например, "measoft"<br />
<br />
'''API - ключ''' - не меняем, этот ключ нам еще потребуется.<br />
<br />
'''Активный''' - галку не трогаем, она должна быть.<br />
<br />
'''Шаблон прав''' - все права.<br />
<br />
'''Источник заказа''' - пусто, не трогаем.<br />
<br />
'''Внешние меню''' - нажмите на данное поле, появится список меню. Отметьте галками все меню.<br />
<br />
'''Источник цен''' - внешнее меню.<br />
<br />
'''Email''' - укажите ваш Email.<br />
<br />
'''Подключенные точки''' - нажмите '''Добавить'''.<br />
<br />
Появится блок, в котором нужно будет отметить галочками все ваши рестораны и нажать сохранить.<br />
[[Файл:Iiko5.png|none|1000 px|]]<br />
<br />
<br />
По итогу у вас будет нечто такое:<br />
[[Файл:Iiko7.png|none|1000 px|]]<br />
<br />
<br />
'''4ый шаг''' - нажмите кнопку Сохранить. Но не закрывайте вкладку с данной страницей, нам еще потребуется сюда вернуться.<br />
<br />
<br />
'''5ый шаг''' - создание интеграции в [[Личный кабинет клиента|ЛК пользователя]].<br />
<br />
Для данного шага запишите '''API - ключ''' из '''3ьего шага'''. <br />
<br />
В ЛК пользователя в разделе '''Интеграция''' -> '''Список интеграций''' напротив интеграции '''Iiko''' нажмите кнопку '''Добавить'''<br />
[[Файл:Iiko8.png|none|1000 px|]]<br />
<br />
<br />
'''6ой шаг''' - в '''поле API - ключ''' запишите '''API - ключ''' и нажмите кнопку Сохранить, которая находится внизу страницы.<br />
[[Файл:Iiko9.png|none|1000 px|]]<br />
<br />
<br />
'''7ой шаг''' - после сохранения страницы, вы увидите ссылку '''Api URL''' в самом верху страницы. <br />
<br />
Запишите ее.<br />
<br />
Страницу не закрывайте, мы сюда еще вернемся.<br />
<br />
[[Файл:Iiko10.png|none|1000 px|]]<br />
<br />
<br />
'''8ой шаг''' - вернитесь на страницу Iiko. <br />
<br />
В разделе '''Подключенные точки''' отметьте галкой ваши рестораны и нажмите кнопку '''Настройка веб-хуков'''<br />
<br />
Вы увидите нечто подобное, здесь уже заполнены нужны поля.<br />
[[Файл:Iiko12.png|none|1000 px|]]<br />
<br />
Заполните поля,<br />
<br />
'''Uri''' - запишите здесь Api URL из 7ого шага.<br />
<br />
'''Токен авторизации''' - запишите здесь любое слово, состоящее из латинских букв и цифр. Запомните его.<br />
<br />
В разделе '''Доставка''' отметьте галками '''статус Ждет отправки''' и '''статус Отправлен'''.<br />
<br />
Нажмите '''кнопку OK''', а затем '''кнопку Сохранить'''.<br />
<br />
С настройкой iiko закончено, страницу можно закрыть.<br />
<br />
<br />
'''9ый шаг''' - заполните поля интеграции.<br />
<br />
'''Префикс заказов''' - это префис, который будет добавлен к номеру заказа, если вам это требуется, можно оставить пустым.<br />
<br />
'''Токен авторизации''' - Токен авторизации из 8ого шага.<br />
<br />
'''Используемые организации''' - отметьте галками организации, которые работают с доставкой.<br />
<br />
'''Используемые курьеры''' - отметьте галками тех курьеров, чьи заказы будут передаваться в ЛК.<br />
<br />
'''Настройка соответствия статусов''' - здесь вам нужно сопоставить статусы в ЛК Курьерской службы и статусы в Iiko<br />
<br />
Например '''статус Доставлен Курьерской службы''' и '''статус Доставлено Iiko'''.<br />
<br />
Все соответствия заполнять не требуется.<br />
[[Файл:Iiko13.png|none|1000 px|]]<br />
<br />
<br />
10ый шаг - нажмите '''кнопку Сохранить''' в самом низу страницы и на этом настройка завершена.<br />
<br />
== Создание вебхука на стороне Iiko ==<br />
qwrqwr</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=Iiko&diff=14821Iiko2023-08-07T06:19:33Z<p>Бутусов: </p>
<hr />
<div><br />
== Настройка интеграции состоит из 10 несложных последовательных шагов ==<br />
<br />
<br />
'''1ый шаг''' - вам нужно зайти в раздел '''Настройки Cloud API'''<br />
<br />
Этот раздел находится на главной странице административного раздела Iikoweb.<br />
[[Файл:Iiko1.png|none|1000 px|]]<br />
<br />
<br />
'''2ой шаг''' - в блоке "Интеграции" нажмите кнопку "Добавить"<br />
[[Файл:Iiko2.png|none|1000 px|]]<br />
<br />
<br />
'''3ий шаг''' - в появившемся блоке заполните все поля<br />
[[Файл:Iiko3.png|none|1000 px|]]<br />
<br />
<br />
'''Имя api логина''' - любое название, например, "measoft"<br />
<br />
'''API - ключ''' - не меняем, этот ключ нам еще потребуется.<br />
<br />
'''Активный''' - галку не трогаем, она должна быть.<br />
<br />
'''Шаблон прав''' - все права.<br />
<br />
'''Источник заказа''' - пусто, не трогаем.<br />
<br />
'''Внешние меню''' - нажмите на данное поле, появится список меню. Отметьте галками все меню.<br />
<br />
'''Источник цен''' - внешнее меню.<br />
<br />
'''Email''' - укажите ваш Email.<br />
<br />
'''Подключенные точки''' - нажмите '''Добавить'''.<br />
<br />
Появится блок, в котором нужно будет отметить галочками все ваши рестораны и нажать сохранить.<br />
[[Файл:Iiko5.png|none|1000 px|]]<br />
<br />
<br />
По итогу у вас будет нечто такое:<br />
[[Файл:Iiko7.png|none|1000 px|]]<br />
<br />
<br />
'''4ый шаг''' - нажмите кнопку Сохранить. Но не закрывайте вкладку с данной страницей, нам еще потребуется сюда вернуться.<br />
<br />
<br />
'''5ый шаг''' - создание интеграции в [[Личный кабинет клиента|ЛК пользователя]].<br />
<br />
Для данного шага запишите '''API - ключ''' из '''3ьего шага'''. <br />
<br />
В ЛК пользователя в разделе '''Интеграция''' -> '''Список интеграций''' напротив интеграции '''Iiko''' нажмите кнопку '''Добавить'''<br />
[[Файл:Iiko8.png|none|1000 px|]]<br />
<br />
<br />
'''6ой шаг''' - в '''поле API - ключ''' запишите '''API - ключ''' и нажмите кнопку Сохранить, которая находится внизу страницы.<br />
[[Файл:Iiko9.png|none|1000 px|]]<br />
<br />
<br />
'''7ой шаг''' - после сохранения страницы, вы увидите ссылку '''Api URL''' в самом верху страницы. <br />
<br />
Запишите ее.<br />
<br />
Страницу не закрывайте, мы сюда еще вернемся.<br />
<br />
[[Файл:Iiko10.png|none|1000 px|]]<br />
<br />
<br />
'''8ой шаг''' - вернитесь на страницу Iiko. <br />
<br />
В разделе '''Подключенные точки''' отметьте галкой ваши рестораны и нажмите кнопку '''Настройка веб-хуков'''<br />
<br />
Вы увидите нечто подобное, здесь уже заполнены нужны поля.<br />
[[Файл:Iiko12.png|none|1000 px|]]<br />
<br />
Заполните поля,<br />
<br />
'''Uri''' - запишите здесь Api URL из 7ого шага.<br />
<br />
'''Токен авторизации''' - запишите здесь любое слово, состоящее из латинских букв и цифр. Запомните его.<br />
<br />
В разделе '''Доставка''' отметьте галками '''статус Ждет отправки''' и '''статус Отправлен'''.<br />
<br />
Нажмите '''кнопку OK''', а затем '''кнопку Сохранить'''.<br />
<br />
С настройкой iiko закончено, страницу можно закрыть.<br />
<br />
<br />
'''9ый шаг''' - заполните поля интеграции.<br />
<br />
'''Префикс заказов''' - это префис, который будет добавлен к номеру заказа, если вам это требуется, можно оставить пустым.<br />
<br />
'''Токен авторизации''' - Токен авторизации из 8ого шага.<br />
<br />
'''Используемые организации''' - отметьте галками организации, которые работают с доставкой.<br />
<br />
'''Используемые курьеры''' - отметьте галками тех курьеров, чьи заказы будут передаваться в ЛК.<br />
<br />
'''Настройка соответствия статусов''' - здесь вам нужно сопоставить статусы в ЛК Курьерской службы и статусы в Iiko<br />
<br />
Например '''статус Доставлен Курьерской службы''' и '''статус Доставлено Iiko'''.<br />
<br />
Все соответствия заполнять не требуется.<br />
[[Файл:Iiko13.png|none|1000 px|]]<br />
<br />
<br />
10ый шаг - нажмите '''кнопку Сохранить''' в самом низу страницы и на этом настройка завершена.<br />
<br />
== Создание вебхука на стороне Iiko ==<br />
qwrqwr</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=Iiko&diff=14820Iiko2023-08-07T06:18:56Z<p>Бутусов: /* Создание интеграции на стороне Iiko */</p>
<hr />
<div>== Создание интеграции на стороне Iiko ==<br />
<br />
<br />
'''1ый шаг''' - вам нужно зайти в раздел '''Настройки Cloud API'''<br />
<br />
Этот раздел находится на главной странице административного раздела Iikoweb.<br />
[[Файл:Iiko1.png|none|1000 px|]]<br />
<br />
<br />
'''2ой шаг''' - в блоке "Интеграции" нажмите кнопку "Добавить"<br />
[[Файл:Iiko2.png|none|1000 px|]]<br />
<br />
<br />
'''3ий шаг''' - в появившемся блоке заполните все поля<br />
[[Файл:Iiko3.png|none|1000 px|]]<br />
<br />
<br />
'''Имя api логина''' - любое название, например, "measoft"<br />
<br />
'''API - ключ''' - не меняем, этот ключ нам еще потребуется.<br />
<br />
'''Активный''' - галку не трогаем, она должна быть.<br />
<br />
'''Шаблон прав''' - все права.<br />
<br />
'''Источник заказа''' - пусто, не трогаем.<br />
<br />
'''Внешние меню''' - нажмите на данное поле, появится список меню. Отметьте галками все меню.<br />
<br />
'''Источник цен''' - внешнее меню.<br />
<br />
'''Email''' - укажите ваш Email.<br />
<br />
'''Подключенные точки''' - нажмите '''Добавить'''.<br />
<br />
Появится блок, в котором нужно будет отметить галочками все ваши рестораны и нажать сохранить.<br />
[[Файл:Iiko5.png|none|1000 px|]]<br />
<br />
<br />
По итогу у вас будет нечто такое:<br />
[[Файл:Iiko7.png|none|1000 px|]]<br />
<br />
<br />
'''4ый шаг''' - нажмите кнопку Сохранить. Но не закрывайте вкладку с данной страницей, нам еще потребуется сюда вернуться.<br />
<br />
<br />
'''5ый шаг''' - создание интеграции в [[Личный кабинет клиента|ЛК пользователя]].<br />
<br />
Для данного шага запишите '''API - ключ''' из '''3ьего шага'''. <br />
<br />
В ЛК пользователя в разделе '''Интеграция''' -> '''Список интеграций''' напротив интеграции '''Iiko''' нажмите кнопку '''Добавить'''<br />
[[Файл:Iiko8.png|none|1000 px|]]<br />
<br />
<br />
'''6ой шаг''' - в '''поле API - ключ''' запишите '''API - ключ''' и нажмите кнопку Сохранить, которая находится внизу страницы.<br />
[[Файл:Iiko9.png|none|1000 px|]]<br />
<br />
<br />
'''7ой шаг''' - после сохранения страницы, вы увидите ссылку '''Api URL''' в самом верху страницы. <br />
<br />
Запишите ее.<br />
<br />
Страницу не закрывайте, мы сюда еще вернемся.<br />
<br />
[[Файл:Iiko10.png|none|1000 px|]]<br />
<br />
<br />
'''8ой шаг''' - вернитесь на страницу Iiko. <br />
<br />
В разделе '''Подключенные точки''' отметьте галкой ваши рестораны и нажмите кнопку '''Настройка веб-хуков'''<br />
<br />
Вы увидите нечто подобное, здесь уже заполнены нужны поля.<br />
[[Файл:Iiko12.png|none|1000 px|]]<br />
<br />
Заполните поля,<br />
<br />
'''Uri''' - запишите здесь Api URL из 7ого шага.<br />
<br />
'''Токен авторизации''' - запишите здесь любое слово, состоящее из латинских букв и цифр. Запомните его.<br />
<br />
В разделе '''Доставка''' отметьте галками '''статус Ждет отправки''' и '''статус Отправлен'''.<br />
<br />
Нажмите '''кнопку OK''', а затем '''кнопку Сохранить'''.<br />
<br />
С настройкой iiko закончено, страницу можно закрыть.<br />
<br />
<br />
'''9ый шаг''' - заполните поля интеграции.<br />
<br />
'''Префикс заказов''' - это префис, который будет добавлен к номеру заказа, если вам это требуется, можно оставить пустым.<br />
<br />
'''Токен авторизации''' - Токен авторизации из 8ого шага.<br />
<br />
'''Используемые организации''' - отметьте галками организации, которые работают с доставкой.<br />
<br />
'''Используемые курьеры''' - отметьте галками тех курьеров, чьи заказы будут передаваться в ЛК.<br />
<br />
'''Настройка соответствия статусов''' - здесь вам нужно сопоставить статусы в ЛК Курьерской службы и статусы в Iiko<br />
<br />
Например '''статус Доставлен Курьерской службы''' и '''статус Доставлено Iiko'''.<br />
<br />
Все соответствия заполнять не требуется.<br />
[[Файл:Iiko13.png|none|1000 px|]]<br />
<br />
<br />
10ый шаг - нажмите '''кнопку Сохранить''' в самом низу страницы и на этом настройка завершена.<br />
<br />
== Создание вебхука на стороне Iiko ==<br />
qwrqwr</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=Iiko&diff=14819Iiko2023-08-07T06:17:55Z<p>Бутусов: </p>
<hr />
<div>== Создание интеграции на стороне Iiko ==<br />
<br />
<br />
'''1ый шаг''' - вам нужно зайти в раздел '''Настройки Cloud API'''<br />
<br />
Этот раздел находится на главной странице административного раздела Iikoweb.<br />
[[Файл:Iiko1.png|none|1000 px|]]<br />
<br />
<br />
'''2ой шаг''' - в блоке "Интеграции" нажмите кнопку "Добавить"<br />
[[Файл:Iiko2.png|none|1000 px|]]<br />
<br />
<br />
'''3ий шаг''' - в появившемся блоке заполните все поля<br />
[[Файл:Iiko3.png|none|1000 px|]]<br />
<br />
<br />
'''Имя api логина''' - любое название, например, "measoft"<br />
<br />
'''API - ключ''' - не меняем, этот ключ нам еще потребуется.<br />
<br />
'''Активный''' - галку не трогаем, она должна быть.<br />
<br />
'''Шаблон прав''' - все права.<br />
<br />
'''Источник заказа''' - пусто, не трогаем.<br />
<br />
'''Внешние меню''' - нажмите на данное поле, появится список меню. Отметьте галками все меню.<br />
<br />
'''Источник цен''' - внешнее меню.<br />
<br />
'''Email''' - укажите ваш Email.<br />
<br />
'''Подключенные точки''' - нажмите '''Добавить'''.<br />
<br />
Появится блок, в котором нужно будет отметить галочками все ваши рестораны и нажать сохранить.<br />
[[Файл:Iiko5.png|none|1000 px|]]<br />
<br />
<br />
По итогу у вас будет нечто такое:<br />
[[Файл:Iiko7.png|none|1000 px|]]<br />
<br />
<br />
'''4ый шаг''' - нажмите кнопку Сохранить. Но не закрывайте вкладку с данной страницей, нам еще потребуется сюда вернуться.<br />
<br />
<br />
'''5ый шаг''' - создание интеграции в [[Личный кабинет клиента|ЛК пользователя]].<br />
<br />
Для данного шага запишите '''API - ключ''' из '''3ьего шага'''. <br />
<br />
В ЛК пользователя в разделе '''Интеграция''' -> '''Список интеграций''' напротив интеграции '''Iiko''' нажмите кнопку '''Добавить'''<br />
[[Файл:Iiko8.png|none|1000 px|]]<br />
<br />
<br />
'''6ой шаг''' - в '''поле API - ключ''' запишите '''API - ключ''' и нажмите кнопку Сохранить, которая находится внизу страницы.<br />
[[Файл:Iiko9.png|none|1000 px|]]<br />
<br />
<br />
'''7ой шаг''' - после сохранения страницы, вы увидите ссылку '''Api URL''' в самом верху страницы. <br />
<br />
Запишите ее.<br />
<br />
Страницу не закрывайте, мы сюда еще вернемся.<br />
<br />
[[Файл:Iiko10.png|none|1000 px|]]<br />
<br />
<br />
'''8ой шаг''' - вернитесь на страницу Iiko. <br />
<br />
В разделе '''Подключенные точки''' отметьте галкой ваши рестораны и нажмите кнопку '''Настройка веб-хуков'''<br />
<br />
Вы увидите нечто подобное, здесь уже заполнены нужны поля.<br />
[[Файл:Iiko12.png|none|1000 px|]]<br />
<br />
Заполните поля,<br />
<br />
'''Uri''' - запишите здесь Api URL из 7ого шага.<br />
<br />
'''Токен авторизации''' - запишите здесь любое слово, состоящее из латинских букв и цифр. Запомните его.<br />
<br />
В разделе '''Доставка''' отметьте галками '''статус Ждет отправки''' и '''статус Отправлен'''.<br />
<br />
Нажмите '''кнопку OK''', а затем '''кнопку Сохранить'''.<br />
<br />
С настройкой iiko закончено, страницу можно закрыть.<br />
<br />
<br />
'''9ый шаг''' - заполните поля интеграции.<br />
<br />
'''Префикс заказов''' - это префис, который будет добавлен к номеру заказа, если вам это требуется, можно оставить пустым.<br />
<br />
'''Токен авторизации''' - Токен авторизации из 8ого шага.<br />
<br />
'''Используемые организации''' - отметьте галками организации, которые работают с доставкой.<br />
<br />
'''Используемые курьеры''' - отметьте галками тех курьеров, чьи заказы будут передаваться в ЛК.<br />
<br />
'''Настройка соответствия статусов''' - здесь вам нужно сопоставить статусы в ЛК Курьерской службы и статусы в Iiko<br />
<br />
Например '''статус Доставлен Курьерской службы''' и '''статус Доставлено Iiko'''.<br />
<br />
Вам соответствия заполнять не требуется.<br />
[[Файл:Iiko13.png|none|1000 px|]]<br />
<br />
<br />
10ый шаг - нажмите '''кнопку Сохранить''' в самом низу страницы и на этом настройка завершена.<br />
<br />
== Создание вебхука на стороне Iiko ==<br />
qwrqwr</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=Iiko&diff=14818Iiko2023-08-07T06:15:42Z<p>Бутусов: /* Создание интеграции на стороне Iiko */</p>
<hr />
<div>== Создание интеграции на стороне Iiko ==<br />
<br />
<br />
'''1ый шаг''' - вам нужно зайти в раздел '''Настройки Cloud API'''<br />
<br />
Этот раздел находится на главной странице административного раздела Iikoweb.<br />
[[Файл:Iiko1.png|none|1000 px|]]<br />
<br />
<br />
'''2ой шаг''' - в блоке "Интеграции" нажмите кнопку "Добавить"<br />
[[Файл:Iiko2.png|none|1000 px|]]<br />
<br />
<br />
'''3ий шаг''' - в появившемся блоке заполните все поля<br />
[[Файл:Iiko3.png|none|1000 px|]]<br />
<br />
<br />
'''Имя api логина''' - любое название, например, "measoft"<br />
<br />
'''API - ключ''' - не меняем, этот ключ нам еще потребуется.<br />
<br />
'''Активный''' - галку не трогаем, она должна быть.<br />
<br />
'''Шаблон прав''' - все права.<br />
<br />
'''Источник заказа''' - пусто, не трогаем.<br />
<br />
'''Внешние меню''' - нажмите на данное поле, появится список меню. Отметьте галками все меню.<br />
<br />
'''Источник цен''' - внешнее меню.<br />
<br />
'''Email''' - укажите ваш Email.<br />
<br />
'''Подключенные точки''' - нажмите '''Добавить'''.<br />
<br />
Появится блок, в котором нужно будет отметить галочками все ваши рестораны и нажать сохранить.<br />
[[Файл:Iiko5.png|none|1000 px|]]<br />
<br />
<br />
По итогу у вас будет нечто такое:<br />
[[Файл:Iiko7.png|none|1000 px|]]<br />
<br />
<br />
'''4ый шаг''' - нажмите кнопку Сохранить. Но не закрывайте вкладку с данной страницей, нам еще потребуется сюда вернуться.<br />
<br />
<br />
'''5ый шаг''' - создание интеграции в [[Личный кабинет клиента|ЛК пользователя]].<br />
<br />
Для данного шага запишите '''API - ключ''' из '''3ьего шага'''. <br />
<br />
В ЛК пользователя в разделе '''Интеграция''' -> '''Список интеграций''' напротив интеграции '''Iiko''' нажмите кнопку '''Добавить'''<br />
[[Файл:Iiko8.png|none|1000 px|]]<br />
<br />
<br />
'''6ой шаг''' - в '''поле API - ключ''' запишите '''API - ключ''' и нажмите кнопку Сохранить, которая находится внизу страницы.<br />
[[Файл:Iiko9.png|none|1000 px|]]<br />
<br />
<br />
'''7ой шаг''' - после сохранения страницы, вы увидите ссылку '''Api URL''' в самом верху страницы. <br />
<br />
Запишите ее.<br />
<br />
Страницу не закрывайте, мы сюда еще вернемся.<br />
<br />
[[Файл:Iiko10.png|none|1000 px|]]<br />
<br />
<br />
'''8ой шаг''' - вернитесь на страницу Iiko. <br />
<br />
В разделе '''Подключенные точки''' отметьте галкой ваши рестораны и нажмите кнопку '''Настройка веб-хуков'''<br />
<br />
Вы увидите нечто подобное, здесь уже заполнены нужны поля.<br />
[[Файл:Iiko12.png|none|1000 px|]]<br />
<br />
Заполните поля,<br />
<br />
'''Uri''' - запишите здесь Api URL из 7ого шага.<br />
<br />
'''Токен авторизации''' - запишите здесь любое слово, состоящее из латинских букв и цифр. Запомните его.<br />
<br />
В разделе '''Доставка''' отметьте галками '''статус Ждет отправки''' и '''статус Отправлен'''.<br />
<br />
Нажмите '''кнопку OK''', а затем '''кнопку Сохранить'''.<br />
<br />
С настройкой iiko закончно, страницу можно закрыть.<br />
<br />
9ый шаг - заполните поля интеграции.<br />
<br />
'''Префикс заказов''' - это префис, который будет добавлен к номеру заказа, если вам это требуется, можно оставить пустым.<br />
<br />
'''Токен авторизации''' - Токен авторизации из 8ого шага.<br />
<br />
'''Используемые организации''' - отметьте галками организации, которые работают с доставкой.<br />
<br />
'''Используемые курьеры''' - отметьте галками тех курьеров, чьи заказы будут передаваться в ЛК.<br />
<br />
'''Настройка соответствия статусов''' - здесь вам нужно сопоставить статусы в ЛК Курьерской службы и статусы в Iiko<br />
<br />
Например '''статус Доставлен Курьерской службы''' и '''статус Доставлено Iiko'''.<br />
<br />
Вам соответствия заполнять не требуется.<br />
[[Файл:Iiko13.png|none|1000 px|]]<br />
<br />
10ый шаг - нажмите '''кнопку Сохранить''' в самом низу страницы и на этом настройка завершена.<br />
<br />
== Создание вебхука на стороне Iiko ==<br />
qwrqwr</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Iiko13.png&diff=14817Файл:Iiko13.png2023-08-07T06:15:21Z<p>Бутусов: </p>
<hr />
<div></div>Бутусовhttps://wiki.courierexe.ru/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Iiko12.png&diff=14816Файл:Iiko12.png2023-08-07T06:06:59Z<p>Бутусов: </p>
<hr />
<div></div>Бутусовhttps://wiki.courierexe.ru/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Iiko10.png&diff=14815Файл:Iiko10.png2023-08-07T06:02:08Z<p>Бутусов: </p>
<hr />
<div></div>Бутусовhttps://wiki.courierexe.ru/index.php?title=Iiko&diff=14814Iiko2023-08-07T06:00:25Z<p>Бутусов: </p>
<hr />
<div>== Создание интеграции на стороне Iiko ==<br />
<br />
<br />
'''1ый шаг''' - вам нужно зайти в раздел '''Настройки Cloud API'''<br />
<br />
Этот раздел находится на главной странице административного раздела Iikoweb.<br />
[[Файл:Iiko1.png|none|1000 px|]]<br />
<br />
<br />
'''2ой шаг''' - в блоке "Интеграции" нажмите кнопку "Добавить"<br />
[[Файл:Iiko2.png|none|1000 px|]]<br />
<br />
<br />
'''3ий шаг''' - в появившемся блоке заполните все поля<br />
[[Файл:Iiko3.png|none|1000 px|]]<br />
<br />
<br />
'''Имя api логина''' - любое название, например, "measoft"<br />
<br />
'''API - ключ''' - не меняем, этот ключ нам еще потребуется.<br />
<br />
'''Активный''' - галку не трогаем, она должна быть.<br />
<br />
'''Шаблон прав''' - все права.<br />
<br />
'''Источник заказа''' - пусто, не трогаем.<br />
<br />
'''Внешние меню''' - нажмите на данное поле, появится список меню. Отметьте галками все меню.<br />
<br />
'''Источник цен''' - внешнее меню.<br />
<br />
'''Email''' - укажите ваш Email.<br />
<br />
'''Подключенные точки''' - нажмите '''Добавить'''.<br />
<br />
Появится блок, в котором нужно будет отметить галочками все ваши рестораны и нажать сохранить.<br />
[[Файл:Iiko5.png|none|1000 px|]]<br />
<br />
<br />
По итогу у вас будет нечто такое:<br />
[[Файл:Iiko7.png|none|1000 px|]]<br />
<br />
<br />
'''4ый шаг''' - нажмите кнопку Сохранить.<br />
<br />
<br />
'''5ый шаг''' - создание интеграции в [[Личный кабинет клиента|ЛК пользователя]].<br />
<br />
Для данного шага запишите '''API - ключ''' из '''3ьего шага'''. <br />
<br />
В ЛК пользователя в разделе '''Интеграция''' -> '''Список интеграций''' напротив интеграции '''Iiko''' нажмите кнопку '''Добавить'''<br />
[[Файл:Iiko8.png|none|1000 px|]]<br />
<br />
<br />
'''6ой шаг''' - в '''поле API - ключ''' запишите '''API - ключ''' и нажмите кнопку Сохранить, которая находится внизу страницы.<br />
[[Файл:Iiko9.png|none|1000 px|]]<br />
<br />
<br />
== Создание вебхука на стороне Iiko ==<br />
qwrqwr</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Iiko9.png&diff=14813Файл:Iiko9.png2023-08-07T06:00:17Z<p>Бутусов: </p>
<hr />
<div></div>Бутусовhttps://wiki.courierexe.ru/index.php?title=Iiko&diff=14812Iiko2023-08-07T05:57:03Z<p>Бутусов: /* Создание интеграции на стороне Iiko */</p>
<hr />
<div>== Создание интеграции на стороне Iiko ==<br />
<br />
<br />
'''1ый шаг''' - вам нужно зайти в раздел '''Настройки Cloud API'''<br />
<br />
Этот раздел находится на главной странице административного раздела Iikoweb.<br />
[[Файл:Iiko1.png|none|1000 px|]]<br />
<br />
<br />
'''2ой шаг''' - в блоке "Интеграции" нажмите кнопку "Добавить"<br />
[[Файл:Iiko2.png|none|1000 px|]]<br />
<br />
<br />
'''3ий шаг''' - в появившемся блоке заполните все поля<br />
[[Файл:Iiko3.png|none|1000 px|]]<br />
<br />
<br />
'''Имя api логина''' - любое название, например, "measoft"<br />
<br />
'''API - ключ''' - не меняем, этот ключ нам еще потребуется.<br />
<br />
'''Активный''' - галку не трогаем, она должна быть.<br />
<br />
'''Шаблон прав''' - все права.<br />
<br />
'''Источник заказа''' - пусто, не трогаем.<br />
<br />
'''Внешние меню''' - нажмите на данное поле, появится список меню. Отметьте галками все меню.<br />
<br />
'''Источник цен''' - внешнее меню.<br />
<br />
'''Email''' - укажите ваш Email.<br />
<br />
'''Подключенные точки''' - нажмите '''Добавить'''.<br />
<br />
Появится блок, в котором нужно будет отметить галочками все ваши рестораны и нажать сохранить.<br />
[[Файл:Iiko5.png|none|1000 px|]]<br />
<br />
<br />
По итогу у вас будет нечто такое:<br />
[[Файл:Iiko7.png|none|1000 px|]]<br />
<br />
<br />
'''4ый шаг''' - нажмите кнопку Сохранить.<br />
<br />
<br />
'''5ый шаг''' - создание интеграции в [[Личный кабинет клиента|ЛК пользователя]].<br />
<br />
Для данного шага запишите '''API - ключ''' из '''3ьего шага'''. <br />
<br />
В ЛК пользователя в разделе '''Интеграция''' -> '''Список интеграций''' напротив интеграции '''Iiko''' нажмите кнопку '''Добавить'''<br />
[[Файл:Iiko8.png|none|1000 px|]]<br />
<br />
== Создание вебхука на стороне Iiko ==<br />
qwrqwr</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Iiko8.png&diff=14811Файл:Iiko8.png2023-08-07T05:56:31Z<p>Бутусов: </p>
<hr />
<div></div>Бутусовhttps://wiki.courierexe.ru/index.php?title=Iiko&diff=14810Iiko2023-08-07T05:53:39Z<p>Бутусов: </p>
<hr />
<div>== Создание интеграции на стороне Iiko ==<br />
<br />
<br />
'''1ый шаг''' - вам нужно зайти в раздел '''Настройки Cloud API'''<br />
<br />
Этот раздел находится на главной странице административного раздела Iikoweb.<br />
[[Файл:Iiko1.png|none|1000 px|]]<br />
<br />
<br />
'''2ой шаг''' - в блоке "Интеграции" нажмите кнопку "Добавить"<br />
[[Файл:Iiko2.png|none|1000 px|]]<br />
<br />
<br />
'''3ий шаг''' - в появившемся блоке заполните все поля<br />
[[Файл:Iiko3.png|none|1000 px|]]<br />
<br />
<br />
'''Имя api логина''' - любое название, например, "measoft"<br />
<br />
'''API - ключ''' - не меняем, этот ключ нам еще потребуется.<br />
<br />
'''Активный''' - галку не трогаем, она должна быть.<br />
<br />
'''Шаблон прав''' - все права.<br />
<br />
'''Источник заказа''' - пусто, не трогаем.<br />
<br />
'''Внешние меню''' - нажмите на данное поле, появится список меню. Отметьте галками все меню.<br />
<br />
'''Источник цен''' - внешнее меню.<br />
<br />
'''Email''' - укажите ваш Email.<br />
<br />
'''Подключенные точки''' - нажмите '''Добавить'''.<br />
<br />
Появится блок, в котором нужно будет отметить галочками все ваши рестораны и нажать сохранить.<br />
[[Файл:Iiko5.png|none|1000 px|]]<br />
<br />
<br />
По итогу у вас будет нечто такое:<br />
[[Файл:Iiko7.png|none|1000 px|]]<br />
<br />
<br />
'''4ый шаг''' - нажмите кнопку Сохранить.<br />
<br />
5ый шаг - в [[личный кабинете клиента|ЛК пользователя]]<br />
<br />
<br />
== Создание вебхука на стороне Iiko ==<br />
qwrqwr</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Iiko7.png&diff=14809Файл:Iiko7.png2023-08-07T05:48:27Z<p>Бутусов: Бутусов загрузил новую версию Файл:Iiko7.png</p>
<hr />
<div></div>Бутусовhttps://wiki.courierexe.ru/index.php?title=Iiko&diff=14808Iiko2023-08-07T05:46:23Z<p>Бутусов: /* Создание интеграции на стороне Iiko */</p>
<hr />
<div>== Создание интеграции на стороне Iiko ==<br />
<br />
<br />
'''1ый шаг''' - вам нужно зайти в раздел '''Настройки Cloud API'''<br />
<br />
Этот раздел находится на главной странице административного раздела Iikoweb.<br />
[[Файл:Iiko1.png|none|1000 px|]]<br />
<br />
<br />
'''2ой шаг''' - в блоке "Интеграции" нажмите кнопку "Добавить"<br />
[[Файл:Iiko2.png|none|1000 px|]]<br />
<br />
<br />
'''3ий шаг''' - в появившемся блоке заполните все поля<br />
[[Файл:Iiko3.png|none|1000 px|]]<br />
<br />
<br />
'''Имя api логина''' - любое название, например, "measoft"<br />
<br />
'''API - ключ''' - не меняем, этот ключ нам еще потребуется.<br />
<br />
'''Активный''' - галку не трогаем, она должна быть.<br />
<br />
'''Шаблон прав''' - все права.<br />
<br />
'''Источник заказа''' - пусто, не трогаем.<br />
<br />
'''Внешние меню''' - нажмите на данное поле, появится список меню. Отметьте галками все меню.<br />
<br />
'''Источник цен''' - внешнее меню.<br />
<br />
'''Email''' - укажите ваш Email.<br />
<br />
'''Подключенные точки''' - нажмите '''Добавить'''.<br />
<br />
Появится блок, в котором нужно будет отметить галочками все ваши рестораны и нажать сохранить.<br />
[[Файл:Iiko5.png|none|1000 px|]]<br />
<br />
<br />
По итогу у вас будет нечто такое:<br />
[[Файл:Iiko7.png|none|1000 px|]]<br />
<br />
<br />
'''4ый шаг''' - нажмите кнопку Сохранить.<br />
<br />
== Создание вебхука на стороне Iiko ==<br />
qwrqwr</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=Iiko&diff=14807Iiko2023-08-07T05:45:45Z<p>Бутусов: </p>
<hr />
<div>== Создание интеграции на стороне Iiko ==<br />
<br />
<br />
'''1ый шаг''' - вам нужно зайти в раздел '''Настройки Cloud API'''<br />
<br />
Этот раздел находится на главной странице административного раздела Iikoweb.<br />
[[Файл:Iiko1.png|none|1000 px|]]<br />
<br />
<br />
'''2ой шаг''' - в блоке "Интеграции" нажмите кнопку "Добавить"<br />
[[Файл:Iiko2.png|none|1000 px|]]<br />
<br />
<br />
'''3ий шаг''' - в появившемся блоке заполните все поля<br />
[[Файл:Iiko3.png|none|1000 px|]]<br />
<br />
<br />
'''Имя api логина''' - любое название, например, "measoft"<br />
<br />
'''API - ключ''' - не меняем, этот ключ нам еще потребуется.<br />
<br />
'''Активный''' - галку не трогаем, она должна быть.<br />
<br />
'''Шаблон прав''' - все права.<br />
<br />
'''Источник заказа''' - пусто, не трогаем.<br />
<br />
'''Внешние меню''' - нажмите на данное поле, появится список меню. Отметьте галками все меню.<br />
<br />
'''Источник цен''' - внешнее меню.<br />
<br />
'''Email''' - укажите ваш Email.<br />
<br />
Подключенные точки - нажмите "Добавить".<br />
<br />
Появится блок, в котором нужно будет отметить галочками все ваши рестораны и нажать сохранить.<br />
[[Файл:Iiko5.png|none|1000 px|]]<br />
<br />
<br />
По итогу у вас будет нечто такое:<br />
[[Файл:Iiko7.png|none|1000 px|]]<br />
<br />
<br />
'''4ый шаг''' - нажмите кнопку Сохранить.<br />
<br />
== Создание вебхука на стороне Iiko ==<br />
qwrqwr</div>Бутусовhttps://wiki.courierexe.ru/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Iiko7.png&diff=14806Файл:Iiko7.png2023-08-07T05:45:29Z<p>Бутусов: </p>
<hr />
<div></div>Бутусовhttps://wiki.courierexe.ru/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:Iiko5.png&diff=14805Файл:Iiko5.png2023-08-07T05:44:03Z<p>Бутусов: </p>
<hr />
<div></div>Бутусов