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

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

Модуль полностью бесплатный. Скачать: cc_salesdrive.ocmod.zip для OpenCart 4.x или cc_salesdrive-oc3.ocmod.zip для OpenCart 3.0.2–3.0.5, либо cc_salesdrive-oc2.ocmod.zip для OpenCart 2.3.0.0–2.3.0.2 — без лицензионных ключей и ограничений по количеству заказов.

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

1. Покупатель оформляет заказ в вашем магазине OpenCart.
2. Срабатывает событие catalog/model/checkout/order*addHistory — модуль реагирует на оформление или на переход заказа в статус-триггер.
3. Формируется заявка: покупатель с телефоном в формате +380, товары с SKU, ценой и количеством, стоимость доставки, комментарий — и отправляется в SalesDrive через обработчик заявок (POST /handler/, заголовок X-Api-Key).
4. Номер заявки фиксируется в журнале синхронизации. Журнал имеет уникальную запись на заказ, поэтому повторное событие никогда не создаст дубль — завершённая запись просто пропускается.
5. Если SalesDrive недоступен — запись остаётся в очереди, и почасовой cron OpenCart повторяет отправку (по умолчанию до 5 попыток).
6. Результат видно в админке: журнал показывает статус, ID заявки, количество попыток и последнюю ошибку, если она была.

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

• Native-расширение для OpenCart 4.x — события (events) и отдельная таблица, без OCMOD-патчей чужих файлов. Событие регистрируется в формате OC4 с разделителем * перед методом — именно так ядро 4.x сопоставляет события моделей.
• Идемпотентность на уровне БД: таблица cc_salesdrive_sync с UNIQUE-ключом по order_id — физически невозможно создать две заявки из одного заказа.
• API-ключ шифруется перед сохранением в БД — в открытом виде в базе не лежит.
• Retry-очередь через штатный cron OpenCart: задача cc_salesdrive_retry выполняется ежечасно и добирает заказы со статусом ошибки, а также те, что зависли в процессе отправки дольше часа. URL повторов можно закрыть собственным cron-токеном.
• Журнал с excerpt-ами запроса и ответа — при разборе проблем видно, что именно модуль отправил и что ответила CRM.

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

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

OpenCart 2.3. Штатный Инсталлятор 2.3 копирует файлы только по FTP: если FTP в магазине не настроен, распакуйте cc_salesdrive-oc2.ocmod.zip и залейте содержимое папки upload/ в корень магазина, а дальше так же — Расширения → Модули → SalesDrive Sync → «Установить».

Повторы в OpenCart 2.3. В 2.3 планировщика нет вообще, поэтому очередь повторов запускает обычный адрес витрины — добавьте его в crontab хостинга (обычно раз в 15 минут) и закройте собственным cron-токеном из настроек модуля:

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