Search our Help.

WooCommerce Integration Setup

Follow

WooCommerce Integration Setup tutorial video

Overview tab

Configuration tab

Data Management tab

Connection Log tab

Essential notices before you set up your WooCommerce integration

  1. 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.
    If you are concerned about using WooCommerce plugins or extensions with Unleashed's integration submit a support ticket in the Support Portal and our team will be able to further advise.
  2. WooCommerce and WordPress versions Supported: Check that the eCommerce Hub's integration is compatible with your WooCommerce store. The current integration supports WooCommerce API V3 and later, meaning it will support WooCommerce 3.5x or later and Wordpress 4.4 or later.

  3.  Existing WooCommerce connection: If you have an existing WooCommerce integration (e.g. via a 3rd party developer) and wish to switch your integration, please verify that current limitations with Unleashed's eCommerce Hub's integration are acceptable for your requirements. See the Setup Checklist below for more detail.

Setup Checklist: WooCommerce

  1. Store URL format:The URL must include the full path to your WooCommerce store's homepage.
  2. Product Settings in Unleashed: Ensure all products you wish to sync are set to 'Sellable' in Unleashed.
  3. Product records in WooCommerce: Check the 'Manage Stock Level' setting is enabled in each of your WooCommerce product records.
  4. Tax codes and rates: The tax code in Unleashed must match the Tax Name / Label in WooCommerce, and the Tax Rate must match.
  5. Store Currency: The WooCommerce Store's Base Currency should match Unleashed's Base Currency.
  6. Guest customer setting: Ensure you set up a Guest Customer in Unleashed to sync with your WooCommerce Guest Customers.

WooCommerce Integration Setup tutorial video

Find WooCommerce in the Unleashed menu under eCommerce Hub 

To access, activate and manage your WooCommerce integration, go to eCommerce Hub option in the Unleashed main menu and select the "WooCommerce" tile.

It is recommended that you go through all the menu options and review the functions before activating the integration. 

Overview tab

