KeepinCRM Sync — CRM для OpenCart 2.3, 3.x и 4.x

KeepinCRM Sync для OpenCart — модуль, который передаёт заказы магазина на OpenCart 2.3, 3.x или 4.x в KeepinCRM в виде сделок. При оформлении заказа (или при переходе в выбранный статус) в CRM автоматически появляется сделка с клиентом, товарами с ценой и валютой и комментарием покупателя. Менеджер обрабатывает заявку в KeepinCRM, пока заказ ещё «горячий», без копирования данных из админки OpenCart.

Модуль полностью бесплатный, код открытый. Скачать с GitHub: github.com/catcodestudio/opencart-keepincrm-sync — без лицензионных ключей и ограничений.

Как это работает — шаг за шагом

1. Клиент оформляет заказ в магазине OpenCart.
2. Модуль ловит событие добавления истории заказа и срабатывает при оформлении или при переходе в выбранный статус.
3. Формируется сделка: клиент-лид (ФИО, email, телефон в формате +380), товары строками сделки с ценой и валютой, комментарий — и отправляется в KeepinCRM (POST /agreements на api.keepincrm.com/v1, заголовок X-Auth-Token).
4. ID сделки фиксируется в журнале синхронизации. Запись на заказ уникальна, поэтому повторные события не порождают дубли — одна сделка на один заказ, гарантированно.
5. Если KeepinCRM недоступен — заказ остаётся в очереди, и почасовой cron OpenCart повторяет отправку (по умолчанию до 5 попыток).
6. Админ видит результат в журнале: статус, ID сделки, количество попыток, последнюю ошибку и полное тело запроса/ответа.

Что под капотом

• Событийная архитектура OC4 — модуль регистрирует event на добавление истории заказа и работает без OCMOD-патчей системных файлов или темы.
• Идемпотентность на уровне БД: таблица журнала cc_keepincrm_sync с уникальным ключом по order_id — дубли сделок исключены физически.
• Retry-очередь через штатный cron OpenCart: задача cc_keepincrm_retry выполняется ежечасно и добирает неудачные отправки до исчерпания лимита попыток.
• API-токен шифруется перед сохранением в БД, в открытом виде в базе не хранится.
• Полный лог обмена: журнал хранит тело запроса и ответа CRM по каждому заказу — диагностика проблем без угадываний.

Как установить

1. В админке OpenCart откройте Расширения → Инсталлятор и загрузите cc_keepincrm.ocmod.zip.
2. В Расширения → Расширения → Модули найдите KeepinCRM Sync и нажмите «Установить» — создадутся таблица журнала, событие и cron-задача.
3. Откройте настройки модуля и вставьте API-токен из кабинета KeepinCRM (Настройки → Профиль компании → вкладка API).
4. Нажмите кнопку проверки соединения — убедитесь, что CRM отвечает.
5. При желании заполните маршрутизацию (воронка, этап, источник, ответственный), выберите момент отправки и сохраните.

Отдельно для OpenCart 3.x. Загрузите cc_keepincrm-oc3.ocmod.zip через Расширения → Инсталлятор и обновите модификации. Планировщика задач в OpenCart 3 нет, поэтому повторные попытки ставятся в crontab хостинга — адрес показан в настройках модуля; там же задайте cron-токен, иначе адрес открыт кому угодно:

curl -s "https://ВАШ-МАГАЗИН/index.php?route=extension/module/cc_keepincrm/cronRetry&token=ТОКЕН"

Отдельно для OpenCart 2.3. Штатный Инсталлятор 2.3 копирует файлы только по FTP: если FTP в магазине не настроен, распакуйте cc_keepincrm-oc2.ocmod.zip и залейте содержимое папки upload/ в корень магазина, после чего установите модуль в Расширения → Модули. Планировщика в 2.3 нет вообще, поэтому повторные попытки ставятся в системный crontab вручную — адрес показан на вкладке «Cron» в настройках модуля; задайте там же cron-токен, иначе адрес открыт кому угодно:

curl -s "https://ВАШ-МАГАЗИН/index.php?route=extension/module/cc_keepincrm_cron/retry&token=ТОКЕН"