| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Inventory (stock) • Invoicing (account) • Sales (sale_management) • Purchase (purchase) |
| Lines of code | 5366 |
| Technical Name |
shd_delivery_route_optimisation |
| License | OPL-1 |
| Website | https://www.shadailtech.com |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Inventory (stock) • Invoicing (account) • Sales (sale_management) • Purchase (purchase) |
| Lines of code | 5366 |
| Technical Name |
shd_delivery_route_optimisation |
| License | OPL-1 |
| Website | https://www.shadailtech.com |
|
|||||||||||||||||
|
Capacity-Based Allocation
Allocates deliveries to trucks, vans, and bikes based on weight and volume capacity limits. Auto-switches to the next available vehicle when the current one is full.
Geographic Route Grouping
Groups delivery stops geographically for efficient routing. Multi-warehouse support with nearest-warehouse assignment for each delivery zone.
Live GPS Tracking
Real-time GPS position updates from driver devices. Managers see the live vehicle location on a map widget. Full tracking history stored per route.
Google Maps & Mapbox Integration
Google Maps API as the primary map provider with Mapbox as a seamless fallback. Configurable API keys in Settings.
Driver Notifications
Automated email notifications sent to drivers when new deliveries are assigned and when routes are confirmed. No manual communication needed.
Proof of Delivery
Drivers capture proof of delivery with timestamp and GPS location. Records stored against each delivery stop for audit and dispute resolution.
Return Eligibility Checks
Evaluate return requests against configurable return windows. Links to sales orders, invoices, and delivery orders. Approve or reject with one click.
Backend & Portal Views
Full backend management for managers and a customer-facing portal view for tracking delivery status in real time.
Multi-Warehouse Support
Routes are scoped to warehouses. Nearest-warehouse assignment ensures deliveries are dispatched from the most efficient origin point.
Supported Vehicle Types
Truck
High capacity — heavy loads and bulk deliveries
Van
Medium capacity — standard parcel deliveries
Bike
Low weight — last-mile urban deliveries
Motorcycle
Fast & agile — express and small parcels
Route Lifecycle
Install the Module
Go to Apps, search for SHD Delivery Route Optimisation, and click Install. Standard dependencies (stock, sale_stock, purchase_stock, delivery, mail, portal) are installed automatically.
-
Configure API Keys
Configure the API configuration for the google map api or mapbox api key. Go to Settings → Delivery Route section:
- Google Maps API Key — Primary map provider. Obtain from Google Cloud Console with Maps JavaScript API and Directions API enabled.
- Mapbox API Key — Fallback provider. Obtain from mapbox.com. Optional if Google Maps is configured.
- Return Window Days — Default number of days within which returns are accepted (default 30).
-
Create Delivery Resources (Vehicles)
Create Vehicle and drivers information which can be used in assigning confirmed deliveries. 
Vehicle status display screen. Go to Delivery Routes → Configuration → Vehicles → New.
Field Description Vehicle Name Display name (e.g. "Van 01 — Mumbai") Vehicle Type Truck / Van / Bike / Motorcycle License Plate Must be unique across all vehicles Assigned Driver Internal Odoo user (not portal) — receives notifications Base Warehouse Origin warehouse for routes assigned to this vehicle Max Weight (kg) Maximum payload weight. Route allocation respects this limit. Max Volume (m³) Maximum payload volume. Auto-switch triggers when exceeded. Assign Deliveries to a Route
Open confirmed stock picking (delivery) records. Use the Assign to Route wizard to allocate them to a vehicle route. The wizard respects weight/volume limits and auto-switches vehicles when full.
Confirm and Dispatch Routes
Go to Delivery Routes → Routes. Open a draft route and click Confirm. The driver receives an email notification with their assigned stops.
Configure Return Eligibility Window
Go to Settings → Delivery Route → Return Window Days. Set the default return window. Individual return checks can override this per request.
Receiving a Route Assignment
When a manager confirms a route, you will receive an automated email notification listing your assigned delivery stops for the day. The notification includes the planned date, number of stops, and a link to your route in the Odoo portal.
Starting Your Route
Log in to the Odoo Portal
Open your browser and log in to
/webor use the Odoo mobile app. Navigate to Delivery Routes in the portal menu.Open Your Assigned Route
Your active route appears at the top. Review all stops and their sequence before departing from the warehouse.
Click Start Route
This transitions the route to In Progress and begins GPS tracking. Your location is updated in real time and visible to your manager.
Completing Each Delivery Stop
Navigate to the Stop
Click the Open in Maps button on the stop to open Google Maps / Mapbox navigation to the delivery address.
Deliver and Capture Proof
Hand over the goods and click Mark as Delivered. The system records the timestamp and your current GPS coordinates as proof of delivery.
Handle Non-Delivery
If the customer is unavailable or refuses delivery, select the appropriate reason and click Mark as Failed. The manager will be notified immediately.
Completing Your Route
Once all stops are processed, click Complete Route. The route transitions to Done state and GPS tracking stops. Your completion time is recorded automatically.
Vehicle Status Actions
| Action | When to use |
|---|---|
| Set Available | When returning from a route and the vehicle is ready for new assignments |
| Set Maintenance | When the vehicle requires servicing — removes it from allocation |
Route Management Overview
Live GPS Tracking
Go to Delivery Routes → Live Tracking to see the real-time map view showing all active vehicles. The map widget refreshes automatically and shows the last known position, vehicle type, driver name, and active route for each vehicle.
Route Performance & Analytics
| Metric | Where to find it |
|---|---|
| Total routes per vehicle | Vehicle form → Statistics section |
| Completed routes | Vehicle form → Completed Routes count |
| Total deliveries handled | Vehicle form → Total Deliveries |
| Route duration | Route form → Date Started / Date Completed |
| Tracking history | Route form → Tracking tab (all GPS pings) |
Return Eligibility Management
Go to Delivery Routes → Returns to manage return requests.
Create a Return Check
Click New. Link to the delivery order (stock.picking), sale order, or invoice. Set the customer and delivery date.
Check Eligibility
Click Check Eligibility. The system evaluates: return window (configurable days), delivery completion status, and invoice payment state. Result is Eligible or Not Eligible with reasons.
Approve or Reject
For eligible returns, click Approve Return — a return stock picking is created automatically. For rejections, click Reject Return with review notes.
Return Reasons
| Reason | Description |
|---|---|
| Damaged / Defective | Item arrived in unusable condition |
| Wrong Item Delivered | Customer received incorrect product |
| Not Delivered | Delivery marked done but customer disputes receipt |
| Customer Refusal | Customer refused delivery at the door |
| Other | Reason captured in notes field |
Vehicle Status Overview
| Status | Meaning | Available for Allocation? |
|---|---|---|
| Available | Vehicle is ready for new route assignments | ✅ Yes |
| On Route | Vehicle is currently on an active delivery route | ⚠️ Limited |
| Maintenance | Vehicle is undergoing servicing or repair | ❌ No |
| Inactive | Vehicle is retired or permanently out of service | ❌ No |
Need Custom Delivery Logic or Map Integrations?
Shadail Technology can extend this module with custom routing algorithms, third-party logistics APIs, or custom portal views.
Contact UsSHD Delivery Route Optimisation
| Module: | shd_delivery_route_optimisation |
|---|---|
| Version: | 19.0.1.0.1 |
| Author: | Shadail Technology |
| License: | OPL-1 |
| Category: | Inventory / Delivery |
Overview
Outbound delivery route optimisation for Odoo 19 with capacity-based vehicle allocation, live GPS tracking, Google Maps / Mapbox integration, proof of delivery, and return eligibility management.
Key Features
- Capacity-based allocation — Allocates deliveries to trucks, vans, and bikes based on weight and volume limits. Auto-switches to the next available vehicle when the current one is full.
- Geographic route grouping — Groups stops geographically for efficient routing. Multi-warehouse support with nearest-warehouse assignment.
- Live GPS tracking — Real-time driver location visible to managers on a map widget. Full tracking history stored per route.
- Google Maps & Mapbox integration — Google Maps API as primary provider, Mapbox as seamless fallback. API keys configurable in Settings.
- Driver notifications — Automated email notifications when routes are assigned and confirmed.
- Proof of delivery — Timestamp and GPS coordinates captured at each stop.
- Return eligibility checks — Configurable return window with one-click approve/reject and automatic return picking creation.
- Backend & portal views — Full backend management and a customer-facing portal for real-time delivery status tracking.
Supported Vehicle Types
| Type | Description |
|---|---|
| Truck | High capacity — heavy loads and bulk deliveries |
| Van | Medium capacity — standard parcel deliveries |
| Bike | Low weight — last-mile urban deliveries |
| Moto | Fast and agile — express and small parcels |
Route Lifecycle
Draft → Confirmed → In Progress → Done
└──────→ Cancelled
Dependencies
- stock
- sale_stock
- purchase_stock
- delivery
- portal
- web
- base_setup
- sale_management
- account
Installation
- Copy the module folder to your Odoo addons path.
- Restart the Odoo server.
- Go to Apps, search for SHD Delivery Route Optimisation, and click Install.
Configuration
API Keys
Navigate to Settings → Delivery Route:
- Google Maps API Key — Obtain from Google Cloud Console with Maps JavaScript API and Directions API enabled.
- Mapbox API Key — Obtain from mapbox.com. Used as fallback if Google Maps is unavailable.
- Return Window Days — Default number of days within which returns are accepted (default: 30).
Delivery Resources (Vehicles)
Go to Delivery Routes → Configuration → Vehicles → New:
| Field | Description |
|---|---|
| Vehicle Name | Display name, e.g. Van 01 — Mumbai |
| Vehicle Type | Truck / Van / Bike / Motorcycle |
| License Plate | Must be unique across all vehicles |
| Assigned Driver | Internal Odoo user — receives email notifications |
| Base Warehouse | Origin warehouse for routes from this vehicle |
| Max Weight (kg) | Maximum payload weight for allocation |
| Max Volume (m³) | Maximum payload volume; triggers auto-switch |
Usage
Assigning Deliveries
- Open confirmed stock picking (delivery) records.
- Use the Assign to Route wizard.
- The wizard allocates stops to vehicles respecting weight/volume limits and auto-switches vehicles when capacity is exceeded.
Confirming and Dispatching Routes
- Go to Delivery Routes → Routes.
- Open a draft route and click Confirm.
- The assigned driver receives an email notification.
Live Tracking
Go to Delivery Routes → Live Tracking to monitor all active vehicles on the map. The widget auto-refreshes and shows each vehicle's last known position, driver, and active route.
Managing Returns
Go to Delivery Routes → Returns:
- Click New and link to the delivery order, sale order, or invoice.
- Click Check Eligibility — the system evaluates the return window, delivery completion, and invoice payment state.
- Click Approve Return (creates return picking) or Reject Return.
Return Reasons
| Reason | Description |
|---|---|
| Damaged / Defective | Item arrived in unusable condition |
| Wrong Item Delivered | Customer received incorrect product |
| Not Delivered | Customer disputes receipt |
| Customer Refusal | Customer refused delivery at the door |
| Other | Free-text reason in notes field |
Technical Reference
Models
- delivery.resource
- Represents a delivery vehicle with capacity limits and driver assignment.
- delivery.route
- A route grouping multiple delivery line stops for one vehicle.
- delivery.route.line
- An individual delivery stop (linked to stock.picking).
- delivery.tracking
- GPS ping record for a route (latitude, longitude, timestamp).
- delivery.return.check
- Return eligibility record linked to a delivery, sale order, or invoice.
Controllers
- /delivery/tracking/<int:route_id>
- Portal endpoint for live route tracking.
- /delivery/update-location
- JSON endpoint called by the driver's browser to push GPS coordinates.
Static Assets
- static/src/js/map_widget.js — Backend map widget (OWL component)
- static/src/js/live_tracking.js — Backend live tracking page
- static/src/js/portal_tracking.js — Portal driver tracking
- static/src/css/delivery_route.css — Shared styles
- static/src/xml/map_widget.xml — OWL template for map widget
Migrations
- 19.0.1.0.1
- Initial release migration script (migrations/19.0.1.0.1/pre-migrate.py).
Changelog
19.0.1.0.1 (2025-01-01)
- Initial release for Odoo 19.
- Capacity-based delivery allocation with auto vehicle switching.
- Live GPS tracking with Google Maps and Mapbox integration.
- Proof of delivery capture (timestamp + GPS).
- Return eligibility checks with configurable return window.
- Backend and portal views for route monitoring.
- Demo data for quick evaluation.
Author & Support
| Company: | Shadail Technology |
|---|---|
| Website: | https://www.shadailtech.com |
| Email: | info@shadailtech.com |
| Phone: | +91 79773 52693 |
| Address: | Office no. 602, Raj Oaks, MTNL Rd, Gokul Village, Mira Road East, Mira Bhayandar, MH 401107 |
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module