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

KeepinCRM Sync для OpenCart 4 — модуль, який передає замовлення магазину на OpenCart 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 угоди, кількість спроб, останню помилку і повне тіло запиту/відповіді.

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

Безкоштовно, код відкритий. Репозиторій на GitHub: catcodestudio/opencart-keepincrm-sync — користуйтесь без активацій і підписок.

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

• OpenCart 4.0.2 – 4.1.x
• API-токен KeepinCRM — створюється в кабінеті: Налаштування → Профіль компанії → вкладка API → «Створити»
• Увімкнений cron OpenCart — для автоматичних повторів при збоях (основна відправка працює одразу за подією, без cron)

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

• Подієва архітектура 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. За бажанням заповніть маршрутизацію (воронка, етап, джерело, відповідальний), оберіть момент відправки і збережіть.

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

1.0.0 — липень 2026

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