WooCommerce is a plugin for WordPress to allow customers to run an online store.
Woo Commerce Integration Features
Order sync
Stock and Product sync
Despatch Updates (Status)
Prerequisite - Generate an API key
Before you can add the connection in Mintsoft, you need to generate API keys from within WooCommerce. Please make sure the API key has read and write access. If it doesn't, we can't update orders when shipped, or sync inventory levels.
Add the connection on Mintsoft
Once you have the API key from WooCommerce, you can add the account on Mintsoft, to do this:
Click Connect then Order Integrations.
Select WooCommerce then Add Account.
(3PL Only) Select the Client.
Select the Warehouse and Channel.
(Optional) Set the Shipping Zone to Only Import Countries in Selected Shipping Zone.
Enter your Woo Commerce URL.
If the WooCommerce version installed is 3.0 or higher, you need to add /wp-json/wc/v2/ to the end of the URL. For example, https://customerdomain.co.uk/wp-json/wc/v2/.
Set the Frequency.
Enter your Consumer Key and Consumer Secret.
Set the following statuses -
Import Status: This is the status Mintsoft will send back to WooCommerce when the order is imported. Accepted order statuses are shown below.
Picking Status: This is the status Mintsoft will send back to WooCommerce when the order goes into picked status. Accepted order statuses are shown below.
Despatched Status: This is the status Mintsoft will send back to WooCommerce when the order is despatched. Accepted order statuses are shown below.
Set the Number Of Days to Check back from Orders.
(Optional) Set the Order Prefix.
(Optional) Enable Use order_number instead of order_id.
Enable Sync Stock Levels and set the Stock Sync Frequency.
(Optional) Enable Sync New Products and set the Product Sync Frequency.
Set the Note Mapping Field.
(Optional) Enable Use Webhooks.
This requires additional setup, please review the Using Webhooks on WooCommerce section below to learn more.
Make Active once ready.
Finally, click Add.
Accepted Order Statuses
The following statuses are accepted by WooCommerce instead of the default ones set on the connector:
auto-draft
pending
processing
payment-received
on-hold
completed
cancelled
refunded
failed
authorised
fraud-screen
checkout-draft
WooCommerce Webhooks
Using Webhooks on WooCommerce requires some additional setup. A Custom Topic must be created on WooCommerce with the following Downloadable File.
Once the file has been downloaded, please review the WooCommerce Help Guide, to learn more about creating Webhooks within WooCommerce.
Why use Webhooks?
Turning on Webhooks will ignore the Frequency set for orders to import and instead import orders as soon as the customer places them.
Note: Webhooks may bring orders in from any status and not just the one specified on the connection.
Deleting WooCommerce webhooks
If you are receiving an error of WooCommerce implementation does not currently support deleting webhooks. You will need to manually delete the webhook with ID: xx, Name: xxx within Mintsoft, please go to the affected Woo Commerce store and delete the webhook(s), once deleted please add the new webhook(s) if needed. The reason for this error is that the WooCommerce integration on Mintsoft does not support deleting webhooks, if WooCommerce webhooks need to be deleted, this must be done directly on WooCommerce.