Fleet Management System

bench get-app https://github.com/nareshkannasln/Fleet-Management-System

[![Listed on Frappe Gems](https://frappegems.com/api/method/frappe_gems.seo.badge?app=nareshkannasln%2FFleet-Management-System)](https://frappegems.com/gems/apps/nareshkannasln/Fleet-Management-System)

Fuel Management App

This is a Frappe application that provides APIs for transport company onboarding, wallet management, fleet card creation, and PIN updates. It integrates with ERPNext for customer, wallet, and vehicle management.

Installation

Navigate to your frappe-bench directory.

Get the app:

bench get-app fuel_management

Install the app on your site:

bench --site install-app fuel_management

Restart the server:

bench start

API Endpoints 1. Onboard Transport Company

URL

POST /api/method/fuelmanagement.api.onboardtransport_company

Request Body

{ "company_name": "ABC Logistics", "email": "abc@example.com", "phone": "9876543210" }

Response

{ "status": "success", "message": "Transport Company and User created", "companyid": "COMP-0001", "walletid": "FLID0001", "customerid": "CUST-0001", "email": "abc@example.com", "password": "autogenerated_password" }

2. Create Fleet Card

URL

POST /api/method/fuelmanagement.api.createfleet_card

Request Body

{ "walletid": "FLID0001", "vehiclenumber": "TN01AB1234" }

Response

{ "status": "success", "card_no": "CARD123456", "pin": "1234", "message": "Fleet card created successfully" }

3. Change Fleet Card PIN

URL

POST /api/method/fuelmanagement.api.changepin

Request Body

{ "cardno": "CARD123456", "oldpin": "1234", "new_pin": "5678" }

Response

{ "status": "success", "message": "PIN changed successfully" }

Notes

Onboarding a transport company automatically creates:

User account with default role

Transport Company doctype entry

Linked ERPNext Customer

Wallet ID (FLIDxxxx)

Fleet cards are tied to vehicles and wallets.

PIN updates are validated against the existing PIN before changing.