Fuel Entries Reference

Name

Type

Req?/Editable?

Description

id

Integer

N/N

Auto generated unique identifier

cost_per_hour

Double

N/N

The calculated cost per hour since the last fuel entry. Automatically calculated.

cost_per_km

Double

N/N

The calculated cost per kilometer since the last fuel entry. Automatically calculated.

cost_per_mi

Double

N/N

The calculated cost per mile since the last fuel entry. Automatically calculated.

custom_fields

Hash

N/Y

Hash of custom fields for the fuel entry.

date

DateTime

Y/Y

The date and time during which the fueling occurred.

external_id

String

N/N

Used to uniquely identify fuel entries that are imported from external systems, such as Fleetcor and Wex.

fuel_type_id

Integer

N/Y

Foreign key for the associated fuel type.

fuel_type_name

String

N/N

Convenience method for the associated fuel type's name.

kpl

Double

N/N

Kilometers per liter. Auto calculated.

liters

Double

N/Y

The fuel volume amount in liters. This field will be used if the vehicle is set to use liters, otherwise it will be ignored

liters_per_hour

Double

N/N

Auto calculated.

lp100k

Double

N/N

Liters per 100 kilometers. Auto calculated.

mpg_uk

Double

N/N

Miles per gallon using UK gallons. Auto calculated.

mpg_us

Double

N/N

Miles per gallon using US gallons. Auto calculated.

partial

Boolean

N/Y

Denotes whether this fuel entry is a partial fuel up as opposed to a complete fuel up. More info found here.

personal

Boolean

N/Y

price_per_volume_unit

Double

N/Y

The unit price for the vehicle's volume unit.

raw_transaction_data

Hash

N/N

The raw data that Fleetio receives from a third party integration such as Fleetcor or Wex.

reference

String

N/Y

Optional data field for collecting information such as the invoice number, transaction id, or receipt number.

reset

Boolean

N/Y

Tells Fleetio whether to reset calculations starting with this fuel entry. An example can be found here.

uk_gallons

Double

N/Y

The fuel volume amount in UK gallons. This field will be used if the vehicle is set to use UK gallons, otherwise it will be ignored

uk_gallons_per_hour

Double

N/N

Number of UK gallons used per hour. Auto calculated.

us_gallons

Double

N/Y

The fuel volume amount in US gallons. This field will be used if the vehicle is set to use US gallons, otherwise it will be ignored

us_gallons_per_hr

Double

N/N

Number of US gallons used per hour. Auto calculated.

usage_in_hr

Double

N/N

Hours between the previous fuel entry and the current one. Auto calculated.

usage_in_km

Double

N/N

Kilometers between the previous fuel entry and the current one. Auto calculated.

usage_in_mi

Double

N/N

Miles between the previous fuel entry and the current one. Auto calculated.

vehicle_id

Integer

Y/Y

Foreign key for the vehicle association.

vehicle_name

String

N/N

Convenience method for the vehicle's name.

vendor_id

Integer

N/Y

Foreign key for the vendor association.

vendor_name

String

N/N

Convenience method for the vendor's name.

total_amount

Double

N/N

The total amount calculated by multiplying the price_per_volume_unit by the relevant volume for the vehicle. Auto calculated.

meter_entry_attributes

Hash

Y/Y

Each fuel entry requires a meter entry value and an associated meter entry. See the MeterEntry documentation for more info.