> For the complete documentation index, see [llms.txt](https://help.supplyd.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.supplyd.co/supplyd-erp/deliveries/creating-a-delivery.md).
# Creating a Delivery
Creating deliveries in the optional Delivery module in Supply’d allows you to efficiently plan, organise, and manage the movement of orders to your customers. By setting up deliveries within the system, you can assign orders, allocate vehicles and drivers, schedule routes, and track each delivery from start to finish. This helps reduce errors, improve customer service, and ensures your team has a clear, streamlined process for getting orders out on time.
{% hint style="success" %}
👉 For details on managing your deliveries once they have been set up, see the [Managing Deliveries](/supplyd-erp/deliveries/managing-deliveries.md) document.
{% endhint %}
This document will guide you through:
* [#the-deliveries-page](#the-deliveries-page "mention")
* [#the-steps-to-creating-a-delivery](#the-steps-to-creating-a-delivery "mention")
* [#creating-the-delivery](#creating-the-delivery "mention")
* [#editing-and-adding-delivery-runs](#editing-and-adding-delivery-runs "mention")
* [#assigning-orders-to-a-delivery](#assigning-orders-to-a-delivery "mention")
* [#optimising-the-route](#optimising-the-route "mention")
***
## The Deliveries Page
Selecting **Deliveries** from the main menu opens the **Deliveries** page, which lists all deliveries you have created.
* The **Up Next** tab shows upcoming deliveries.
* The **Completed** tab shows deliveries that have already been completed.
This is also create where you create a new delivery.
{% hint style="success" %}
Each delivery’s status is colour-coded for quick and easy identification.
* - The delivery has been created but is still in setup mode. Orders, vehicles, or drivers may not yet be assigned.
* - The delivery run has been created but not yet started. Orders are assigned and waiting to be dispatched.
* - The delivery run is currently underway. Orders are being delivered, and progress is actively tracked.
* - The delivery run is finished. All orders have been delivered or marked according to their final outcome. Any completed deliveries will appear under the **Completed** tab.
{% endhint %}
***
## The Steps to Creating a Delivery
1. [#creating-the-delivery](#creating-the-delivery "mention")
2. [#editing-and-adding-delivery-runs](#editing-and-adding-delivery-runs "mention")
3. [#assigning-orders-to-a-delivery](#assigning-orders-to-a-delivery "mention")
4. [#optimising-the-route](#optimising-the-route "mention")
***
## Creating the Delivery
{% hint style="warning" %}
Before creating a **Delivery**, you should have added your vehicles and applied their details in your **Delivery Settings**.
👉 See the [Delivery Settings](/supplyd-erp/settings/delivery-settings.md#the-vehicles-tab) [Delivery Settings](/supplyd-erp/settings/delivery-settings.md) section of the [Delivery Settings](/supplyd-erp/settings/delivery-settings.md) document for instructions on how to do this.
{% endhint %}
{% stepper %}
{% step %}
#### Go to the Delivery Page
Select **Deliveries** from the main menu. The **Deliveries** page will open, listing all upcoming and in-progress deliveries.
***
{% endstep %}
{% step %}
#### Click Add+
Click on **Add +** in the top right corner.
The **Create Delivery Run** form will open
{% hint style="success" %}
To open or close the sections on this form click the little arrows to the right of the titles (as circled in red above).
{% endhint %}
Complete the sections as per the guidelines below:
***
{% endstep %}
{% step %}
#### Delivery Details
**Delivery Date & Start Time\* \[required field]**
Select the delivery start date and time from the calendar and clock that will show when you click on the field. Click to set the date and time.
**Maximum Delivery Time (Hours)\* \[required field]**
Enter the maximum time allowed for each delivery.
**Location\* \[required field]**
Select the location this vehicle is used from your list of [Locations](/supplyd-erp/settings/locations.md) in the drop-down menu.
**Vehicle\* \[required field]**
Select one or more vehicles for the delivery. Click the field to view and choose from your vehicle list.
{% hint style="success" %}
To remove a vehicle, simply click the **X** next to its name.\
{% endhint %}
***
{% endstep %}
{% step %}
#### Order Allocation
This section defines how orders are allocated to this delivery.
**Allocate Orders**
Choose how orders should be allocated to this delivery.
* **Auto-assign:** Have orders automatically assigned based your chosen criteria.
* **Manually:** Manually assign orders to the delivery after it has been created.
**Order Selection**
Choose how you’d like orders to be allocated to this delivery.
* **Picked Orders:** Assign all orders that have been picked but not yet delivered.
* **Unfulfilled Orders:** Assign all orders that have not yet been fulfilled.
**Include Shipping Zones**
When filtering by Shipping Zones, select whether to include or exclude them.
* **Include:** Include the list of shipping zones related orders.
* **Exclude:** Exclude the list of shipping zones related orders.
**Shipping Zones**
Select the [Shipping Settings](/supplyd-erp/settings/shipping-settings.md#shipping-zones) to include or exclude orders allocated to these zones for the delivery.
Leave blank for all shipping zones.
**Include Shipping Rules**
When filtering by **Shipping Rules**, select whether you would like to include or exclude them.
* **Include:** Include the list of shipping rules related orders.
* **Exclude:** Exclude the list of shipping rules related orders.
**Shipping Rules**
Select the [Shipping Settings](/supplyd-erp/settings/shipping-settings.md#shipping-rules) to include or exclude orders allocated to these rules for the delivery.
Leave blank for all shipping rules.
**Delivery Dates**
Select the delivery dates to assign to this delivery run.
Leave blank for all delivery dates.
Click to set the dates.
**Order Limit**
Enter a limit for the number of orders automatically allocated to the delivery. Maximum 2,000 orders.
***
{% endstep %}
{% step %}
#### Click Create
Click to finish creating the **Delivery**.
{% endstep %}
{% endstepper %}
***
## Editing & Adding Delivery Runs
A delivery may consist of multiple **Delivery Runs**, using multiple vehicles and drivers. Once the delivery is set up and orders are assigned, you can optionally edit runs to assign one or more drivers, change the vehicle for each delivery run, and update the start and end locations or add runs.
{% hint style="info" %}
If **Auto-Assign** was selected under **Allocate Orders** when creating the delivery (see step 4 above) orders will be auto-assigned in the background. You may navigate away from the page, or refresh to see if they have finished being assigned.
{% endhint %}
{% stepper %}
{% step %}
#### Select the Delivery
After clicking , the delivery details will appear. If not, select the delivery from the **Deliveries** list.
***
{% endstep %}
{% step %}
#### Go to the Runs Tab
Go to the **Runs** tab. Here you’ll see the runs created for this delivery, including the **Run Number**, delivery **Date**, assigned **Vehicle** and **Driver**, and how many orders have been **Delivered** (which will be 0 at this stage).
***
{% endstep %}
{% step %}
#### Select Edit Run or Click Add+
#### Editing Runs
To edit an existing run, click on the run to open its details. Then, click the 3 dots in the top right and select **Edit Run** from the menu.
The **Edit Delivery Run** form will open and you can make changes by following the steps outlined below.
#### Adding Runs
If you would like to add a run to a delivery, click **Add +** in the top right.
The **Add Delivery Run** form will open.
The fields are identical in both the **Add Delivery Run** and **Edit Delivery Run** forms.
Complete/update the fields in each section as outlined below:
***
{% endstep %}
{% step %}
#### Delivery Run Details
**Vehicle\* \[required field]**
The vehicle used for this delivery run.
{% hint style="warning" %}
This is initially set when creating the run but can be updated if needed. If changing to a smaller vehicle please beware of capacity differences before changing the vehicle.
{% endhint %}
**Driver**
Select the delivery driver for this **Delivery Run**.
{% hint style="warning" %}
If the driver doesn't exist in Supply'd, you will need to add them as a **User**. The [Users](/supplyd-erp/settings/users.md) document explains how to do this. Select **Delivery Driver** as the **Account Type**. This user type will gain access to the **Delivery Runs** they are assigned to.
**It’s important to assign a driver, or update the assignment if a new driver takes over, because unassigned runs won’t appear on drivers’ scanners.**
{% endhint %}
**Start Time\* \[required field]**
Enter the start time of this delivery run in 24 hour time format (HH:MM). The run must be performed within the overall delivery hours set for the main delivery.
**Maximum Delivery Time\* \[required field]**
Enter the maximum delivery time for this delivery run in hours. The run must be finished within the overall delivery hours set for the main delivery.
***
{% endstep %}
{% step %}
#### Start Location
Select the start location for the delivery run from the list of your [Locations](/supplyd-erp/settings/locations.md) or choose **Custom Address**.
If the **Start Location** is different from your list of locations (for example, if a driver wants to start their run at home), you can select **Custom Address**. When this option is chosen, additional address fields will appear for you to enter the details.
***
{% endstep %}
{% step %}
#### End Location
Select the **End Location** for the delivery run from the list of your locations, or choose **Custom Address** (as shown above for the **Start Location**).
***
{% endstep %}
{% step %}
#### Save
Click to apply your changes.
{% endstep %}
{% endstepper %}
***
## Assigning Orders to a Delivery
Supply'd will auto-assign deliveries based on certain **Shipping Zones**, **Order Status, Delivery Dates** etc. You can also manually assign orders.
{% hint style="success" %}
You can select whether to **Auto-Assign** or **Manually** assign orders when [#creating-the-delivery](#creating-the-delivery "mention") as explained above.
{% endhint %}
When **Auto-Assign** is selected, the orders will automatically be assigned. If you would like to add any orders you can follow the instructions below for manually adding orders.
### Manually Assigning Orders
To manually assign orders to a delivery:
{% stepper %}
{% step %}
#### Go to the Orders Tab
After creating the delivery and making any necessary edits to runs, go to the **Orders** tab.
{% hint style="success" %}
If orders have been Auto-Assigned they will appear under this tab.
{% endhint %}
***
{% endstep %}
{% step %}
#### Click Assign +
Click on or **Assign +** in the top right.
{% hint style="success" %}
The button will only appear if no orders have been assigned.
{% endhint %}
The **Assign Orders** page will open.
***
{% endstep %}
{% step %}
#### Select the Orders
Check the box next to each order you want to to include in the delivery.
{% hint style="info" %}
Clicking the 3 dots in the top right opens a menu with 2 options
* **Refresh:** Updates the page to show the latest information.
* **Toggle Full Screen:** Expands the page to full-screen view, providing more space to view data without distractions.
{% endhint %}
***
{% endstep %}
{% step %}
#### Click Assign
Click to add the orders to the delivery.
The orders will now appear on the list under the **Orders** tab.
{% endstep %}
{% endstepper %}
***
## Optimising the Route
Once you’re satisfied with the delivery runs and the assigned orders, you can optimise the delivery route.
Route optimising is the process of planning and arranging delivery stops in the most efficient order to save time, reduce fuel costs, and improve overall delivery speed. In Supply’d, route optimising helps streamline delivery operations by using **Supply'd Intelligence** to automatically calculate the best sequence of customer stops based on factors like distance, traffic, and delivery priorities.
To optimise the delivery, click on the 3 dots in the top right and select **Optimise Route** from the menu.
{% hint style="success" %}
Alternatively, you can click on "optimise the delivery" in the grey box.
{% endhint %}
You will be asked to confirm. Click .
**Supply'd Intelligence** will do all the hard work for you.
The delivery's status will update from to .
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.supplyd.co/supplyd-erp/deliveries/creating-a-delivery.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.