Skip to content

Instance · Ecommerce

Ecommerce Freight Suppliers Introduction

Last updated 1 November 2026

The carriers you ship with, their methods, service levels and tracking links.

Freight suppliers are the carriers you ship orders with. Each supplier records how it ships, the service levels it offers and the link customers use to track a parcel. When you ship an order, you choose a supplier and add a tracking code, so the customer can follow the delivery.

Where to find freight suppliers

In the admin, open Ecommerce and choose Freight Suppliers. The list can be searched, and you choose which columns it shows.

FieldMeaning
Freight Supplier NameThe carrier. Required
Freight MethodsHow it ships, such as road or air
Freight OptionsIts service levels, such as standard or express
Tracking LinkWhere customers track a parcel

How a supplier is used on an order

An order's shipping package stores a copy of the supplier details at the time you ship: the supplier, the method, the option and the tracking code, with the dispatch and delivery dates. Because it is a copy, renaming a supplier later does not change orders already shipped.

From code

POST /ecommerce/api/v2/freight-suppliers

{
  "freight_supplier_name": "Example Freight",
  "tracking_link": "https://example.com/track"
}

The API can list, read, create, update and delete suppliers. The docs instance has none, so no list is shown.

Common mistakes

  • Putting a tracking code on the supplier. It belongs on the order's shipping package; the supplier's own tracking code field is deprecated.
  • Deleting a supplier you still use. Orders keep their copy, but you can no longer choose it for new ones.
  • One supplier per service level. Add the levels as options instead.