Модуль интеграции RetailCRM с oShip позволяет:

• передавать заказы из RetailCRM в раздел Подтверждение oShip;
• передавать заказы из RetailCRM в раздел Упаковка oShip;
• включать для магазина только нужные модули: Подтверждение, Упаковка или оба сразу;
• печатать собственную этикетку RetailCRM или этикетку транспортной компании;
• синхронизировать статусы подтверждения, упаковки и отгрузки между oShip и RetailCRM;
• передавать Честный знак в RetailCRM при подтверждении или при упаковке;
• повторно выгружать или пересоздавать заказ в oShip после исправления данных или изменения товарного состава;
• видеть активные и решенные проблемы интеграции в личном кабинете модуля.

Модуль доступен в маркетплейсе RetailCRM: Настройки -> Интеграция -> Маркетплейс, название модуля - Автоматизация упаковки заказов. После нажатия кнопки Подключить RetailCRM откроет личный кабинет модуля.

Для работы интеграции нужен аккаунт в oShip и магазин oShip с источником заказов API.

1. Авторизуйтесь в oShip.

2. Перейдите в раздел Магазин и нажмите Новый магазин.

3. Заполните данные магазина, перейдите на вкладку API и сохраните API-ключ.

4. Нажмите Сохранить.

Перед добавлением магазина в модуле создайте печатную форму. Она определяет, какую этикетку модуль получит и передаст в oShip при упаковке заказа.

Откройте раздел Этикетки и нажмите Новая печатная форма.



Доступные печатные формы:

• RetailCRM - собственная печатная форма RetailCRM;
• СДЭК - получение этикетки через API СДЭК v2;
• Почта России;
• Интеграл;
• X5Post;
• Яндекс Доставка;
• Магнит Пост;
• Logsis;
• Курьерист.

При добавлении печатной формы RetailCRM нужно указать ID печатной формы. Его можно посмотреть в RetailCRM на странице печатных форм заказа.

Магазин в модуле связывает сайт RetailCRM, тип доставки, магазин oShip, печатную форму и правила обмена статусами. Перейдите в раздел Магазины и нажмите Новый магазин.



Общие настройки:

• Печатная форма - этикетка, которая будет использоваться при упаковке заказа.
• Имя - название настройки в списке магазинов модуля.
• Поддомен - поддомен аккаунта oShip без .oship.ru.
• API-key магазина oShip - API-ключ магазина oShip с источником заказов API.
• Сайт - сайт RetailCRM, из которого модуль будет брать заказы.
• Подключенные модули - Подтверждение, Упаковка или оба модуля. Если вы не используете Подтверждение, отключите его в этом поле.
• Тип доставки - тип доставки RetailCRM, заказы с которым будет обрабатывать этот магазин.
• Дата отгрузки - какое поле RetailCRM передавать в oShip как плановую дату отгрузки: дату доставки или дату отгрузки.
• Признак для обновления заказа - символьный код пользовательского поля RetailCRM типа Да/Нет для пересоздания заказа в oShip при изменении товарного состава.

Передача маркировки:
Если нужно передавать Честный знак из oShip в RetailCRM, включите Передавать маркировку и выберите режим.

• При подтверждении - oShip запросит коды маркировки на этапе подтверждения заказа, а модуль передаст их в RetailCRM после подтверждения.
• При упаковке - oShip запросит коды маркировки на этапе упаковки, а модуль передаст их в RetailCRM после упаковки.

Статусы для oShip определяют, при каких статусах RetailCRM модуль будет выполнять действия в oShip.

• Готов к подтверждению - заказы в этих статусах будут создаваться в разделе Подтверждение oShip.
• Готов к упаковке - заказы в этих статусах будут создаваться в разделе Упаковка oShip.
• Статусы отмененного заказа - если заказ RetailCRM перейдет в один из этих статусов, модуль отменит заказ в oShip.
• Статусы отгруженного заказа - если заказ RetailCRM перейдет в один из этих статусов, модуль отметит заказ в oShip как отгруженный.

