Net Zero Cloud Developer Guide

Introduction to Net Zero Cloud
Net Zero Cloud Standard Objects
Net Zero Cloud Business APIs
Net Zero Cloud Metadata API Types
Net Zero Cloud Tooling API Objects
Net Zero Cloud Calculations
Energy Use Records
Air Travel Energy Use
Freight Hauling Energy Use
Ground Travel Energy Use
Hotel Stay Energy Use
Rental Car Energy Use
Stationary Asset Energy Use
Vehicle Asset Energy Use
Scope 3 Procurement Summary
Emissions Factor Records
Carbon Footprint
Waste Management
Water Management
Science Based Targets
Emissions Forecasts
Sustainability Scorecard
Building Size Category
Building Energy Intensity
Data Gap Filling
Allocate Carbon Credits
Annual Emissions Inventory
Conversion Factors
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Vehicle Asset Energy Use

The Vehicle Asset Energy Use object represents the fuel consumption related to vehicles. The selected emissions factors on the energy use record control the calculation for scope 1 or scope 3 emissions for vehicles depending on whether the asset is company owned.
Available in: Lightning Experience and the Salesforce mobile app
Available in: Enterprise, Developer, Performance, and Unlimited Editions

Permission Set Needed
To enter and modify data: Net Zero Cloud Manager

Allocate the default scope for the fuel. Depending on the scope, the relevant fields are populated and the other fields default to 0.

If you have not associated a scope allocation for a vehicle asset, then use the default scope allocations.

  • If the asset is owned, then it is scope 1 emissions.
  • If asset is not owned, then it is scope 3 downstream emissions.

For information about converting the values from one unit of measure to another compatible unit of measure, see Conversion Factors.

