NetHunt Sync — CRM for WooCommerce

NetHunt Sync for WooCommerce is a plugin that automatically sends every new WooCommerce order to NetHunt CRM. Right after checkout, a record appears in the NetHunt folder with the phone number, email, total, item list and a link to the order — the manager works with the request in the CRM instead of copying data from the shop admin by hand.

How it works, step by step

1. The customer places an order — both the classic checkout and Checkout Blocks are supported.
2. The plugin builds the record fields: name, phone (normalised to +380 format), email, total, items, address and payment method — and sends a POST /api/v2/folders/{folderId}/records to NetHunt with an Authorization: Bearer header.
3. NetHunt returns a record ID — it is stored in the order meta as _cc_nethunt_record_id, so duplicates are ruled out.
4. If NetHunt is temporarily unavailable — WP-Cron retries the send automatically: up to 3 attempts — a retry after 5 min, then after 30 min.
5. The manager sees the result in the order metabox and the sync log; orders paid online get a Paid checkbox and a “✅ Paid online” note in the comment.

How much it costs

Free. The plugin is distributed under a GPLv2 licence, with open code on GitHub. All features are available right after installation — there is no paid version.

Under the hood

• NetHunt’s public REST API v2 with a Bearer token; the “Test connection” button does a GET /folders and instantly shows whether the token is valid.
• Auto-provisioned folder: if no folder is set, the plugin creates “WooCommerce Orders (domain)” with all the fields in one action. If you point it to your own folder — it only adds the missing fields (Phone, Email, Total, Products, Payment method, etc.) without touching existing ones.
• Protection against double-sending at the database level: checkout, a status change and a payment callback can hit the same order at once — a lock takes exactly one request, the rest are dropped, so no second record appears in the CRM.
• The “Order ID” field in the folder: if no response came back from NetHunt (timeout), the plugin searches for a record by this field before retrying and adopts an existing one instead of creating a second. The field is added automatically to folders created in 0.1.0.
• Clean removal: the log table and settings disappear along with the plugin; record IDs on orders are deliberately kept — they’re exactly what stops old orders being pushed into the CRM again on reinstall.
• API token encrypted in the database — libsodium with an HMAC fallback; the token is never stored in plain text.
• HPOS compatibility (custom order tables) — orders are handled only through WC_Order CRUD.
• Extension points for developers: the cc_nethunt_order_payload filter (change the data before sending) and the cc_nethunt_order_sent hook (react to a successful sync).

How to install

1. Upload catcode-order-sync-with-nethunt-for-woocommerce-0.2.0.zip via Plugins → Add New → Upload Plugin.
2. Activate the plugin in the “Plugins” menu.
3. Open WooCommerce → NetHunt Sync and paste the API token from your NetHunt account (Settings → API & MCP → Create token).
4. Save the settings — the plugin creates the “WooCommerce Orders” folder with fields itself, or connects the one you specified.
5. Click “Test connection” — a confirmation should appear.
6. Place a test order and check that a record appeared in NetHunt.