EDF Zen Flex Smart-Home-Integration, kostenlos und Open Source
Unofficial: EDF Zen Flex Sobriété and Bonus days, and the contract priced right in Gladys.
Veröffentlicht von LM1LC3N7
- Geräte
- Version 0.1.1
- Erfordert Gladys >=5.2.0
- ★ 0
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
Unofficial integration, not affiliated with EDF. It brings the French EDF Zen Flex electricity offer (commercial name: "Zen Week-End – Option Flex") to Gladys:
- the type of each day (Éco, Sobriété, Bonus), read the day before from the EDF website, in the
zen-flextariff calendar of Gladys; - an "EDF Zen Flex" contract template that Gladys prices itself from that calendar;
- a scene trigger "EDF Zen Flex day announced", to get the home ready the day before a Sobriété day.
Not tested on a real Gladys installation with a meter under a Zen Flex contract: reading the EDF website was checked for real on 11 November 2026, the pricing on the tariff engine of Gladys 5.3.
The source: a public page of the EDF website, undocumented
The integration reads the endpoint that the Zen Flex page of the EDF website uses itself
(particulier.edf.fr/services/rest/opm/getOPMStatut): no account, no login, with its own User-Agent
(gladys-edf-zen-flex/<version>), never a browser's nor the EDF app's. It gives the type of today and of
tomorrow, or "not announced yet".
EDF does not document this endpoint and may change or close it without notice. Any answer of an unexpected form (an unknown code, a missing key, an HTML page…) is refused as a whole: the status shows "EDF cannot be read: answer of an unexpected form", nothing is published, and the days already known stay as they are. No day is ever made up: a day not announced stays unknown.
EDF sees the IP address of your home and the User-Agent of the module; no other data leaves.
When the module asks EDF
EDF announces tomorrow by 16:00 at the latest. The module reads at these Paris times, and only when something is missing:
| Time | Read when |
|---|---|
| 00:15 | the type of today is unknown |
| 10:15, 13:15, 16:15 | the type of today or tomorrow is unknown; at 16:15 also when tomorrow was read before 16:00 |
| 17:15, 19:15, 22:15 | the same (late announcement) |
(EDF may still change a tomorrow read before 16:00: it is read once more at 16:15.) An ordinary day thus makes
3 readings (10:15, 13:15, 16:15), then nothing until the next day. At the first start,
one reading goes at once. Two readings are at least 10 minutes apart, restarts included (the time of the
attempt is written to /data before the request).
On a failure: tried again after 5 (raised to 10), 15, 30 and 60 minutes, then every 2 hours. A 429 answer pauses
for the time its Retry-After asks (between 1 minute and 6 hours, 30 minutes without the header); a 403 answer
(the website refuses the module) pauses 6 hours. The module does not try to get around a refusal.
The contract
Open Integrations → Energy monitoring → Contracts, create a contract from the EDF Zen Flex template and check its prices. Gladys computes the cost of your consumption with its own tariff engine; the module only feeds the calendar.
Pre-filled prices: EDF "Zen Week-End" grid, Flex option, taxes included, applicable from 15 September 2026 to new contracts (PDF). EDF may revise them twice a year: use those of your bill.
| Off-peak hours | Peak hours | |
|---|---|---|
| Éco day (and Bonus day) | 0.1595 EUR/kWh | 0.2142 EUR/kWh |
| Sobriété day | 0.2142 EUR/kWh | 0.7467 EUR/kWh |
- Peak hours: 08:00-13:00 and 18:00-20:00, every day (EDF terms); the rest is off-peak. The "Peak hours" field of the contract follows a change of hours announced by EDF.
- Subscription per month, taxes included, by power: 6 kVA 15.86 · 9 kVA 19.88 · 12 kVA 23.76 · 15 kVA 27.40 · 18 kVA 31.14 · 24 kVA 39.14 · 30 kVA 46.47 · 36 kVA 53.88 EUR (6 kVA pre-filled).
- Bonus days: billed as Éco days. The reward EDF pays when you follow its advice is not computed.
- A day absent from the calendar (not announced yet, module stopped): priced as an Éco day, as most days are. A day read later (the day before at 16:00, or on the day) enters the calendar and Gladys recomputes the costs concerned.
- A day missed entirely is not caught up: the module only reads today and tomorrow. If the module or the EDF website is unavailable from 16:00 the day before to the end of the day, that day stays priced as Éco, even if it was a Sobriété day (its peak hours then underpriced by 0.53 EUR/kWh). The status names these days (weekdays of the Sobriété season, public holidays excepted): check them in your EDF customer area.
- A day runs from midnight to midnight (Paris time). Gladys handles the changes of time.
Scenes
Trigger "EDF Zen Flex day announced": it fires when the module first reads the type of tomorrow (usually
around 16:15), with the filter "Type of tomorrow" (Éco, Sobriété, Bonus; empty: any). Variables: day_type
(eco, sobriete or bonus) and date (YYYY-MM-DD).
- Once per announced day; again if the 16:15 reading finds that type changed (tomorrow read before 16:00).
- If Gladys does not take the announcement, it is sent again (after 1, 5, 15 minutes, then every 30 minutes) until midnight, then dropped: an announcement is not sent any more once its day has begun.
- A module started after midnight fires nothing for the current day.
- The advice of a Bonus day (reduce or shift the consumption) is not given by this endpoint: EDF sends it by e-mail or SMS.
To act during the peak hours of a Sobriété day, a scene may also use the "current price" condition of the contract.
The status
The integration screen shows: the type of today and tomorrow, the number of Sobriété (of 20) and Bonus days
seen by the module this year, the time of the last reading, and what is wrong (EDF unreadable with the reason
and the time of the next try, calendar refused, announcement not sent, /data not writable), and the days of the
Sobriété season never read since the installation ("Not read … priced as Éco days", the 5 most recent). The
counters only see the days read since the installation.
What /data keeps
The days read (400 days at most), those Gladys accepted in its calendar, the last announcement sent, the time of
the last attempt and of the last successful reading, the pause under way. No personal data, no secret. If
/data cannot be read, the module reads it again every 10 seconds without asking EDF; if it cannot be written,
the days stay in memory and the first reading waits 10 minutes after the start.
Calendar already provided
The zen-flex key belongs to the first installed integration that declares it. If another integration already
provides it, Gladys refuses this one (the status says so): the template then reads the values of the other
integration, and the scene trigger still works.
Konfigurationseinstellungen
Diese Einstellungen fragt EDF Zen Flex in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| How it works | section | Nein | Nothing to set here. Unofficial: this integration reads the type of today and tomorrow (Éco, Sobriété, Bonus) from a public page of the EDF website, without any account, a few times a day; EDF does not document it and may change it, the status then says so and no day is made up. Open Integrations → Energy monitoring → Contracts, create a contract from the EDF Zen Flex template and check its prices. Scenes: the trigger "EDF Zen Flex day announced". |
So installierst du EDF Zen Flex in Gladys
- Öffne in Gladys Integrationen: EDF Zen Flex erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/lm1lc3n7/gladys-edf-zen-flex:0.1.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/LM1LC3N7/gladys-edf-zen-flex.
EDF Zen Flex benötigt Gladys >=5.2.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
EDF Zen Flex ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von LM1LC3N7 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation