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.

The plugin is completely free, and the code is open. Download it from GitHub: github.com/catcodestudio/wp-nethunt-sync. No licence keys, paid versions or limits on the number of orders.

What the admin gets

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: 3 attempts with 5 min / 30 min / 2 h delays.
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.

Technical requirements

• WordPress 6.2+ (tested up to 7.0)
• WooCommerce 6.0 or newer
• PHP 7.4+
• NetHunt API token — created in the account: Settings → API & MCP → Create token

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.

Version history

0.2.0 — August 2026

The “Resend” button finally works: the metabox was drawing its own form nested inside the order form, and the browser was discarding it. Protection against double-sending moved from a transient to a database lock — parallel requests no longer create two records. Added an “Order ID” field in the folder and a search by it after a timeout, so an unanswered attempt doesn’t turn into a second record. Deleting the plugin now also removes the log table. Admin styles are enqueued via wp_add_inline_style, the interface has moved to English with a Ukrainian translation in /languages. The plugin was renamed to “CatCode Order Sync with NetHunt for WooCommerce” (settings, meta and the table are unchanged — nothing needs migrating).

0.1.0 — July 2026

First public release: sends orders to a NetHunt folder via REST API v2, auto-provisioned folder with fields, retries via WP-Cron, order metabox, sync log, connection test, token encryption.