> ## Documentation Index
> Fetch the complete documentation index at: https://localtechnologiesinc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Delivery routes and your own drivers

> Add your vehicles, plan each day's stops across your vans, follow your drivers on a live map and tick off deliveries.

If you deliver orders yourself, **Orders → Delivery routes** plans the day for you. It shares the day's stops between your vehicles, puts each van's stops in a good driving order, and shows where your drivers are. Your drivers follow the route, stop by stop, in the Local Pass app.

> [!NOTE]
>
> Delivery routes is for shops, grocers, butchers, bakeries and farms that deliver their own orders. Restaurants don't have it.

Three kinds of order show up on their delivery day:

* Shop orders you deliver yourself
* Wholesale deliveries from your order sheets
* CSA boxes going to members' homes

## 1. Add your vehicles

Go to **Settings → Fulfillment Settings → Delivery Settings**. Under **Your vehicles**, press **Add a vehicle**. You can also press **Vehicles** at the top of the Delivery routes page. You can add up to 10 vehicles.

1. Under **What kind of vehicle is it?**, pick **Car or SUV**, **Cargo van**, **Refrigerated van**, **Pickup truck** or **Box truck**. This fills in the details below. You can change any of them.
2. Give it a **Name**. The **Plate** is optional.
3. Under **What it carries**, set the **Weight** and the **Bins or crates** it holds. Leave either empty for no limit.
4. Turn on **Refrigerated** if it has a fridge. Frozen orders go only on refrigerated vehicles, and keep-cold orders go there when there's room.
5. Set where it **Starts from** and **Finishes at**: **Your store** or **Another address**.
6. Under **When it drives**, set when it **Starts** and **Finishes**. You can add a **Lunch break**.
7. Press **Add vehicle**.

Under **More options** you'll find **Most hours on the road**, **Roads to avoid** (**Ferries**, **Highways**, **Tolls**), **Time at each stop**, **How fast it drives** and **Running costs**. Rough numbers are fine.

> [!TIP]
>
> Your store needs a map pin, or the plan doesn't know where your vans start. If the page says your store has no map pin, set your address in **Store Settings**, or give the vehicle a start address.

### Planning rules

Below your vehicles, **Planning rules** sets what the plan aims for:

* **Keep-cold orders, without a fridge van**, **Frozen orders, without a fridge van** and **Fresh orders**: how many minutes after the van starts they should be delivered.
* **Home deliveries by**: shop orders and farm boxes aim to arrive by this time. A stop that can't make it is still delivered.
* **Finish deliveries by**: each van aims to be done and back by this time. With two or more vans, the work spreads to another van when one would run late.
* **Most stops per van** (two or more vans): no van gets more stops than this in a day. Leave it empty for no limit.
* **Plan with typical traffic** and **Plan for the weather**: switch each on or off.

On the Delivery routes page, **How stops are assigned** explains every rule the plan follows, in plain words.

## 2. Plan a day

Open **Orders → Delivery routes**. Pick the day with the arrows or the date. **Day** shows one day. **Month** shows the whole month, with each day marked **Planned**, **To plan** or **Delivered**.

Under the day, a strip shows this week and how many stops each day has. A weather line shows the forecast the plan uses.

To plan the day, press the plan button in the card beside the map. It's named for the day, for example **Plan today** or **Plan Wed, Oct 21**. It shares the stops between all your vans and puts each van's stops in order. It takes about half a minute.

* Cold and frozen orders go on refrigerated vans first. A van with no fridge says so, for example "No fridge on this van: pack cold stops in a cooler."
* Wholesale stops arrive within their receiving hours.
* CSA boxes arrive within the delivery window you promised your members.
* Each planned route says when to leave, with **Leave by**.

You can plan any day from today on, and plan again whenever something changes. On the day itself, planning again keeps the stops already delivered.

> [!NOTE]
>
> Each store has a daily limit for planning. If you reach it, planning opens again the next day.

If you see **Route planning isn't switched on yet**, Local Pass needs to turn it on for your store. Message us. Until then, **List by street** puts a van's stops in order town by town, then by street, with no times.

### One van at a time

