Содержание
Интеграционный модуль передаёт заказы из Яндекс KIT в RetailCRM и отправляет в обратном направлении отдельные события: подтверждение заказа, отмену и завершение самовывоза. В модуле также настраиваются ICML-каталог, программа лояльности, статусы и справочники.
В рамках одного подключения поддерживается работа с несколькими магазинами.
Подключение
Зайдите в кабинет магазина в Яндекс KIT в раздел Настройки → Интеграции → RetailCRM и скопируйте АПИ-ключ.
Далее откройте настройки модуля в маркетплейсе RetailCRM. На странице «Подключенные магазины» отображается список магазинов, добавленных в рамках текущего подключения.
Чтобы открыть настройки магазина, нажмите на строку с нужным магазином. Переключатель «Активен в модуле» включает или отключает работу магазина в модуле.
Для подключения нового магазина нажмите «Добавить магазин» и заполните поля:
- Секретный ключ — АПИ-ключ, скопированный из Яндекс KIT.
- Магазин в RetailCRM — магазин, который будет использоваться для обмена данными.
- Активность — должна быть включена для работы модуля.
Сохраните настройки.
Важно!
При первом включении активного подключения модуль выполняет полный обмен данными с Яндекс KIT. Он может создать новые и обновить связанные заказы, которые уже есть в RetailCRM. До включения проверьте сопоставления статусов, оплат, доставок и пользовательских полей.
После сохранения в поле «Статус авторизации Яндекс KIT» должен отображаться статус «Авторизован».
Кнопка «Переподключиться» генерирует новый ключ для проверки подлинности запросов между системами авторизации и отправляет его в Яндекс KIT.
Важно!
Для корректного обмена товарным составом необходимо включить опцию «Возможность добавлять в заказ одинаковые торговые предложения как разные позиции». Настройка находится в разделе Настройки → Системные → Заказы. Подробнее см. в статье «Как добавлять в заказ одинаковые торговые предложения как разные позиции».
ICML-каталог
Раздел «ICML-каталог» используется для обновления ссылки на товарный каталог выбранного магазина. Нажмите «Обновить ICML-каталог» — модуль получит актуальную ссылку из Яндекс KIT и автоматически сохранит её в настройках магазина RetailCRM.
Копировать и добавлять ссылку вручную не требуется.
Важно!
Модуль не синхронизирует остатки товаров между RetailCRM и Яндекс KIT. Изменение количества товара в одной системе не приводит к обновлению остатков в другой.
Направление обмена заказами
- Заказы из Яндекс KIT создаются и обновляются в RetailCRM.
- Заказ, созданный только в RetailCRM, автоматически не создаётся в Яндекс KIT.
- Из RetailCRM в Яндекс KIT передаются подтверждение заказа, отмена и завершение самовывоза для настроенных статусов.
- Состав, оплата и статус заказа, изменённые вручную в RetailCRM, могут быть перезаписаны при следующем обновлении из Яндекс KIT.
Программа лояльности
Программа лояльности настраивается отдельно для каждого подключенного магазина.
Важно!
Старую и новую интеграции Яндекс KIT с программой лояльности нельзя использовать одновременно. Перед переходом уточните актуальный сценарий миграции и убедитесь, что одновременно активно только одно подключение программы лояльности.
В разделе «Программа лояльности»:
- Включите чекбокс «Включить программу лояльности».
- Нажмите Сохранить.
После сохранения настроек отображается статус авторизации программы лояльности. При успешной авторизации отображается значение «Авторизован».
Кнопка Переподключиться позволяет повторно синхронизировать программу лояльности без перегенерации основного ключа подключения.
Примечание
Переподключение доступно после сохранения настроек. Если настройки не сохранены, при попытке выполнить переподключение система показывает уведомление.
После этого становятся доступны сценарии лояльности: регистрация и обновление пользователей, бонусные операции, работа с loyalty-заказами.
Примечание
Поддерживается бонусная модель. Процентная скидка не поддерживается.
Статусы товаров
В разделе «Статусы товаров» настраиваются статусы, которые устанавливаются позициям заказа при синхронизации.
- Статус проданного товара — статус, который присваивается позиции заказа, если количество больше 0.
- Статус возвращённого товара — статус, который присваивается позиции заказа, если количество равно 0.
Значения выбираются из справочника статусов товаров RetailCRM. По умолчанию используются статусы «Продан» и «Возврат».
Справочники и статусы
Справочники и статусы настраиваются отдельно для каждого подключенного магазина. Если в рамках одного подключения добавлено несколько магазинов, откройте нужный магазин из списка и настройте сопоставления для него.
В разделе «Соответствия справочников» настраиваются сопоставления по направлению Яндекс KIT → RetailCRM:
- статусы заказов;
- статусы оплат;
- типы оплат;
- доставки;
- пользовательские поля.
На страницах сопоставлений слева отображаются значения Яндекс KIT, справа — поля для выбора соответствующих значений RetailCRM. Для каждого значения Яндекс KIT выберите значение RetailCRM, которое должно ему соответствовать.
Если значение не сопоставлено, заказ все равно передается, но несопоставленное поле в CRM не заполняется по маппингу.
Для настройки статусов заказа откройте страницу «Статусы заказа». В верхней части страницы задаются:
- статус отмены заказа в RetailCRM;
- статус подтверждения заказа в RetailCRM;
- статус завершения самовывоза в RetailCRM.
Эти три статуса используются для обратного направления RetailCRM → Яндекс KIT: при переходе заказа в один из них модуль отправляет соответствующее событие.
Ниже на странице сопоставляются статусы заказов Яндекс KIT и RetailCRM. Для каждого статуса Яндекс KIT выберите соответствующий статус RetailCRM в поле справа. Если для статуса не требуется передавать соответствие, оставьте значение «Не выбрано».
Для настройки статусов оплат откройте страницу «Статусы оплат». В этом разделе сопоставляются статусы оплаты, которые используются в Яндекс KIT и RetailCRM.
В строке нужного статуса Яндекс KIT выберите соответствующий статус RetailCRM. Сопоставление используется при передаче данных об оплате заказа из Яндекс KIT в RetailCRM. Если статус оплаты не используется в обмене или для него нет подходящего значения в RetailCRM, поле можно оставить незаполненным.
Для настройки типов оплат откройте страницу «Типы оплат». В этом разделе сопоставляются способы оплаты Яндекс KIT и RetailCRM.
Для каждого типа оплаты Яндекс KIT выберите соответствующий тип оплаты RetailCRM. Такое сопоставление позволяет модулю определить, какое значение оплаты нужно использовать при обмене заказами. Если тип оплаты не должен сопоставляться, оставьте поле справа со значением «Не выбрано».
Для настройки доставок откройте страницу «Доставки». В этом разделе настройте соответствие между службами доставки Яндекс KIT и типами доставок RetailCRM.
Слева отображаются службы доставки Яндекс KIT. Справа для каждой службы выберите соответствующий тип доставки RetailCRM.
Если для службы доставки не выбрать значение RetailCRM, заказы с такой доставкой все равно будут создаваться, но тип доставки в RetailCRM не будет заполнен автоматически.
После настройки каждой страницы нажмите «Сохранить».
Пользовательские поля
Модуль поддерживает передачу следующих значений из Яндекс KIT в пользовательские поля RetailCRM:
| Значение Яндекс KIT | Пользовательское поле RetailCRM по умолчанию | Сущность RetailCRM |
|---|---|---|
| Штрихкод | «Штрихкод» (barcode_yandex_kit) |
Заказ |
| Ссылка на отслеживание | «Ссылка на отслеживание» (tracking_url_yandex_kit) |
Заказ |
| Промокод | «Промокод» (promocode_yandex_kit) |
Заказ |
| Ссылка на оплату | «Ссылка на оплату» (payment_url_yandex_kit) |
Заказ |
| Способ доставки | «Способ доставки» (delivery_method_yandex_kit) |
Заказ |
| Тип эквайринга | «Тип эквайринга» (acquiring_type_yandex_kit) |
Заказ |
| Промокод за подписку на рассылку | «Промокод за подписку на рассылку» (promo_code_for_subscription_yandex_kit) |
Клиент |
При установке модуля соответствующие пользовательские поля создаются в RetailCRM, если они отсутствуют.
На странице «Пользовательские поля» настройки разделены на два блока: «Пользовательские поля заказа» и «Пользовательские поля клиента». В строках слева отображаются фиксированные поля Яндекс KIT, справа — поля RetailCRM. Для полей заказа можно выбрать другое пользовательское поле заказа RetailCRM, для поля клиента — другое пользовательское поле клиента.
Сопоставления сохраняются отдельно для каждого подключенного магазина. Чтобы изменить настройки другого магазина, откройте его из списка магазинов и настройте сопоставления для него.
Если значение не требуется передавать, очистите выбранное поле RetailCRM. Если значение отсутствует в данных от Яндекс 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-меток не требуется.