We’ve made it simple to connect your WooCommerce store so you can display rates at checkout and import orders. Just follow the steps below.

TABLE OF CONTENTS

• Before You Begin     
• Steps to Connect FreightExchange & WooCommerce
  • 1. Generate an API Key
  • 2. Activate the FreightExchange Plugin
  • 3. Packaging
  • 4. Verify the Installation
  • 5. Troubleshooting

Before You Begin     

• If you haven’t already signed up for FreightExchange, create an account here. This will give you the credentials required to access our API.

• You’ll need admin access to both your FreightExchange account and your WooCommerce store.

Steps to Connect FreightExchange & WooCommerce

1. Generate an API Key

• Log in to FreightExchange and go to Apps > System Integrations.

• Click Add New and select WooCommerce from the dropdown list.

• Click Connect. An API key will be generated.

• Copy this API key — you’ll need it later in WooCommerce to complete the connection.
  
  

2. Activate the FreightExchange Plugin

• In WooCommerce, install and activate the FreightExchange plugin.

• Follow this guide for detailed activation steps.

3. Packaging

• If you’ve already set up product dimensions in WooCommerce, the plugin will automatically read them and use this data to calculate freight costs.

• If your product ships in multiple packages, follow these steps:

  1. In WooCommerce > Products, search for the product you want to update.

  2. Click on the product name to open its details.

  3. On the product page, go to Product Data > Attributes, then click Attributes.

  4. Set the following:

     • Name = packagingids

     • Values = packagingidnum_1, packagingidnum_2, ...

  5. Example: If the product with SKU SK-0017 ships in 3 packages, enter the values as:
     SK-0017_1,SK-0017_2,SK-0017_3
     (separate with commas, with no spaces after commas).

4. Verify the Installation

Follow these steps to confirm the setup was successful:

• Navigate to Apps > System Integrations in FreightExchange. Your WooCommerce store name should appear under the app, with the status shown as Connected.

• Place a test order on your store. At checkout, enter a shipping address and proceed. You should see FreightExchange rates (for Cheapest & Fastest options) displayed.

• Once an order is placed (by a customer or as a test), it will automatically appear on the Quote page* in FreightExchange, with all shipping details pre-filled.

*You are able to modify the order on the quote page. Once ready, you can proceed to confirm the quote and book the pick-up.

5. Troubleshooting

If things aren’t working as expected, try the following:

• Check WooCommerce access: Contact WooCommerce support first to confirm your store access and setup are correct.

• Check plugin conflicts: Other plugins may cause clashes. Deactivate any unnecessary or obsolete plugins and test again.

• Check tax settings: If your shipping costs appear too high in FreightExchange, review your tax settings in WooCommerce.

• Check Debug Mode: Make sure “Enable debug mode” is unchecked. If this is enabled, rates will continually recalculate and prevent customers from completing checkout.

  • To update this setting, go to Settings > Shipping > Shipping Settings, then find and disable the Debug mode option.

Anything else? Please email sales@freightexchange.com.au and we'd love to help!