Plug-ins & Integration

Shopify – Connect Your Store

Connect your Shopify store to FreightExchange and your customers see their final delivery price at checkout. Paid orders land on your Quote page, ready to book, label and track.

You'll switch between two places. Each step is tagged so you always know where to be.

Shopify  your Shopify admin     FreightExchange  the FreightExchange portal


In this article

  1. How it works
  2. Getting started
  3. Connect your store
  4. Set up your shipping
  5. Optional extras
  6. Check your setup
  7. Where to find everything
  8. Troubleshooting


1. How it works

1.1 At the checkout

  1. Rates are worked out from your store's pickup address, the shopper's delivery address and every item in the cart.
  2. Each SKU is matched to your Standard Packaging to get its cartons, sizes and weights.
  3. All items are quoted together as one consignment with the carriers on your account, including any Bring Your Own (BYO) carrier accounts.
  4. Your Workflow Rules decide which options to show, such as cheapest, fastest, depot collect or click and collect.
  5. Your Sales Rates set what the customer pays, for example a margin or free delivery.
  6. Delivery options appear at checkout and the customer pays in Shopify.

1.2 After ordering

StepWhereWhat happens
1ShopifyThe customer checks out.
2FreightExchangeThe order appears on the Quote page with all order and shipping details filled in.
3FreightExchangeCheck or edit the quote, confirm it and make a booking. If you use a FreightExchange network carrier, we request payment at this stage.
4FreightExchangePrint Shipping Labels from the Book page.
5FreightExchangeBook a pickup and close your manifest.
6FreightExchangeBranded Tracking emails go to your customer automatically.


Tracking numbers are not written back to the Shopify order.


2. Getting started

2.1 Get your store ready  Shopify

  1. Make sure you have admin access to your Shopify store.
  2. Ask Shopify support to turn on Third-Party Carrier-Calculated Shipping for your plan.
  3. Go to Settings > Locations and add your store address as a location.
Without Third-Party Carrier-Calculated Shipping, the app still installs and imports orders, but rates won't show at checkout.

2.2 Add the eCommerce Plugin  FreightExchange

The Shopify integration is a paid add on. See FreightExchange pricing.

  1. Log in or sign up.
  2. Click Subscriptions in the top menu bar and add the eCommerce Plugin. For more detail, see How to Subscribe to FreightExchange.


3. Connect your store

You start in FreightExchange and finish in Shopify.

StepWhereWhat to do
1FreightExchangeFrom the menu in the top right corner, go to Apps > Systems Integrations.
2FreightExchangeClick + Add New, choose Shopify as the System and click Connect. This opens the FreightExchange app in the Shopify App Store.
3ShopifyClick Add App and follow the steps to install it.
4FreightExchangeYou're brought back here. Your store appears in the list with the status Connected


Add Platform window with Shopify selected as the System and the Connect button

Step 2. Choose Shopify in the Add Platform window and click Connect.


4. Set up your shipping

4.1 Set your default pickup and delivery options  FreightExchange

Go to Apps > Systems Integrations and click the settings icon next to your store. This opens Edit Settings.

Edit Settings window showing the General, Origin and Destination settings

The Edit Settings window. Each setting is explained below.

SettingWhat to choose
General
Name and URLYour Shopify store name and URL.
Origin
Location TypeFactory/Warehouse, Residential or Carrier Depot.
Opening and Closing timeThe window when carriers can collect.
Tail lift required to pickup goodsTurn on if you can't load heavy freight without a tail lift. Fees apply.
Destination
Location TypeChoose Residential if most orders go to homes, so residential fees are included.
Opening and Closing timeStandard is 9am to 5pm.
Authority To Leave or Signature RequiredYour default delivery type.
Tail lift required to drop goodsTurn on if deliveries always need a tail lift. Extra fees are added automatically.


4.2 Set up your Standard Packaging  FreightExchange

FreightExchange rates each order from the items in it. Add one entry per carton under Settings > Packaging.

The Packaging ID must match the Shopify SKU exactly.
If your productWhat to set up
Ships in one cartonOne entry with the same ID as the SKU. Delete any packagingids metafield on that product in Shopify.
Ships in more than one cartonOne entry per carton, for example MAIN-1 and MAIN-2. Then complete step 4.3 in Shopify.
Is an optional product or accessoryGive it its own SKU and entry. Its carton is added when it's in the cart.
Has variantsOne entry for each variant SKU, even when variants are the same size.

For more detail, see How To Set Up Your Standard Packaging. You can also add your Products by following How To Configure Your Products in FreightExchange.


4.3 Link products that ship in more than one carton  Shopify

Skip this step if every product ships in one carton.

  1. Go to Settings > Metafields and metaobjects and add a product metafield called packagingids.
  2. Open each product that ships in more than one carton.
  3. In packagingids, list one Packaging ID per carton, separated by commas with no spaces.
