> For the complete documentation index, see [llms.txt](https://help.supplyd.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.supplyd.co/supplyd-erp/integrations/sales-channel-integrations/woocommerce.md).
# WooCommerce
Integrating WooCommerce with Supply’d allows you to seamlessly sync orders, products, and inventory between your online store and your operations in Supply’d. This connection helps automate order flow, reduce manual data entry, and keep stock levels accurate across both platforms, thus saving time and improving accuracy in your sales and fulfilment process.
This document will guide you through:
* [#connecting-to-woocommerce](#connecting-to-woocommerce "mention")
* [#woocommerce-payments-and-payouts](#woocommerce-payments-and-payouts "mention")
* [#editing-the-woocommerce-integration](#editing-the-woocommerce-integration "mention")
* [#disconnecting-from-woocommerce](#disconnecting-from-woocommerce "mention")
***
## Connecting to WooCommerce
{% stepper %}
{% step %}
#### Go to Settings
Click on your company name in the top right and select **Settings**.
***
{% endstep %}
{% step %}
#### Select Integrations
Scroll down and select **Integrations** from the **Settings** menu.
***
{% endstep %}
{% step %}
#### Click Add+
Click on **Add +** in the top right.
The **Add Integration** page will show.
***
{% endstep %}
{% step %}
#### Click WooCommerce
Click on the **WooCommerce** logo (as circled above).
The **Connect to WooCommerce** form will appear.
***
{% endstep %}
{% step %}
### **Complete the Form**
**Store URL**
The URL of the WooCommerce store you would like to connect to.
***
{% endstep %}
{% step %}
#### Click Connect
Click .
The **WooCommerce Settings** screen should appear.
{% hint style="info" %}
The list of additional integrations will vary based on the third-party platforms you’ve connected to Supply’d.
{% endhint %}
{% hint style="info" %}
If the **WooCommerce Settings** page doesn't appear:
1. Click on your name in the top right corner, and select **Settings.**
2. Scroll down and select **Integrations.**
3. Select **WooCommerce** from the **Integrations** list.
You can also follow these steps if you need to make changes to the settings at a later date.
{% endhint %}
Complete the sections as follows:
***
{% endstep %}
{% step %}
### WooCommerce Settings
**Integration Name\* \[required field]**
Enter a reference name for this integration.
***
{% endstep %}
{% step %}
### Sync Orders?
Toggle on to sync orders from WooCommerce to Supply'd and complete the fields.
**Order Number Prefix**
Enter an optional prefix for order numbers imported from this integration.
**Mark As Completed**
Select when to mark orders as completed in WooCommerce.
**Sync Orders**
Se;ect which orders would you like to sync from WooCommerce.
When **All Orders Since Date** is selected man additional field - **Order Sync Start Date** - will appear.
**Order Sync Start Date**
Select the first date you would like orders to be synced from.
{% hint style="info" %}
This field will only show when **All Orders Since Date** is selected in the **Sync Orders** field.
{% endhint %}
**Reduce Inventory On Import**
Choose how you would like to reduce Supply'd inventory when orders are imported, and which orders status is used to reduce inventory. We recommend to only reduce inventory for "Processing" orders.
**Reduce Stock On Hand On Import**
Choose whether or not to reduce stock on hand on import.
**No:** By default available stock will be reduced on import then on hand stock will be reduced when the order is picked.
**Yes:** If you're not utilising pick & pack within Supply'd set this to **Yes**.
**Match Product SKU Using**
The SKU in WooCommerce is used to match products in Supply'd.
Choose which field should be used as the PLU (price look-up) in WooCommerce - either **SKU** or **Barcode**.
**Warehouse**
Select which warehouse would you like to make available for WooCommerce inventory. This warehouse is also used for mapping orders for pick & pack.
***
{% endstep %}
{% step %}
### Advanced Mapping
Advanced mapping allows you to set-up advanced mapping rules to define specific actions based on order information. These actions will run once at the time of import if all the conditions defined in a rule set are met.
To add a **Rule:**
1. Click **Add Rule Set**.
2. Select your desired conditions from the drop-down menus.
3. Add any additional conditions, if required, by clicking **Add Condition**.
4. Select your desired **Actions** from the drop-down menus.
5. Add any additional actions, if required, by clicking **Add Action**.
Repeat as required to add any additional **Rule Sets**.
***
{% endstep %}
{% step %}
### Sync Inventory?
Toggle on to sync inventory from Supply'd to WooCommerce.
**Warehouse**
Select which warehouse would you like to make available for WooCommerce inventory.
**Match Product SKU Using**
The SKU in WooCommerce is used to match products in Supply'd.
Choose which field to use in Supply'd to match products - **SKU** or **Barcode**.
**Manage Stock Off Setting**
Select how you would like Supply'd to handle products that are set as "Manage Stock" in WooCommerce.
* **Use Supply'd Setting:** Will update the product to match Supply'd manage stock setting.
* **Set as In Stock or Out of Stock:** Will keep manage stock set to no, but will set as In Stock or Out of Stock based on the availability in Supply'd.
* **Ignore Product:** Product will be ignored and inventory/status will not be synced.
***
{% endstep %}
{% step %}
### Sync Products?
Toggle on to sync products added in Supply'd to WooCommerce automatically. You can select which products to sync when editing each product in Supply'd.
**Match Product SKU Using**
The SKU in WooCommerce is used to match products in Supply'd.
Choose which field to use in Supply'd to match products.
**GST Tax\* \[required field]**
Select where to map tax for products that attract GST.
**GST Free Tax\* \[required field]**
Choose where to map tax for products that are GST Free - **None** or **Tax**.
**Name Format\* \[required field]**
The format to use when sending product names to WooCommerce. Uses out templating language, see docs for more details. Some common options are:
* {{brand}}: Products brand name.
* {{name}}: Products name.
* {{size\_unit}}: Products size (e.g. "100" for a product that is 100g).
* {{size\_measure)}: Products size measurement in short form (e.g. "g" for grams).
* {{carton\_qty}}: The quantity per carton (e.g. "8" for 8 per carton, "1" for items sold by unit).
**Description Mapping**
Set-up how descriptions map to WooCommerce. Add Supply'd fields using handlebars and basic HTML tags are supported.
👉 See available fields and learn more in the [Handlebars](/supplyd-erp/templating/handlebars.md) document.
***
{% endstep %}
{% step %}
#### Click Save
Click to add the WooCommerce integration.
{% endstep %}
{% endstepper %}
***
## Additional Options
Clicking the 3 dots in top right corner of the **WooCommerce Settings** page brings up an additional menu.
***
### Advanced > Re-sync Orders
This will delete all existing orders then begin the full import again.
You will be asked to confirm.
***
### Remove Integration
Allows you to remove the WooCommerce integration.
👉 See [Disconnecting from WooCommerce](#disconnecting-from-woocommerce) below.
***
## WooCommerce Payments & Payouts
When you integrate WooCommerce with Supply’d, all sales orders are automatically synced and recorded to a clearing account in your connected accounting software (Xero or MYOB). This makes it easier to track payments, manage merchant fees, and reconcile your accounts accurately.
#### How It Works
1. **Sales Happen:** Orders come in via WooCommerce, using all sorts of payment methods.
2. **Supply’d Does Its Thing:** We capture those sales and log them in the right clearing account in your accounting software - eg. WooCommerce Clearing Account.
3. **Payouts Arrive:** Stripe, PayPal, Afterpay, etc. send payouts (with fees already deducted) to your bank. You’ll reconcile this payout against the clearing account.
4. **Merchant Fees:** You create bills for merchant fees and reconcile them against the clearing account.
This setup makes sure all WooCommerce sales are recorded correctly and payouts are easy to match in your accounting system.
The simplified example chart above illustrates the flow. You’ll have multiple payouts from different payment methods, such as PayPal, Stripe, Visa, Afterpay, and others, along with their associated merchant fees.
{% hint style="success" %}
See the [Clearing Account Flow for Sales Channels](/supplyd-erp/integrations/accounting-integrations/clearing-account-flow-for-sales-channels.md) for further information.
{% endhint %}
{% hint style="success" %}
For more information on syncing your accounting software, see the relevant documents in the [Integrations](/supplyd-erp/integrations.md) section.
{% endhint %}
***
## Editing the WooCommerce Integration
If you like to edit the WooCommerce integration:
{% stepper %}
{% step %}
Click on your company name in the top right corner and select **Settings** from the menu.
{% endstep %}
{% step %}
Scroll down and select **Integrations**.
{% endstep %}
{% step %}
Select **WooCommerce** from the **Integrations** list. The **WooCommerce Settings** page will open.
{% endstep %}
{% step %}
Update any details required following the guidelines above for [#connecting-to-woocommerce](#connecting-to-woocommerce "mention").
{% endstep %}
{% step %}
Click to update the settings.
{% endstep %}
{% endstepper %}
***
## Disconnecting from WooCommerce
If you like to disconnect from WooCommerce:
{% stepper %}
{% step %}
Click on your company name in the top right corner and select **Settings** from the menu.
{% endstep %}
{% step %}
Scroll down and select **Integrations**.
{% endstep %}
{% step %}
Select **WooCommerce** from the **Integrations** list.
{% endstep %}
{% step %}
Click on the 3 dots in the top right corner and select **Remove Integration.**
You will be asked to confirm.
Click .
{% endstep %}
{% endstepper %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://help.supplyd.co/supplyd-erp/integrations/sales-channel-integrations/woocommerce.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
