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.