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

# ShipLogic

Get ShipLogic rates, book shipments, and receive proof of delivery on your OrderEazi projects with the ShipLogic courier app.

When your courier runs on ShipLogic, booking each delivery in its portal and copying the waybill back takes time. The ShipLogic courier app (**Ship Logic Courier App** in the App Gallery) brings ShipLogic's rates and bookings into OrderEazi Central. When a shipment is delivered, its proof of delivery is added to the project.

### Before you start

You'll need:

* **A ShipLogic API key:** The key from your ShipLogic account. The API is the connection other systems use to exchange data with ShipLogic.
* **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 ShipLogic

> **Warning:** The app always uses your live ShipLogic account, so every booking is a real shipment, billed to your ShipLogic account.

1. In the main menu, select **Apps**.
2. If **Installed Apps** opens, select **View Gallery**.
3. Find **Ship Logic Courier App**, and select **Install**.
4. On **Installed Apps**, select **Open** on **Ship Logic Courier App**.
5. Under **Ship Logic Courier API Key**, enter your **API Key**.
6. Choose your **OrderEazi Supplier**.
7. Choose your **OrderEazi Product**.
8. Copy the **Tracking Url**.
9. Select **Save**.

From then on, ShipLogic appears in **Get Courier Quote** on your projects. Add the Tracking Url in your ShipLogic account dashboard. Until you do, delivery updates 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).

### How ShipLogic works

* **Rates:** You get a rate for every service level ShipLogic offers on the route, excluding VAT, with its collection date and delivery window.
* **Booking:** ShipLogic 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.
* **Waybill:** Select **View Waybill** on the shipment to open it.
* **Cancelling:** Deleting the shipment from the project cancels it with ShipLogic.

**Example:** You request rates for PRO001234's two parcels from Johannesburg to Cape Town. ShipLogic returns Economy at R185 and Overnight at R320, and you book Economy. When ShipLogic delivers it, the project's history shows "Tracking information received from ShipLogic : delivered".

### How proof of delivery reaches the project

When ShipLogic 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, such as in transit, aren't recorded. This only works once the Tracking Url is in your ShipLogic dashboard.

### How to turn on automatic booking

1. Open **Ship Logic 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. See [Couriers](/central/apps/couriers.md).

If ShipLogic doesn't offer it on a route, nothing is booked, and you see "No rates were found for this service level \[service level]", with the service level's name in place of \[service level].

### What the ShipLogic app does not do

* **Print labels or show View POD:** The shipment has **View Waybill** only. Proof of delivery is in the project's attachments.
* **Send declared value:** Insurance isn't sent with the booking.
* **Change a booked shipment:** Delete it and book again.

### 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