How can we help? πŸ‘‹

Understanding the ENERGY STAR data sync process

How properties and meters sync from ENERGY STAR Portfolio Manager into Scaler, from sharing and mapping to checking sync status and resolving issues.

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

  1. Find the asset and click Add data source
  1. Choose Energy Star as the provider
  1. Select the utility types that apply: energy, water, waste, individually or in any combination
  1. 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

Did this answer your question?
😞
😐
🀩