SalesDrive Sync — CRM for WooCommerce

SalesDrive Sync for WooCommerce is a plugin that automatically sends every WooCommerce order to SalesDrive CRM. As soon as the customer completes checkout, a lead appears in SalesDrive with the buyer, items, shipping and comment — the manager works in the CRM instead of copying data from the site admin by hand. Both the classic checkout and the new Checkout Blocks are supported.

The plugin is completely free. Download: catcode-order-sync-with-salesdrive-for-woocommerce-0.2.0.zip. GPLv2 licence — no keys, no trial periods, no limits on the number of orders.

How it works, step by step

1. The customer places an order in the shop — via the classic checkout or Checkout Blocks.
2. The plugin builds the payload: the buyer (phone normalised to +380 format), items with SKU, price and quantity, shipping, comment. For orders paid online, an optional “Paid online” note is added to the comment.
3. The data flies to SalesDrive via the leads handler — POST /handler/ with an X-Api-Key header.
4. SalesDrive returns a lead number — it is stored in the order meta (_cc_salesdrive_order_id). Together with a database-level lock, this guarantees: one order — one lead.
5. If the CRM is temporarily unavailable — the plugin retries the send itself: 3 attempts with 5 min / 30 min / 2 h delays via WP-Cron.
6. The manager sees the result in the order metabox and in the “Log” tab on the settings page.

How much it costs

Free. The plugin is distributed under the GPLv2 licence — download it and use it without activations, subscriptions or limits.

Under the hood

• API key encrypted in the database — libsodium with an HMAC fallback for hosts without the sodium extension. The key is never stored in plain text.
• Database-level lock against duplication: checkout, a status change and a payment callback may arrive at once — exactly one request goes through, and the order is re-read past the HPOS cache before the final check.
• Check by externalId after a timeout: SalesDrive’s leads handler does NOT deduplicate (two POSTs with the same externalId create two leads), so before retrying, the plugin asks the CRM via GET /api/order/list/ whether the lead already exists and adopts its ID. If the key lacks read permission — the order is flagged in the metabox so the manager can check the CRM manually.
• HPOS compatibility — all order handling goes only through WC_Order CRUD, with no direct queries against posts.
• Phone normalisation to E.164 (+380…) before sending to the CRM.
• Currency: the leads handler has no currency field, so for non-hryvnia orders the currency code is appended to the lead’s comment.
• Extension points for developers: the cc_salesdrive_order_payload filter (change the lead body) and the cc_salesdrive_order_sent hook (react to a successful send).

How to install

1. Download catcode-order-sync-with-salesdrive-for-woocommerce-0.2.0.zip and install via Plugins → Add New → Upload Plugin.
2. Activate it in the “Plugins” menu.
3. Open WooCommerce → SalesDrive Sync, enter the account domain and the API key.
4. Click “Test connection” — make sure the CRM responds.
5. Choose when to send orders (right after checkout or on moving to the chosen statuses), save the settings.