Модуль обеспечивает полную двухстороннюю интеграцию CS-Cart с CRM-системой RetailCRM. Данные синхронизируются в обе стороны: заказы, клиенты, корзины, обратные звонки и заказы в один клик.
Как работает синхронизация
Модуль подключается к жизненному циклу CS-Cart через хуки и реагирует на события в реальном времени. При создании заказа на сайте (хук place_order) заказ автоматически экспортируется в RetailCRM. При изменении статуса заказа (хук change_order_status) обновление передаётся в CRM. При оплате (хук finish_payment) в RetailCRM обновляется статус оплаты. Клиенты синхронизируются при регистрации и обновлении профиля (хуки update_profile, retailcrm_pre_save_customer).
Для массовой выгрузки и импорта используются cron-задачи. Модуль предоставляет отдельные cron-ссылки для: импорта истории изменений из RetailCRM (заказы и клиенты), экспорта пользователей в CRM, импорта пользователей из CRM, экспорта заказов, импорта заказов. Каждая задача вызывается по своему URL с секретным ключом для авторизации.
Экспорт из CS-Cart в RetailCRM
Заказы выгружаются при создании, изменении статуса и оплате. В заказ передаются: товары с ценами и количеством, данные клиента (ФИО, телефон, email, адрес), способ доставки и оплаты, статус, скидки, UTM-метки (при включённой настройке). Корзины (незавершённые покупки) выгружаются при включённой настройке — в RetailCRM создаются заказы со статусом «корзина».
Клиенты экспортируются при регистрации и обновлении профиля. Модуль сопоставляет пользователей по email и телефону, чтобы избежать дублирования. При экспорте заказа, если клиент ещё не найден в RetailCRM, он создаётся автоматически.
Импорт из RetailCRM в CS-Cart
Импорт заказов выполняется через cron или при получении webhook от RetailCRM (если настроена история изменений). Новые заказы из CRM создаются на сайте с сопоставлением статусов, способов оплаты и доставки. Клиенты импортируются при первом обращении к ним в заказе.
Модуль поддерживает импорт истории изменений: при изменении заказа или клиента в RetailCRM данные обновляются в CS-Cart. Синхронизируются статус заказа, оплата, данные доставки, примечания.
Обратный звонок и покупка в один клик
При наличии модуля «Обратный звонок» заявки на обратный звонок и покупку в один клик передаются в RetailCRM (хук call_requests_do_call_request_post). В CRM создаётся заказ с типом «обратный звонок» или «покупка в один клик», привязывается менеджер. Можно настроить создание полноценного заказа с товарами при покупке в один клик.
Интеграция с MEASoft и Яндекс.Маркет
При использовании модуля MEASoft для доставки стоимость доставки передаётся в RetailCRM (в комментарий или отдельным полем). Для Яндекс.Маркета: при генерации YML-прайса для выгрузки в RetailCRM модуль подменяет класс Offers, чтобы подставлять external_id товаров из RetailCRM (хук yml_export_get_options_post).
Мультивендорность
Модуль поддерживает Multi-Vendor и Ultimate. Настройки и сопоставления хранятся отдельно для каждой компании (витрины). Для каждого магазина задаётся свой сайт и склад в RetailCRM. Cron-задачи выполняются с учётом company_id или storefront_id.
Где находятся настройки
Все настройки модуля расположены в разделе «Администрирование» → «Синхронизация данных» → «MS: Расширенная интеграция с retailCRM». Интерфейс организован в виде вкладок: Общие (URL, API-ключ, валюта, сайт и склад по умолчанию), Заказы (режимы экспорта и импорта, настройки полей), Склады, Импорт статусов, Экспорт статусов, Способы оплаты, Способы доставки, Поля пользователей, Обратный звонок и покупка в один клик, Cron (пароль и ссылки для cron).
На странице редактирования заказа в админке CS-Cart отображается ID заказа в RetailCRM (если заказ был выгружен). Доступны кнопки для экспорта заказа в RetailCRM и импорта из RetailCRM на сайт.
