OneBox Sync — order synchronisation for WooCommerce

OneBox Sync for WooCommerce is a plugin that, after every checkout, automatically creates a process order in OneBox OS with the customer, phone number, delivery address and list of items. The manager opens a ready-made request in the CRM instead of copying data from the WooCommerce order by hand — and no order gets lost between the site and OneBox.

How it works, step by step

1. The customer places an order — the plugin supports both the classic checkout and Checkout Blocks.
2. The plugin authenticates with OneBox: it obtains a token via POST /api/v2/token/get/ (the token is cached and refreshed automatically) and sends the order via POST /api/v2/order/set/ to your OneBox domain.
3. The customer and items are mapped to the CRM: clientname/clientemail/clientphone/clientaddress plus a products array linked to the OneBox catalogue — catalogue items are matched by SKU or created automatically. Delivery is a separate line, so the process total matches the order total.
4. OneBox returns a process ID — it is stored in the _cc_onebox_order_id meta; an externalid of wc-{id} is also sent, so duplicates are ruled out twice over.
5. If OneBox is unavailable — WP-Cron retries the send: up to 3 attempts — a retry after 5 min, then after 30 min. Orders paid online get a “✅ Paid online” note on the process (COD and offline methods are not marked).

How much it costs

Free. The plugin is distributed under GPLv2 with open source on GitHub — all features are available with no payment right after installation.

Under the hood

• Double deduplication: an externalid of wc-{id} gives an upsert on the OneBox side, and the process ID saved in the order meta blocks the plugin from creating it again.
• Database-level lock — if the checkout hook, a status change and a payment callback hit the same order at once, exactly one create request goes to OneBox (verified with 24 parallel requests against 3 orders).
• An unanswered attempt doesn’t duplicate the deal — if OneBox doesn’t respond (timeout), the order is flagged, and before retrying the plugin asks the CRM for the externalid (POST /order/get/) and picks up the process already created.
• API password encrypted in the database — libsodium with an HMAC fallback; the access token is cached and refreshed automatically.
• Phone normalisation to E.164 (+380…) — numbers arrive in the CRM in a single format.
• HPOS compatibility (custom order tables) — orders are handled exclusively through WC_Order CRUD.
• Extensibility: the cc_onebox_order_payload filter lets you change the data before sending, and the cc_onebox_order_sent hook lets you run your own code after a successful sync.

How to install

1. Install the “API v2” component in OneBox (1b.app → Apps → API services) and set a login and password for the employee in their card (Users and employees → Login, password, permissions).
2. Upload catcode-order-sync-with-onebox-for-woocommerce-0.2.0.zip via Plugins → Add New → Upload Plugin and activate it.
3. Open WooCommerce → OneBox Sync and enter your OneBox domain, API login and API password.
4. Click “Test connection” — the plugin will fetch a token and the list of business processes.
5. If needed, set the business process, stage and source ID (leave blank for the first business process automatically) and save.
6. Place a test order — a process order will appear in OneBox.