If you've not yet subscribed to the the eCommerce Hub's WooCommerce integration, only the Overview tab will be available after selecting the WooCommerce tile. To activate the integration your Account Owner (or a user with permissions to manage your subscription's billing) can click on the "Subscribe to Integration" button in the Overview tab and update your account's plan. Once you're subscribed to the eCommerce Hub's WooCommerce module, you can proceed with configuring the integration. 

Install a WooCommerce Store on Unleashed

Once your account has subscribed to eCommerce Hub's WooCommerce module, you can integrate one WooCommerce Store using the following steps:

  1. From Unleashed's main menu, go to eCommerce Hub, WooCommerce and select the Overview tab.

  2. In the Store URL field, enter the URL of your WooCommerce store. The URL must include the full path to your WooCommerce store's homepage. e.g. woo-always-genuine-puppy.wpcomstaging.com
    NOTE: Ensure there is no "https://" prefix, and no forward slashes "/"that indicates subdirectories or sub-folders


  3. Click on the "Install" button. 

  4. A new window "Unleashed would like to connect to your store" will be displayed. Provide your Admin Login details to your WooCommerce store:


  5. If the URL and login details are valid, the window "Unleashed would like to connect to your store" will update. To activate the link between Unleashed and the WooCommerce Store, click on the "Approve" button.
    On this page, you will also find more information about WooCommerce and its integration with Unleashed.


  6.  Once approved, the WooCommerce Store's URL will be displayed on the "Overview" tab in your eCommerce Hub's WooCommerce page. The "Configuration", "Data Management" and "Connection Log" tabs will now be available use.

In the top right corner of the WooCommerce integration's page you'll find a an Active or Inactive badge. This badge denotes whether the WooCommerce integration is currently active or not. 

Configuration tab

Use the Configuration tab to manage the connection between Unleashed and your WooCommerce Store. 

Uninstall App

If the integrated 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 Unleashed. Any data that has previously synced or imported from WooCommerce will remain in Unleashed after the store is uninstalled, but no further updates or imports will be made from WooCommerce to Unleashed.

NOTE: Uninstalling the WooCommerce integration does not automatically remove the eCommerce Hub's WooCommerce module from your Unleashed subscription.

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 without losing any of the configuration settings currently selected for your store.

Choose How Unleashed and WooCommerce integrate

Use the Configuration options (table below) available to manage how your products, stock availability and Sales Orders will sync between Unleashed and the WooCommerce store. Once all fields are configured, click the "Save Configuration" button.

Configuration option Description
SOH Count 
(Stock on Hand Count)

Choose to export available stock quantities (Available Qty + Can Assemble Qty) in Unleashed to Unleashed as either:

  • Aggregated across all warehouses
  • Single Warehouse

NOTE: SOH updates are scheduled for every 15 minutes.

Guest Account Mapping

Select an existing Unleashed Customer Code to assign all "Guest" WooCommerce Orders to. All "Guest" orders will be assigned to the Customer record entered. If this is left blank or incorrect then "Guest" Orders and Orders without an assigned Customer in WooCommerce will fail to import to Unleashed.
NOTE: Sales Orders created with the "Guest" Customer in Unleashed will not sync the customer's contact name and phone number from WooCommerce into Unleashed's Sales Order.

Order Warehouse Mapping Use the dropdown menu to select the Warehouse in Unleashed that all WooCommerce Orders will import to. 
Unleashed Order Status

Use the dropdown menu to select one of the following Sales Order statuses all WooCommerce Orders will attempt to import as:

  • Parked
  • Placed
  • Completed
    NOTE: If orders import as Completed, but there is not enough stock available to fulfil the order, it will import as Parked instead.
Product Price Sync

When enabled, use the drop down menu to select the Unleashed Product Sell Price tier that will sync with WooCommerce:

  • Existing products: Sell Price Tier's price will update the existing product in WooCommerce when the product's record is saved in Unleashed.
  • New products: Sell Price Tier's price in Unleashed will export to WooCommerce as the product's created.

When disabled, no pricing updates will occur for products between Unleashed and WooCommerce

Set Customer Type

Use the dropdown menu to select a default Customer Type to apply to Customers created and synced from WooCommerce:

  • New Customers: When a new customer places an order through WooCommerce, the selected Customer Type will be applied to them.
  • Existing Customers: If an existing customer places an order in WooCommerce and they have no Customer Type in Unleashed, the selected Customer Type will be applied to their Customer record.

When connecting to a Sandbox Unleashed account it is recommended that you first export your current SOH out of WooCommerce (especially if this is your current source of truth), then import this into the sandbox. This way the SOH will initially match so when you integrate.

Data Management tab

Use the Data Management tab to manage your ongoing integration. This page gives you the opportunity to find and import any WooCommerce Orders that haven't imported to Unleashed.

Import Missing Orders

Use the "Start Date" and "End date" fields to set a date range and click on the "Find" button to search for any missing orders for the given date range. Any WooCommerce Orders that haven't imported from that date range will populate in "Missing Orders" field. Click on the "Import" button to re-attempt importing them to Unleashed.

Points to note

  • The maximum date range for finding missing orders in WooCommerce is 31 days.
  • The "Start Date" can be no more than 31 days prior to the current day's date.
  • The "Missing Orders" field will display a maximum of 100 WooCommerce Orders, with the oldest orders first.
  • The finding missing orders, the integration will search all "Processing" and "Completed" status WooCommerce Orders, to find missing ones for the period.

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 to Unleashed.

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. If you are unsure on how to resolve the error Submit a support ticket in the Support Portal.
  • WARNING: Displays any error caused by connection issues with the WooCommerce Store.
  • DEBUG: Displays any actions completed to resolve an error.

After the WooCommerce Integration

WooCommerce FAQs

Was this article helpful?
0 out of 0 found this helpful