Route Dispatching — Overview

Route Dispatching lets you build delivery routes from orders, assign drivers and dispatchers, and optimize stop order using an interactive map.

Key Concepts

• Route — A delivery route with a date, driver, vehicle, and list of stops.
• Stop — A delivery address on a route. Stops are linked to orders by their order UUID.
• Pending Orders — Orders with shipping addresses that haven't been assigned to a route yet.
• Optimization — Automatic reordering of stops to minimize total distance or time.

Prerequisites

Route Dispatching must be enabled in two places before it can be used. See Route Dispatching — Settings for the full step-by-step walkthrough:

1. Menu Manager — Add a menu item with router link route-dispatch so users can access the Route Dispatch screen.
2. Function Groups — Add the Create Waypoint button (assignToRoute) to your order screen function group so orders can be assigned to routes from the POS.

Route Statuses

Status	Meaning
Building	Route is open, stops can be added or reordered.
Ready	Route is ready to drive. Toggle "Ready to Drive" to set this status.
Completed	Route has been closed with a completion date.

Stop Statuses

Status	Meaning
Pending	Stop is on the route but hasn't been started.
En Route	Driver is heading to this stop.
Delivered	Delivery confirmed.
Failed / Attempted	Delivery could not be completed.

Workflow Overview

1. Create a new route or let a pending order auto-create one via drag-and-drop.
2. Assign stops to routes by dragging pending orders onto a route, or by adding them manually.
3. Open route details to view the map, reorder stops, and optimize the route.
4. Toggle Ready to Drive when the route is finalized.
5. Close the route when all deliveries are complete.

See Managing Routes for route creation and assignment workflows, and Route Details for map-based stop management and optimization.