NetHunt Sync — CRM для WooCommerce

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

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

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 мин.
5. Менеджер видит результат в метабоксе заказа и в журнале синхронизации; оплаченные онлайн заказы получают чекбокс Paid и пометку «✅ Оплачено онлайн» в комментарии.

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

• Публичное 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.