Fuel Consumption plugin: manual fuel refill to calculate vehicle's fuel consumption

This guide shows how to use the Fuel Consumption plugin to track the fuel consumption of your vehicles. 

Note: this plugin is not functional to devices with fuel-reading features. If you have devices with fuel sensors check the solutions for fuel-reading capabilities.

Setup

Follow these steps to install the Fuel Consumption plugin.

1. Log in to the Site Admin > PluginsGet More plugins

2. Install the Fuel Consumption plugin

3. Access the application privileges and features

4. Enable Fuel Consumption privileges in your application.

mceclip1.png

5. Enable FC reports in your application.

mceclip0.png

6. Save the changes to the application properties.

7. Login to the application.

8. Modify the User Type of the user Device.

9. Add Exp. Fuel consumption field.

mceclip2.png

10. Save the user type.

Application setup

Add Expected Fuel Consumption

This step is optional, but adding the expected fuel consumption variable allows you to compare the expected consumption value against the real one on the graphs and reports.

1. Right-click on a user in the Vehicles list and select Edit User

2. Add a fuel consumption value in the Exp. Fuel Consumption field (this step is optional)

mceclip3.png

3. Add an Odometer to the vehicle.

Read how to set up an odometer guide.

Usage

Fuel Consumption requires adding several fuel-refills entries to display the data in the correct format.

Enter the fuel refills as accurately as possible to get the best results.

1. Add the Fuel Consumption menu to the interface by clicking on Windows > Fuel Consumption Fuel Consumption menu

mceclip0.png

2. To add your first refill, click on + Add Refill

mceclip2.png

3. Add your refill in liters/gallons. The values will be adjusted according to your localization settings in your application.

mceclip1.png

4. Click on Save or Save and Next if you want to introduce a new value.

Important: It is necessary to enter at least two entries to start having data and fuel consumption statistics. Enter the data as accurately as possible to ensure better results.

mceclip3.png

If you click on the Graph button, it will show the graph for the selected time period

mceclip4.png

Fuel refills Import

Follow these steps to import a file with fuel fills.

1. Click on Window > Fuel ConsumptionImport in the Fuel Consumption menu

2. Select your file and click Upload

3. The fuel fills are imported and displayed in the Fuel Consumption window

Fuel Fill File Format

Fuel fill files have the format below. Any number of <Refill> … </Refill> sections can be included in one file.

<?xml version="1.0" encoding="utf-8"?>
<Fuel fileid="FuelFile-132">
    <Refills>
        <Refill>
            <VehicleID>truck2</VehicleID>
            <TimeStamp>2013-12-21T10:14:00</TimeStamp>
            <Volume>26.05</Volume>
            <CustomFields>
                <CustomField>
                    <CustomFieldName>Price</CustomFieldName>
                    <CustomFieldValue>35.80</CustomFieldValue>
                </CustomField>
                <CustomField>
                    <CustomFieldName>Where</CustomFieldName>
                    <CustomFieldValue>123 First Avenue</CustomFieldValue>
                </CustomField>
            </CustomFields>
        </Refill>
        <Refill>
            <VehicleID>truck2</VehicleID>
            <TimeStamp>2013-12-23T09:59:00</TimeStamp>
            <Volume>43.95</Volume>
        </Refill>
    </Refills>
</Fuel>
  • It is important to give each file a unique fileid. If the same file id is used for the second import the previously imported fuel fills will be deleted.
  • The TimeStamp is expressed in UTC time zone.
  • Fuel fills will only be imported for vehicles in the current application.
  • Custom Fields are optional.

Fuel Consumption Reports

Verify the available report for the Fuel Consumption plugin (FC reports) in the reports index.

FC1002 report

This report will list all fuel-refills per vehicle selected and time period. Read more about this report here.

mceclip0.png

FC1003 (exceptions) report

This report will list all fuel-refills per tag, that are outside the Expected Fuel consumption parameter. Read more about this report here.

mceclip1.png