Skip to main content
Connect Veolia EMSYS or HUBGRADE to KODE OS for electric meter data

Overview

Use this integration to collect historical meter readings from the Veolia EMSYS or HUBGRADE platform. The connector brings meter status, cumulative energy, and demand into KODE OS.

Supported capabilities

  • Discover devices and points
  • Collect sensor data
  • Collect historical data

Prerequisites

  • Access to the Veolia Meter Read API
  • The API and authorization URLs
  • A client ID and client secret
  • Access to the required Veolia portfolio
  • KODE OS access to Data Sources

Configure the connector in KODE OS

  1. Open Data Sources for your building.
  2. Select API Catalog, then search for Veolia API.
  3. Select + Add Datasource.
  4. Complete the connector fields.
KODE OS authenticates with the client credentials, then sends a Bearer token on each data request.

Discover devices and points

After you save the connector, select Discover. Review the returned meters and points, then save the records you want in KODE OS. For more details, see the Discovery guide.

Devices and points

Veolia meters map to the electricMeter canonical type.

What data you get

Point history

The connector collects the same meter-read data available in Veolia EMSYS or HUBGRADE. Veolia updates the API data hourly.

Polling schedule

  • Point history — Default polling: 15 minutes
For more details, see the Data collection guide.

Use cases

Once connected, you can:
  • Monitor electric meter status and cumulative usage
  • Analyze historical consumption and demand trends
  • Use standardized meter data in Building BI dashboards and energy reports

Troubleshooting

Verify the API URL, authorization URL, client ID, and client secret. Confirm the credentials can access the selected portfolio.
Confirm the selected portfolio contains meters available to the API client. Test the connection before you run discovery again.
Veolia updates the API data hourly. Allow for this delay before treating a missing recent value as a collection issue.
Last modified on September 15, 2026