Truck

1. Overview

The "Truck" document in the VSD Fleet Management System (VSD Fleet MS) is used to register, manage, and track detailed truck information, such as its specifications, operational status, driver assignments, fuel configuration, and documentation. This document is central to enabling fleet tracking, maintenance logging, and trip assignments.

2. Key Features

• Tracks truck-specific metadata like license plate, make, model, fuel type, and odometer readings.
• Status-based control with workflow states: Idle, Under Maintenance, On Trip, Disabled.
• Auto-logging of status changes via the Truck Log doctype.
• Dynamic enforcement to prevent disabling a truck if an active trip is ongoing.
• Supports default trailer assignment and driver linkage.
• Enables fuel warehouse and stock handling configuration.
• Manages attached vehicle documentation through a child table.

3. Pre-Requisites

Before using the Truck document, ensure the following:

• Fuel UOM, Truck Driver, Warehouse, and Trailer masters are created.
• The Trips Doctype is properly configured to support linking with the truck.
• Document Attachments Doctype exists for managing vehicle documentation.

4. Step-by-Step Usage

1. Navigation:

   • Go to VSD Fleet MS module.
   • Click on Truck under the Fleet section.

2. Creating a Truck Entry:

   • Click New.
   • Enter the Truck Number (auto-set using License Plate if left empty).
   • Fill in required fields: License Plate, Make, Model, Manufacturing Year, Acquisition Date, Fuel Type, Chassis Number, Fuel UOM, etc.
   • Optionally assign:
     • Driver (linked to Truck Driver doctype)
     • Default Trailer
     • Fuel Warehouse if stock is to be maintained.

3. Operational Tabs:

   • Overview: Basic identification and specs.
   • Details: Fuel, odometer, and engine info.
   • Transportation Default: Driver and trailer assignments.
   • Documents: Upload related compliance or vehicle documents.

4. Status Handling:

   • Upon setting status to "On Trip", a log is created automatically.
   • If the status is changed to "Disabled", the system will:
     • Check for any incomplete trips.
     • Prevent disabling if a trip is active and prompt a link to resolve.

5. Script Customizations

• Auto truck number setting: If truck_number is not manually set, it auto-fills from the license_plate.
• Truck Log Creation: Each time the status changes, a Truck Log is generated to keep a history.
• Trip Enforcement: The truck cannot be disabled unless all associated trips are marked complete. A link to the trip is shown in the error message using frappe.throw().
• Status consistency: When status is "Disabled", the disabled checkbox is automatically checked.

6. Troubleshooting (Common Errors and Resolutions)

7. User Roles and Permissions

Custom roles can be configured as needed in the Role Permission Manager to limit or extend access.

8. Key Notes

• Truck Logs are automatically created when the truck status changes — useful for audits and operational tracking.
• Truck records should be kept up to date with the latest fuel and odometer readings to ensure accurate fleet management.
• Disabling a truck is tightly controlled to avoid disrupting active logistics operations.

9. What business process pain point does it help remove

The Truck doctype addresses several critical operational inefficiencies in fleet-based businesses:

• Ensures centralized visibility of truck specs, fuel setup, and documentation.
• Avoids accidental usage of trucks undergoing maintenance or already assigned to trips.
• Reduces risk of assigning unavailable vehicles by controlling disabling actions.
• Automates logging of truck activities, which supports reporting and performance tracking.
• Enhances accountability by linking trucks to drivers and default trailers.