Press a van's card to open its route below the map. From there:

* **Plan this van** (or **Plan this van again**) plans that van on its own, with the same rules.
* **List by street** orders its stops by town and street, with no times.
* **Print** prints the route and the van's load list.

### Change the order by hand

Drag a stop, or use its up and down arrows. Times after a moved stop are cleared until you plan again.

### Put an order on a different van

Every stop has **Put on van ▾**. Pick a van. If it goes against your settings, for example the van has no fridge or is over its weight, you're told and asked first. The order stays on that van for the day, even when you plan again, until you unpin it. The order itself doesn't change.

### Orders not on a route

Beside the route, **Not on a route** lists the day's deliveries that no van is taking yet:

* **Not planned yet**: plan the day (or a van) again to add them, or put one on a van yourself.
* **Didn't fit**: left out when a route was planned, with the reason.
* **Can't go yet**: something needs sorting first. The reason is under each one.

### Load list

Each route has a load list: what to put on the van for the stops not delivered yet, coldest first (frozen, cold, fresh, then room temperature), with stop numbers.

> [!NOTE]
>
> If the plan card says orders still need to be marked **Ready**, the customer's card isn't charged yet. Press **Open orders** to find them, and mark each one Ready before it leaves.

## 3. Add your drivers

Your own drivers see your routes in the Local Pass app on their phone. They aren't Local Pass couriers: they never see courier offers, shifts or earnings.

> [!WARNING]
>
> Store routes need the Local Pass app on an **iPhone** for now. Android is coming soon.

On **Delivery Settings**, under **Driver Fleet**:

1. Under **Your driver code**, press **Make a code**. Copy it and give it to your drivers.
2. Or press **Invite a driver**. Enter their **First name** (optional) and their **Email or mobile number**, then **Send invite**. You can also **Copy invite** and send it yourself.

**What the driver gets:** a text or email from Local Pass that says "Drive for *your store* with the Local Pass app", with three steps:

1. Install Local Pass on their iPhone.
2. Sign in or create an account. It should be one that doesn't drive for Local Pass as a courier.
3. Open **Settings**, tap **Driving for a store? Enter its code**, and enter your code.

After that, the app opens today's route. They follow it stop by stop and mark each order delivered.

Drivers show under **Your drivers** once they enter your code. To remove one, press **Remove**. Your driver code changes too, so they can't join again with the old one. Drivers still on your list stay linked. **Make a new code** also stops the old code, and linked drivers stay linked.

### Give a van its driver

Once a day is planned, each van card has **Driver: ▾**. Pick one of your drivers, or **Nobody**. It saves at once. If a van has no route yet, plan the day first.

### Drivers without the app

On a route, **Send to driver** copies a message with your driver code, ready to paste in a text. **Open route in Google Maps** opens the remaining stops in Google Maps. A long route opens in parts. You can also **Print** the route.

## 4. Follow the day

On today, the map is **Live**. It shows each van's position, its planned line and its stops. Each van card shows who's driving and how far along they are. When a driver presses Start in the app, the card shows when they started. The stop they're heading to gets a ring on the map and says **Van heading here now**.

Each stop has **Directions**, **Call** and **Mark delivered**. Marking a stop delivered completes the order (a CSA box is marked collected). You're asked first, and you can't undo it from this page. When a driver marks a stop delivered in the app, it shows here straight away.

### Tell customers their delivery is on the way

On **Delivery Settings**, under **Driver Fleet**, **Tell customers when their delivery is on the way** is on unless you turn it off.

**What the customer gets:**

* When your driver starts the route, a heads-up with an arrival window.
* When the driver heads to their stop, a "you're next" message.

We send a push notification if they have the Local Pass app. Otherwise we send a text, or an email for the heads-up. Each stop on your route shows which messages its customer got, for example "Told: on the way 8:02 am · you're next 10:31 am".

## Related

* [Delivery settings](https://localtechnologiesinc.mintlify.site/restaurants/order-fulfillment/delivery-settings.md): the area, fees and days for shop delivery
* [Order Sheet Creator](https://localtechnologiesinc.mintlify.site/merchants/order-sheet.md): wholesale orders


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.