Finance Vehicle Asset Management Field Reference Complete reference of all fields in the Vehicle Asset Management module.
This page provides a comprehensive reference for every field in the Vehicle Asset Management module, organized by section. Use it to look up what a specific field means, what values it accepts, and see examples.
These fields identify the vehicle and the asset record itself.
Field Type Description Example Brand Text The manufacturer of the vehicle Toyota Model Text The specific model name Hilux Year Number The manufacturing year of the vehicle 2023 Plate Number Text The vehicle's license plate number A 12345 VIN / Chassis Text The Vehicle Identification Number (chassis number) JTFHX02P100012345 Status Enum The current operational status of the asset ACTIVE Date Added Date When the asset record was created in the system 2024-01-15 Last Updated Date When the asset record was last modified 2024-06-20
These fields capture the financial details of the vehicle purchase.
Field Type Description Example Purchase Value (excl. VAT) Number (AED) The amount paid for the vehicle before tax. This is a required field 100,000 VAT Percentage Number (%) The VAT rate applied to the purchase. Default is 5% 5 VAT Amount Number (AED) Automatically calculated: Purchase Value x VAT Percentage 5,000 Total Purchase Cost Number (AED) Automatically calculated: Purchase Value + VAT Amount 105,000 Dealer Company Text Name of the dealership or seller. Optional Al Futtaim Motors Purchase Date Date The date the vehicle was purchased. Optional 2023-11-01 Funding Source Enum How the vehicle purchase was financed CASH
Value Description CASH Vehicle was purchased outright with available funds. This is the default BANK_LOAN Vehicle was financed through a bank loan LEASE Vehicle is leased from a leasing company OTHER Any other financing arrangement
These fields control how the vehicle's value decreases over time. Calculated fields are derived automatically from the configuration.
Field Type Description Example Depreciation Method Enum The calculation method used for depreciation STRAIGHT_LINE Useful Life (Years) Number Expected number of years the vehicle will be in service. Default is 5 5 Residual Value Number (AED) Estimated value at the end of useful life. Default is 0 10,000 Annual Depreciation Number (AED) Calculated yearly depreciation amount 18,000 Monthly Depreciation Number (AED) Calculated monthly depreciation amount 1,500 Daily Depreciation Number (AED) Calculated daily depreciation amount 49.32
Value Description STRAIGHT_LINE Equal depreciation each year. Default method. See Understanding Depreciation DECLINING_BALANCE Higher depreciation in early years, lower in later years NONE No depreciation is calculated
Annual, Monthly, and Daily Depreciation are read-only fields calculated automatically from the method, purchase cost, residual value, and useful life. They update whenever you change the depreciation configuration.
Field Type Description Example Commission Rate Number (%) The percentage of vehicle revenue shared with drivers. Default is 20% 20
For example, at a 20% commission rate, if the vehicle earns AED 10,000 in a month, AED 2,000 is allocated as driver commission.
Optional file attachments related to the vehicle asset.
Field Type Description Example Purchase Invoice File A copy of the purchase invoice or receipt invoice_hilux_2023.pdf Purchase Invoice Name Text Display name for the purchase invoice file Purchase Invoice - Toyota Hilux Registration Documents File Vehicle registration certificate or ownership documents reg_A12345.pdf Registration Docs Name Text Display name for the registration documents file Registration - A 12345
These fields appear in the expanded row view and detail page. They are calculated automatically from revenue and expense data.
Field Type Description Example Total Revenue Number (AED) All revenue generated by this vehicle 250,000 Net Profit (Lifetime) Number (AED) Revenue minus all costs over the vehicle's lifetime 85,000 Net Profit (Monthly) Number (AED) Average monthly net profit 3,541 Total ROI Earnings Number (AED) Earnings attributed to ROI calculation 85,000 ROI Percentage Number (%) Return on investment relative to purchase cost 80.95
Field Type Description Example Total Expenses Number (AED) All expenses charged to this vehicle 45,000 Monthly Expenses Number (AED) Average monthly expenses 1,875 Total Fines Number (AED) All fines associated with drivers of this vehicle 2,500
Per-driver financial breakdown. One entry per driver who has operated this vehicle.
Field Type Description Example Driver Name Text Full name of the driver Ahmed Al Rashid Label Text The driver's role or assignment label Primary Driver Revenue Number (AED) Revenue generated by this driver on this vehicle 120,000 Commission Number (AED) Commission earned by this driver 24,000 Expense Number (AED) Expenses incurred by this driver 15,000 Fine Number (AED) Fines associated with this driver 500
Field Type Description Example Total Maintenance Cost Number (AED) Sum of all maintenance expenses 12,000 Service Period (km) Number Recommended service interval in kilometers 10,000 First Service Date Date When the first maintenance was performed 2024-02-15
Field Type Description Example Date Date When the maintenance was performed 2024-11-10 Status Text Current status of the maintenance record Completed Priority Text Priority level of the maintenance Medium Cost Number (AED) Cost of the maintenance 3,200 Issue Text Description of the maintenance issue Brake pad replacement
Field Type Description Example Purchase Price Number (AED) Original total purchase cost 105,000 Depreciation Number (AED) Current accumulated depreciation amount 36,000 Depreciation Years Number Configured useful life 5 Commission Rate Number (%) Revenue share percentage with drivers 20 Profit Status Enum Overall financial standing of the vehicle PROFIT
Value Description PROFIT Revenue exceeds all costs including depreciation. The vehicle is a net positive LOSS Total costs exceed revenue. The vehicle is costing more than it earns BREAK_EVEN Revenue and costs are roughly equal
Value Description ACTIVE Vehicle is in service and generating revenue. Default for new assets INACTIVE Vehicle is temporarily out of service SOLD Vehicle has been sold. Terminal status WRITTEN_OFF Vehicle is a total loss. Terminal status
For more details on statuses and transitions, see Status Workflow .