Here are the calculated fields:

  • Fuel Efficiency (mpg) (FuelEfficiencyInMpg)

    Input Fields

    • Fuel Efficiency Unit (FuelEfficiencyUnit)

    • Fuel Efficiency (FuelEfficiency)

    • Conversion Constant - L per 100 km To mpg

    Calculations

    If Fuel Efficiency Unit = “Miles per Gallon”, then Fuel Efficiency (mpg) = Fuel Efficiency

    If Fuel Efficiency Unit = “L per 100 km, then Fuel Efficiency (mpg) = 235.215/Fuel Efficiency

  • Aircraft Fuel Economy (gal/h) (AircraftFuelEconomyInGph)

    Input Fields

    • Aircraft Fuel Economy (AircraftFuelEconomy)

    • Aircraft Fuel Economy Unit (AircraftFuelEconomyUnit)

    • Constant - Liters to Gallons

    Calculations

    If Aircraft Fuel Economy Unit = “Gallons per Hour”, then Aircraft Fuel Economy (gal/h) = Aircraft Fuel Economy

    If Aircraft Fuel Economy Unit = “Liters per Hour”, then Aircraft Fuel Economy (gal/h) = Aircraft Fuel Economy × 0.26417205

  • Total Fuel Consumption (Liters) (TotalFuelConsumptionInLiter)

    Input Fields

    • If Record Type = “Private Jet”:

      • Fuel Consumption (FuelConsumption)

      • Fuel Consumption Unit (FuelConsumptionUnit)

      • Aircraft Fuel Economy (Gallons per Hour) (AircraftFuelEconomyInGph)

      • Flight Duration (Hours) (FlightDurationInHours)

      • Conversion constant - Liters to gallons

    • If Record Type = “Fleet Vehicle”:

      • Fuel Consumption (FuelConsumption)

      • Fuel Consumption Unit (FuelConsumptionUnit)

    Calculations

    • If Record Type = “Private Jet”:

      • If Fuel Consumption! = 0, then Total Fuel Consumption (Liters) = Fuel Consumption converted to liters.

      • If Fuel Consumption = 0, then Total Fuel Consumption (Liters) = (Aircraft Fuel Economy (Gallons per Hour) × Flight Duration (Hours))/0.26417205.

    • If Record Type = “Fleet Vehicle”:

      • If Fuel Consumption Unit = “Gallons”, then Total Fuel Consumption (Liters) = Fuel Consumption/0.26417205.

      • If Fuel Consumption Unit = “Liters”, then Total Fuel Consumption (Liters) = Fuel Consumption.

  • Total Fuel Consumption (US Gallons) (TotalFuelConsumptionInGal)

    Input Fields

    • Total Fuel Consumption (Liters) (TotalFuelConsumptionInLiter)

    • Conversion constant - Liters to gallons

    Calculations

    Total Fuel Consumption (US Gallons) = Total Fuel Consumption (Liters) × 0.26417205

  • CH4 Emissions (kg) (Ch4EmissionsInKg)

    Input Fields

    • If Record Type = “Private Jet”:

      • Total Fuel Consumption (US Gallons) (TotalFuelConsumptionInGal)

      • Other Emissions Factors (OtherEmissionFactor)

    • If Record Type = “Fleet Vehicle”:

      • Total Fuel Consumption (US Gallons) (TotalFuelConsumptionInGal)

      • Fuel Efficiency (mpg) (FuelEfficiencyInMpg)

      • Other Emissions Factors (OtherEmissionFactor)

      • Fuel Type (FuelType)

      • Fuel Consumption (FuelConsumption)

    Calculations

    If Record Type = “Private Jet”, then

    • CH4 Emissions (kg) = Total Fuel Consumption (US Gallons) × OtherEmissionFactor.OtherEmssnFctrSetItem.CH4 Emissions Factor (where Fuel Type = Jet Fuel and CH4 Emissions Factor converted to Kg/Gallon)

    If Record Type = “Fleet Vehicle” and Fuel Type = “Diesel”, “Autogas/LPG”, “Biodiesel”, “Compressed Natural Gas (CNG)”, “Ethanol”, or “Gasoline”,  and CH4 Emissions Factor unit is “g/Km” then

    • CH4 Emissions (kg) = Total Fuel Consumption (US Gallons) × Fuel Efficiency (mpg) × 1.60934 × OtherEmissionFactor.OtherEmssnFctrSetItem.CH4 Emissions Factor (where Fuel Type = OtherEmissionFactor.OtherEmssnFctrSetItem.Fuel Type and CH4 Emissions Factor converted to Kg/Km)

    If Record Type = “Fleet Vehicle” and Fuel Type = “Diesel”, “Autogas/LPG”, “Biodiesel”, “Compressed Natural Gas (CNG)”, “Ethanol”, “Gasoline” and CH4 Emissions Factor unit is NOT “g/Km” then

    • CH4 Emissions (kg)=Total Fuel Consumption (US Gallons) * OtherEmissionFactor.CH4 Emissions Factor (convert to Kg/Gallon)

    If Record Type = “Fleet Vehicle” and Fuel Type=”Electricity” then

    • CH4 Emissions (kg)=Fuel Consumption * OtherEmissionFactor.CH4 Emissions Factor (where, OtherEmissionFactor.Fuel Type = Electricity and CH4 Emissions Factor converted to kg/Kwh)

    If Record Type = “Fleet Vehicle” and Fuel Consumption  = null and Fuel Efficiency (mpg) = null and Distance != null then

    • CH4 Emissions (kg)= Distance Converted to Km * OtherEmissionFactor.CH4 Emissions Factor (where, Fuel Type = OtherEmissionFactor.Fuel Type  and CH4 Emissions Factor converted to Kg/Km)

    Default Value

    0

  • CO2 Emissions (kg) (Co2EmissionsInKg)

    Input Fields

    • If Record Type = “Private Jet”:

      • Total Fuel Consumption (US Gallons) (TotalFuelConsumptionInGal)

      • Other Emissions Factors (OtherEmissionFactor)

    • If Record Type = “Fleet Vehicle”:

      • Total Fuel Consumption (Liters) (TotalFuelConsumptionInLiter)

      • Other Emissions Factors (OtherEmissionFactor)

      • Fuel Type (FuelType)

      • Fuel Consumption (FuelConsumption)
      • CO2 Emissions (kg) (Co2EmissionsInKg)
      • Fuel Efficiency (FuelEfficiency)

    Calculations

    If Record Type = “Private Jet”, then

    • CO2 Emissions (kg) = Total Fuel Consumption (US Gallons) × OtherEmissionFactor.OtherEmssnFctrSetItem.CO2 Emissions Factor (where Fuel Type = Jet Fuel and CO2 Emissions Factor converted to Kg/Gallon)

    If Record Type = “Fleet Vehicle” and Fuel Type = “Diesel”, “Autogas/LPG”, “Biodiesel”, “Compressed Natural Gas (CNG)”, “Ethanol”, or “Gasoline”, then

    • CO2 Emissions (kg) = Total Fuel Consumption (Liters) × OtherEmissionFactor.OtherEmssnFctrSetItem.CO2 Emissions Factor (where FuelT ype = OtherEmissionFactor.OtherEmssnFctrSetItem.Fuel Type and CO2 Emissions Factor converted to Kg/L)

    If Record Type = “Fleet Vehicle” and Fuel Type = “Electricity” then

    • CO2 Emissions (kg) = Fuel Consumption * OtherEmissionFactor.OtherEmssnFctrSetItem.CO2 Emissions Factor (where, OtherEmissionFactor.OtherEmssnFctrSetItem.Fuel Type = “Electricity” and CO2 Emissions Factor converted to Kg/kwh)

  • If Record Type = “Fleet Vehicle” and Fuel Type = “Electricity” and Fuel Consumption  = null and Fuel Efficiency = null and Distance != null then

    • CO2 Emissions (kg) = Distance Converted to Km * OtherEmissionFactor.OtherEmssnFctrSetItem.CO2 Emissions Factor (where, Fuel Type = OtherEmissionFactor.OtherEmssnFctrSetItem.Fuel Type and CO2 Emissions Factor converted to Kg/km)

    Default Value

    0

  • N2O Emissions (kg) (N2oEmissionInKg)

    Input Fields

    • If Record Type = “Private Jet”:

      • Total Fuel Consumption (US Gallons) (TotalFuelConsumptionInGal)

      • Other Emissions Factors (OtherEmissionFactor)

    • If Record Type = “Fleet Vehicle”:

      • Total Fuel Consumption (US Gallons) (TotalFuelConsumptionInGal)

      • Fuel Efficiency (mpg) (FuelEfficiencyInMpg)

      • Other Emissions Factors (OtherEmissionFactor)

      • Fuel Type (FuelType)

    Calculations

    If Record Type = “Private Jet”, then

    • N2O Emissions (kg) = Total Fuel Consumption (US Gallons) × OtherEmissionFactor.OtherEmssnFctrSetItem.N2O Emissions Factor (where Fuel Type = Jet Fuel and N2O Emissions Factor converted to Kg/Gallon)

    If Record Type = “Fleet Vehicle” and Fuel Type = “Diesel”, “Autogas/LPG”, “Biodiesel”, “Compressed Natural Gas (CNG)”, “Ethanol”, or “Gasoline” and N2O Emissions Factor unit is “g/Km”, then

    • N2O Emissions (kg) = Total Fuel Consumption (US Gallons) × Fuel Efficiency (mpg) × 1.60934 × OtherEmissionFactor.OtherEmssnFctrSetItem.N2O Emissions Factor (where Fuel Type = OtherEmissionFactor.OtherEmssnFctrSetItem.Fuel Type and N2O Emissions Factor converted to Kg/Km)

    If Record Type = “Fleet Vehicle” and Fuel Type = “Diesel”, “Autogas/LPG”, “Biodiesel”, “Compressed Natural Gas (CNG)”, “Ethanol”, or “Gasoline” and N2O Emissions Factor unit is NOT “g/Km”, then

    • N2O Emissions (kg) = Total Fuel Consumption (US Gallons) × OtherEmissionFactor.OtherEmssnFctrSetItem.N2O Emissions Factor (where N2O Emissions Factor converted to Kg/Gallon)

    if(Total Fuel Consumption (US Gallons)  = null && Fuel Efficiency (mpg) = null && Distance != null) then

    • N2O Emissions (kg) = Distance * OtherEmissionFactor.OtherEmssnFctrSetItem.N2O Emissions Factor (where, FuelType = OtherEmissionFactor.Fuel Type and N2O Emissions Factor converted to Kg/km)

    If Record Type = “Fleet Vehicle” and FuelType = “Electricity” then

    • N2O Emissions (kg)= Fuel Consumption * OtherEmissionFactor.OtherEmssnFctrSetItem.N2O Emissions Factor (convert to Kg/Kwh)

    If Record Type = “Fleet Vehicle” and Fuel Consumption  = null and Fuel Efficiency (mpg) = null and Distance != null then

    • N2O Emissions (kg) = Distance Converted to Km * OtherEmissionFactor.OtherEmssnFctrSetItem.N2O Emissions Factor (where, Fuel Type = OtherEmissionFactor.OtherEmssnFctrSetItem.Fuel Type  and N2O Emissions Factor converted to Kg/Km)

    Default Value

    0

  • Scope 1 Emissions (tCO2e) (Scope1EmissionsInTco2e)

    Input Fields

    • If Record Type = “Private Jet”:

      • Total Fuel Consumption (US Gallons) (TotalFuelConsumptionInGal)

      • Other Emissions Factors (OtherEmssnFctr)

      • Supplemental Scope 1 Emissions (SuplScope1Emissions)

    • If Record Type = “Fleet Vehicle”:

      • N2O Emissions (kg) (N2oEmissionsInKg)

      • CO2 Emissions (kg) (Co2EmissionsInKg)

      • CH4 Emissions (kg) (Ch4EmissionsInKg)

      • Other Emissions Factors (OtherEmssnFctr)

      • Supplemental Scope 1 Emissions (SuplScope1Emissions)

      • Total Fuel Consumption (US Gallons) (TotalFuelConsumptionInGal)
      • Fuel Consumption (FuelConsumption)

    Calculations

    If the scope allocation for this energy use record is scope 1, then perform this calculation.

    If the scope allocation field is empty, then check, if Company-Owned Asset = true then Scope 1 else if not owned then Scope 3.

    • If Record Type = “Private Jet”, thenScope 1 Emissions (tCO2e) = Total Fuel Consumption (US Gallons) × [OtherEmssnFctr.OtherEmssnFctrSetItem.CO2 Emissions Factor (convert to Kg/Gal) + OtherEmssnFctr.OtherEmssnFctrSetItem.CH4 Emissions Factor (convert to Kg/Gal) × OtherEmssnFctr.CH4 Global Warming Potential + OtherEmssnFctr.OtherEmssnFctrSetItem.N2O Emissions Factor (convert to Kg/Gal) × OtherEmssnFctr.N2O Global Warming Potential]/1000 + Supplemental Scope 1 Emissions
    • If Record Type = “Fleet Vehicle”, thenScope 1 Emissions (tCO2e) = CO2 Emissions (kg)/1000 + CH4 Emissions (kg)/1000 × OtherEmssnFctr.CH4 Global Warming Potential +N2O Emissions (kg)/1000 × OtherEmssnFctr.N2O Global Warming Potential + Supplemental Scope 1 Emissions

    If Supplied CO2e Emissions Factor is null, then

    • If Record Type = “Private Jet”, then

      Scope 1 Emissions (tCO2e) = Total Fuel Consumption (US Gallons) × [OtherEmssnFctr.OtherEmssnFctrSetItem.CO2 Emissions Factor (convert to Kg/Gal) + OtherEmssnFctr.OtherEmssnFctrSetItem.CH4 Emissions Factor (convert to Kg/Gal) × OtherEmssnFctr.CH4 Global Warming Potential + OtherEmssnFctr.OtherEmssnFctrSetItem.N2O Emissions Factor (convert to Kg/Gal) × OtherEmssnFctr.N2O Global Warming Potential]/1000 + Supplemental Scope 1 Emissions

    • If Record Type = “Fleet Vehicle”, then

      Scope 1 Emissions (tCO2e) = CO2 Emissions (kg)/1000 + CH4 Emissions (kg)/1000 × OtherEmssnFctr.CH4 Global Warming Potential +N2O Emissions (kg)/1000 × OtherEmssnFctr.N2O Global Warming Potential + Supplemental Scope 1 Emissions.

    If Supplied CO2e Emissions Factor isn’t null, then

    • If Record Type = “Private Jet”, then

      Scope 1 Emissions (tCO2e) = Total Fuel Consumption (US Gallons) × OtherEmssnFctr.OtherEmssnFctrSetItem.Supplied CO2e Emissions Factor (convert to Kg/Gal)/1000 + Supplemental Scope 1 Emissions.

    • If Record Type = “Fleet Vehicle”, then

      • if(Total Fuel Consumption (US Gallons) != null) then Scope 1 Emissions (tCO2e) = Total Fuel Consumption (US Gallons) × OtherEmssnFctr.OtherEmssnFctrSetItem.Supplied CO2e Emissions Factor (convert to Kg/Gal)/1000 + Supplemental Scope 1 Emissions
      • if(Total Fuel Consumption (US Gallons) != null) then Scope 1 Emissions (tCO2e) = Fuel Consumption × OtherEmssnFctr.OtherEmssnFctrSetItem.Supplied CO2e Emissions Factor (convert to Kg/Kwh)/1000 + Supplemental Scope 1 Emissions
      • else if(Total Fuel Consumption (US Gallons) = null and Distance != null) then Scope 1 Emissions (tCO2e) = Distance (in km) × OtherEmssnFctr.OtherEmssnFctrSetItem.Supplied CO2e Emissions Factor (convert to Kg/Km)/1000 + Supplemental Scope 1 Emissions

    Default Value

    Scope 1 Emissions (tCO2e) = Supplemental Scope 1 Emissions

  • Scope 2 Location-Based Emissions (tCO2e) (Scope2LocBasedEmssnInTco2e)

    Input values

    • Supplemental Scope 2 Location-Based Emissions (tCO2e) (SuplScope2LocationBasedEmssn)
    • Carbon Emissions Scope Allocation (CrbnEmssnScopeAlloc)

    Calculations are same as Scope 1 Emissions (tCO2e) (include correct supplemental emissions), but will hold a value only if Carbon Emissions Scope Allocation = “Scope 2”

    Default Value

    Scope 2 Location-Based Emissions (tCO2e) = Supplemental Scope 2 Location-Based Emissions

  • Scope 2 Market-Based Emissions (tCO2e) (Scope2MktBasedEmssnInTco2e)

    Input values

    • Supplemental Scope 2 Market-Based Emissions (tCO2e) (SuplScope2MarketBasedEmssn)
    • Carbon Emissions Scope Allocation (CrbnEmssnScopeAlloc)

    Calculations are same as Scope 1 Emissions (tCO2e) (include correct supplemental emissions), but will hold a value only if Carbon Emissions Scope Allocation = “Scope 2”

    Default Value

    Scope 2 Market-Based Emissions (tCO2e) = Supplemental Scope 2 Market-Based Emissions

  • Scope 3 Downstream Emissions (tCO2e) (Scope3DnstrmEmissionsInTco2e)

    Input values

    • Supplemental Scope 3 Downstream Emissions (SuplScope3DnstrmEmissions)
    • Vehicle Asset Emissions Source (VehicleAssetEmssnSrc)
      • Carbon Emissions Scope Allocation (CrbnEmssnScopeAlloc)

    Calculations are same as Scope 1 Emissions (tCO2e) (include correct supplemental emissions), but will hold a value only if VehicleAssetEmssnSrc.Carbon Emissions Scope Allocation = “Scope 3 Downstream” or “Scope 3 Downstream Transportation and Distribution”

    Default Value

    Scope 3 Downstream Emissions (tCO2e) = Supplemental Scope 3 Downstream Emissions

  • Scope 3 Upstream Emissions (tCO2e) (Scope3UpstrmEmissionsInTco2e)

    Input values

    • Supplemental Scope 3 Upstream Emissions (SuplScope3UpstrmEmissions)
    • Vehicle Asset Emissions Source (VehicleAssetEmssnSrc)
      • Carbon Emissions Scope Allocation (CrbnEmssnScopeAlloc)

    Calculations are same as Scope 1 Emissions (tCO2e) (include correct supplemental emissions), but will hold a value only if VehicleAssetEmssnSrc.Carbon Emissions Scope Allocation = “Scope 3 Upstream” or “Scope 3 Employee Commuting” or “Scope 3 Business Travel” or “Scope 3 Upstream Transportation and Distribution”

    Default Value

    Scope 3 Upstream Emissions (tCO2e) = Supplemental Scope 3 Upstream Emissions

  • Scope 3 GHG Category (Scope3GhgCategory)

    Input values

    • Vehicle Asset Emissions Source (VehicleAssetEmssnSrc)
      • Carbon Emissions Scope Allocation (CrbnEmssnScopeAlloc)

    Calculations

    if VehicleAssetEmssnSrc.Carbon Emissions Scope Allocation =“Employee Commuting” or “Business Travel” or Upstream Transportation and Distribution“ or ”Downstream Transportation and Distribution” then

    Scope 3 GHG Category = VehicleAssetEmssnSrc.Carbon Emissions Scope Allocation

    else

    Scope 3 GHG Category = null

  • Fuel Efficiency (FuelEfficiency) and Fuel Efficiency Unit (FuelEfficiencyUnit)

    Input Fields

    • Fuel Efficiency (FuelEfficiency)

    • Fuel Efficiency Unit (FuelEfficiencyUnit)

    • Fuel Consumption (FuelConsumption)

    • Fuel Consumption Unit (FuelConsumptionUnit)

    • Total Fuel Consumption (US Gallons) (TotalFuelConsumptionInGal)

    • Total Fuel Consumption (Liters) (TotalFuelConsumptionInLiter)

    • Distance (Distance)

    • Distance Unit (DistanceUnit)

    Calculations

    If (Record Type = “Fleet Vehicle”)

    • If Fuel Efficiency = null then calculate the fuel efficiency
    • If fuel efficiency and distance traveled exist, update the Fuel Efficiency user input with the calculated value based on distance traveled and fuel consumption
    • If Distance Unit = “Miles”:

      • Fuel Efficiency = Distance/Total Fuel Consumption (US Gallons)

      • Fuel Efficiency Unit = “Miles per Gallon”

    • If Distance Unit = “Kilometers”:

      • Fuel Efficiency = Total Fuel Consumption (Liters) × 100/Distance

      • Fuel Efficiency Unit = “L per 100 km”

    If Fuel Efficiency is provided and the distance isn’t provided, don’t override user input.

  • Distance (Distance) and Distance Unit (DistanceUnit)

    Input Fields

    • Fuel Efficiency (FuelEfficiency)

    • Fuel Efficiency Unit (FuelEfficiencyUnit)

    • Fuel Consumption (FuelConsumption)

    • Fuel Consumption Unit (FuelConsumptionUnit)

    • Total Fuel Consumption (US Gallons) (TotalFuelConsumptionInGal)

    • Total Fuel Consumption (Liters) (TotalFuelConsumptionInLiter)

    • Distance (Distance)

    • Distance Unit (DistanceUnit)

    Calculations

    • If the user has provided a value, don’t override it.
    • If the value is null, then update the field with the calculated value.

    • If Fuel Efficiency Unit = “Miles per Gallon”:

      • Distance = Fuel Efficiency × Total Fuel Consumption (US Gallons)

      • Distance Unit = “Miles”

    • If Fuel Efficiency Unit = “L per 100 km”:

      • Distance = (1/Fuel Efficiency) ×100 × Total Fuel Consumption (Liters)

      • Distance Unit = “Kilometers”

    • If Fuel Type = Electricity, Fuel Efficiency is not relevant and can’t be used to calculate Fuel Consumption
    • Fuel Consumption

      Input fields

      • Fuel Efficiency (FuelEfficiency)
      • Fuel Efficiency Unit (FuelEfficiencyUnit)
      • Distance (Distance)
      • Distance Unit (DistanceUnit)

      Outputs

      • Fuel Consumption (FuelConsumption)
      • Fuel Consumption Unit (FuelConsumptionUnit)

      Calculations

      • if Record Type = “Fleet Vehicle” and Distance != null and Fuel Efficiency != null

        • If Fuel Efficiency Unit = “Miles per Gallon” and Distance Unit = “Miles”

          Fuel Consumption = Distance / Fuel Efficiency(in mpg)Fuel Consumption Unit = "Gallons"

        • If Fuel Efficiency Unit = “L per 100 km” and Distance Unit = “Kilometers”

          Fuel Consumption = (Distance * Fuel Efficiency)/100Fuel Consumption Unit = "Liters"

        • If Record Type = “Fleet Vehicle” and Distance != null and Fuel Efficiency = null

          Fuel Consumption can’t be calculated in this case with only Distance field

        • If Fuel Type = Electricity, Fuel Efficiency is not relevant and cannot be used to calculate Fuel Consumption