In this Document

    Frequently Asked Questions

    To better understand the Fuel Usage and Fill Ups feature, we’ve put together some common questions and scenarios on how fuel usage is calculated, and how the data can help you get the most out of your fuel transactions.

    How is fuel usage calculated?

    Fuel usage is calculated using a combination of engine-reported fuel data, imported fuel card data, and the GPS-calculated travel distance. The system calculates the fuel used during a trip for a vehicle by querying the Device Total Fuel Used metric from the engine. In addition, the imported fuel transaction data will be used in the calculation, if available. The fuel economy is then reported as the amount of fuel used over the distance travelled with the given fuel (in mpg or L/100 km).

    Why is my fuel consumption inaccurate or not being calculated?

    Your vehicle may not support the Total fuel used (since telematics device install) diagnostic. Check the Engine Measurements report (Engine & Maintenance > Engine and Device… > Measurements) to see if your vehicle supports the diagnostic. Not all engine computers provide the detailed information needed to calculate all fuel consumption and fill-ups. The tables below shows what is supported.

    In Fuel Usage Report

    Report will show

    Quantity/Consumption

    Vehicle diagnostic: Total fuel used

    True

    Vehicle diagnostic: Fuel level

    False

    If fuel transactions are imported

    True

    In Fill-Ups Report

    Report will show

    Time, Location, Odometer

    Amount. Consumption

    Cost

    Vehicle diagnostic: Total Fuel Used

    False

    True*

    False

    Vehicle diagnostic: Fuel Level

    True

    False

    False

    If fuel transactions are imported

    True

    True

    True

    *Fuel Level or Transaction must also be present

    In Fill-Ups Graph

    Report will show

    Fuel Used (blue line down)

    Fill Up (blue line up)

    Fuel Level (red line)

    Vehicle diagnostic: Total Fuel Used

    True

    False

    False

    Vehicle diagnostic: Fuel Level

    False

    True

    True

    If fuel transactions are imported

    True

    True

    False

    I filled up my vehicle, why don’t I see any fill-ups?

    • Your vehicle may not be able to report the fuel level or the device is not yet capable of capturing the fuel level from your vehicle type. Check whether your vehicle supports the Fuel level diagnostic in the Engine Measurements report (Engine & Maintenance > Engine and Device… > Measurements).
    • Your selected date range might not include the time at which the fill-up occurred.
    • The algorithm used to determine fill-ups from the fuel level diagnostic requires a window of data to accurately determine if a fill up occurred. The vehicle may need to be driven for a longer time to have enough data to determine the last fill-up event.

    Can rules and exceptions be created for fill-ups?

    No, rules and exceptions cannot be created based on fill-ups at this time.

    What data must be included in the fuel transaction import?

    Fuel card data must include the following data points:

    • A UTC date/time of the transaction;
    • Coordinates (latitude, longitude);
    • A vehicle identifier that matches at least one the following telematics device fields:
      • VIN
      • Device
      • Serial Number
      • Licence Plate
      • Description
      • Comments
    • Volume (Liters)
    • Cost
    • ISO Currency Code

    How is fuel card data matched?

    To match a fuel transaction to a device, there must be at least one reference between the fuel card data and the device. The following reference fields are acceptable: VIN, Device Serial Number, License Plate, Device Description (name), Username and Comments. If fuel card data cannot be matched to a vehicle, it will not appear as an event on the Fill-Ups page.

    What fuel card file types are supported by the Fuel Transaction Import Add-in?

    • A generic format
    • WEX customer format files

    What do I do if I want my fuel card format to be supported?

    Please contact support for additional information.

    What if my fuel card provider is not supported by the Add-In?

    Depending on the file format, the Add-In can be modified to support your provider's format. The Add-In is open source and available on Github. Please contact your Reseller for more information. If you would like to share a modified Add-In with other users, please make a pull request.

    I am a WEX telematics customer, how do I enable automatic importing?

    If you are a WEX telematics customer you can contact your WEX representative to determine if they can enable your account for automatic importing. If they can, you will need to integrate the Fuel Transaction Provider Add-In into your database and enter your WEX account number into the Add-In when prompted. Please contact your Reseller for more information.

    If WEX has enabled the data feed for the provided account number, the fuel transactions will be imported into the database the next time the import service runs (within 24 hours). When fuel transactions have been successfully added for this database, the Last Imported field will be updated with the timestamp of the latest WEX-provided file used for the import.

    How do I view the imported fuel card data?

    Run the Fill-Up Report. The rows in the Fill-Up Report are derived from the fuel card data.

    Why are there fill-ups with and without costs for the same vehicle?

    The system may have identified a fill-up from engine data that was not matched to an imported fuel transaction.

    What if a fuel transaction is not matched to my telematics device?

    Unmatched transactions are still saved in the database. They can be viewed in the Fill-Ups Report by setting the Include Unmatched option to Yes. Unmatched transactions appear under the Unknown Vehicle heading at the bottom of the fill-ups list.

    I did not import fuel transactions, but I see fill-ups, how is this possible?

    In many cases, fill-ups can be identified from engine data.

    Is there API access to matched fill-ups?

    There is currently no way to get derived fill-ups through the API. However, imported fuel transactions can be accessed through the API.

    Do fuel usage and fill-ups reports have any known limitation(s)?

    The fuel usage and fill-up reports have the following limitations that may impact the accuracy or detail of reported items.

    • Fuel reports may not support certain vehicle types. Refer to the Vehicle Data table to determine if the fuel reports support the vehicle type. For more information, please contact your authorized Reseller.
    • Fuel use during idling is not included as a separate item in the fuel usage report.
    • Use of Personal Mode impacts the detail in fill-ups report — fill-ups during a private trip are grouped together.
    • Fill-ups report may not account for Small/Partial fill-ups since the fuel level change is not noticeable.
    • Location of the fill-up may be inaccurate. The fill-ups report is not intended for IFTA purposes.
    • Fill-ups reports may be inaccurate in rare scenarios. For example, a significant change in elevation (i.e. the vehicle tilts) or a significant change in speed may cause the fuel to slosh around.