VehicleAssetEnrgyUse

Represents the fuel consumption related to vehicles. This object is available in API version 54.0 and later.

Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

Fields

AircraftFuelEconomy

Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The fuel economy of the aircraft.

AircraftFuelEconomyInGph

Type: double
Properties: Filter, Nillable, Sort
Description: The fuel economy of the aircraft in gallons per hour.

AircraftFuelEconomyUnit

Type: picklist
Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description: The unit of measure for the fuel economy of the aircraft.
Possible values:
- GALLONS_PER_HOUR—Gallons per Hour
- LITERS_PER_HOUR—Liters per Hour

AircraftType

Type: string
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The type of aircraft.

CarbonFootprintReportDate

Type: date
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The date when the carbon footprint data of the associated stationary asset is due to be sent to a reporting body.

Ch4EmissionsInKg

Type: double
Properties: Filter, Nillable, Sort
Description: The CH4 emissions that are calculated for this energy use record.

Co2EmissionsInKg

Type: double
Properties: Filter, Nillable, Sort
Description: The CO2 emissions that are calculated for this energy use record.

CostCenter

Type: string
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The cost center associated with this energy use record.

CrbnEmssnScopeAlloc

Type: picklist
Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description: The allocation of fuel consumption for different scope emissions to override the scope allocation defined in the vehicle asset for the fuel type.
Possible values:
- Scope 1
- Scope 2
- Scope 3 Downstream
- Scope 3 Upstream
- Scope3BusinessTravel—Total Scope 3 Business Travel
- TotScp3DnstrmLsdAsset—Total Scope 3 Downstream Leased Asset
- TotScp3DnstrmTrnspDstr—Total Scope 3 Downstream Transportation and Distribution
- TotScp3EmpComut—Total Scope 3 Employee Commuting
- TotScp3UpstrmTrnspDstr—Total Scope 3 Upstream Transportation and Distribution

Distance

Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The distance traveled. For a fleet vehicle, the distance is calculated if you’ve already entered the fuel efficiency and fuel consumption.

DistanceUnit

Type: picklist
Properties: Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description: The unit of measure for the distance travelled.
Default value: Kilometers
Possible values:
- Kilometers
- Miles

EndDate

Type: date
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The date until when the values of this energy use record are valid.

FlightDate

Type: date
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The date when the flight was taken.

FlightDurationInHours

Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The duration of the flight in hours.

FuelConsumption

Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The calculated fuel consumption when you enter the distance and fuel effeciency

FuelConsumptionUnit

Type: picklist
Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description: The unit of measure for the consumed fuel. For custom fuel unit of measure, if the NamespacePrefix exists then this value is NamespacePrefix_custom_DeveloperName of the SustainabilityUom object; for example, ftPackage_custom_bundle, else this value is custom_DeveloperName of the SustainabilityUom object; for example, custom_bundle.
Possible values:
- LITERS—Liters
- UsGallons—US Gallons
- kWh

FuelEfficiency

Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The fuel efficiency value. For a fleet vehicle, the fuel efficiency is calculated if you’ve already entered the distance and fuel consumption.

FuelEfficiencyInMpg

Type: double
Properties: Filter, Nillable, Sort
Description: The fuel efficiency of the vehicle in miles per gallons.

FuelEfficiencyUnit

Type: picklist
Properties: Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description: The unit of measure for the fuel efficiency of the vehicle.
Default value: LITRES_PER_100KM
Possible values:
- LITRES_PER_100KM—L per 100 km
- MILES_PER_GALLON—Miles per Gallon

FuelType

Type: picklist
Properties: Create, Filter, Group, Restricted picklist, Sort, Update
Description: The type of fuel consumed for this energy use record. For custom fuels, if the NamespacePrefix exists then this value is NamespacePrefix_custom_DeveloperName of the FuelType object; for example, ftPackage_custom_wood, else this value is custom_DeveloperName of the FuelType object; for example, custom_wood.
Possible values:
- AutogasLPG—Autogas/LPG
- Biodiesel
- CompressedNaturalGasCNG—Compressed Natural Gas (CNG)
- Diesel
- Electricity
- Ethanol
- Gasoline
- JetFuel—Jet Fuel

IsCompanyOwnedAsset

Type: boolean
Properties: Defaulted on create, Filter, Group, Sort
Description: Indicates whether the asset is owned by the organization.
Default value: false

IsRecordLocked

Type: boolean
Properties: Defaulted on create, Filter, Group, Sort
Description: Indicates whether the vehicle asset energy use record is locked for editing because the associated carbon footprint is locked for editing.
Default value: false

LastReferencedDate

Type: dateTime
Properties: Filter, Nillable, Sort
Description: The timestamp for when the current user last viewed a record related to this record.

LastViewedDate

Type: dateTime
Properties: Filter, Nillable, Sort
Description: The timestamp for when the current user last viewed this record. If this value is null, this record might only have been referenced (LastReferencedDate) and not viewed.

N2oEmissionsInKg

Type: double
Properties: Filter, Nillable, Sort
Description: The N2O emissions that are calculated for this energy use record.

Name

Type: string
Properties: Create, Filter, Group, idLookup, Sort, Update
Description: The name of the record.

OtherEmssnFctrId

Type: reference
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The other emission factors that are used to calculate the emissions. This is a relationship field.
Relationship Name: OtherEmssnFctr
Relationship Type: Lookup
Refers To: OtherEmssnFctrSet

OthrLifecyclEmssnFctrSetId

