StnryAssetEnrgyUse

Represents the energy consumption related to stationary assets across multiple fuel types. This object is available in API version 54.0 and later.

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

  • Type: double

  • Properties: Filter, Nillable, Sort

  • Description: Total energy attribute certificate credits from the biomass clean energy type that are allocated to this energy use record.

    Available in API version 59.0 and later.

  • Type: double

  • Properties: Filter, Nillable, Sort

  • Description: Total energy attribute certificate credits from the geothermal clean energy type that are allocated to this energy use record.

    Available in API version 59.0 and later.

  • Type: double

  • Properties: Filter, Nillable, Sort

  • Description: The total energy attribute certificate credits that are allocated to this energy use record.

    Available in API version 59.0 and later.

  • Type: double

  • Properties: Filter, Nillable, Sort

  • Description: Total energy attribute certificate credits from the solar clean energy type that are allocated to this energy use record.

    Available in API version 59.0 and later.

  • Type: double

  • Properties: Filter, Nillable, Sort

  • Description: Total energy attribute certificate credits from the wind clean energy type that are allocated to this energy use record.

    Available in API version 59.0 and later.

  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The value to override the allocated renewable energy for the energy use record.
  • 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.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The CH4 emissions that are calculated for this energy use record.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The CO2 emissions that are calculated for this energy use record.

  • 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 stationary asset for the fuel type.

  • Possible values:

    • SCOPE1—Scope 1
    • SCOPE2—Scope 2
    • SCOPE3Downstream—Scope 3 Downstream
    • SCOPE3DownstreamLeasedAssets—Scope 3 Downstream Leased Assets
    • SCOPE3EmpComut—Scope 3 Employee Commuting
    • SCOPE3Franchises—Scope 3 Franchises
    • SCOPE3Investments—Scope 3 Investments
    • SCOPE3Upstream—Scope 3 Upstream
    • SCOPE3UseOfSoldProducts—Scope 3 Use of Sold Products
    • SCP3CptlGoods—Scope 3 Capital Goods
    • SCP3EndLifeTreatSoldProducts—Scope 3 End-of-Life Treatment of Sold Products
    • SCP3FuelEnergyRelatedActv—Scope 3 Fuel and Energy-Related Activities
    • SCP3ProcessingSoldPrdct—Scope 3 Processing of Sold Products
    • SCP3PurchGoodsServices—Scope 3 Purchased Goods and Services
    • SCP3UpstrmLsdAst—Scope 3 Upstream Leased Assets
    • SCP3WasteGeneratedInOperations—Scope 3 Waste Generated In Operations

  • Type: picklist

  • Properties: Filter, Group, Nillable, Restricted picklist, Sort

  • Description: The data gap filling method that’s used if this record was generated by the application.

  • Possible values:

    • BUILDING_BENCHMARK—Building Energy Intensity
    • DAILY_AVERAGE_CURRENT_YEAR—Current Year Daily Average
    • DAILY_AVERAGE_LAST_YEAR—Previous Year Daily Average
    • Manual
    • REGIONAL_BENCHMARK—Regional Building Energy Intensity
  • Type: reference
  • Properties: Filter, Group, Nillable, Sort
  • Description: The greenhouse gas emissions that occur during the electricity lifecycle. This includes emissions from producing electricity and losses during the transmission and distribution of each kilowatt hour (kWh) of electricity. This field is a relationship field.
  • Relationship Name: ElectrLifecyclEmssnFctrSet
  • Refers To: ElectrLifecyclEmssnFctrSet
  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The electricity emissions factors record associated with this location. This is a relationship field.
  • Relationship Name: ElectricityEmissionFactors
  • Relationship Type: Lookup
  • Refers To: ElectricityEmssnFctrSet
  • Type: date
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The date until when the values of this energy use record are valid.
  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The estimated energy use job run related to this stationary asset energy use record. This field is a relationship field.
  • Relationship Name: EstmtEnergyUseJobRun
  • Refers To: EstmtEnergyUseJobRun
  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The final energy consumption calculated using the data gap-filling method.
  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The amount of fuel consumed during the data entry period.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The amount of fuel consumed during the data entry period in GJ (gigajoules).
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The amount of fuel consumed during the data entry period in kWh.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The average fuel consumption per day. This field is a calculated field.

  • 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.

  • Default value: kWh

  • Possible values:

    • 1000m3—1000 m3
    • GJ
    • GWh
    • Kiloliters
    • Liters
    • MJ
    • MMBtu
    • MWh
    • Therms
    • Tonnes
    • UkGallons—Uk Gallons
    • UsGallons—Us Gallons
    • ccf
    • kG—kg
    • kWh
    • kcal
    • lbs
    • longTons—long tons
    • m3
    • shortTons—short tons
  • Type: reference
  • Properties: Filter, Group, Nillable, Sort
  • Description: This field is a relationship field.
  • Relationship Name: FuelConsumptionUnitRef
  • Relationship Type: Lookup
  • Refers To: SustainabilityUom

  • 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:

    • CityGas—City Gas
    • Cooling
    • Diesel
    • Electricity
    • FuelOil—Fuel Oil
    • Heat
    • HeavyOil—Heavy Oil
    • Kerosene
    • LightOil—Light Oil
    • LiquidNaturalGasLNG—Liquid Natural Gas (LNG)
    • NaturalGas—Natural Gas
    • Propane
    • Refrigerant
    • Steam
  • Type: reference
  • Properties: Filter, Group, Nillable, Sort
  • Description: This field is available in API version 57.0 and later. This field is a relationship field.
  • Relationship Name: FuelTypeRef
  • Relationship Type: Lookup
  • Refers To: FuelType
  • Type: boolean
  • Properties: Defaulted on create, Filter, Group, Sort
  • Description: Indicates whether the asset is owned by the organization.
  • Default value: false
  • Type: boolean
  • Properties: Defaulted on create, Filter, Group, Sort
  • Description: Indicates whether the monthly power usage effectiveness range is between 1 and 2.
  • Default value: false
  • Type: boolean
  • Properties: Defaulted on create, Filter, Group, Sort
  • Description: Indicates that the stationary asset energy use record is locked for editing because the associated carbon footprint is locked for editing.
  • Default value: false
  • Type: boolean
  • Properties: Create, Defaulted on create, Filter, Group, Sort, Update
  • Description: Indicates whether the energy use record was created by data gap filling.
  • Default value: false
  • Type: dateTime
  • Properties: Filter, Nillable, Sort
  • Description: The timestamp for when the current user last viewed a record related to this record.
  • 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.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total electricity generated from biomass for all the associated energy use records, that’s used to calculate emissions using the location-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total electricity generated from nuclear power for all the associated energy use records, that’s used to calculate emissions using the location-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total electricity generated from other fuel energy sources for all the associated energy use records, that’s used to calculate emissions using the location-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total electricity generated from coal for all the associated energy use records, that’s used to calculate emissions using the location-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total electricity generated from gas for all the associated energy use records, that’s used to calculate emissions using the location-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total electricity generated from hydroelectric energy sources for all the associated energy use records, that’s used to calculate emissions using the location-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total electricity generated from oil for all the associated energy use records, that’s used to calculate emissions using the location-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total electricity generated from solar photovoltaic energy sources for all the associated energy use records, that’s used to calculate emissions using the location-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total electricity generated from wind for all the associated energy use records, that’s used to calculate emissions using the location-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total electricity generated from geothermal energy sources for all the associated energy use records, that’s used to calculate emissions using the location-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total electricity generated from geothermal energy sources for all the associated energy use records, that’s used to calculate emissions using the location-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total electricity generated from other fossil fuel energy sources for all the associated energy use records, that’s used to calculate emissions using the location-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total electricity generated from biomass for all the associated energy use records, that’s used to calculate emissions using the market-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total electricity generated from nuclear power for all the associated energy use records, that’s used to calculate emissions using the market-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total electricity generated from coal for all the associated energy use records, that’s used to calculate emissions using the market-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total electricity generated from gas for all the associated energy use records, that’s used to calculate emissions using the market-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total electricity generated from hydroelectric energy sources for all the associated energy use records, that’s used to calculate emissions using the market-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total electricity generated from oil for all the associated energy use records, that’s used to calculate emissions using the market-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total electricity generated from solar photovoltaic energy sources for all the associated energy use records, that’s used to calculate emissions using the market-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total electricity generated from wind for all the associated energy use records, that’s used to calculate emissions using the market-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total electricity generated from other fuel energy sources for all the associated energy use records, that’s used to calculate emissions using the market-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The CH4 emissions for the associated energy use record, that’s calculated using the market-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The CO2 emissions for the associated energy use record, that’s calculated using the market-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total electricity generated from geothermal energy sources for all the associated energy use records, that’s used to calculate emissions using the market-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The percentage of total non-renewable energy generated from coal, gas, nuclear, oil, and other sources for this market.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total electricity generated from other fossil fuel energy sources for all the associated energy use records, that’s used to calculate emissions using the market-based method.
  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The electricity emissions factors record associated with this energy use record that’s used to calculate emissions using the market-based method. This field is a relationship field.
  • Relationship Name: MktBsdElectriEmssnFctr
  • Relationship Type: Lookup
  • Refers To: ElectricityEmssnFctrSet
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The N2O emissions for the associated energy use record, that’s calculated using the market-based method.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The N2O emissions that are calculated for this energy use record.
  • Type: string
  • Properties: Create, Filter, Group, idLookup, Sort, Update
  • Description: The name for this energy use record.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The normalized value of the average monthly electricity consumption that’s calculated based on the electricity consumption, report start date, and report end date.
  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The value to override the occupied floor area of the associated stationary asset.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The floor area occupied by the stationary asset associated with this energy use record in square foot.

  • Type: picklist

  • Properties: Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update

  • Description: The unit of measure for the occupied floor area of the stationary asset associated with this energy use record.

  • Default value: sqft

  • Possible values:

    • m2
    • sqft
  • 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
  • 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
  • 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
  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The ratio that describes how efficiently a computer data center uses the energy.
  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The energy consumption proposed by the data gap-filling method
  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The refrigerant emissions factor record containing global warming potential values. This is a relationship field.
  • Relationship Name: RefrigerantEmssnFctr
  • Relationship Type: Lookup
  • Refers To: RefrigerantEmssnFctr

  • Type: picklist

  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update

  • Description: Specifies the energy type to override the renewable energy that’s accounted for in an allocated renewable energy.

  • Possible values:

    • BIOMASS—Biomass
    • GEOTHERMAL—Geothermal
    • HYDROELECTRICITY—Hydroelectricity
    • SOLAR—Solar
    • WIND—Wind
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total scope 1 emissions from all the associated energy use records and supplemental emissions.
  • 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.
  • 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.
  • 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.

  • Type: picklist

  • Properties: Filter, Group, Nillable, Restricted picklist, Sort

  • Description: Specifies the scope 3 GHG category related to the energy use by the stationary asset environmental source.

  • Possible values:

    • SCOPE3DownstreamLeasedAssets—Scope 3 Downstream Leased Assets
    • SCOPE3EmpComut—Scope 3 Employee Commuting
    • SCOPE3Franchises—Scope 3 Franchises
    • SCOPE3Investments—Scope 3 Investments
    • SCOPE3UseOfSoldProducts—Scope 3 Use of Sold Products
    • SCP3CptlGoods—Scope 3 Capital Goods
    • SCP3EndLifeTreatSoldProducts—Scope 3 End-of-Life Treatment of Sold Products
    • SCP3FuelEnergyRelatedActv—Scope 3 Fuel and Energy-Related Activities
    • SCP3ProcessingSoldPrdct—Scope 3 Processing of Sold Products
    • SCP3PurchGoodsServices—Scope 3 Purchased Goods and Services
    • SCP3UpstrmLsdAst—Scope 3 Upstream Leased Assets
    • SCP3WasteGeneratedInOperations—Scope 3 Waste Generated In Operations
  • 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.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The methane (CH4) emissions from producing, transmitting, and delivering fuels and energy a company purchases.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The carbon dioxide (CO2) emissions from producing, transmitting, and delivering fuels and energy a company purchases.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The emissions, measured in metric tons, that occur upstream from a company’s direct use of energy, such as the extraction, refining, production, transmission, and transport of fuels.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The market-based emissions, measured in metric tons, that occur upstream from a company’s direct use of energy, such as the extraction, refining, production, transmission, and transport of fuels.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The nitrous oxide (N2O) emissions from producing, transmitting, and delivering fuels and energy a company purchases.
  • Type: date
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The date from when the values of this energy use record are valid.
  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The stationary asset carbon footprint record associated with this energy use record. This is a relationship field.
  • Relationship Name: StnryAssetCrbnFtprnt
  • Relationship Type: Lookup
  • Refers To: StnryAssetCrbnFtprnt
  • Type: reference
  • Properties: Create, Filter, Group, Sort, Update
  • Description: The stationary asset environmental source record associated with this energy use record. This is a relationship field.
  • Relationship Name: StnryAssetEnvrSrc
  • Relationship Type: Lookup
  • Refers To: StnryAssetEnvrSrc
  • 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
  • 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
  • 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
  • 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
  • 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
  • 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
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total renewable energy excluding hydroelectric energy. This value is calculated based on the market-based grid mix values and allocated renewable energy values.
  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The value to override the total floor area of the associated stationary asset environmental source.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total floor area of the stationary asset associated with this energy use record in square foot.

  • Type: picklist

  • Properties: Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update

  • Description: The unit of measure for the total floor area of the stationary asset associated with this energy use record.

  • Default value: sqft

  • Possible values:

    • m2
    • sqft
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total fuel consumed in kWh. This value is calculated by multiplying the electricity consumed with the power usage effectiveness value.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Description: The total renewable energy in kWh that’s calculated based on the market-based grid mix values and the allocated renewable energy value.

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.

StnryAssetEnrgyUseChangeEvent (API Version 63.0)

Change events are available for the object.

StnryAssetEnrgyUseFeed

Feed tracking is available for the object.

StnryAssetEnrgyUseHistory

History is available for tracked fields of the object.

StnryAssetEnrgyUseShare

Sharing is available for the object.