> 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/parcel-perfect.md).

# Parcel Perfect

Get rates and book waybills with a courier that runs on Parcel Perfect, and see its tracking events on your OrderEazi projects.

When your courier runs on Parcel Perfect, booking in its system and copying each waybill number back takes time. The Parcel Perfect courier app (**Parcel Perfect Courier App** in the App Gallery) connects OrderEazi Central to your courier's Parcel Perfect system. You get its rates, book waybills from the project, and see its tracking events on the project's history.

### Before you start

You'll need:

* **Your courier's Parcel Perfect details:** Your courier gives you two web addresses and three logins. Ecommerce is for rates and bookings, Tracking is for proof of delivery, and Integration is for automatic booking. Each login has a username, password, and customer code.
* **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 Parcel Perfect

> **Warning:** Every booking goes to your courier's live system, unless your courier gave you test addresses.

1. In the main menu, select **Apps**.
2. If **Installed Apps** opens, select **View Gallery**.
3. Find **Parcel Perfect Courier App**, and select **Install**.
4. On **Installed Apps**, select **Open** on **Parcel Perfect Courier App**.
5. Under **ParcelPerfect Courier Authentication**, enter the **Ecom API Base URL** and **Integration API Base URL** from your courier.
6. Enter the **Ecommerce API Username**, **Ecommerce API Password**, and **Ecommerce API Customer Code**.
7. Enter the **Tracking API Username**, **Tracking API Password**, and **Tracking API Customer Code**.
8. Enter the **Integration API Username**, **Integration API Password**, and **Integration API Customer Code**.
9. Choose your **OrderEazi Supplier**.
10. Choose your **OrderEazi Product**.
11. Copy the **Tracking Url**.
12. Select **Save**.

From then on, your courier appears in **Get Courier Quote** on your projects. Give the Tracking Url to your Parcel Perfect contact. Until your courier has set it up, tracking events don't reach OrderEazi.

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).

**Optional settings:**

* **Applicable Workflows:** Choose the workflows whose projects can use this courier. With none chosen, every workflow can.
* **Additional Delivery Instructions:** Enter instructions to send on every waybill, separated by commas, up to 512 characters.

### How Parcel Perfect works

* **Rates:** You get a rate for each service your courier offers on the route. Parcel Perfect only gives a due date, so the collection date and delivery window show that date.
* **Booking:** The courier returns a waybill number, which appears on the project's **Shipments** tab. Select **View Waybill** on the shipment to open it.
* **Tracking:** Each tracking event your courier sends is added to the project's history, as "Tracking information received: \[code] - \[event] - \[date] \[time]", with the event's details in place of the placeholders.
* **Proof of delivery:** When your courier scans the proof of delivery, the image is added to the project's attachments.

**Example:** You book PRO001234 with your courier's overnight service, and the waybill appears on the **Shipments** tab. Over the next day, the project's history shows each event, such as collected and out for delivery. When the courier scans the signed waybill, the image appears in the project's attachments.

### How to turn on automatic booking

1. Open **Parcel Perfect Courier App** from **Installed Apps**, as in the setup steps.
2. Under **Automatic Shipment Creation**, tick the checkbox.
3. Enter a **Default Service Level**, using a service code your courier gives you.
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. See [Couriers](/central/apps/couriers.md).

To collect automatic bookings from a different address, fill in **Address 1**, **Address 2**, **Suburb**, **City**, and **Postal Code** under **Automatic Shipment Creation - Origin Address Override**. It's only used when **Address 1** is filled in.

### When a booking fails

* **"Invalid workflow for tenant":** The project's workflow isn't one of your **Applicable Workflows**. Add it, or clear the list.
* **"Ecom API Base URL is not configured for this tenant.":** Enter the **Ecom API Base URL** from your courier, and save.

### What the Parcel Perfect app does not do

* **Cancel a booking:** Deleting the shipment doesn't cancel it with your courier, and the shipment stays on the **Shipments** tab. You see "Shipment for \[waybill] could not be deleted.", with the waybill number in place of \[waybill]. Contact your courier to cancel.
* **Print labels or show View POD:** The shipment has **View Waybill** only.
* **Return documents for automatic bookings:** An automatic booking returns the waybill number only, without the waybill document.

### 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
* [Project History](/central/order-management/projects/project-history.md): see your courier's tracking events