Перенос статусов в RetailCRM задает статусы, которые модуль установит после действий в oShip.

• Статус подтверждения - после подтверждения заказа в oShip.
• Статус упаковки - после упаковки заказа в oShip.
• Статус отгрузки - после отгрузки заказа в oShip.

В блоке Прочие настройки задается сопоставление товаров между RetailCRM и oShip:

• Сопоставление товаров - основной способ сопоставления: по артикулу или по штрихкоду. При сопоставлении по штрихкоду код товара не передается, поэтому отсутствующие товары при выгрузке в oShip создаваться не будут.
• Артикул - поле RetailCRM, которое будет передаваться в oShip как код товара.
• Штрихкоды - поле RetailCRM, которое будет передаваться в oShip как штрихкод товара.

Эти же настройки используются при передаче Честного знака обратно в RetailCRM: модуль сопоставляет отсканированные коды с позициями заказа по выбранному признаку.

Модуль определяет маркируемые товары по признаку markable в RetailCRM. Уже заполненные коды маркировки из RetailCRM передаются в oShip вместе с заказом. После подтверждения или упаковки модуль записывает полученные коды в markingCodes позиций заказа RetailCRM.

Подробно работа с маркировкой в oShip описана в разделе Честный знак.

Интеграция регулярно проверяет RetailCRM и oShip. Базовый интервал обработки - каждые 2 минуты.

Подтверждение

Если подключен модуль Подтверждение, модуль ищет заказы RetailCRM на выбранном сайте, с выбранным типом доставки и в статусах Готов к подтверждению. Подходящие заказы создаются в разделе Подтверждение oShip. После подтверждения модуль при необходимости передает коды Честного знака и устанавливает в RetailCRM настроенный статус подтверждения.

Упаковка

Если подключен модуль Упаковка, модуль ищет заказы RetailCRM на выбранном сайте, с выбранным типом доставки и в статусах Готов к упаковке. Перед созданием заказа в oShip модуль получает этикетку из RetailCRM или через API транспортной компании. После упаковки модуль при необходимости передает коды Честного знака и устанавливает в RetailCRM настроенный статус упаковки.

Отмена, отгрузка и дата отгрузки

Если заказ RetailCRM перешел в один из настроенных статусов отмены или отгрузки, модуль отправит соответствующее действие в oShip. Если заказ уже создан в oShip, а выбранная дата отгрузки в RetailCRM изменилась, модуль отправит обновленную дату в oShip.

Если заказ не был создан в oShip из-за ошибки данных, настроек или API транспортной компании, исправьте причину и оставьте заказ в статусе, который указан в настройках Готов к подтверждению или Готов к упаковке. При следующей обработке модуль снова попробует создать заказ.

Если после выгрузки в oShip у заказа изменился товарный состав, используйте настройку Признак для обновления заказа. Укажите в ней символьный код пользовательского поля заказа RetailCRM типа Да/Нет. Когда заказ нужно пересоздать, установите это поле в RetailCRM в значение Да.

Модуль сравнит текущий состав заказа RetailCRM с составом заказа в oShip. Если состав отличается и заказ в oShip находится в допустимом статусе, старый заказ будет отменен, а новый будет создан с версией в номере, например 12345v1 или 12345v2. Если заказ в oShip уже отменен, модуль сразу создаст новую версию без повторной отмены, в том числе если товарный состав не изменился. После успешного пересоздания модуль сбросит пользовательское поле обратно в Нет.

Раздел Проблемы интеграции показывает активные и решенные ошибки обмена между RetailCRM, oShip и транспортными компаниями.



В списке отображаются магазин, заказ или объект ошибки, операция, этап, текст ошибки, количество повторов, время последнего возникновения и подробности.

Для внешней поддержки можно создать защищенную ссылку на страницу проблем. По этой ссылке доступны только проблемы интеграции; настройки магазинов и этикеток недоступны.