> For the complete documentation index, see [llms.txt](https://ezom.gitbook.io/ezom-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ezom.gitbook.io/ezom-docs/our-features/outbound-consignment-management/shipping-couriers-selector.md).

# Shipping courier selector

## Overview

The Shipping couriers Selector automatically displays available shipping options with real-time rates when creating or editing shipments. This component integrates seamlessly within the shipment form to provide instant rate comparison from multiple courier providers.

## How to Use

### 1️⃣ Initial State - Incomplete Information

<figure><img src="/files/1ITICJ3j7ufcMatjX1h9" alt=""><figcaption></figcaption></figure>

When shipment information is incomplete, the selector displays:

* Information message: "Please fill in sender/receiver addresses and package weight to see available courier options."
* Disabled state with no interactive elements

**Required information includes:**

* Service provider selection
* Pickup address with postal code
* Delivery address with city and postal code
* Package weight, length, dimensions, quantity, and commodity

### 2️⃣ Loading State - Fetching Rates

<figure><img src="/files/PP8ewHS2Cl7kgcxhfUfp" alt=""><figcaption></figcaption></figure>

Once all required fields are complete:

* Loading spinner appears
* **Loading courier options...** message displayed
* The system queries each courier API at the same time

### 3️⃣ Active State - Available Options

<figure><img src="/files/pr73PMdPELNTR2t6bwGO" alt=""><figcaption></figcaption></figure>

When rates are successfully retrieved, the selector shows:

* List of available courier services with logos
* Real-time shipping costs in selected currency
* Estimated delivery time (business days)
* **Most Affordable** badge on cheapest option
* Interactive cards for selection

### 4️⃣ Select Shipping couriers

<figure><img src="/files/sFf0Wtesoec1gNrEnZfz" alt=""><figcaption></figcaption></figure>

* Click on your preferred shipping option
* Selected option will be highlighted with colored border
* Selection persists while editing other form fields
* Continue with shipment creation or update

## Supported Couriers

* Australia Post
* Border Express
* Allied Express
* Blue Star
* Bonds
* XFM
* And more...

## Key Features

✅ **Conditional Display**: Only appears when required information is complete\
✅ **Real-time Rates**: Live pricing from multiple carriers\
✅ **Smart Recommendations**: Automatic identification of most affordable option\
✅ **Instant Updates**: Rates refresh when shipment details change\
✅ **Error Handling**: Clear messages for unavailable services

{% hint style="info" %}
The selector automatically activates once all required shipment details are complete and valid. Any changes to addresses or package details will trigger a fresh rate lookup.
{% endhint %}

{% hint style="info" %}
**Warning**: Ensure that all address fields are accurate. Incorrect or incomplete information may result in no available courier options or inaccurate pricing.
{% endhint %}