> For the complete documentation index, see [llms.txt](https://support.ordereazi.com/central/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.ordereazi.com/central/apps/couriers/fastway.md).

# Fastway

Get Fastway rates, book consignments from your closest branch, and print labels from your OrderEazi projects with the Fastway app.

When you ship from several branches or stores, choosing where each Fastway parcel is collected from takes time. The Fastway app (**Fastway Courier App** in the App Gallery) brings Fastway's rates and bookings into OrderEazi Central. It collects each consignment from the closest of your branches.

### Before you start

You'll need:

* **A Fastway API key:** The key issued with your Fastway account. The API is the connection other systems use to exchange data with Fastway. The test (Sandbox) and live (Production) systems are separate, so each has its own key.
* **Your Fastway account ID:** You need it on **Sandbox**, and it's optional on **Production**. Fastway support can give it to you.
* **Your branches' details:** Each branch's address, and its map coordinates (latitude and longitude).
* **A courier supplier and product:** Your courier must exist as a supplier in OrderEazi, with a product you charge courier costs to.
* **Permissions:** You need **View Installed Apps** and **Configure and Open Installed Apps**, in the **App Gallery** permission group. See [App Gallery](/central/apps/app-gallery.md).

### How to set up Fastway

> **Warning:** On **Production**, every booking is a real consignment, billed to your Fastway account. Test on **Sandbox** first.

1. In the main menu, select **Apps**.
2. If **Installed Apps** opens, select **View Gallery**.
3. Find **Fastway Courier App**, and select **Install**.
4. On **Installed Apps**, select **Open** on **Fastway Courier App**.
5. Under **Fastway Account**, choose the **Environment**: **Sandbox** for testing, or **Production**.
6. Enter your **API Key**.
7. Enter your **Account Id**.
8. Choose your **Parcel Packaging**.
9. Choose your **OrderEazi Supplier**.
10. Choose your **OrderEazi Product**.
11. Select **Save**.

From then on, Fastway appears in **Get Courier Quote** on your projects. Once saved, the key isn't shown again, and a label shows **Captured** or **Not captured**. Leave the box blank to keep the saved key.

With the **OrderEazi Supplier** and **OrderEazi Product** set, **Add Customer Charge** on the shipment adds the courier cost to the project. Without them, the shipment shows **Courier supplier not linked**. See [Expenses, discounts, and shipments](/central/order-management/projects/expenses-discounts-and-shipments.md).

### How Parcel Packaging prices parcels

**Parcel Packaging** sets how Fastway prices every parcel on every quote and consignment. With **Box**, the default, each parcel is priced on its own size and weight. With **A5**, **A4**, **A3**, or **A2 Satchel**, every parcel is priced as that satchel.

Fastway charges on whichever is greater: the actual weight, or the volumetric weight (length × width × height in centimetres, divided by 5000). Each parcel can weigh up to 30 kg.

### How to add your collection locations

Fastway collects from your own branches, set up on the app's **Locations** tab. The **From** address on the **Addresses** step of **Get Courier Quote** isn't where Fastway collects.

1. On the app's **Locations** tab, add a location for each branch.
2. Enter its name, company name, and street address.
3. Enter its latitude and longitude.
4. Add a contact person and collection instructions, if you have them.
5. Tick **Active**.
6. Select **Save**.

The coordinates aren't looked up for you, and they decide which branch is closest, so they need to be accurate. To find them, right-click the branch on an online map and copy the pair it shows, latitude first. If a location has no contact, the project's sales rep is used.

A location can be a child of a parent branch, such as a "Tokai" store under a "Bellville (Head Office)" branch. A child location's consignments are collected from its parent. Child locations are one level deep, and each belongs to one parent.

### How Fastway works

* **Choosing a branch:** If your branch or organisation name matches a location's name, that location is used, or its parent if it's a child. Otherwise, the active location with the shortest driving time to the delivery address is used.
* **Rates:** You get a rate for each service level Fastway offers on the route, excluding VAT, with its collection date and delivery window. The branch is kept with the rate, so you're collected from where you were quoted for.
* **Booking:** Fastway returns a waybill number, which appears on the project's **Shipments** tab. Each parcel's label number is added to the project's history, so your client can track it on Fastway's website.
* **Labels:** Select **View Labels** on the shipment to print them.

Your client's order number is sent as the customer reference.

**Example:** Your head office is in Bellville, with a store in Tokai. A project for a client in Stellenbosch is collected from Bellville, the closest active branch. Fastway returns two rates, you book the cheaper one, and the label numbers appear on the project's history.

### How to turn on automatic booking

1. Open **Fastway Courier App** from **Installed Apps**, as in the setup steps.
2. Under **Automatic Shipment Creation**, tick the checkbox.
3. Choose a **Default Service Level**: **\[LOC] Standard Economy Local Parcel**, **\[SAT] Standard Economy Local Main Centre A5 - A2 Satchels**, or **\[LMC] Standard Economy Local Main Centre**.
4. Select **Save**.

From then on, **Auto consign**, **Auto Consign Shipment** in the Fulfillment Manager, and a completed **ReadyForDelivery** step all book this service level. If Fastway doesn't offer it on a route, nothing is booked. See [Couriers](/central/apps/couriers.md).

### What the Fastway app does not do

* **Track consignments:** Status updates and proof of delivery aren't received after booking.
* **Use PUDO lockers:** Only door-to-door consignments are offered.
* **Package parcels differently:** One **Parcel Packaging** setting applies to every parcel.

### Related pages

* [Couriers](/central/apps/couriers.md): how courier apps work in OrderEazi
* [Getting a courier quote](/central/order-management/projects/getting-a-courier-quote.md): get rates and book from a project
* [Box Dimensions](/central/order-management/settings/box-dimensions.md): set up the boxes you pack in
