Integration - Veolia

Hello everyone,

Following the request from @Olivier.L57, here is a first version of the Veolia external integration: it retrieves your water consumption from your Veolia customer space (eau.veolia.fr).

What it does

  • A « Water Meter » device per subscription:
    • meter index (m³)
    • daily consumption (L)
    • monthly and yearly consumption (m³)
  • The history is dated correctly: Veolia publishes readings with 1 to 3 days delay, each reading is sorted by the date the water was consumed. When the meter is added, the current month and the previous month are imported.
  • A dashboard widget: last day, month, year, index, daily graph (7, 14 or 30 days), reading date and reliability (measured / estimated), Refresh button.
  • 3 scene triggers:
    • New water reading
    • High water consumption: threshold in liters/day, useful for detecting a leak
    • Water reading late: the meter is no longer reporting
  • 2 scene actions:
    • Refresh water consumption
    • Get water consumption: last day, this month, last month, this year, in L and m³ (e.g.: a message on the 1st of each month with the consumption of the previous month)
  • Cloud Badge on the device: Cloud / Unreachable, with an orange dot if no more readings are coming in.
  • « Check my town » button in the configuration: enter your postal code, it tells you if your town is managed and on which portal.

Prerequisites

  • Gladys 5.1 or newer
  • A remote-read water meter and a Veolia customer space (e-mail + password)
  • Managed portals: eau.veolia.fr and Eau de Toulouse Métropole

@Olivier.L57: good news, Metz (57000) goes through the eau.veolia.fr portal :slightly_smiling_face:

Installation

  1. In Gladys: Integrations → Install an integration, search for Veolia
  2. Configuration tab: Veolia e-mail and password, then Test the connection
  3. Discovery tab: add the water meter
  4. Add the Water Consumption widget to your dashboard

Documentation: gladys-veolia/docs/fr.md at main · prohand/gladys-veolia · GitHub Source code: GitHub - prohand/gladys-veolia: Gladys external integration to connect veolia in Gladys · GitHub

To know

  • Veolia does not offer an official API for this data. The integration works like the website (same method as the Veolia Home Assistant integration). If Veolia changes its website, an update will be needed.
  • Your credentials remain in the Gladys configuration and are only sent to Veolia. The integration only reads: it does not modify anything on your account.
  • Reading every 6 hours by default (adjustable): Veolia only publishes one reading per day.

Need testers

I don’t have a Veolia meter: your feedback is precious!

  • Does Test the connection display your meter and your last reading correctly?
  • Do the values match those on the Veolia website?
  • Does your town have its own Veolia portal? Give me its address, I will add it.

In case of issues, open an issue on GitHub or reply here with the integration logs (remember to hide your e-mail and your meter number).

Thanks!

Hi @prohand, I opened an issue on Github to add my Veolia portal

Hi @Will_71,

Thanks for the issue and for the very complete report! It’s in place in v1.3.0.

New portals managed

  • C Mon O
  • Atlantic’Eau
  • Calléo
  • Eau du Coquelicot
  • Eaux de Dinan
  • Nantes Métropole
  • Odici
  • SMAEP Ouest Briard
  • Sobass
  • Valyo
  • Vendée Eau

They are added to eau.veolia.fr and Eau de Toulouse Métropole.

To test C Mon O

  1. Update the Veolia integration in Gladys.
  2. Configuration tab → Customer space: choose C Mon O.
  3. Click on Test the connection, then add the meter in Discovery.

The Check my town button now indicates the correct portal to choose for the towns of these services (for example La Roche-sur-Yon → Vendée Eau).

I don’t have an account on these portals, so your feedback on C Mon O is very interesting to me. If it doesn’t work, put the message displayed in the status here or on the issue, without the password.

Release notes: Release v1.3.0 · prohand/gladys-veolia · GitHub

Thanks @prohand, I have a test tomorrow, I’ll keep you posted.

@prohand, I managed to log in, I have my meter but no data has been sent to Gladys. All values are zero.
Maybe the API doesn’t return any values in my region?

Nothing in the logs.

Thanks @Will_71! I think your meter is not remotely read: Veolia then does not have daily readings, only billed volumes. Update the integration (v1.3.1) then click on Test the connection: the message now indicates the type of reading provided by Veolia. You can also check « Reading type » on your C Mon O subscription page. Let me know what is displayed.
Version 1.3.1 no longer displays false zeros, and the logs indicate what Veolia returns with each refresh.

Here is the result: Connected. Meter XXXXXXXXXXXX: no reading yet.

image

@Will_71: Version 1.3.2 is available. Update the integration, then click Test Connection. The message now provides the meter reading type (or “not specified”) and the number of readings that Veolia sends. Copy the line for me (you can hide the meter number). If the type is “not specified,” also send the log line that starts with Subscription … no mode_releve.

Connected. Meter XXXXXXXXXX: no reading yet (reading type: not indicated; Veolia has sent 0 reading(s) per day and 0 per month).

[2026-11-01T09:07:57.352Z] [WARN] [veolia] Subscription xxxxxxx: no mode_releve in the billing data, fields: bic, code_insee_facturation, code_societe, code_postal_facturation, date_debut_abonnement, date_index_releve, dernier_index_releve, facture_numerique, iban, is_resiliable, is_abonnement_iris, marque, mode_paiement, numero_abonnement, numero_client, numero_compteur, numero_pds, releve_en_cours, solde, statut, titulaire, indicateur_consentement, index_horaire_autorise, statut_consentement
[2026-11-01T09:07:58.799Z] [INFO] [sync] Meter xxxxxxx: (reading mode unknown): 0 daily record(s) -> 0 reading(s), 0 monthly record(s) -> 0 total(s)
[2026-11-01T09:07:58.820Z] [INFO] [sync] Meter xxxxxxx: history imported (0 daily reading(s))
[2026-11-01T09:08:08.256Z] [INFO] Action test_connection
[2026-11-01T09:08:08.763Z] [INFO] [sync] Meter xxxxxxx: (reading mode unknown): 0 daily record(s) -> 0 reading(s), 0 monthly record(s) -> 0 total(s)

Your app works but I have no reading.

Thanks @Will_71, that’s very clear!

Veolia does not provide a « meter reading type » for your meter. On your portal, the C Mon O website then does not display daily consumption. It only displays the billed volumes (one line per invoice: period, m³, index). Your meter is therefore not remotely read by Veolia.

Can you confirm what you see on C Mon O, under the consumption section? A daily curve, or just a list « From … to … » with m³?

If it’s the list, I can add that in the integration:

  1. Yes, add the billed volumes: Gladys would have the meter index with each invoice and the consumption of each billed period. This only changes a few times a year, and there will be no daily value.
  2. No, not useful for me: I leave it as is, with a clearer message (« meter not remotely read ») in Test the connection.

Let me know what you prefer.

I only have the list of billed m3.
If you could add the billed volumes, that would be great.

@Will_71: It’s done, v1.4.0 reads billed volumes.

  1. Update the integration.
  2. Click on Test Connection: you should see « not tele-read… Last invoice: X m³ (date → date), index Y m³ ».
  3. As your meter is already added, go to Discovery and click on Update: this adds the « Billed Consumption » value.
  4. The Water Consumption widget displays the last invoice, the index, and a graph of the last invoices.

The values are sorted by the date of each invoice, so they only change a few times a year. I don’t have a C Mon O account to test: let me know if the numbers match those on the website.

It’s perfect like this until I get the daily statement from Veolia.