> 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/courier-guy.md).

# Courier Guy

Get Courier Guy rates, book door and PUDO locker shipments, and print labels from your OrderEazi projects with the Courier Guy app.

Booking every delivery in Courier Guy's portal, then copying the waybill back, takes time. The Courier Guy app (**Courier Guy Courier App** in the App Gallery) brings Courier Guy's rates and bookings into OrderEazi Central. It handles door deliveries and PUDO lockers (parcel lockers you drop off at or collect from).

### Before you start

You'll need:

* **A Courier Guy API key:** The key issued with your Courier Guy account. The API is the connection other systems use to exchange data with Courier Guy. The test (QA) and live systems are separate, so each has its own key.
* **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 Courier Guy

> **Warning:** On **Live**, every booking is a real shipment, billed to your Courier Guy account. New installs start on **QA**, Courier Guy's test system, so test there first.

1. In the main menu, select **Apps**.
2. If **Installed Apps** opens, select **View Gallery**.
3. Find **Courier Guy Courier App**, and select **Install**.
4. On **Installed Apps**, select **Open** on **Courier Guy Courier App**.
5. Under **Courier Guy Account**, choose the **Environment**: **QA** for testing, or **Live**.
6. Enter your **API Key** for that environment.
7. Choose your **OrderEazi Supplier**.
8. Choose your **OrderEazi Product**.
9. Copy the **Tracking Url**.
10. Select **Save**.

From then on, Courier Guy appears in **Get Courier Quote** on your projects. Add the Tracking Url in your Courier Guy account dashboard. Until you do, delivery updates don't reach OrderEazi.

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 Courier Guy works

* **Rates:** You get a rate for each service level Courier Guy offers on the route, with its collection date and delivery window. Rates exclude VAT unless you choose to include it under **Quotes**.
* **Booking:** Courier Guy returns a waybill number, which appears on the project's **Shipments** tab. Your client's order number is sent as the customer reference, and the project's delivery instructions go to the driver.
* **Waybills and labels:** Select **View Waybill** or **View Labels** on the shipment.
* **Cancelling:** Deleting the shipment from the project cancels it with Courier Guy.

### How to send to a PUDO locker

1. On the project, under **Project Actions**, select **Get Courier Quote**.
2. Pack your parcels, and select **Select couriers**.
3. On the **Delivery** step, under **Lockers**, choose Courier Guy.
4. Select **Continue**.
5. On the **Addresses** step, set the end that uses a locker to **Locker**.
6. Select **Find lockers**.
7. Choose a locker.
8. Select **Get quotes**.

You can ship door to locker, locker to door, or locker to locker. Up to 5 lockers near the address are shown, each with its address and trading hours. See [Getting a courier quote](/central/order-management/projects/getting-a-courier-quote.md).

Lockers have size limits. If a parcel is too big, Courier Guy refuses the rate and says why.

**Example:** A client on PRO001234 chooses a locker near their office. You book Courier Guy door to locker, and print the label with **View Labels**. When the client collects the parcel, the project's history shows who collected it.

### How proof of delivery reaches the project

When Courier Guy marks a shipment delivered, the project's history records the driver, the delivery location, and who received it. The proof of delivery images are added to the project's attachments. Other tracking updates aren't recorded, and the project's status doesn't change.

### How to turn on automatic booking

1. Open **Courier Guy Courier App** from **Installed Apps**, as in the setup steps.
2. Under **Automatic Shipment Creation**, tick the checkbox.
3. Choose a **Default Service Level**, such as **\[ECO] Economy**.
4. Select **Save**.

The other service levels are **\[LOF] Local Overnight Flyer**, **\[LSF] Local Sameday Flyer**, **\[LSE] Local Same Day Economy**, **\[LSX] Local Sameday Express**, and **\[OVN] Overnight**. From then on, **Auto consign**, **Auto Consign Shipment** in the Fulfillment Manager, and a completed **ReadyForDelivery** step all book this service level. If Courier Guy doesn't offer it on a route, nothing is booked. See [Couriers](/central/apps/couriers.md).

### What the Courier Guy app does not do

* **Send declared value:** Insurance isn't sent with the booking.
* **Change a booked shipment:** Delete it and book again.
* **Book a time slot:** You can't choose a collection or delivery time window.

### 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
* [Fulfillment Manager](/central/order-management/delivery/fulfillment-manager.md): book shipments for several projects