What do we need from you before onboarding?

An overview of the two things Enersee needs before your sites can go live: master data (buildings and meters) via the Master Data File, and a way to get your time series data into the platform.

Written By Arnor Van Leemputten

Last updated About 1 month ago

What does Enersee need before onboarding can start?

Before your sites can go live in Enersee, we need two things from you: master data and time series data. Both are required. The quality and completeness of this information directly determines how quickly your onboarding can be completed and how accurately the platform can analyse your energy consumption.

1. Master data

Master data is the structural information that describes your buildings and meters. Enersee uses this to set up your portfolio correctly in the platform. It is provided via the Enersee Master Data File (MDF), a structured spreadsheet template that your onboarding contact will share with you.

Buildings

For each building, the following fields are required (marked with *):

  • Building name

  • Building function (e.g. retail store, office building, warehouse)

  • Gross internal area in m2 (according to IPMS 2 standards)

  • Address: street, number, zip code, city, country

  • EV charging installation: yes/no, and capacity if applicable

  • Solar installation: yes/no, and if yes: nominal installed power (kWp), orientation relative to south, and slope in degrees

  • Wind energy: yes/no

  • Direct combustion: yes/no (gas or gasoline use in the building)

  • CHP installation: yes/no (combined heat and power)

Optional fields include a building description and the name of the site the building belongs to.

Meters

For each meter, the following fields are required:

  • Meter name

  • Meter identifier: a unique ID used in the Enersee system, must be URL-safe and unique across all meters

  • Meter category: what the meter is measuring (e.g. HVAC, lighting, total consumption, EV, solar)

  • Building: which building this meter belongs to

  • Utility type: electricity, gas, water, or thermal energy

  • Time resolution: 15 minutes or hourly

  • Unit: the unit to display in the platform (kWh, m3, l)

  • External meter value: the unique identifier of the meter in your system or API

  • Official meter: yes/no, whether this is an EAN meter used for invoicing

  • Virtual meter: whether this is a physical meter or a virtual aggregation of other meters

For virtual meters, you also need to specify which meter IDs are added or subtracted to calculate the virtual value. For meters that are part of a hierarchy, the parent meter ID is required.

⚠️ Incomplete or inconsistent master data is the most common cause of onboarding delays. Take time to fill in the MDF carefully, especially meter identifiers and building-meter links. Your onboarding contact will validate the file before import.

2. Time series data

Time series data is the actual meter readings over time. Enersee needs this data to populate your portfolio and, where historical data is available, to train the anomaly detection baseline models.

There are two ways to get data into Enersee:

You send data to us

If your metering system can push data outward, we can receive it via:

  • MQTT: for real-time or near-real-time streaming

  • SFTP: for scheduled batch file transfers

  • API: for push-based integrations

We collect data from you

If your data is already stored in an existing system or EMS, Enersee can connect to it and retrieve data via API. Your onboarding contact will work with you to set up the connection and confirm the required credentials and access rights.

πŸ’‘ The more historical data you can provide, the better. Anomaly detection requires at least 9 months of historical data per meter to train a reliable baseline. A full year is ideal.

Getting started

Your Enersee onboarding contact will send you the Master Data File template and walk you through how to fill it in. Once the MDF is validated and a data connection is established, your sites can be activated in the platform.

If you have questions about the required fields or how to set up a data connection, reach out to your onboarding contact before filling in the template.