OpenCart — популярная опенсорс-CMS для интернет-магазина, а RetailCRM забирает обработку заказов и аналитику. Связка ставится официальным модулем для OpenCart, который выгружает каталог в ICML и синхронизирует заказы со статусами.
Как работает связка
OpenCart даёт полный доступ к файлам и БД, поэтому интеграция ставится модулем на сам движок и работает через REST API RetailCRM. Фоновые задачи (выгрузка каталога, догон заказов) выполняет cron.
- Каталог выгружается из OpenCart в RetailCRM файлом ICML.
- Заказы и клиенты передаются в CRM при оформлении.
- Статусы, оплаты, доставки синхронизируются в обе стороны.
Установка модуля
Модуль устанавливается через штатный Installer (Расширения → Установка расширений), затем активируется в списке модулей и настраивается.
- Загрузите архив модуля через установщик, при необходимости обновите модификаторы (ocmod).
- Создайте в RetailCRM ключ доступа к API с нужными правами.
- В настройках модуля укажите
API URLи ключ, сохраните и проверьте связь. - Настройте cron на скрипт обмена модуля для регулярной синхронизации.
Выгрузка каталога ICML
Модуль формирует ICML-фид из товаров OpenCart и публикует его по ссылке, которую вы указываете в RetailCRM. В фид входят категории, товары, опции/варианты, цены и остатки.
| OpenCart | RetailCRM (ICML) |
|---|---|
| Товар | Товар / торговое предложение |
| Опции товара | Торговые предложения |
| Категория | Категория каталога |
| Модель / Артикул | Артикул предложения |
Как и на других платформах, критично уникальные артикулы: по ним RetailCRM связывает позиции заказа с каталогом.
Синхронизация заказов и клиентов
Заказ из OpenCart передаётся в RetailCRM: создаётся заказ, карточка клиента, срабатывают триггеры и распределение. Обратно на сайт возвращаются изменения статуса, состава и сумм.
- Способы оплаты и доставки OpenCart сопоставляются со справочниками RetailCRM.
- Клиенты дедуплицируются по телефону и email.
- История заказов может быть выгружена пакетно при первом запуске обмена.
После настройки менеджеры работают в CRM, а админка OpenCart остаётся для контента и настроек витрины.
Обратите внимание на кодировку и телефоны: OpenCart-магазины нередко хранят номера в разном формате, а RetailCRM дедуплицирует по нормализованному телефону. Если на витрине нет маски ввода, в CRM легко получить два «разных» контакта у одного покупателя. Также при большом каталоге держите генерацию ICML на отдельном cron-интервале, отличном от обмена заказами, чтобы тяжёлая выгрузка не тормозила передачу свежих заказов.
Соответствие статусов
Статусы заказов OpenCart сопоставляются со статусами RetailCRM. Маппинг задаёт, как переходы в CRM отражаются в магазине и наоборот.
| Статус OpenCart | Статус RetailCRM |
|---|---|
| Ожидание | Новый |
| В обработке | Комплектование |
| Отправлено | Передан в доставку |
| Выполнен | Выполнен |
| Отменён / Возврат | Отменён |
Тестирование и типовые сбои
Прогоните полный цикл: тестовый заказ в OpenCart → появление в RetailCRM → смена статуса в CRM → отражение в магазине.
- Каталог пуст — не работает cron или недоступна/незаписываема ссылка на ICML.
- Заказ без товаров — расхождение артикулов между каталогом и позициями.
- Статус не возвращается — пропуск в маппинге или кастомный статус.
- Ошибки после обновления OpenCart — устаревшие модификаторы ocmod, требуется обновить/переустановить.
Итог
Интеграция OpenCart с RetailCRM собирается из модуля на движок, корректного ICML с уникальными артикулами, настроенного cron и продуманного маппинга статусов. Отдельно стоит следить за совместимостью модуля с версией OpenCart и модификаторами при обновлениях. В результате витрина остаётся на OpenCart, а обработка заказов уходит в CRM.
Мы подключаем OpenCart к RetailCRM и настраиваем весь обмен под ключ — от модуля и каталога до cron и тестового цикла заказов. Если нужно выстроить процессы продаж вокруг CRM, а не просто связать системы, поможем собрать это в единое целое.
Частые вопросы
Как ставится интеграция для OpenCart?
Официальным модулем через штатный установщик расширений: загружаете архив, активируете модуль и вводите API URL и ключ RetailCRM.
В каком формате выгружается каталог?
В ICML — XML-фид с категориями, товарами, опциями, ценами и остатками, который модуль публикует по ссылке для RetailCRM.
Нужен ли cron?
Да, для регулярной выгрузки ICML и догона заказов настраивается cron на скрипт обмена модуля.
Что с совместимостью версий?
Модуль привязан к версии движка и модификаторам. Перед установкой уточните совместимость с вашей веткой OpenCart (2.x/3.x/4.x).
Как связываются позиции заказа с каталогом?
По артикулам. Уникальные и заполненные артикулы обязательны, иначе заказ придёт с неопознанными позициями.
Обмен заказами двусторонний?
Да. Заказы уходят в CRM, а изменения статусов, состава и сумм возвращаются в OpenCart согласно маппингу.
Почему после обновления OpenCart интеграция ломается?
Обычно из-за устаревших модификаторов ocmod/vQmod. Их нужно обновить или переустановить модуль под новую версию движка.
Поможем с настройкой и поддержкой RetailCRM
Поможем с настройкой, доработкой и поддержкой RetailCRM.