Enterprise-Grade Fleet Management Powered by ERPNext
A comprehensive, open-source fleet management solution built on the Frappe framework, designed for transportation companies, logistics providers, and organizations managing vehicle fleets. Streamline operations from cargo registration to trip completion with integrated financial management and real-time tracking.
Complete documentation is available at: https://iota.co.tz/docs/
Quick Links:
- User Guide - Complete workflow and feature documentation
- Installation Guide - Setup instructions
- API Reference - Technical documentation
📝 Note: This is a community fork of the original VVSD-LTD/vsd_fleet_ms project, enhanced with comprehensive documentation and additional features based on real customer needs. The original project was built by VVSD-LTD after studying SAP's fleet management solutions, making it one of the most sophisticated fleet management applications in the ERPNext ecosystem.
- Cargo Registration → Vehicle Assignment → Trip Execution → Financial Settlement
- End-to-end workflow automation with approval processes
- Multi-currency support (USD/TZS) with automatic exchange rate handling
- Integrated accounting with ERPNext Journal Entries and Purchase Orders
- Real-time Trip Tracking with location updates and GPS integration
- Intelligent Vehicle Assignment with trailer management
- Automated Financial Workflows for fund and fuel approval
- Breakdown Management with trip reassignment capabilities
- Comprehensive Reporting with expense analysis and fuel tracking
- ERPNext Native - Seamless integration with existing ERP systems
- Multi-Company Support - Manage multiple business entities
- Role-Based Access - Granular permissions and approval workflows
- Audit Trail - Complete transaction history and compliance tracking
graph TB
A[Cargo Registration] --> B[Manifest Creation]
B --> C[Vehicle Assignment]
C --> D[Trip Execution]
D --> E[Fund Management]
D --> F[Fuel Management]
E --> G[Financial Settlement]
F --> G
D --> H[Real-time Tracking]
D --> I[Reporting & Analytics]
- Vehicle Registry - Complete truck and trailer specifications
- Driver Management - Driver profiles with document management
- Route Configuration - Predefined routes with distance and fuel calculations
- Expense Templates - Standardized cost structures per route
- Cargo Registration - Customer service entry with invoice generation
- Manifest Management - Vehicle-cargo assignment with trailer support
- Trip Execution - Complete journey management with 7 specialized tabs
- Financial Workflows - Fund approval and fuel procurement processes
- Real-time Tracking - GPS integration with location updates
- Breakdown Management - Trip interruption handling and reassignment
- Performance Analytics - Fuel efficiency and cost analysis
- Compliance Reporting - Regulatory and audit trail management
- Logistics Providers - Complete cargo-to-delivery management
- Fleet Operators - Vehicle and driver optimization
- Cross-Border Transport - International route management
- Manufacturing Companies - In-house fleet management
- Distribution Centers - Delivery fleet optimization
- Service Companies - Field service vehicle management
# Install on existing ERPNext system
bench get-app https://github.com/nelsonmpanju/Fleet-Management-System.git
bench --site [your-site] install-app vsd_fleet_ms- Set up Transport Settings with fuel items and warehouses
- Configure accounting dimensions for financial tracking
- Define master data (trucks, drivers, routes, expenses)
- Register customer cargo with service details
- Create manifest and assign vehicles
- Generate trip with automatic expense allocation
- Execute trip with real-time tracking
Visit https://iota.co.tz/docs/ for complete documentation including:
- Complete Workflow Guide - End-to-end process documentation
- API Reference - Complete technical documentation
- Installation Guide - Detailed setup instructions
- Cargo Registration - Customer service management
- Manifest Management - Vehicle assignment workflow
- Trip Management - Transportation execution
- Financial Workflows - Fund and fuel management
- API Reference - Complete doctype specifications
- Setup Guides - Master data and system configuration
All guides and references are available at: https://iota.co.tz/docs/
- Framework: Frappe/ERPNext v15+
- Database: MariaDB/MySQL
- Frontend: Frappe UI with Material Design
- Backend: Python 3.10+
- Integration: REST APIs, Webhooks, ERPNext native
Unlike standalone fleet management systems, VSD Fleet MS is built natively on ERPNext, providing:
- Unified Data Model - Single source of truth for all business data
- Integrated Financials - Seamless accounting and reporting
- Extensible Architecture - Easy customization and integration
- Approval-Based Operations - Multi-level approval for funds and fuel
- Status-Driven Processes - Clear progression through trip lifecycle
- Exception Handling - Breakdown management and trip reassignment
- Multi-Currency Support - USD/TZS with automatic exchange rates
- Accounting Dimensions - Granular cost tracking and analysis
- Audit Compliance - Complete transaction history and trail
- Reduced Manual Work - Automated workflows and calculations
- Faster Processing - Streamlined approval and execution processes
- Better Resource Utilization - Optimized vehicle and driver assignment
- Cost Transparency - Detailed expense tracking and analysis
- Approval Workflows - Controlled spending with multi-level approvals
- Real-time Reporting - Instant visibility into fleet performance
- Audit Trail - Complete transaction history for compliance
- Document Management - Centralized storage of all fleet documents
- Exception Handling - Proper management of breakdowns and delays
We welcome contributions from the community! Whether you're a developer, business analyst, or fleet management expert, there are many ways to contribute:
- Bug Reports - Help improve system stability
- Feature Requests - Suggest new capabilities
- Code Contributions - Enhance functionality
- Documentation - Improve user guides and technical docs
- Workflow Optimization - Suggest process improvements
- Industry Knowledge - Share transportation best practices
- User Testing - Provide feedback on usability
- Case Studies - Document successful implementations
- Fork the repository on GitHub
- Create a feature branch for your contribution
- Develop your changes following our guidelines
- Test thoroughly on a development environment
- Submit a pull request with detailed description
For detailed contribution guidelines, see our Contributing Guide.
- Complete Documentation - User guides and technical references
- User Guides - Step-by-step instructions for all features
- API Reference - Complete technical documentation
- Video Tutorials - Visual learning resources
- GitHub Issues - Bug reports and feature requests
- Discussions - Community forum for questions and ideas
- Contributions - Code, documentation, and testing
- Email Support - nelsonnorbert87@gmail.com
- Implementation Services - Custom setup and training
- Consulting - Workflow optimization and customization
This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.
- VVSD-LTD - Original creators of the VSD Fleet Management System
- SAP Research - Inspiration and best practices from SAP's fleet management solutions
- ERPNext Community - Framework and ecosystem support
- Documentation - Comprehensive guides and technical references
- Feature Enhancements - Customer-driven improvements
- Testing & Feedback - Quality assurance and user experience improvements
Ready to transform your fleet operations?
🚀 Get Started • 📖 Documentation • 🤝 Contribute
Complete documentation available at iota.co.tz/docs
Forked from VVSD-LTD/vsd_fleet_ms with enhanced documentation and features