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