Track fuel consumption with fill log

Enter your fuel fills in the Fuel Consumption plugin to track your fuel consumption

This guide shows how to use the Fuel Consumption plugin to track fuel consumption by logging your fuel fills.

Note:

FC1000 is replaced by FC1002

FC1001 is replaced by FC1003

SiteAdmin Application Setup

Install Plugin

Follow these steps to install the Fuel Consumption plugin.

  1. Login to the SiteAdmin application
  2. Select the Plugins tab
  3. Install the Fuel Consumption plugin

Enable Fuel Consumption plugin in Applications

Activate the Fuel Consumption plugin in your application following these steps.

  1. Login to the SiteAdmin application
  2. Select the Applications tab
  3. Click on the Application you want the Fuel Consumption plugin in
  4. Scroll down to the Privileges and Roles section and check all the boxes under Plugins / Fuel Consumption as shown below
  5. Check the boxes for the FC reports under Plugins / Reporting / _CreateReport, marked in yellow below
  6. Save the Application

VehicleTracker Application Setup

The Fuel Consumption plugin shows fuel consumption for vehicles based on fuel fills and the distance driven.

Add Expected Fuel Consumption and check Odometer

Add an expected fuel consumption for a vehicle following these steps.

  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
  3. Click on the Accumulators tab and check that the Odometer is configured and correctly setup for the vehicle
  4. Save the User

View Fuel Fills

To view fuel fills and fuel consumption for a vehicle, follow these steps.

  1. Click on Fuel Consumption in the Fuel Consumption menu
  2. A list of fuel fills for the selected time period is shown for the selected vehicle
  3. Click on the Graph button to show the graph for the selected time period

Note: The very first fuel fill does not show consumption values as the distance driven before that fill is unknown

Fuel Fill File Format

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
<?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>

Note 1: It is important to give each file a unique fileid. If the same file id is used for second import the previously imported fuel fills will be deleted.
Note 2: The TimeStamp is expressed in UTC time zone.
Note 3: Fuel fills will only be imported for vehicles in the current Application.
Note 4: Custom Fields are optional.

Fuel Fill File Import

Follow these steps to import a file with fuel fills.

  1. Click on Import 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

Manual Fuel Fill Entry

You can enter fuel fills manually. Follow these steps:

  1. Click on Fuel Consumption in the Fuel Consumption menu
  2. Enter a Date, Time and Volume for your fuel fill and click Add
  3. The matching Odometer value for the vehicle is fetched and the consumption is calculated

Fuel Consumption Reports

Two reports are included with the Fuel Consumption Plugin. You can activate them under the Reports / Manage Reports menu in the VehicleTracker application.

Sample Summary report:

A summary report showing all fills for a vehicle

 

Sample Exception report:

An exception report showing the fills that fall outside the expected fuel consumption setting