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

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

Модуль повністю безкоштовний, код відкритий. Репозиторій на GitHub: github.com/catcodestudio/opencart-nethunt-sync. Без ключів активації, платних тарифів і лімітів на кількість замовлень.

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

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

1. Покупець оформлює замовлення у магазині — модуль ловить подію додавання історії замовлення, нічого в checkout не змінюючи.
2. Дані летять у NetHunt через REST API v2 із Bearer-токеном: клієнт, контакти, сума, товари у зручному форматі.
3. NetHunt повертає ID запису — він фіксується у журналі синхронізації з UNIQUE-обмеженням по замовленню, тому один ордер ніколи не створить два записи.
4. Невдалі відправки не губляться: cron-черга повторює їх автоматично, до 5 спроб на замовлення.
5. Адмін контролює процес у журналі: статус, запит і відповідь API по кожному замовленню.

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

Безкоштовно. Модуль із відкритим кодом — завантажуйте з GitHub і користуйтеся без обмежень. Платної версії немає, всі можливості доступні одразу.

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

• OpenCart 4.0.2 – 4.1.x
• API-токен NetHunt — безкоштовно у кабінеті: Settings → API & MCP → Create token

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

• Події OpenCart 4 замість OCMOD — модуль підписується на подію історії замовлення, файли ядра і теми не модифікуються.
• Автопровіжн папки: при збереженні налаштувань модуль створює в NetHunt папку «OpenCart Orders» з усіма потрібними полями. Якщо вказати власну папку — додасть лише відсутні поля (Phone, Email, Total, Products тощо).
• Ідемпотентність через журнал синхронізації — UNIQUE-запис по замовленню гарантує відсутність дублів навіть при повторних спрацюваннях події.
• Cron-черга повторів — до 5 спроб для замовлень, які не вдалося відправити з першого разу.
• API-токен зашифрований у БД (libsodium з HMAC-фолбеком) — у відкритому вигляді не зберігається.

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

1. Завантажте cc_nethunt.ocmod.zip через Розширення → Інсталятор у вашій адмінці OpenCart.
2. У списку Розширення → Модулі знайдіть NetHunt Sync і натисніть «Встановити», потім відкрийте налаштування.
3. Вставте API-токен з кабінету NetHunt (Settings → API & MCP → Create token).
4. Оберіть тригер відправки — при створенні замовлення або при переході в конкретний статус.
5. Збережіть налаштування — модуль сам створить папку «OpenCart Orders» з полями (або підключить вказану) — і натисніть «Перевірити з’єднання».
6. Оформіть тестове замовлення та перевірте запис у NetHunt і рядок у журналі.

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

1.0.0 — липень 2026

Перший публічний реліз: відправка замовлень OpenCart 4.x у NetHunt (REST API v2, Bearer-токен) при створенні або зміні статусу, автопровіжн папки «OpenCart Orders» з полями, ідемпотентний журнал синхронізації, cron-черга повторів, шифрування токена, перевірка з’єднання.