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 по каждому заказу.

Что под капотом

• События вместо правок ядра — модуль подписывается на событие истории заказа (в 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-1.1.2.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.