Модуль обеспечивает полную двухстороннюю интеграцию 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 на сайт.
- Store Builder
- Store Builder Ultimate
- Владельцам
- English
- Русский
- 4.18.X
- 4.17.X
- 4.16.X
- 4.15.X
Установка
Установите модуль через «Администрирование» → «Модули» → «Управление модулями». Найдите «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 и телефону; при расхождении данных могут создаваться дубликаты. Проверьте сопоставление полей.
v2.2.0
19.02.2026
- [\*] Обновлен шаблон модуля
v2.1.0
28.01.2026
- [!] Исправлена критическая ошибка в файле модуля (код класса StaticFunctions заменился кодом контроллера)
- [!] Исправлена ошибка вызванная отсутсвием функции модуля store_locations
v2.0.0
24.11.2025
- [\*] Полная переработка модуля
- [!] Исправлена ошибка при попытке перехода в настройки синхронизации
- [!] Исправлена ошибка при получении retailcrm_id заказа из бд
- [!] Исправлена ошибка если скидка превышала итоговую стоимость и переставляла неправильно цены
- [\*] Исправлен поиск пользователя по номеру телефона для обратного звонка
- [\*] Исправлена поиск и передача отчества клиента в заказе
- [+] Добавлена возможность экспорта и импорта пользователей в RetailCrm
- [\*] Исправлена передача складов/ПВЗ в заказе
- [+] Добавлены настройки импорта заказов и cron для импорта заказов
- [+] Добавлены настройки экспорта заказов и cron для экспорта заказов
- [+] Добавлено отображение id заказа в RetailCrm на странице редактирования заказа, так же добавлены кнопки для экспорта данных товара в RetailCrm и импорта из него на сайт
v1.14.2
11.01.2024
- [\*] Доработана передача utm меток при создании заказа
- [!] Исправлена ошибка, возникающая после установке модуля (не найден класс модуля)
v1.14.1
25.12.2023
- [\*] Изменена ссылка для cron
- [!] Исправлена ошибка при генерации файла прайс-листа ЯндексМаркета (осуществлялся поиск external_id в таблице products)
- [+] Добавлена возможность передачи utm меток в заказе по настройке в модуле
v1.14.0
30.10.2023
- [+] Добавлена передача стоимости доставки, из модуля «Исключить стоимость доставки из заказа.»
v1.13.2
23.09.2023
- [+] Добавлена передача ИНН клиента в заказе
v1.13.1
18.09.2023
- [\*] MEASoft: передача стоимость доставки в комментарий заказа, распространяется только для 5post
v1.13.0
11.09.2023
- [+] MEASoft: передача стоимость доставки в комментарий заказа
v1.12.0
04.09.2023
- [+] Поддержка служб доставки от MEASoft, передача адреса и плательщика
- [+] MEASoft: Плательщика можно выбрать в настройке модуля во вкладке Заказы
- [\*] Изменены короткие теги <? на обычные <?php
v1.11.16
05.06.2023
- [\*] Улучшена проверка клиентов на стороне retailcrm для предотвращения дублирования (добавлен поиск клиентов email и по ИНН), приведение к одинаковому виду названия компаний при сравнении
v1.11.15
12.05.2023
- [\*] Улучшена проверка клиентов на стороне retailcrm для предотвращения дублирования
- [\*] Изменена структура файлов
- [+] Добавлен выбор сайтов для клиентов в настройках модуля, по которому будут запрашиваться клиенты из retailcrm
v1.11.14
26.12.2022
- [+] Стандартизация модуля
v1.11.13
06.12.2022
- [!] Исправлена проблема с дублированием пользователей
- [\*] При выключенной настройке импортировать новые заказы, новые клиенты тоже не создаются
- [\*] Импорт происходит только во включенные витрины
v1.10.13
18.11.2022
- [!] Исправлена проблема с дублированием способа оплаты
- [\*] Добавление доставки в комментарий перенесено в другой хук
v1.9.13
17.11.2022
- [+] Добавлена возможность выгрузки способа доставки в комментарий
v1.8.13
17.10.2022
- [\*] Изменены языковые переменные
v1.8.12
04.10.2022
- [+] Стандартизация модуля
v1.8.11
20.07.2022
- [+] Добавлена настройка — Выгружать external_id товара
v1.8.10
29.04.2022
- [!] Исправлен баг при совпадении внешнего кода клиента
v1.8.9
21.04.2022
- [\*] Отключена отправка Email при импорте нового клиента в cs-cart
v1.8.8
20.04.2022
- [+] Добавлено сопоставление Доставок / ПВЗ (CS-Cart) с Магазинами / Складами (RetailCRM)
v1.7.8
08.04.2022
- [!] Исправлено дублирование заказа при покупке в один клик
v1.7.7
31.03.2022
- [+] Добавлена передача ФИО при создании клиента как физ. лица
v1.7.6
25.03.2022
- [+] Добавлено удаление ИНН из заказа при наличии в нём ошибки
- [+] Добавлен адрес ПВЗ в заказ
- [\*] Изменено опредедение типа заказа по полю идентификации
v1.6.6
24.03.2022
- [+] Добавлено создание двух типов клиентов — юр.лицо и физ.лицо
- [+] Добавлена привязка заказа к клиенту
- [!] Исправлена ошибка при обращении к методам корпоративных клиентов
v1.5.6
- [+] Добавлено сопостовление полей «ИНН» и «Имя компании» из модуля ms_invoicing
- [+] Добавлено изменение типа заказа на «Юр. лицо» при заполненном ИНН
- [+] Добавлена валидация email
- [!] Исправлена ошибка «Не верный тип контрагента»
v1.4.6
- [\*] Обновлена иконка MakeShop.pro
v1.4.5
- [+] Синхронизация объединения клиентов
- [+] Настройка символьного обозначения заказов в 1 клик
- [!] Фикс настроек в мультивендоре
- [!] Фикс клиентов «Без ФИО»
v1.4.4
- [\*] Заменены языковые переменные
v1.4.3
- [+] Добавлена возможность экспорта купона на скидку
- [!] Исправлена ошибка взаимодействия с модулем «Обратный звонок»
- [!] Исправлен языковой файл (en)
v1.4.2
- [\*] Исправлен баг в шаблонах настроек мультивендора
v1.4.1
- [+] Удаление товаров из корзины со статусом отмены
- [+] Добавлена функция логирования
v1.4.0
- [+] Поддрежка мультивитрин
v1.3.3
- [+] Выгрузка незавершенных покупок незарегистрированных пользователей с контактными данными
v1.3.2
- [+] Возможность отключения витрин
v1.3.1
- [+] Точка старта выгрузки незавершенных покупок
- [\*] Исправлены ошибки
v1.3.0
- [+] Экспорт незавершенных покупок + настройки
- [+] Подсчет веса
- [+] Учет сумм подарочных сертификатов и купонов на скидку
- [!] Исправлены подсчет и синхронизация скидок
- [\*] MsRetailcrm_orders => MsRetailcrm_objects (синхронизации других сущностей)
- [+] Возможность отключения импорта новых заказов из retailCRM
- [+] Выполнение действий при обновлении модуля в режиме разработчика
v1.2.0
- [\*] Добавлены настройки обратного звонка и покупки в один клик
- [\*] Добавлена возможность добавлять в комментарий клиента адрес доставки, отделения СДЭК
- [\*] Добавлена возможность добавлять товары в корзине в комментарий клиента при покупке в один клиик
- [\*] Добавлена возможность стирать поле email по указанным доменам
- [\*] Добавлена возможность указывать URL заказа из админки
- [\*] Добавлена возможность записывать ФИО в поле «имя»
- [\*] Добавлена опция отключения модуля (для отображения настроек в отключенном режиме)
- [!] Исправлена ошибка с присвоением retailCRM ID клиента
v1.1.1
- [\*] Запуск firstUpdateSince после включения отключенного модуля
- [!] Исправлена ошибка при создании заказа в один клик
v1.1.0
- [+] Структура прайс-листа по документации retailCRM
- [+] Опция «прайс-лист для retailCRM» в редактировании прайс-листа
- [+] Опции включения/отключения импорта/экспорта
- [\*] Доработан расчет скидок
- [!] Перед postInstall() и firstUpdateSince() проверка на активность модуля
- [!] Мелкие исправления
v1.0.0
- [+] Первый выпуск
Здесь можно поделиться своим мнением и оценить нашу работу.
Ваши отзывы помогают нам стать лучше и предлагать вам еще более качественный сервис.