Интеграция CS-Cart с RetailCRM строится на дополнении (add-on), которое подключает магазин к CRM по API, выгружает каталог в ICML и синхронизирует заказы. У платформы есть особенности — многоскладность и режим Multi-Vendor, — которые важно учесть до запуска.
Как устроена интеграция
CS-Cart подключается к RetailCRM через дополнение, которое взаимодействует с REST API v5. Логика та же, что у других коннекторов: витрина отдаёт каталог и заказы, CRM возвращает статусы и правки менеджеров.
- Каталог — генерируется ICML-файл со всеми товарами, вариациями и категориями.
- Заказы — при оформлении уходят в CRM с
externalId, равным номеру заказа CS-Cart. - Обратная синхронизация — по cron магазин забирает из CRM смену статуса, оплату и изменения состава заказа.
Для CS-Cart критично, что платформа поддерживает несколько складов и валют. Их нужно заранее сопоставить со складами и параметрами RetailCRM, иначе остатки и цены поедут.
Установка дополнения
Add-on ставится штатными средствами CS-Cart без правки ядра.
- Загрузите пакет дополнения через
Модули → Управление модулями → Загрузить и установитьлибо распакуйте в каталогapp/addons/. - Найдите модуль RetailCRM в списке и переведите статус в Активно.
- Откройте настройки дополнения и заполните параметры подключения к CRM.
?cc в адресной строке админки.Подключение по API
В RetailCRM создайте ключ доступа в разделе Настройки → Интеграция → Ключи доступа к API, ограничив его нужным магазином и набором методов.
| Параметр | Где взять |
|---|---|
| Адрес CRM | URL вашего аккаунта retailcrm.ru |
| API-ключ | «Ключи доступа к API» с ограничением по магазину |
| Код магазина (site) | из карточки магазина в «Администрирование → Магазины» |
После сохранения дополнение проверит соединение и откроет вкладки сопоставления оплат, доставок и статусов.
Особенности Multi-Vendor
Если вы работаете на редакции CS-Cart Multi-Vendor, учитывайте, что заказ может содержать позиции разных продавцов, а CS-Cart дробит его на подзаказы.
- Решите заранее, как заказ маркетплейса ложится в CRM: единым заказом или отдельными по вендорам.
- Склады продавцов сопоставьте со складами RetailCRM, чтобы корректно считались остатки.
- Комиссии и выплаты вендорам в CRM не переносятся — эту логику ведут на стороне CS-Cart.
Выгрузка каталога ICML
Каталог формируется по расписанию. Настройте cron на генерацию ICML и укажите его URL в CRM.
*/30 * * * * php /var/www/cscart/index.php --dispatch=retailcrm.generate_icml
Публичный адрес файла (например https://site.ru/var/retailcrm/retailcrm.xml) впишите в поле Адрес файла каталога ICML в разделе Администрирование → Магазины и запустите пробную загрузку.
Вариации товара (features/options) выгружаются как отдельные торговые предложения (offers) внутри одного товара — это важно для корректного учёта остатков по размерам и цветам.
Проверка обмена
Финальная проверка — сквозной тест: оформляем заказ на витрине, смотрим его в CRM, меняем статус в CRM и убеждаемся, что он вернулся на сайт.
| Что проверяем | Ожидаемый результат |
|---|---|
| Новый заказ | Появился в CRM с товаром, оплатой и доставкой |
| Смена статуса в CRM | Через несколько минут отражается в CS-Cart |
| Остатки | Совпадают по складам витрины и CRM |
| Клиент | Не задваивается, находится по телефону или e-mail |
Логи дополнения ищите в журнале CS-Cart и в разделе загрузки каталога RetailCRM.
Итог
Интеграция CS-Cart с RetailCRM даёт единый поток заказов, актуальный каталог и синхронные статусы. Основная работа — не установка, а маппинг справочников, складов и, для Multi-Vendor, согласование модели разбиения заказов. Именно на этих шагах чаще всего возникают дубли и расхождения остатков.
Мы настраиваем связку CS-Cart и RetailCRM с учётом многоскладности и маркетплейс-логики, тестируем полный цикл заказа и передаём готовую к работе систему.
Частые вопросы
Куда устанавливается дополнение RetailCRM в CS-Cart?
Модуль ставится через раздел «Управление модулями» или распаковкой в каталог app/addons. После активации нужно очистить кеш шаблонов через ?cc.
Поддерживается ли CS-Cart Multi-Vendor?
Да, но требует отдельного согласования: заказ с товарами разных продавцов CS-Cart дробит на подзаказы, и нужно заранее решить, как это отражать в CRM, чтобы не задваивать заказы.
Как выгружаются вариации товара?
Размеры, цвета и другие опции попадают в ICML как торговые предложения (offers) внутри одного товара. Это позволяет вести остатки по каждой вариации отдельно.
Что делать с несколькими складами?
Склады CS-Cart сопоставляют со складами RetailCRM в настройках. Без маппинга остатки будут считаться некорректно.
Обязателен ли cron?
Да. По расписанию генерируется каталог ICML и подтягивается история изменений заказов из CRM. Без cron обратная синхронизация статусов не работает.
Переносятся ли комиссии вендоров в RetailCRM?
Нет. Расчёты и выплаты продавцам остаются в CS-Cart. В CRM попадают заказы, клиенты и статусы для управления продажами.
Как убедиться, что интеграция работает?
Проведите сквозной тест: оформите заказ на сайте, найдите его в CRM, смените статус в CRM и проверьте, что он вернулся на витрину. Параллельно сверьте остатки.
Поможем с настройкой и поддержкой RetailCRM
Поможем с настройкой, доработкой и поддержкой RetailCRM.