What moves between WooCommerce and Sage X3
WooCommerce runs the store inside your WordPress site; Sage X3 runs fulfilment, invoicing and the ledgers. The integration sends each web order to X3 and returns the stock and order details customers see, so the store and the ERP tell the same story.
WooCommerce
The WordPress store where orders start
- Orders
- Customers
- Products and variations
- Stock quantities
- Refunds
Sage X3
Where stock, pricing and finance are managed
- Sales orders
- Customers
- Products
- Stock by site
- Invoices and credit memos
WooCommerce to Sage X3 record mapping
A common first map. Discovery agrees the exact fields, sites and rules for your store and X3 folder.
| WooCommerce | Sage X3 | Direction |
|---|---|---|
| Order | Sales order | WooCommerce to Sage X3 |
| Customer | Customer | Both ways |
| Product or variation (SKU) | Product | Sage X3 to WooCommerce |
| Stock quantity | Stock at the chosen sites | Sage X3 to WooCommerce |
| Order status and tracking | Shipment details | Sage X3 to WooCommerce |
| Refund | Credit memo | WooCommerce to Sage X3 |
How the WooCommerce and Sage X3 sync works
Web orders into X3
WooCommerce can send a webhook when an order is created. Connect turns that order into an X3 sales order, with its lines, addresses and the sales site you've agreed, and can add the X3 order number to the WooCommerce order notes.
One stock figure from many X3 sites
Core WooCommerce keeps a single stock quantity on each product or variation, while Sage X3 counts stock per site. Discovery settles which X3 sites feed the store, and Connect writes the resulting figure to WooCommerce on your schedule.
Order status back to the customer
When X3 ships an order, Connect updates the WooCommerce order's status and tracking details so the customer's account shows where it is. Refunds made in the store can be sent to X3 for the matching credit memo.
See Clarity Connect move an order
Watch an online order travel into the ERP and its status come back in our Clarity Connect demo, or book a live walkthrough on your own systems.
WooCommerce's API and webhooks
WooCommerce's REST API (currently version 3, under wc/v3) is built into WordPress's own REST API and authenticates with a consumer key and secret over HTTPS. Its webhooks cover orders, products and customers, but WooCommerce switches a webhook off after five failed deliveries in a row, so we pair the webhook with a scheduled Connect task that pulls recent orders and picks up any it missed.
On the X3 side, the integration uses Sage's GraphQL API where Sage X3 Services is installed, or X3's published SOAP web services where it isn't.
How Clarity Connect runs it
Clarity Connect is Clarity's integration platform. It keeps WooCommerce and Sage X3 connected both ways and runs each flow as a task, in real time or on a schedule, with failed jobs retried rather than dropped. Clarity has built more than 3,000 integrations on it, including WooCommerce ones you can watch in our video playlist.
Discovery
A Clarity business analyst documents the data fields and workflows each system can share and which ones you need.
Tasks and mapping
Each flow becomes a Connect task, such as orders to the ERP or stock to the store, set to run in real time or on a schedule.
Testing
Orders and updates are run end to end, including the return trip of statuses back to the customer-facing system.
Live, with a dashboard
Queues and scheduled tasks show in Connect's Hangfire dashboard. A job whose target is offline is retried 10 times, every 30 minutes, and can be re-queued once the cause is fixed.
Clarity Connect is sold as a SaaS subscription at $599 a month or as a one-time license at $15,000 with no ongoing fees, and larger projects are priced to scope. See pricing.
Questions
Do WooCommerce orders reach Sage X3 straight away?
Yes, when the order webhook is on: Connect posts the order to X3 as it arrives. A scheduled pull backs it up in case a webhook delivery fails.
How does X3's per-site stock show in WooCommerce?
WooCommerce holds one quantity per product or variation, so we agree which X3 sites count toward it and Connect writes that figure to the store.
Does it need a WooCommerce plugin?
No extra plugin is needed for the connection itself. Connect uses WooCommerce's built-in REST API and webhooks with an API key you create in WooCommerce.
What does Clarity Connect cost?
$599 a month as SaaS, or $15,000 for a one-time license with no ongoing fees; larger projects are priced to scope. See pricing.
Related resources
Connect WooCommerce and Sage X3
Tell us how orders, stock and customer records should move between your WooCommerce store and Sage X3. A Clarity business analyst will map it with your team before the build starts.
Book a demo
