SalesDrive Sync — CRM для OpenCart 3.x & 4.x

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

Модуль повністю безкоштовний. Завантажити: cc_salesdrive.ocmod.zip — без ліцензійних ключів і обмежень за кількістю замовлень.

Що отримує адмін

Як це працює — крок за кроком

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 заявки, кількість спроб і останню помилку, якщо вона була.

Скільки коштує

Безкоштовно. Завантажуйте і користуйтесь — без активацій, підписок і прихованих платежів.

Технічні вимоги

• OpenCart 4.0.2 – 4.1.x
• Кабінет SalesDrive: домен виду yourshop.salesdrive.me та API-ключ бази заявок із правом «Заявки: додавання»
• Увімкнений cron OpenCart — для автоматичних повторних спроб при збоях (сама відправка працює і без нього)

Що під капотом

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

Як встановити

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

Історія версій

1.0.0 — липень 2026

Перший публічний реліз: відправка замовлень у SalesDrive при оформленні або за статусом-тригером, ідемпотентний журнал синхронізації (UNIQUE по order_id), retry-черга через погодинний cron, мапінг товарів/оплати/доставки, шифрування API-ключа, перевірка з’єднання, журнал із логом запитів і відповідей.