Установка

Установите модуль через «Администрирование» → «Модули» → «Управление модулями». Найдите «MS: Расширенная интеграция с retailCRM» и нажмите «Установить». После установки модуль появится в списке синхронизаций.

Где находятся настройки

Все настройки модуля расположены в разделе «Администрирование» → «Синхронизация данных» → «MS: Расширенная интеграция с retailCRM». Интерфейс организован в виде вкладок: Общие, Заказы, Склады, Импорт статусов, Экспорт статусов, Способы оплаты, Способы доставки, Поля пользователей, Обратный звонок и покупка в один клик, Cron.

Настройка — вкладка «Общие»

Ссылка на retailCRM — укажите полный URL вашей учётной записи RetailCRM (например, https://ваш-магазин.retailcrm.ru/). Ссылку можно скопировать из адресной строки браузера при входе в RetailCRM.

API ключ — получите ключ в RetailCRM: «Настройки» → «Интеграции» → «API-ключи» → «Добавить ключ». Создайте ключ с правами на чтение и запись. Скопируйте ключ и вставьте в поле.

Включить обмен — отметьте галочку для активации синхронизации. Без этой галочки обмен не выполняется.

Выгружать external_id товара — при необходимости выгрузки внешнего идентификатора товара в RetailCRM.

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

Сайт по умолчанию и Склад по умолчанию — выбираются из списка, загружаемого из RetailCRM после указания URL и API-ключа. Эти значения используются при создании заказов и товаров.

Настройка — вкладка «Заказы»

Экспорт заказов из CS-Cart в RetailCRM — режим: отключено, только создание, только обновление, полный обмен. При включении задайте режим выгрузки: все заказы, только за сегодня, начиная с даты, за последние N дней.

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

В подразделе «Общие настройки заказов» настройте: тип заказа, способ оформления, поле для URL заказа, добавление в комментарий (купон, адрес доставки, способ доставки), импорт примечаний и деталей, экспорт изменений.

Незавершённые покупки — включите для выгрузки корзин в RetailCRM. Укажите способ оформления и статус для таких заказов, а также — добавлять ли товары корзины в комментарий.

В разделах «Физ. лицо» и «Юр. лицо» сопоставьте поля RetailCRM с полями профиля CS-Cart (ФИО, телефон, email, адрес и т.д.). В «Пользовательские поля» сопоставьте дополнительные поля заказа.

Настройка — вкладки сопоставления

Склады — сопоставьте склады/ПВЗ CS-Cart с магазинами/складами RetailCRM.

Импорт статусов и Экспорт статусов — сопоставьте статусы заказов CS-Cart со статусами RetailCRM. Без сопоставления заказы могут не синхронизироваться корректно.

Способы оплаты и Способы доставки — сопоставьте методы оплаты и доставки между системами.

Поля пользователей — сопоставьте дополнительные поля профиля пользователя с полями RetailCRM.

Настройка — Обратный звонок и покупка в один клик

Требуется модуль «Обратный звонок». Включите интеграцию, выберите действие при обратном звонке (не создавать заказ, создавать заказ, создавать заказ с товарами). Настройте сопоставление полей и при необходимости — добавление товаров в комментарий при покупке в один клик.

Настройка — вкладка «Cron»

Пароль для cron — задайте секретный ключ (по умолчанию ms_retailcrm). Он используется для авторизации cron-запросов.

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

Работа с модулем

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

На странице редактирования заказа в админке CS-Cart отображается ID заказа в RetailCRM (если заказ был выгружен). Доступны кнопки для экспорта данных товара в RetailCRM и импорта из RetailCRM на сайт.

Проверка работы

1. Создайте тестовый заказ на сайте — он должен появиться в RetailCRM в разделе «Заказы».

2. Создайте заказ в RetailCRM — при включённом импорте он должен появиться в CS-Cart.

3. Проверьте логи: в настройках синхронизации отображается информация о последней выгрузке (количество обновлённых и пропущенных записей). При ошибках проверьте URL, API-ключ и сопоставление статусов, способов оплаты и доставки.

Типичные проблемы

Заказы не выгружаются — проверьте, что «Включить обмен» отмечено, экспорт заказов не отключён, статусы и способы оплаты/доставки сопоставлены.

Ошибка API — убедитесь, что URL указан без лишних символов, API-ключ действителен и имеет нужные права.

Дублирование клиентов — модуль ищет клиентов по email и телефону; при расхождении данных могут создаваться дубликаты. Проверьте сопоставление полей.