379
правок
Изменения
→На некоторые заказы
<div style="font-size: 18px; color: #a92424; background-color: #ffdede; border: 1px solid #ebccd1; padding: 3px 10px 10px;">
Обратите внимание, RetailCRM не передает Услуги, не используйте их.
</div>
== Настройка интеграции ==
##* '''Использовать данные склада как отправителя''' — если выбрано значение '''Использовать''', данные отправителя заполняются следующей информацией о складе: адрес, название склада, телефон контактного лица ('''Настройки''' > '''Магазины''' > '''Склады''');
##* '''Передавать ФИО получателя из пользовательского поля''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое вводится имя фактического получателя. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM];
##* '''Передавать телефон получателя из пользовательского поля''' — укажите символьный код пользовательского поля в заказе RetailCRM, в которое вводится телефон фактического получателя. Чтобы создать поле или увидеть символьный код, в RetailCRM выберите '''Настройки''' > '''Системные''' > '''Пользовательские поля'''. Подробнее о настройке пользовательских полей см. [https://help.retailcrm.ru/Users/CustomFields документацию RetailCRM]. Интеграция не передает электронную почту получателя.
##* '''Обновлять заказ при изменении''' — определяет, будет ли заказ в MeaSoft обновлен при изменении данных на стороне RetailCRM. Возможные значения: '''Да''', '''Нет'''.
#: По завершении настройки нажмите '''Сохранить'''.
# Настройте интеграцию в RetailCRM:
## Откройте '''Настройки''' > '''Справочники''' > '''Типы доставок''' и на странице «Типы доставок» нажмите на кнопку '''Добавить'''. Откроется окно «Новая доставка»:[[Файл:Retail1.png|none|1000 px|]]
## В этом окне заполните обязательные поля и в выпадающем списке '''Интегрировать с''' выберите значение '''Курьерская служба 2008MeaSoft'''.
## Нажмите '''Сохранить'''.
Чтобы отправлять заказы в курьерскую службу по статусам и отменять при изменении типа доставки, используйте [[RetailCRM#Настройка триггеров|триггеры]].
== Передача типа платежа в ЛК из retailCRM ==
Если символьный код передаваемого платежа содержит вхождение слова "card", то платеж передается как Карта, иначе Наличные.
Если заказ будет оплачен, то передается NO.
== Исключение печати чеков ==
Чтобы настроить корректную передачу наложенного платежа:
# Откройте '''Настройки''' > '''Интеграция''' и выберите модуль MEASOFT.
# На странице «Настройки интеграции с Курьерская служба 2008» MeaSoft» перейдите на вкладку '''Доставка''' и на панели справа выберите пункт '''Способы оплаты'''.
# Установите флажки для способов оплаты, которые могут использоваться для передачи наложенного платежа, и нажмите '''Сохранить '''.[[Файл:Retail5.png|none|1000 px]]
Интеграция транслирует НДС товаров.
== Передача статусов из MeaSoft ==
Чтобы получать статусы заказа из MeaSoft:
# Откройте '''Настройки''' > '''Интеграция''' и выберите модуль MEASOFT.
# На странице «Настройки интеграции с Курьерская служба 2008» MeaSoft» перейдите на вкладку '''Доставка''' и на панели справа выберите пункт '''Статусы'''.
# Настройте сопоставление статусов MeaSoft и RetailCRM. Для этого в столбце «Статус в RetailCRM» из выпадающего списка выберите соответствие для каждого статуса службы доставки. ''' [[Файл:Retail передача статусов.png|none|1000 px]]
# Нажмите на кнопку '''Сохранить'''.
Статус из MeaSoft в RetailCRM передается 1 раз в 30 минут. Поэтому некоторые промежуточные статусы для заказа могут быть пропущены, и будет показан последний выставленный на момент синхронизации статус заказа.
В интеграции RetailCRM нет понятия "Финальный статус". Интеграция отправляет все статусы, которые есть у заказа, без дополнительных условий.
== Проверка интеграции ==
#: В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:
#:<source lang="javascript">
order.getStatus().getCode() in ["SentMeaSoft"] and order.getDeliveryType().getCode() in ["outcity","incity"]and changeSet.hasChangedField("status")
</source>
#:где
#: В разделе '''Условие''' установите переключатель '''Редактор''' и добавьте следующий скрипт:
#:<source lang="javascript">
order.getStatus().getCode() in ["CancelMeaSoft"] and order.getDeliveryType().getCode() in ["outcity","incity"]and changeSet.hasChangedField("status")
</source>
#:где
Триггер настроен.
== Проверка работоспособности Передача габаритов ==Габариты из retailCRM передаются стандартными средствами retailCRM. Они берутся, либо из раздела "Габариты и вес", либо из раздела "Упаковки", где вы можете распределить товары между упаковками, указав габариты и вес каждой упаковки. [[Файл:Gab.png|none|800 px]] Дополнительно можете изучить информацию здесь https://docs.retailcrm.ru/Users/OperatingActivity/Orders/OrderPage/WorkOrderPage/WorkDeliveryOrder раздел "Оформление упаковок" == Передача признака необходимости возврата ==1) В retailCRM создайте справочник со значениями "no", "yes", "only". [[Файл:Return.png|none|800 px]] 2) В retailCRM создайте пользовательское поле с типом "Справочник". Справочником выберите справочник из 1ого пункта. [[Файл:Return2.png|none|800 px]] 3) В заказе выбирайте нужный элемент справочника и он будет уходить вместе с заказом. 4) В настройках интеграции в ЛК вам нужно в опции "Признак необходимости возврата" выбрать созданное вами поле. == Ошибка "Не удалось загрузить список служб доставки" ==Существует известная проблема на стороне retailCRM, когда вместо получения тарифов вы видите сообщение "Не удалось загрузить список служб доставки". Суть проблемы в том, что retailCRM не может принять большое число ПВЗ. У retailCRM просто не хватает мощностей на обработку большого числа информации. Если у вас много ПВЗ для многих подрядчиков (СДЭК, ПОЧТА РОССИИ, 5POST и тд), то вы иногда можете наблюдать данную ошибку. Избавиться от данной ошибки можно за счет снижения получаемой информации. То есть, вам нужно либо уменьшить кол-во получаемых ПВЗ, либо уменьшить кол-во информации о ПВЗ. Вот варианты того, как можно убрать данную ошибку: #Если вы не используете ПВЗ, то в настройках интеграции в ЛК у опции *Получать ПВЗ для выбора* выберите '''Не получать'''#Если вы не используете все режимы срочности, то в настройках интеграции в ЛК у опции '''Режимы срочности''' выберите только нужные вам режимы#Если вам не нужна такая информация о ПВЗ, как адрес/телефон/время работы/как добраться, то у опции '''Отсылать информацию о ПВЗ''' выберите '''Нет''' == Передача артикулов == === Постоянно ===Если вы планируете передавать артикулы на каждый заказ, то используйте настройку '''Использовать артикулы''' === На некоторые заказы ===Если вы планируете передавать артикулы только на некоторые заказы, то используйте настройку '''Переодическая передача артикула по заказу'''.
# Убедитесь, что выполнены все шаги [[RetailCRM#Настройка интеграции|инструкции по настройке интеграции]].# Если используются триггеры, убедитесь, что они настроены согласно [[RetailCRM#Настройка триггеров|инструкции]].# Создайте заказ, заполните требуемые данные.# Нажмите на кнопку Сначала создайте кастомное поле в retailCRM с типом '''СохранитьФлажок (да/нет)''' внизу страницы, флажок #Сопоставьте этого поле в настройке '''Не отправлять данные в службу доставкиПереодическая передача артикула по заказу''' должен быть снят.<br>Заказ должен отправиться в курьерскую службу. Если заказ отправлен без ошибок и отображается в ЛК, значит интеграция настроена.# Если возникает ошибка, ее текст отображается наверху страницы.:: Если это ошибка заполнения формыДля передачи артикула, исправьте внесенные данные и попробуйте отправить заказ снова. Пример ошибки: «Ошибка сервиса доставки "Курьерская служба 2008": field [receiver phone] has no valid phone number».:: Если это ошибка ответа курьерской службы, сообщите об этом разработчику. Пример ошибки: «Служба доставки прислала ответ ставьте галку в неверном формате».Текст ошибки можно увидеть через [[Личный кабинет#Отладка|отладку]] созданного поле в личном кабинете. Чтобы найти свой заказ в запросах, нажмите CTRL+F нужном заказе и введите в строку поиска номер заказа или ориентируйтесь на время создания заказа.тогда артикулы будут передаваться по данному заказу
