Установка

После скачивания модуля, его установка производится штатными средствами CS-Cart на странице Панель администратора → Модули → Управление модулями → Загрузить и установить модуль (+).

Для версии CS-Cart более 4.13.1 Панель администратора → Модули → Управление модулями → Кнопка Шестеренка → Ручная установка

Нажимаем Загрузить, в появившемся окне выбираем файл модуля, далее Загрузить и установить.

Настройка

Первоначальная настройка осуществляется на вкладке Общие настройки, где надо ввести URL учетной записи RetailCRM и API ключ.

По умолчанию, модуль находится в статусе Выключен, рекомендуется провести настройку перед тем, как включить его.

После подключения необходимо выбрать магазин и склады в RetailCRM и указать валюту магазина в RetailCRM

Дополнительная настройка

Описание настроек:

На вкладке Справочники необходимо взаимно сопоставить статусы заказов, способы доставки, способы оплаты между CS-Cart и RetailCRM. Так же здесь указывается зависимость статуса платежа в retailCRM от статуса заказа в CS-Cart.

На вкладке Поля пользователей сопоставляются поля профилей покупателей

На вкладке Заказы детально настраивается синхронизация: отключается импорт новых заказов из retailCRM, импорт/экспорт изменений заказа, экспорт обратных звонков, заказов в один клик и т.д.

Для импорта товаров из CS-Cart в RetailCRM необходимо создать YML-файл (например с помощью стандартного модуля Экспорт в Яндекс.Маркет). Для этого необходимо зайти в Администрирование →  Экспорт в Яндекс.Маркет → Прайс-лист.

Нажать кнопку Создать новый прайс-лист в виде плюса.

Настроить необходимые значения Ключ доступа, Имя прайс-листа, Название магазина и поставить галочку Прайс-лист для RetailCRM.

Ключ доступа находится в RetailCRM Настройки - Интеграция - Ключи доступа к API

После этого нажимаем Создать, появятся дополнительные настройки экспорта (можно оставить по умолчанию) и ссылки для формирования и скачивания файла, а также cron-команда для автоматического обновления файла.

А со стороны RetailCRM прописать на вкладке Настройки → Магазины → [Выбрать нужный магазин] → Каталог выбрать Загружать из ICML и в поле URL ICML-файла указать адрес сформированного YML-файла.

Важно: Для сквозной синхронизации МойСклад - RetailCRM - CS-Cart необходимо в yml-файл добавлять external_id для товара. Сделать это можно с помощью нашего модуля Применение фиксов.

Применяем 7 (Добавление в retailcrm xmlid изменения в gatherAdditional) и 8 (Добавление в retailcrm xmlid изменения в getRetailCrmOfferAttributes) фикс:

После этого для товаров нужно указать значение external_id:

После этого обязательно сгенерировать файл импорта заново и значение external_id появится там в поле  .....

Чтобы автоматически синхронизировать изменения заказов/статусов из RetailCRM в CS-Cart необходимо на сервере CS-Cart прописать cron-команду php /path/to/admin.php --dispatch=trigger.retailcrm_import.

После настройки синхронизации меняем статус модуля на Включен.

Важно: При включении/отключении и обновлении модуля обновляются точки старта для заказов и незавершенных покупок. Это сделано для тех случаев, если надолго отключили модуль, чтобы не выгружались старые заказы и не синхронизировались старые изменения из истории.