NetHunt Sync — CRM для WooCommerce

NetHunt Sync для WooCommerce — плагин, который автоматически передаёт каждый новый заказ WooCommerce в NetHunt CRM. Сразу после оформления в папке NetHunt появляется запись с телефоном, email, суммой, списком товаров и ссылкой на заказ — менеджер работает с заявкой в CRM, а не переносит данные из админки магазина вручную.

Плагин полностью бесплатный, код открытый. Скачать можно с GitHub: github.com/catcodestudio/wp-nethunt-sync. Никаких лицензионных ключей, платных версий или ограничений по количеству заказов.

Что получает админ

Как это работает — шаг за шагом

1. Покупатель оформляет заказ — поддерживается и классический checkout, и Checkout Blocks.
2. Плагин собирает поля записи: имя, телефон (нормализуется до формата +380), email, сумму, товары, адрес и способ оплаты — и отправляет POST /api/v2/folders/{folderId}/records в NetHunt с заголовком Authorization: Bearer.
3. NetHunt возвращает ID записи — он сохраняется в мете заказа _cc_nethunt_record_id, поэтому дубли исключены.
4. Если NetHunt временно недоступен — WP-Cron повторяет отправку автоматически: 3 попытки с паузами 5 мин / 30 мин / 2 ч.
5. Менеджер видит результат в метабоксе заказа и в журнале синхронизации; оплаченные онлайн заказы получают чекбокс Paid и пометку «✅ Оплачено онлайн» в комментарии.

Сколько стоит

Бесплатно. Плагин распространяется под лицензией GPLv2, код открыт на GitHub. Все функции доступны сразу после установки — платной версии не существует.

Технические требования

• WordPress 6.2+ (протестировано до 7.0)
• WooCommerce 6.0 или новее
• PHP 7.4+
• API-токен NetHunt — создаётся в кабинете: Settings → API & MCP → Create token

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

• Публичное REST API v2 NetHunt с Bearer-токеном; кнопка «Проверить соединение» делает GET /folders и сразу показывает, валиден ли токен.
• Автопровижн папки: если папка не указана, плагин создаёт «WooCommerce Orders (домен)» со всеми полями одним действием. Если указать свою папку — добавит только недостающие поля (Phone, Email, Total, Products, Payment method и т.д.), имеющиеся не трогает.
• Защита от двойной отправки на уровне БД: чекаут, смена статуса и колбэк оплаты могут прилететь на один заказ одновременно — лок берёт ровно один запрос, остальные отсеиваются, поэтому второй записи в CRM не будет.
• Поле «Order ID» в папке: если ответа от NetHunt не было (таймаут), плагин перед повторной попыткой ищет запись по этому полю и подхватывает имеющуюся вместо того, чтобы создать вторую. Папкам, созданным в 0.1.0, поле добавляется автоматически.
• Чистое удаление: вместе с плагином исчезают таблица журнала и настройки; ID записей на заказах остаются намеренно — именно они не дают при переустановке залить старые заказы в CRM повторно.
• Шифрование API-токена в БД — libsodium с HMAC-фолбеком; токен не лежит в открытом виде.
• HPOS-совместимость (custom order tables) — работа с заказами только через WC_Order CRUD.
• Точки расширения для разработчиков: фильтр cc_nethunt_order_payload (изменить данные перед отправкой) и хук cc_nethunt_order_sent (реакция на успешную синхронизацию).

Как установить

1. Загрузите catcode-order-sync-with-nethunt-for-woocommerce-0.2.0.zip через Плагины → Добавить новый → Загрузить плагин.
2. Активируйте плагин в меню «Плагины».
3. Откройте WooCommerce → NetHunt Sync и вставьте API-токен из кабинета NetHunt (Settings → API & MCP → Create token).
4. Сохраните настройки — плагин сам создаст папку «WooCommerce Orders» с полями или подключит указанную вами.
5. Нажмите «Проверить соединение» — должно появиться подтверждение.
6. Сделайте тестовый заказ и проверьте, что запись появилась в NetHunt.

История версий

0.2.0 — август 2026

Кнопка «Отправить повторно» наконец работает: метабокс рисовал собственную форму внутри формы заказа, и браузер её выбрасывал. Защита от двойной отправки переехала с транзиента на лок в базе — параллельные запросы больше не создают две записи. Добавлено поле «Order ID» в папке и поиск по нему после таймаута, чтобы попытка без ответа не превратилась во вторую запись. Удаление плагина теперь убирает таблицу журнала. Стили админки — через wp_add_inline_style, интерфейс переведён на английский с украинским переводом в /languages. Плагин переименован в «CatCode Order Sync with NetHunt for WooCommerce» (настройки, мета и таблица не изменились — мигрировать ничего не надо).

0.1.0 — июль 2026

Первый публичный релиз: отправка заказов в папку NetHunt через REST API v2, автопровижн папки с полями, повторные попытки через WP-Cron, метабокс в заказе, журнал синхронизации, проверка соединения, шифрование токена.