External integration - OCEA Smart Building (water and heating in condominiums)

Hi everyone! :waving_hand:

In a condominium, you receive an annual breakdown of charges… and you discover what you’ve consumed a year too late :sweat_smile: @Jluc asked to be able to track their meters managed by OCEA. Here is OCEA Smart Building: your water and heating readings directly in Gladys.

What it does

  • :droplet: Cold water and hot water, in m³, with their cumulative indices.
  • :fire: Heating, depending on what you have at home:
    • a thermal energy meter, in kWh, connected to Gladys’ energy tracking, including cost;
    • or distributors on the radiators, in units. This is not energy: these units only indicate what portion of the building’s heating bill you are responsible for. The integration therefore displays them honestly as a unitless meter, never in kWh.
  • :house: One device per apartment, even if you have several on the same account.
  • :puzzle_piece: A widget « OCEA Consumption »: the consumption of the month, fluid by fluid.
  • In French, English, German, and Spanish :wink:

The cool thing

High hot water consumption this week → a little reminder « we might have a dripping tap » :shower:
Beginning of winter → we compare the heating units from one month to another, before the year-end breakdown :fire:

Installation

:warning: Gladys 5.1 minimum.

:light_bulb: It will arrive in the store later today. In a hurry? Integrations → Install from GitHub, with the address GitHub - guim31/gladys-ocea: OCEA Smart Building water and heating consumption (French co-ownership meters) for Gladys Assistant · GitHub

  1. In the configuration, enter the email and password of your OCEA resident space (the one from https://espace-resident.ocea-sb.com).
  2. Click on Test connection and read.
  3. Discovery tab: add your apartment.

Readings are taken every 6 hours by default (adjustable from 1 hour to 24 hours): the meters are in any case only read once or a few times a day.

Honest small reservations

  • :warning: Beta, developed without an OCEA account. I still checked the connection against the real portal: it goes all the way and correctly recognizes a wrong password. What remains to be seen on a real account is the detail of the readings, especially for the distributors.
  • OCEA does not have a public API: the integration reads the portal like your browser, and may break if OCEA changes it.

@Jluc, this is your request: if you can try it, your feedback interests me a lot, especially what comes up for heating :folded_hands:

It is based on the Home Assistant integration ha_ocea_smart_building by Triskae, under MIT license: a big thank you to him!

Like the previous ones, developed with Claude Code :robot:. Independent project, not affiliated with OCEA Smart Building.

Repository: GitHub - guim31/gladys-ocea: OCEA Smart Building water and heating consumption (French co-ownership meters) for Gladys Assistant · GitHub

As with ISTA, I need to find the password to use and I think the property manager can help me.

Thanks again for your work :+1: