Purpose of this article
This article walks through the full ENERGY STAR Portfolio Manager (ESPM) data flow in Scaler: sharing properties, mapping assets, creating and mapping meters with Discovered Meters, and checking sync status.
Video walkthrough
Before you start
- Access level required: Portfolio Editor or Admin
- An active ENERGY STAR connection with Scaler. If you have not connected yet, see ENERGY STAR connection set-up
- Everything in this article happens on the Automations page: Data Collection Portal β Portfolio β Automations
How properties and meters get shared
If an ESPM property has not been shared and connected to an asset in Scaler before, Scaler configures it first, then mapping can begin.
If a property has already been shared and connected, any new meters you share for it are ready to map right away. Skip ahead to the Discovered Meters section below.
For the full sharing steps in ENERGY STAR Portfolio Manager, including bulk sharing and permission levels, see ENERGY STAR connection set-up.
The API Mapping page
Data Collection Portal β Portfolio β Automations β API Mapping is the default view when you open Automations. It gives a full picture of every asset's ESPM connection status.
Filter the list by year, vendor, resource type, status, property type, country, or sync start and end date.
Each row shows the asset name, client ID, and address, plus:
Asset mappedβ whether the asset is connected to a provider
Meters mappedβ how many meters are mapped, shown as a fraction (for example, 13/13)
Sync statusβ whether the mapped meters are syncing
Data sourcesβ which providers are connected, ESPM among them
Mapping a new asset to ESPM
Once a property is ready, either because it was already connected or because Scaler has finished configuring it:
- Find the asset and click Add data source
- Choose
Energy Staras the provider
- Select the utility types that apply:
energy,water,waste, individually or in any combination
- Click Map Asset and select the correct property from the connected sites dropdown
For the full mapping workflow, including bulk mapping meters, see Mapping assets and meters on the Automations page.
Creating and mapping meters with Discovered Meters
Data Collection Portal β Portfolio β Automations β Discovered Meters is where any new meters ESPM shares that have not been created in Scaler yet land, once the asset is mapped.
Each meter shows a status: Ready to configure, Review ready, Created, or Dismissed.
Open a meter and fill in the two fields it needs:
Area type
Purchased by
Click Save and create. This single action creates the meter in Scaler and maps it to the ESPM source, no separate mapping step needed.
You can also save your changes for later review, or click Dismiss if you do not want a meter in Scaler. Dismissed meters are not lost β restore them anytime from the Dismissed filter.
If you are processing several meters at once, select multiple rows and use the bulk actions in the table toolbar to edit them together.
Checking sync status
Back on the API Mapping page, click the Map Meters icon for an asset to see the meter data coming from ESPM side by side with the matching Scaler meter, along with a sync status for each: Fully synced, Partially synced, or Failed.
If a meter shows a partial or failed sync, go to Data Collection Portal β Portfolio β Asset List β [asset] β Meters & Consumption, then into the API integration section for that meter. This shows exactly where the sync is breaking down.
Scaler syncs new data daily. If you need an immediate refresh rather than waiting for the next scheduled sync, contact your Scaler account manager.
Troubleshooting partial syncs
Overlapping consumption dates in ESPM
A partial sync is often caused by an overlap in the consumption dates in ENERGY STAR Portfolio Manager β for example, one record's end date extends past the next record's start date, or the reverse. Check the consumption records for the affected meter directly in ESPM and correct the overlap there. The sync updates once the dates no longer overlap.
For other causes of missing or unexpected data, including mapping and provider-side checks, see Troubleshooting missing or unexpected data from an API integration.
Additional resources
- ENERGY STAR connection set-up β Connecting Scaler to ENERGY STAR Portfolio Manager for the first time
- Mapping assets and meters on the Automations page β The full asset and meter mapping workflow, including bulk mapping
- Troubleshooting missing or unexpected data from an API integration: working through provider, API and mapping checks in order
