The eCommerce Hub's WooCommerce integration transforms how you manage your online store by creating a seamless connection between your Unleashed inventory system and your WooCommerce website.
This guide walks you through the complete setup process, from meeting the initial requirements to configuring advanced settings and managing your integration over time. Whether you're setting up a new WooCommerce store or migrating from another integration solution, you'll find step-by-step instructions to get your systems working together smoothly.
Prerequisites and Requirements
Before setting up your WooCommerce integration through the eCommerce Hub, ensure your WooCommerce store meets these essential requirements:
WooCommerce Version: 3.5x or later.
WordPress Version: 4.4 or later.
API Support: WooCommerce API V3 or later.
The eCommerce Hub's WooCommerce integration must also be included as an add-on to your account's subscription.
🤓 Tip: WooCommerce add-ons may affect your integration. We strongly recommend testing the integration thoroughly with a Sandbox environment before implementing it in your live system.
You will also want to ensure your WooCommerce store and Unleashed account are set up correctly:
Currency: The WooCommerce Store's base currency must match your Unleashed account's base currency.
Unleashed products: Ensure all products you wish to sync with the WooCommerce store have the Type setting "Sellable" enabled.
WooCommerce Products: Ensure all products in your WooCommerce Store have the "Manage Stock Level" setting enabled.
Taxes: The Tax Code and Tax Rate in Settings > Taxes must match the Tax Names or Labels and Tax Rates in the WooCommerce store.
Guest customer setting: Create a customer in Unleashed for Guest Customer orders in WooCommerce to import to.
Tutorial Video
WooCommerce setup
Overview tab
The Overview tab in the eCommerce Hub's WooCommerce integration provides you with the opportunity to subscribe to the integration and install one WooCommerce store.
Install a WooCommerce Store
Once subscribed to the WooCommerce eCommerce Hub module, install a WooCommerce Store:
From the main menu, go to eCommerce Hub > WooCommerce.
In the Store URL field, provide your store's homepage URL, e.g., woo-always-genuine-puppy.wpcomstaging.com, excluding the "https://" prefix and suffix subdirectories or sub-folders, indicated by forward slashes.
Click on Install.
In the WooCommerce pop-up window, provide your WooCommerce Store's admin login.
In the window "Unleashed would like to connect to your store", click Approve.
The eCommerce Hub's WooCommerce page will update show the WooCommerce store is connected with an "Active" status.
After the store's integration is active, you can use the Configuration and Data Management tabs to set up and manage the integration's sync behaviours. The configurations applied at the point of installation can be updated and amended at any time and will take effect as soon as the new configuration is saved.
Configuration tab
In the Configuration tab, determine how orders, products, and customers will sync between your account and the WooCommerce store. Once the settings are up to date, click on the Save Configuration button at the bottom of the page to apply them to the integration.
Configuration option | Description |
SOH Count | Determine what stock availability is exported to your WooCommerce store from the following options:
Stock availability is calculated as Stock On Hand plus Can Assemble quantity minus Allocated Stock. The Can Assemble quantity included is calculated using the component products' available stock in the mapped Stock Availability Warehouse. |
Guest Account Mapping | Search and select an existing customer to assign all "Guest" WooCommerce Orders to. If this is left blank or invalid, "Guest" Orders and Orders without an assigned Customer in WooCommerce will fail to import. |
Order Warehouse Mapping | Use the dropdown menu to select which warehouse WooCommerce Orders will import to. |
Unleashed Order Status | Use the dropdown menu to select the status orders will be imported as in Unleashed:
If Sales Orders attempt to import as Completed, but there is not enough stock available to fulfil the order, it will import as Parked instead. |
Product Price Sync | Use the drop-down menu to select the Sell Price Tier that will sync with WooCommerce. When enabled:
When disabled, no pricing updates will occur across the integration. |
Set Customer Type | Select a Customer Type to apply to customers synced from the WooCommerce store.
|
🤓 Tip: When connecting to a Sandbox, we recommend first exporting your current Stock On Hand (SOH) from WooCommerce and importing this to your Sandbox so that the platforms are aligned.
Disconnect WooCommerce
If you are experiencing connectivity or permission issues with your integrated WooCommerce store, or you'd like to pause the connection without losing the current configuration settings, select the red "Disconnect WooCommerce" link in the Configuration tab.
When you’re ready to re-connect simply select “Save Configuration”. You will be redirected to a new browser page, requiring WooCommerce Admin login details. Follow the steps outlined in the new browser page to refresh your integration's connection as it was.
Uninstall App
If the integration WooCommerce Store is no longer needed or is being replaced, select the red "Uninstall App" link in the Configuration tab. This will remove the store's current integration from your eCommerce Hub. Any data that has previously synced or imported from Shopify will remain in your account, but no further updates or syncs will be made with the WooCommerce store.
📌 Note: Uninstalling the WooCommerce store will not remove the eCommerce Hub's WooCommerce module from your subscription. Your Account Owner must submit a request from your Billing page.
Data Management tab
Use the Data Management tab to search and find any WooCommerce orders in "Processing" and "Completed" status that have failed to import.
Import Missing Orders
To find and import missing orders over a given date range:
From the main menu, go to eCommerce Hub > WooCommerce > Data Management > Import Missing Orders.
Use the date range field to filter missing orders by their order date. The "Start Date" can be no more than 31 days before the current day's date
Click on Find, and all missing orders will be listed by their WooCommerce Order Number.
Click on Import.
To import missing orders by their WooCommerce Order Number:
From the main menu, go to eCommerce Hub > WooCommerce > Data Management > Import Missing Orders
Enter the missing order's WooCommerce Order Number in the free text field. Separate multiple orders by commas or a new line.
Click on Import.
📌 Note:
The maximum date range for finding missing WooCommerce orders in WooCommerce is 31 days.
A maximum of 100 missing WooCommerce orders can attempt to be imported at any one time. If more than 100 missing orders need to be imported, wait 10 minutes between each group of 100.
Connection Log tab
Use the Connection Log to review the activity in your WooCommerce integration over the last 7 days, displaying 20 activities per page. This is especially useful when reviewing errors if products have failed to sync with WooCommerce or if Sales Orders have failed to import.
The following filters can be used on the Log Level:
ALL: Displays all messages that have occurred for the integration.
INFO: Displays any completed actions such as product imports, exports or updates, and Sales Orders imported successfully.
ERROR: Displays any failed imports update errors.
WARNING: Displays any error caused by connection issues with the WooCommerce Store.
DEBUG: Displays any actions completed to resolve an error.
Frequently asked questions
Why are my products failing to export to WooCommerce?
Why are my products failing to export to WooCommerce?
During the initial setup of the WooCommerce integration, all your products saved as "sellable" in Unleashed should export to WooCommerce. If you have a large volume of sellable products in Unleashed, this may be too much data for the WordPress site or WooCommerce Store's hosted server to receive. If you see a server error in your WooCommerce Connection Log, contact the Unleashed support team to resolve.