> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kodelabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Veolia

> Connect Veolia EMSYS or HUBGRADE to KODE OS for historical electric meter data

> 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.

| Property            | Value      |
| ------------------- | ---------- |
| **System Type**     | Meters     |
| **Communication**   | REST       |
| **Collection**      | Pull       |
| **Collection Mode** | HISTORICAL |

## 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.

| Field             | Required | Type     | Description                                     |
| ----------------- | -------- | -------- | ----------------------------------------------- |
| **Name**          | Yes      | text     | Name that identifies this connection in KODE OS |
| **Area**          | No       | object   | Area associated with the connection             |
| **URL**           | Yes      | text     | Veolia Meter Read API base URL                  |
| **Auth URL**      | Yes      | text     | URL used to request an access token             |
| **Client ID**     | Yes      | text     | OAuth client identifier issued by Veolia        |
| **Client Secret** | Yes      | password | OAuth client secret issued by Veolia            |
| **Portfolio ID**  | Yes      | dropdown | Veolia portfolio to collect                     |
| **Notes**         | No       | text     | Additional connection details                   |

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](/products/integrations/capabilities/discovery).

## Devices and points

Veolia meters map to the `electricMeter` canonical type.

| Point      | Description                                   | Unit    | Writable | Ontology field                      |
| ---------- | --------------------------------------------- | ------- | -------- | ----------------------------------- |
| `isBilled` | Indicates whether the meter reading is billed | boolean | No       | —                                   |
| `value`    | Cumulative electric energy                    | kWh     | No       | `total_electric_energy_accumulator` |
| `demand`   | Average electric demand                       | kW      | No       | `average_power_sensor`              |

## 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](/products/integrations/capabilities/data-collection).

## 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

<AccordionGroup>
  <Accordion title="Authentication or connection error">
    Verify the API URL, authorization URL, client ID, and client secret. Confirm the credentials can access the selected portfolio.
  </Accordion>

  <Accordion title="Discovery returns no meters">
    Confirm the selected portfolio contains meters available to the API client. Test the connection before you run discovery again.
  </Accordion>

  <Accordion title="The newest meter values are unavailable">
    Veolia updates the API data hourly. Allow for this delay before treating a missing recent value as a collection issue.
  </Accordion>
</AccordionGroup>