Содержание
Перед настройкой обмена подключите магазин к Яндекс KIT.
Настройки обмена задаются отдельно для каждого подключённого магазина. Если в рамках одного подключения добавлено несколько магазинов, сначала откройте нужный магазин из списка.
На страницах сопоставлений слева отображаются значения Яндекс KIT, справа — поля для выбора соответствующих значений RetailCRM.
Если необязательное значение не сопоставлено, заказ всё равно передаётся, но соответствующее поле в RetailCRM не заполняется по сопоставлению. Обязательные статусы, а также совместимость типов и статусов оплат и доставок необходимо настроить до включения обмена.
Направление обмена заказами
- Заказы из Яндекс KIT создаются и обновляются в RetailCRM.
- Заказ, созданный только в RetailCRM, автоматически не создаётся в Яндекс KIT.
- Из RetailCRM в Яндекс KIT передаются подтверждение заказа, отмена и завершение самовывоза для настроенных статусов.
- Состав, оплата и статус заказа, изменённые вручную в RetailCRM, могут быть перезаписаны при следующем обновлении из Яндекс KIT.
Статусы товаров
В разделе «Статусы товаров» выбираются статусы, которые модуль устанавливает позициям заказа при синхронизации.
- Статус проданного товара — устанавливается у товаров, которые покупатель получил. Обязателен при использовании программы лояльности. По умолчанию используется статус «Продан».
- Статус возвращённого товара — устанавливается у неполученных и возвращённых товаров. Обязателен для обработки товаров и используется как с программой лояльности, так и без неё. По умолчанию используется статус «Возвращён».
После настройки нажмите «Сохранить».
Соответствия справочников
В разделе «Соответствия справочников» настраиваются:
- статусы заказов;
- статусы оплат;
- типы оплат;
- доставки;
- пользовательские поля.
Статусы заказа
В верхней части страницы задаются статусы RetailCRM, при переходе в которые модуль отправляет события в Яндекс KIT.
- Статус подтверждения заказа — обязателен для обработки подтверждения заказов и работы программы лояльности. Выберите статус RetailCRM, означающий, что заказ подтверждён.
- Статус отмены заказа — обязателен для обработки отмены заказов и отмены операций программы лояльности. Выберите статус RetailCRM, означающий отмену заказа.
- Статус завершения самовывоза — необязательный. Укажите его, если заказ с самовывозом должен обрабатываться после перехода в отдельный статус завершения.
Ниже сопоставляются статусы заказов Яндекс KIT и RetailCRM. Для каждого используемого статуса Яндекс KIT выберите соответствующий статус RetailCRM. Если соответствие не требуется, оставьте значение «Не выбрано».
После настройки нажмите «Сохранить».
Статусы оплат
В разделе «Статусы оплат» сопоставляются статусы оплаты Яндекс KIT и RetailCRM.
Для каждого используемого статуса Яндекс KIT выберите соответствующий статус RetailCRM. Если статус не участвует в обмене или в RetailCRM нет подходящего значения, поле можно оставить незаполненным.
Важно!
Для каждого сопоставленного статуса оплаты проверьте, что он разрешён в настройках соответствующего типа оплаты RetailCRM. Если заказ содержит тип оплаты со статусом, который не разрешён для этого типа, при передаче возникнет ошибка и заказ из Яндекс KIT не будет создан или обновлён в RetailCRM. Настройка выполняется в разделе Настройки → Заказы → Типы оплат. Подробнее см. в статье «Типы оплат».
После настройки нажмите «Сохранить».
Типы оплат
В разделе «Типы оплат» сопоставляются способы оплаты Яндекс KIT и типы оплат RetailCRM.
Для каждого используемого типа оплаты Яндекс KIT выберите соответствующий тип оплаты RetailCRM. Если тип оплаты не должен сопоставляться, оставьте значение «Не выбрано».
Перед включением обмена убедитесь, что выбранные типы оплат доступны нужному магазину RetailCRM, а сопоставленные статусы разрешены в настройках этих типов оплат.
После настройки нажмите «Сохранить».
Доставки
В разделе «Доставки» сопоставляются службы доставки Яндекс KIT и типы доставок RetailCRM.
Для каждой используемой службы доставки Яндекс KIT выберите соответствующий тип доставки RetailCRM. Если соответствие не задано, заказ будет передан, но тип доставки в RetailCRM не заполнится автоматически.
Важно!
Для каждого выбранного типа доставки откройте его настройки в RetailCRM и в разделе «Способы оплаты» разрешите все типы оплат, используемые в сопоставлениях Яндекс KIT. Если в заказе указан тип оплаты, который недоступен для выбранного типа доставки, при передаче возникнет ошибка и заказ из Яндекс KIT не будет создан или обновлён в RetailCRM. Подробнее см. в статье «Основные настройки типа доставки».
После настройки нажмите «Сохранить».
Пользовательские поля
Модуль передаёт отдельные значения Яндекс KIT в пользовательские поля заказа и клиента RetailCRM.
| Значение Яндекс KIT | Пользовательское поле RetailCRM по умолчанию | Сущность RetailCRM |
|---|---|---|
| Штрихкод | «Штрихкод» (barcode_yandex_kit) |
Заказ |
| Ссылка на отслеживание | «Ссылка на отслеживание» (tracking_url_yandex_kit) |
Заказ |
| Трек-номер | «Трек-номер» (tracking_number_yandex_kit) |
Заказ |
| Промокод | «Промокод» (promocode_yandex_kit) |
Заказ |
| Ссылка на оплату | «Ссылка на оплату» (payment_url_yandex_kit) |
Заказ |
| Способ доставки | «Способ доставки» (delivery_method_yandex_kit) |
Заказ |
| Тип эквайринга | «Тип эквайринга» (acquiring_type_yandex_kit) |
Заказ |
| Промокод за подписку на рассылку | «Промокод за подписку на рассылку» (promo_code_for_subscription_yandex_kit) |
Клиент |
«Ссылка на отслеживание» содержит адрес страницы службы доставки, а «Трек-номер» — идентификатор отправления. Яндекс KIT может передать трек-номер без ссылки, поэтому значения сохраняются в разных полях.
При установке модуля соответствующие пользовательские поля создаются автоматически, если они отсутствуют в RetailCRM.
На странице настройки поля разделены на два блока: «Пользовательские поля заказа» и «Пользовательские поля клиента». Для значений заказа можно выбрать другое пользовательское поле заказа RetailCRM, для значения клиента — другое пользовательское поле клиента.
Сопоставления сохраняются отдельно для каждого подключённого магазина. Если значение передавать не требуется, очистите выбранное поле RetailCRM. Если значение отсутствует в данных Яндекс KIT, модуль не передаёт его и при обновлении заказа или клиента не очищает ранее сохранённое значение.
После настройки нажмите «Сохранить».
Передача UTM-меток и источника заказа
Модуль передаёт в RetailCRM информацию об источнике заказа из Яндекс KIT. UTM-метки передаются через массив sources в запросе Яндекс KIT.
Поддерживаются стандартные поля:
utm_source;utm_medium;utm_campaign;utm_term;utm_content.
Нестандартные ключи в sources игнорируются.
Идентификатор клиента Метрики (metric_client_id) сохраняется в пользовательское поле заказа RetailCRM. Данные об источнике передаются как при создании, так и при последующих обновлениях заказа.
Дополнительные настройки на стороне RetailCRM для приёма UTM-меток не требуются.