Vehicle Service Log
The Vehicle Service Log is a crucial document in the ERPNext FMS module for tracking all maintenance, repair, and service activities performed on your vehicles. It serves as a historical record of every job, capturing important details like the nature of the job, odometer readings, and the service provider.
The system supports both manual creation of service logs and fully automated creation through integration with telematics providers like Intangles.
Key Features
- Automated DTC Log Creation: If the
erpnext_intangles_integrationapp is installed, the system will automatically create a new Vehicle Service Log when a Diagnostic Trouble Code (DTC) is received from a vehicle's telematics device. This enables proactive maintenance by flagging issues as soon as they are detected. - Categorized Job Logging: Log services based on their nature (e.g., Periodic, Accidental, or DTC Issue).
- Automated Odometer Reading: Automatically fetches the vehicle's odometer value before and after the service from the Intangles integration, if available.
- Driver Alerts: Automatically creates and sends a notification to the driver when a new service log is created, especially for critical DTC issues.
- Automatic Status Updates: When a "removed" status for a DTC is received from the webhook, the system automatically finds the corresponding "DTC Issue" service log and updates its status to "Completed".
Workflows for Creating a Service Log
1. Automatic Creation via Intangles DTC Webhook (Recommended)
This is the primary and most efficient way to manage vehicle faults. No manual intervention is needed.
- The Intangles telematics system detects a fault in a vehicle and sends a DTC log to your ERPNext instance via a webhook.
- The
pull dtc logfunction in the backend processes this data. - The system automatically creates a new Vehicle Service Log document with the Job Nature set to "DTC Issue" and populates the DTC code and other relevant details.
- A notification is immediately sent to the assigned driver, informing them of the issue.
- The fleet manager can then review the pending service log and assign it to a supplier or workshop for resolution.
2. Manual Creation
You can also create a service log manually for scheduled maintenance, accidental repairs, or issues not captured by telematics.
- Navigate to: Erpnext Fms > Fleet > Vehicle Service Log.
- Click + Add Vehicle Service Log.
- Select the License Plate of the vehicle being serviced.
- Fill in the service details, including the Job Nature, Job Type, and the Supplier (workshop).
- The system will attempt to auto-fill the odometer readings if the Intangles integration is active; otherwise, you can enter them manually.
- Update the Status of the job as it progresses (e.g., Pending, In-progress, Completed).
- Click Save.
Fields Description (Vehicle Service Log)
| Field | Description | Required |
|---|---|---|
| License Plate | Link to the Vehicle that is being serviced. | Yes |
| Datetime | The date and time when the service was initiated or completed. | No |
| Odometer Value Before/After Service | The vehicle's odometer readings recorded before and after the service. Can be fetched automatically. | No |
| Status | The current status of the service job (Pending, In-progress, Completed, or Ignored). | No |
| Job Nature | The reason for the service: "DTC Issue", "Periodic", or "Accidental". | No |
| Job Type | The specific type of job being performed, linked to the "Vehicle Service Job Type" master. | No |
| Job Category | A read-only field showing the broader category of the job (e.g., "Drive Line"), fetched from the selected Job Type. | No |
| Supplier | A link to the Supplier (e.g., workshop) that performed the job. | No |
| DTC Details | A section that appears if Job Nature is "DTC Issue," for recording the fault code and description. | Conditional |
Vehicle Service Job Type (Master)
To maintain consistency, you must first define the types of services in the Vehicle Service Job Type master. This allows you to group jobs into logical categories for better analysis.
How to Create a Service Job Type:
- Navigate to: Dashboards > Vehicle Service Job Type.
- Click + Add Vehicle Service Job Type.
- Enter a unique name for the Job Type (e.g., "Air Filter Cleaning").
- Select a Job Category (e.g., "Body," "Electrical," "Drive Line") to group this job type.
- Click Save.