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=ТОКЕН"