WooCommerce Integration Introduction
Follow
Sales/Support
Updated : Created :
Page contents
eCommerce Hub's WooCommerce integration
Essential steps before you set up your integration
eCommerce Hub's WooCommerce integration
WooCommerce is a popular open-source eCommerce platform built on WordPress that allows you to customise your online business to suit your needs. This integration with Unleashed, found under the eCommerce Hub is designed to streamline your online store and stock management.
- Stock availability in Unleashed is automatically updated every 15 minutes to your WooCommerce store.
- View accurate margins for all sales channels — based on landed costs calculated in Unleashed.
- Using Unleashed reports, you can see centralised sales figures for different sales channels (for example, retail or wholesale)
Essential steps before you set up your integration
- Third-party apps or add-ons: Add-ons in your WooCommerce store may impact your Unleashed integration. We recommend a comprehensive test using an Unleashed Sandbox before integrating into your live environment.
- WooCommerce and WordPress versions Supported: Check that your integration is compatible: this integration supports WooCommerce API V3 and later, meaning it will support WooCommerce 3.5x or later and Wordpress 4.4 or later.
- Existing WooCommerce connection: If you have an existing WooCommerce integration e.g. via a 3rd party, and wish to switch your integration to Unleashed's eCommerce Hub, please verify that current limitations are acceptable, see WooCommerce Setup Checklist below for more detail.
- Subscribe to the eCommerce Hub's Woocommerce module: In order to setup and use Unleashed's Woocommerce integration you must add it to your Unleashed subscription. You can subscribe to the eCommerce Hub's WooCommerce via Settings, Billing or in the eCommerce Hub's WooCommerce page.
WooCommerce Setup Checklist
- Store URL format: The URL must include the full path to your WooCommerce store's homepage.
- Product Settings in Unleashed: Ensure all products you wish to sync are set to 'Sellable' in Unleashed.
- Product records in WooCommerce: Check the 'Manage Stock Level' setting is enabled in each of your WooCommerce product records.
- Tax codes and rates: The tax code in Unleashed must match the Tax Name / Label in WooCommerce, and the Tax Rate must match.
- Guest customer setting: Ensure you set up a Guest Customer in Unleashed to sync with your WooCommerce Guest Customers.
Woocommerce workflows
Only one Woocommerce Store can be integrated with Unleashed at any one time.
Product mapping
Upon the initial connection (Save Configuration), the integration will only compare "Sellable" Unleashed Product Records to the connected WooCommerce Store to identify matching records.
- Any Products found in Unleashed but not in WooCommerce will be exported to WooCommerce. These products will be created in WooCommerce based on the Field Mappings with a draft status.
- Any Products found in WooCommerce that are not in Unleashed will not be imported into Unleashed: for these products, no mapping is created between them.
NOTE: If the new product in WooCommerce is included on a Sales Order, the product will be created in Unleashed upon the order's import from WooCommerce.
Note: Products present only in WooCommerce will import and map only in the event that they are present on an importing Sales Order. These will not import via the initial connection mapping process.
When a New Product is created and marked as "Sellable" in Unleashed, the above mapping process will occur. If a New Product is created in WooCommerce, nothing will happen until the first sales order for the Product is imported. In this event, either a mapping will be created with an existing Unleashed Product, or a new Product will be created in Unleashed.
Product Variants
In WooCommerce, a product can have variants. These are different versions of the product, such as size, colour, style, etc. These products are grouped together in WooCommerce, but each variant of the product should have its own SKU to successfully sync with Unleashed. Each variant's unique SKU will then sync on a 1-to-1 basis with a product record in Unleashed with a matching product code.
When you sync your WooCommerce and Unleashed accounts, each variant of the product will be created as a unique product code in Unleashed.
| Size | Colour | SKU |
|---|---|---|
| 12 | Black | 1001 |
| 14 | Black | 1002 |
| 12 | Blue | 1003 |
| 14 | Blue | 1004 |
Multi-currency
-
WooCommerce Base Currency must match the Unleashed Base Currency for a successful integration
-
WooCommerce only supports 1x Currency per store. However, there are a number of add-ons that will offer multi-currency functionality for displayed prices & payments, but regardless, only a single currency will pull into Unleashed