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.