| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Fleet (fleet)
• Inventory (stock) • Sales (sale_management) • Discuss (mail) • Invoicing (account) |
| Lines of code | 1171 |
| Technical Name |
product_shipping |
| License | LGPL-3 |
| Website | https://hozifa.odoo.com/ |
| Versions | 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Fleet (fleet)
• Inventory (stock) • Sales (sale_management) • Discuss (mail) • Invoicing (account) |
| Lines of code | 1171 |
| Technical Name |
product_shipping |
| License | LGPL-3 |
| Website | https://hozifa.odoo.com/ |
| Versions | 18.0 19.0 |
🚚 Product Shipping Management Module
Comprehensive Odoo 18 Module for Managing Product Delivery Operations
📋 Overview
The Product Shipping Management module is a comprehensive solution for managing delivery operations in Odoo 18. It provides complete control over vehicle dispatch, driver assignment, route planning, and real-time tracking of shipments from order to delivery.
✨ Key Features
🚚 Core Shipping
- Create and track shipments linked to sales orders
- Multi-state workflow management
- Real-time status tracking
- Automatic reference generation
📍 GPS & Location
- GPS coordinates for all partners
- Google Maps integration
- Location validation
- Vendor and customer tracking
🚗 Vehicle & Driver
- Dedicated driver management
- License tracking and expiry alerts
- Vehicle capacity management
- Assignment validation
🗺️ Route Planning
- Automatic distance calculation
- Google Maps navigation
- Travel time estimation
- Route optimization
📊 Sales Integration
- Vehicle selection toggle
- Quick shipment creation
- Shipment counter
- Conditional field display
📈 Reporting
- Kanban board view
- Advanced filtering options
- Performance analytics
- Activity tracking
🔄 Shipment Workflow
The module uses a four-state workflow to manage the complete delivery lifecycle:
Draft
Shipment created, awaiting scheduling
Scheduled
Ready for dispatch, route planned
In Transit
Driver en route, delivery in progress
Delivered
Successfully delivered to customer
⚙️ Installation
Prerequisites
- Odoo 18.0 or higher
- sale_management module
- stock module
- fleet module (automatically installed)
Installation Steps
-
Copy Module Files
cp -r product_shipping /path/to/odoo/addons/
-
Update Apps List
Go to Apps menu → Click "Update Apps List" → Search for "Product Shipping Management"
-
Install Module
Click "Install" button and wait for installation to complete
-
Verify Installation
Check that the "Shipping" menu appears in main navigation and Sales order form has "Shipping Information" tab
🔧 Configuration
1. Set Up Drivers
- Navigate to Shipping → Drivers
- Click Create
- Fill in driver details (Name, Phone, Driver License Number, License Expiry Date)
- Check "Is a Driver" checkbox
- Add GPS coordinates in "Location & Driver Info" tab
2. Set Up Vehicles
- Navigate to Shipping → Vehicles
- Click Create
- Enter vehicle details (License Plate, Model, Max Capacity in Tons)
- Optionally assign a default driver
3. Configure Partner Locations
- Go to Contacts
- Open any partner (Customer or Vendor)
- Go to "Location & Driver Info" tab
- Enter GPS coordinates (Latitude and Longitude)
4. Set Up Product Vendors
- Go to Inventory → Products
- Open your product
- Go to "Purchase" tab
- Add vendor with location that has GPS coordinates
📖 Usage Guide
Creating a Shipment from Sales Order
-
Create Sales Order
Navigate to Sales → Orders → Quotations, click Create, select customer with GPS coordinates, and add product
-
Configure Shipping
Go to "Shipping Information" tab, check "Use Company Vehicle", select Driver and Vehicle
-
Confirm Order
Click Confirm to create the sales order
-
Create Shipment
Click "Create Shipping" button. System automatically fills source location, destination location, driver, and vehicle
Managing the Delivery Process
1. Schedule Shipment (Draft → Scheduled)
- Open shipment in Draft status
- Click Schedule button
- System validates GPS coordinates
- Status changes to Scheduled
2. Start Journey (Scheduled → In Transit)
- Open scheduled shipment
- Click Start Journey button
- Google Maps opens with route from source to destination
- Status changes to In Transit
- Actual start time is recorded automatically
3. Mark as Delivered (In Transit → Delivered)
- When delivery is complete, click Mark as Delivered button
- Actual delivery time is recorded
- Status changes to Delivered
Route Navigation
When clicking "Start Journey", Google Maps app opens automatically with the route pre-configured in driving mode. The driver can start navigation immediately with origin set to source location and destination set to customer location.
🔧 Troubleshooting
| Issue | Solution |
|---|---|
| Cannot create shipment | Ensure sales order is confirmed, "Use Company Vehicle" is checked, and Driver and Vehicle are selected |
| Cannot start journey | Verify both source and destination have GPS coordinates in correct format (decimal degrees) |
| Distance shows 0.0 | Check that all four coordinates (source lat/long, destination lat/long) are filled with numbers, not text |
| Google Maps not opening | Check browser allows popups, verify GPS coordinates are valid, ensure internet connection is active |
💡 Best Practices
- Always set GPS coordinates for partners before creating shipments
- Verify driver licenses are valid before assignment
- Check vehicle capacity matches order quantity
- Use estimated duration for better planning
- Record actual times for performance analysis
- Add notes for exceptional circumstances
- Perform regular license expiry checks for drivers
🔬 Technical Information
Distance Calculation
The module uses the Haversine formula to calculate accurate distances between GPS coordinates:
Google Maps URL Format
Security & Access Rights
- Sales Users: Read, Write, Create shipments
- Sales Managers: Full access including Delete
- Portal Users: No access (internal only)
📞 Support & Contact
If you need assistance with the module or have questions not covered in this guide:
Hozifa Abbas - Freelancer
Website: https://hozifa.odoo.com/
If you encounter any bugs or issues, please provide:
- Odoo version and module version
- Steps to reproduce the issue
- Error messages or screenshots
We welcome suggestions for improvements! Contact the author with your ideas for future enhanproducts.
Please log in to comment on this module