Type: reference
Properties: Filter, Group, Nillable, Sort
Description: The other lifecycle emission factor set record related to the energy use. This field is a relationship field.
Relationship Name: OthrLifecyclEmssnFctrSet
Refers To: OthrLifecyclEmssnFctrSet

OwnerId

Type: reference
Properties: Create, Defaulted on create, Filter, Group, Sort, Update
Description: The ID of the user who owns this record. This is a polymorphic relationship field.
Relationship Name: Owner
Relationship Type: Lookup
Refers To: Group, User

Scope1EmissionsInTco2e

Type: double
Properties: Filter, Nillable, Sort
Description: The total scope 1 emissions from all the associated energy use records and supplemental emissions.

Scope2LocBasedEmssnInTco2e

Type: double
Properties: Filter, Nillable, Sort
Description: The total scope 2 emissions value that’s calculated based on the location-based data of grid emissions.

Scope2MktBasedEmssnInTco2e

Type: double
Properties: Filter, Nillable, Sort
Description: The total scope 2 emissions value that’s calculated based on the utility-provided emissions data and allocated renewable energy.

Scope3DnstrmEmissionsInTco2e

Type: double
Properties: Filter, Nillable, Sort
Description: The scope 3 emissions from downstream activities. This value is calculated based on the scope 3 downstream emission values and supplemental scope 3 downstream emission values of all the associated energy use records.

Scope3GhgCategory

Type: picklist
Properties: Filter, Group, Nillable, Restricted picklist, Sort
Description: Specifies the scope 3 GHG category for the total scope 3 emissions related to the energy use by the stationary asset environmental source.
Possible values:
- Scope3BusinessTravel—Business Travel
- TotScp3DnstrmLsdAsset—Downstream Leased Asset
- TotScp3DnstrmTrnspDstr—Downstream Transportation and Distribution
- TotScp3EmpComut—Employee Commuting
- TotScp3UpstrmTrnspDstr—Upstream Transportation and Distribution

Scope3UpstrmEmissionsInTco2e

Type: double
Properties: Filter, Nillable, Sort
Description: The scope 3 emissions from upstream activities. This value is calculated based on the scope 3 upstream emission values and supplemental scope 3 upstream emission values of all the associated energy use records.

Scp3Ch4EmssnFuelEnrgy

Type: double
Properties: Filter, Nillable, Sort
Description: The methane (CH4) emissions, measured in kilograms, from producing, transmitting, and delivering fuels and energy a vehicle uses.

Scp3Co2EmssnFuelEnrgy

Type: double
Properties: Filter, Nillable, Sort
Description: The carbon dioxide (CO2) emissions, measured in kilograms, from producing, transmitting, and delivering fuels and energy a vehicle uses.

Scp3EmssnFuelEnrgy

Type: double
Properties: Filter, Nillable, Sort
Description: The emissions, measured in metric tons, that occur upstream from a company’s direct use of energy in a vehicle, such as the extraction, refining, production, transmission, and transport of fuels.

Scp3N2oEmssnFuelEnrgy

Type: double
Properties: Filter, Nillable, Sort
Description: The nitrous oxide (N2O) emissions, measured in kilograms, from producing, transmitting, and delivering fuels and energy a vehicle uses.

StartDate

Type: date
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The date from when the values of this energy use record are valid.

SuplScope1Emissions

Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The supplemental scope 1 emissions value that’s added to the calculated total scope 1 emissions value.

SuplScope2LocationBasedEmssn

Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The supplemental scope 2 location-based emissions value that’s added to the calculated total scope 2 location-based emissions value.

SuplScope2MarketBasedEmssn

Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The supplemental scope 2 market-based emissions value that’s added to the calculated total scope 2 market-based emissions value.

SuplScope3DnstrmEmissions

Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The supplemental scope 3 emissions value from downstream activities that’s added to the calculated total scope 3 emissions value

SuplScope3UpstrmEmissions

Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The supplemental scope 3 emissions value from upstream activities that’s added to the calculated total scope 3 emissions value

SupplierId

Type: reference
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The supplier that is associated with this energy use record. This is a relationship field.
Relationship Name: Supplier
Relationship Type: Lookup
Refers To: Supplier

TotalFuelConsumptionInGal

Type: double
Properties: Filter, Nillable, Sort
Description: The total fuel consumed in US gallons.

TotalFuelConsumptionInLiter

Type: double
Properties: Filter, Nillable, Sort
Description: The total fuel consumed in liters. For a private jet, the fuel consumption and fuel consumption unit values are prioritized for calculations over the aircraft fuel economy and aircraft fuel economy unit values. For a fleet vehicle, the total fuel consumption value is the fuel consumption value converted to liters.

VehicleAssetCrbnFtprntId

Type: reference
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The vehicle asset carbon footprint record that’s associated with this energy use record. This is a relationship field.
Relationship Name: VehicleAssetCrbnFtprnt
Relationship Type: Lookup
Refers To: VehicleAssetCrbnFtprnt

VehicleAssetEmssnSrcId

Type: reference
Properties: Create, Filter, Group, Sort, Update
Description: The vehicle asset emission source that’s associated with this energy use record. This is a relationship field.
Relationship Name: VehicleAssetEmssnSrc
Relationship Type: Lookup
Refers To: VehicleAssetEmssnSrc

Associated Objects

This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later.

VehicleAssetEnrgyUseChangeEvent (API Version 63.0): Change events are available for the object.
VehicleAssetEnrgyUseFeed: Feed tracking is available for the object.
VehicleAssetEnrgyUseHistory: History is available for tracked fields of the object.
VehicleAssetEnrgyUseShare: Sharing is available for the object.