Correct
MAIN-1,MAIN-2
Won't work
MAIN-1, MAIN-2


4.4 Choose which carriers show at checkout  FreightExchange

Set up Workflow Rules under Settings > Rules with your preferred carriers and shipping rules. These control which options your customers see, such as cheapest, fastest, depot collect or click and collect.


5. Optional extras

You don't need these to go live. Add them when they suit your business.

5.1 Use your own carrier accounts  FreightExchange

To ship on your own carrier accounts, set them up under Carriers & Accounts.

See Get Started with BYO Carrier Accounts.

5.2 Set what your customers pay  FreightExchange

With Sales Rates you can

  • add a margin to your freight cost
  • offer free delivery to selected postcodes
  • charge for optional products
  • set charges for regional and remote areas

Sales Rates need BYO rate management, which comes with a BYO Carrier add on. You can also set shipping rates in Shopify instead.

5.3 Ship from more than one warehouse

FreightExchange

  1. Add each warehouse to your Address Book.
  2. Note the Address ID of each warehouse.

Shopify

  1. Go to Settings > Metafields and metaobjects and add a product metafield called originAddressId.
  2. On each product, enter the Address ID of the warehouse that ships it.
  3. If variants ship from different warehouses, set it at variant level.

5.4 Offer depot collection at checkout

Customers can collect their order from a carrier depot near their delivery address. It appears at checkout alongside your door delivery options.

Shopify checkout showing depot collection options

Depot options at checkout show the depot address, distance, transit time and price.

At the checkout

  • FreightExchange finds the carrier's nearest active depot within your depot radius of the delivery address.
  • If no depot is within the radius, that option doesn't show.
  • Each carrier service shows one depot, with its address and distance.
  • The price is based on the depot's location, not the customer's address.

Surcharges

  • Tail lift, manual handling and hand load and unload don't apply.
  • On-forwarding, remote area and WA pickup surcharges can still apply, based on the depot address.
  • The carrier may charge a storage fee later. This isn't included in the checkout price.

After ordering

  • Once the quote is confirmed, the depot address replaces the delivery address on the Quote page, so the carrier receives the depot as the destination.
  • The customer's name, email and phone stay on the order.

Availability

Available for carriers using a Manual Upload rate card. It's not yet available for API-Based Rates or for sender drop off at a depot.

Set your depot radius  FreightExchange

  1. Go to Settings > Carriers and rates.
  2. Under Depot radius, enter the furthest distance in km a depot can be from the delivery address.
  3. Click Save changes.

A bigger radius gives customers more depots to choose from, but they may need to travel further to collect.

Carriers and rates settings showing the Depot radius field in km

The Depot radius field under Carriers and rates.

To turn on depot collection, contact FreightExchange Support.


6. Check your setup

Run one test order before you go live.

StepWhereWhat to check
1FreightExchangeIn Apps > Systems Integrations, your store shows as Connected.
2ShopifyAdd products to a cart and enter a delivery address at checkout. FreightExchange rates show on the next screen.
3ShopifyPlace a test order.
4FreightExchangeThe test order appears on the Quote page with all details filled in.


7. Where to find everything

In your Shopify admin

WhereWhat you control there
Settings > LocationsYour ship from address
Settings > Metafields and metaobjectsThe packagingids and originAddressId product metafields
ProductsProduct SKUs and metafield values

In the FreightExchange portal

WhereWhat you control there
Apps > Systems IntegrationsConnecting your store and your default pickup and delivery options
Settings > PackagingThe cartons for each product SKU
Settings > ProductsYour product details
Settings > RulesWhich carriers and options show at checkout
Settings > Carriers and ratesYour depot radius for depot collection
Carriers & AccountsYour BYO carrier accounts and rate cards
Sales RatesWhat your customers pay
Address BookYour warehouses and their Address IDs
Quote pageImported orders, ready to book


8. Troubleshooting

ProblemWhere to fix itWhat to check
Error when connecting, or no rates at checkoutShopifyAsk Shopify support to confirm Third-Party Carrier-Calculated Shipping is on.
No rates appearing at checkout, despite FreightExchange being configured
ShopifyGo to Settings → Shipping and delivery → Shipping profile → Shipping zone. Edit the FreightExchange shipping service and check that Automatically include new services when they become available is enabled. Save the changes and test checkout again.
Another shipping app is installedShopifyTurn it off. Only FreightExchange can return freight rates at checkout.
Rates look too highBothCheck your tax settings, product dimensions in Settings > Packaging and any Shopify handling fees.
Wrong carton countBothIn Shopify, check packagingids uses commas and no spaces. In FreightExchange, check every ID exists under Settings > Packaging.
Wrong pickup warehouseBothIn Shopify, check the product's originAddressId. In FreightExchange, check it matches your Address Book.


Need help?

Browse the Shipping Plugin FAQs or contact FreightExchange Support.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article