Содержание
Интеграционный модуль синхронизирует данные между RetailCRM и Яндекс KIT: передает каталог товаров, клиентов и заказы, поддерживает сценарии лояльности и помогает согласовать статусы и справочники между системами.
В рамках одного подключения поддерживается работа с несколькими магазинами.
Подключение
Зайдите в кабинет магазина в Яндекс KIT в раздел Настройки → Интеграции → RetailCRM и скопируйте АПИ-ключ.
Далее откройте настройки модуля в маркетплейсе RetailCRM. На странице «Подключенные магазины» отображается список магазинов, добавленных в рамках текущего подключения.
Чтобы открыть настройки магазина, нажмите на строку с нужным магазином. Переключатель «Активен в модуле» включает или отключает работу магазина в модуле.
Для подключения нового магазина нажмите «Добавить магазин» и заполните поля:
- Секретный ключ — АПИ-ключ, скопированный из Яндекс KIT.
- Магазин в RetailCRM — магазин, который будет использоваться для обмена данными.
- Активность — должна быть включена для работы модуля.
Сохраните настройки.
После сохранения в поле «Статус авторизации Яндекс KIT» должен отображаться статус «Авторизован».
Кнопка «Переподключиться» генерирует новый ключ для проверки подлинности запросов между системами авторизации и отправляет его в Яндекс KIT.
Важно!
Для корректного обмена товарным составом необходимо включить опцию «Возможность добавлять в заказ одинаковые торговые предложения как разные позиции». Настройка находится в разделе Настройки → Системные → Заказы. Подробнее см. в статье «Как добавлять в заказ одинаковые торговые предложения как разные позиции».
Программа лояльности
Программа лояльности настраивается отдельно для каждого подключенного магазина.
В разделе «Программа лояльности»:
- Включите чекбокс «Включить программу лояльности».
- Нажмите Сохранить.
После сохранения настроек отображается поле «Статус авторизации программы лояльности». При успешной авторизации отображается статус «Авторизован».
Кнопка Переподключиться позволяет повторно синхронизировать программу лояльности без перегенерации основного ключа подключения.
Примечание
Переподключение доступно после сохранения настроек. Если настройки не сохранены, при попытке выполнить переподключение система показывает уведомление.
После этого становятся доступны сценарии лояльности: регистрация и обновление пользователей, бонусные операции, работа с loyalty-заказами.
Примечание
Поддерживается бонусная модель. Процентная скидка не поддерживается.
Статусы товаров
В разделе «Статусы товаров» настраиваются статусы, которые устанавливаются позициям заказа при синхронизации.
- Статус проданного товара — статус, который присваивается позиции заказа, если количество больше 0.
- Статус возвращённого товара — статус, который присваивается позиции заказа, если количество равно 0.
Значения выбираются из справочника статусов товаров RetailCRM. По умолчанию используются статусы «Продан» и «Возврат».
Справочники и статусы
Справочники и статусы настраиваются отдельно для каждого подключенного магазина. Если в рамках одного подключения добавлено несколько магазинов, откройте нужный магазин из списка и настройте сопоставления для него.
В разделе «Соответствия справочников» настраиваются сопоставления по направлению Яндекс KIT → RetailCRM:
- статусы заказов;
- статусы оплат;
- типы оплат;
- доставки.
На страницах сопоставлений слева отображаются значения справочников RetailCRM, справа — поля для выбора соответствующих значений Яндекс KIT. Для каждого значения RetailCRM выберите значение Яндекс KIT, которое должно ему соответствовать.
Если значение не сопоставлено, заказ все равно передается, но несопоставленное поле в CRM не заполняется по маппингу.
Для настройки статусов заказа откройте страницу «Статусы заказа». В верхней части страницы задаются:
- статус отмены заказа в RetailCRM;
- статус подтверждения заказа в RetailCRM;
- статус завершения самовывоза в RetailCRM.
Эти три статуса используются для обратного направления RetailCRM → Яндекс KIT: при переходе заказа в один из них модуль отправляет соответствующее событие.
Ниже на странице сопоставляются статусы заказов RetailCRM и Яндекс KIT. Для каждого статуса RetailCRM выберите соответствующий статус Яндекс KIT в поле справа. Если для статуса не требуется передавать соответствие, оставьте значение «Не выбрано».
Для настройки статусов оплат откройте страницу «Статусы оплат». В этом разделе сопоставляются статусы оплаты, которые используются в RetailCRM и Яндекс KIT.
В строке нужного статуса RetailCRM выберите соответствующий статус Яндекс KIT. Сопоставление используется при передаче данных об оплате заказа между системами. Если статус оплаты не используется в обмене или для него нет подходящего значения в Яндекс KIT, поле можно оставить незаполненным.
Для настройки типов оплат откройте страницу «Типы оплат». В этом разделе сопоставляются способы оплаты RetailCRM и Яндекс KIT.
Для каждого типа оплаты RetailCRM выберите соответствующий тип оплаты Яндекс KIT. Такое сопоставление позволяет модулю определить, какое значение оплаты нужно использовать при обмене заказами. Если тип оплаты не должен сопоставляться, оставьте поле справа со значением «Не выбрано».
Для настройки доставок откройте страницу «Доставки». В этом разделе настройте соответствие между типами доставок RetailCRM и службами доставки Яндекс KIT.
Слева отображаются типы доставок из RetailCRM. Справа для каждого типа доставки выберите соответствующую службу доставки Яндекс KIT.
Если для доставки не выбрать значение Яндекс KIT, заказы с такой доставкой все равно будут создаваться, но тип доставки в RetailCRM не будет заполнен автоматически.
После настройки каждой страницы нажмите «Сохранить».
Передача UTM-меток и источника заказа
Модуль передаёт в RetailCRM информацию об источнике заказа из Яндекс KIT. UTM-метки передаются через массив sources в запросе от Яндекс KIT.
Модуль обрабатывает следующие стандартные поля:
utm_source;utm_medium;utm_campaign;utm_term;utm_content.
Нестандартные ключи в sources игнорируются.
Идентификатор клиента Метрики (metric_client_id) сохраняется в кастомное поле заказа в RetailCRM.
Данные об источнике передаются как при создании заказа, так и при последующих обновлениях заказа.
Дополнительных настроек на стороне RetailCRM для приёма UTM-меток не требуется.