Energy Star - Upload data to ESPM and Request an Energy Star Score
1. Upload data to ESPM and Request an Energy Star Score
You can upload location data to ESPM via API and request an Energy Star Score back to Envizi at the same time.
There are two modes for data upload:
Full Data Sync - under this mode, Envizi will upload both property use details (including all historical) and utility data (12 months only ending selected month) to Energy Star Portfolio Manager(R) and request an ENERGY STAR® Score back via API.
Partial Data Sync - under this mode, Envizi will upload 12 months of utility (enegy & water) data only to Energy Star Portfolio Manager(R) and request an ENERGY STAR® Score back via API. It does not upload any Property or Property Use Details to Energy Star Portfolio Manager(R) under this mode.
This can be done via one of the following navigation paths:
On Location summary page → Action → Request ENERGY STAR(R) Score w Full (or Partial) Data Sync, or
On Location grid → right click → Request ENERGY STAR(R) Score(s) w Full (or Partial) Data Sync, or
On Location Ratings grid → Request a new ENERGY STAR Score w Full (or Partial) Data Sync (button on the top right of the page), or
On Location Ratings grid → select a Location Rating → right click → Re-request ENERGY STAR(R) Score w Full (or Partial) Data Sync (this is for a re-upload for the same month, should the previous request finished with errors)
The request would normally take 5 ~ 10 minutes from start to finish. Please be aware that it involves sending all property and property use details (in Full Data Sync mode) and 12 months of utility consumption data from Envizi to ESPM, and subsequently obtaining an Energy Star Score from ESPM and then stores it in Envizi. Please note if there are any existing property use details (in Full Data Sync mode) and utility consumption data in ESPM for the specified 12 months period, they will be overwritten by data from Envizi.
Partial Data Sync for a new location for the first time
If you request a ‘Partial Data Sync’ for a new location that has not been created in ESPM before, the first sync will upload Property information such as build year and address to ESPM (this is required when creating a new property in ESPM). It will not upload any property use details such as floor area or air conditioning % to ESPM.
Subsequent partial data sync for the same location will not upload any Property information.
Request score from Location Summary page
From Actions on the top right hand side of the location summary page select Request ENERGY STAR(R) w Full Data Sync or Request ENERGY STAR(R) w Partial Data Sync
Request score from Locations grid
You can also request an ENERGY STAR(R) Score from the locations grid rick-click action options.
On the pop up form, select an ending month for the data upload and rating request, and then click ‘SUBMIT’
Bulk Requests
You can also initiate the API process for multiple locations at the same time, by going to:
Locations grid or Group Locations grid → select multiple locations → right click → Request ENERGY STAR(R) Score(s) w Full Data Sync or Request ENERGY STAR(R) Score(s) w Partial Data Sync
Please note API requests will be carried out sequentially for each location, so please do anticipate that the entire process would take longer than usual time (up to a couple of hours) to complete, based on the number of locations selected.
2. Check API job status of the request
The API job involves a series of data exchange and web service API calls to ESPM, such as uploading building data, consumption data and requesting a score etc.
Job History tab
You can see the status of each step in the ENERGY STAR(R) API Job History section on the right hand preview panel of Location Ratings page. Collapse and re-expand the preview panel section will refresh the latest status.
Full Data Sync vs. Partial Data Sync
The first API job status message in the preview panel are slightly different when running under ‘Full Data Sync’ mode and ‘Partial Data Sync’ mode. The ‘Full Data Sync’ mode includes the upload of all property use details data to ESPM while the ‘Partial Data Sync’ mode does not.
Energy Star report
Alternatively, you can also use Energy Star Ratings report to check API job statuses for all Locations, instead of going into each Location one by one. You can find this report in the Benchmark sub-menu at organization, group or location.
3. Additional help
Sometimes the API process may fail to proceed due to insufficient data being provided to ESPM. The API Troubleshooting page has documented some of the most commonly found data issues. Alternatively, the Energy Star API Transation Logs could also be reviewed further to determine root causes of issues.
This module supports uploading of data from Envizi to ENERGY STAR(R) Portfolio Manager (R) only, but not vice versa.
Property types that are not listed in on this page are not supported.