NetHunt Sync — CRM для OpenCart 2.3, 3.x і 4.x

NetHunt Sync для OpenCart — модуль, який передає замовлення OpenCart у NetHunt CRM без участі менеджера. Окремі збірки під OpenCart 2.3, 3.x і 4.x. Щойно покупець оформив замовлення (або замовлення перейшло в потрібний статус), у папці 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 спроб на замовлення — разом із тими, що зависли в процесі відправки. URL повторів можна закрити власним cron-токеном.
5. Адмін контролює процес у журналі: статус, запит і відповідь API по кожному замовленню.

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

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

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

• OpenCart 4.0.2 – 4.1.x — PHP 7.4 або новіший (збірка cc_nethunt.ocmod.zip)
• OpenCart 3.0.2 – 3.0.5 — PHP 7.0 або новіший (збірка cc_nethunt-oc3.ocmod.zip)
• OpenCart 2.3.0.0 – 2.3.0.2 — PHP 5.6 – 7.x (збірка cc_nethunt-oc2.ocmod.zip)
• API-токен NetHunt — безкоштовно у кабінеті: Settings → API & MCP → Create token

Функціонал у всіх трьох збірках однаковий. У 2.3-збірці суми додатково переводяться у валюту замовлення за його історичним курсом, а замість реєстру завдань використовується адреса вітрини для cron — у OpenCart 2.3 планувальника немає взагалі.

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

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

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

1. Завантажте збірку під вашу версію (cc_nethunt.ocmod.zip для 4.x, cc_nethunt-oc3.ocmod.zip для 3.x, cc_nethunt-oc2.ocmod.zip для 2.3) через Розширення → Інсталятор у вашій адмінці OpenCart.
2. Для OpenCart 2.3: штатний Інсталятор копіює файли тільки по FTP. Якщо FTP не налаштовано — розпакуйте архів і залийте вміст теки upload/ у корінь магазину.
3. У списку Розширення → Модулі знайдіть NetHunt Sync і натисніть «Встановити», потім відкрийте налаштування.
4. Вставте API-токен з кабінету NetHunt (Settings → API & MCP → Create token).
5. Оберіть тригер відправки — при створенні замовлення або при переході в конкретний статус.
6. Збережіть налаштування — модуль сам створить папку «OpenCart Orders» з полями (або підключить вказану) — і натисніть «Перевірити з’єднання».
7. Оформіть тестове замовлення та перевірте запис у NetHunt і рядок у журналі.
8. Для OpenCart 3.x і 2.3 додайте у crontab хостингу рядок повторних спроб (типово раз на 15 хвилин), задавши перед цим cron-токен у налаштуваннях:
   curl -s "https://SHOP/index.php?route=extension/module/cc_nethunt_cron/retry&token=ТОКЕН" (у 3.x роут — extension/module/cc_nethunt/cronRetry).

Пряме посилання на 2.3-збірку: cc_nethunt-oc2.ocmod.zip.

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

1.1.1 — серпень 2026

Суми запису й позицій надсилаються у валюті замовлення за його історичним курсом — раніше в NetHunt їхали числа базової валюти магазину поруч із кодом валюти замовлення (збірки 4.x і 3.x).

1.0.0 (OpenCart 2.3) — серпень 2026

Окрема збірка під OpenCart 2.3.0.0 – 2.3.0.2 і PHP 5.6 – 7.x: шаблони Bootstrap 3, події через addOrderHistory, cron як адреса вітрини з токеном, журнал синхронізації окремою сторінкою з пагінацією. Суми переводяться у валюту замовлення за його історичним курсом; заповнюється поле «Order status». Невдале підключення папки більше не скасовує збереження налаштувань.

1.1.0 — серпень 2026

Подія тепер реєструється у форматі OC4 із * перед методом (з крапкою вона не спрацьовувала). Сумісність з PHP 7.4. У чергу повторів потрапляють замовлення, що зависли в процесі відправки. Додано необовʼязковий cron-токен для публічного URL повторів. Журнал більше не потребує mbstring.

1.0.0 — липень 2026

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