Intégration domotique EnergyZero, gratuite et open source

Prix dynamiques de l'électricité et du gaz aux Pays-Bas par EnergyZero, aujourd'hui et demain.

• Publiée par guim31
• Appareils
• Version 1.0.1
• Nécessite Gladys >=5.1.0
• ★ 0

Voir sur GitHubToutes les intégrations

Les prix dynamiques de l'électricité et du gaz aux Pays-Bas, publiés par EnergyZero, dans Gladys : le prix de l'heure en cours, les heures les moins chères du jour, une courbe des prix du jour et du lendemain, et des déclencheurs de scène pour lancer vos appareils quand l'électricité est la moins chère.

Cette intégration n'a aucun lien avec EnergyZero. Elle a été développée sans accès à l'API réelle depuis l'environnement de développement, sur de vraies réponses enregistrées par la bibliothèque energyzero : vos retours sont les bienvenus.

Présentation

EnergyZero publie, sans compte ni clé :

• les prix horaires de l'électricité du marché day-ahead néerlandais (EPEX, zone NL), en prix du marché ou en prix tout compris payé par un client EnergyZero (prix du marché, taxe sur l'énergie et frais d'achat), avec ou sans TVA ;
• le prix journalier du gaz, valable de 6 h à 6 h.

Les prix d'électricité du lendemain sont publiés entre 14 h et 15 h. Les prix valent aussi pour les marques qui achètent leur énergie par EnergyZero (ANWB Energie, Energie van Ons, Mijndomein Energie, SamSam, ZonderGas…).

Toutes les heures sont données à l'heure d'Amsterdam, et une journée va de minuit à minuit à Amsterdam, quel que soit le fuseau de votre Gladys.

Prérequis

• Gladys Assistant 5.1.0 ou plus récent.
• Un accès internet depuis Gladys vers public.api.energyzero.nl.
• Rien d'autre : ni compte, ni clé d'API, ni matériel.

Installation

1. Dans Gladys, ouvrez Intégrations → Installer depuis GitHub et saisissez https://github.com/guim31/gladys-energyzero.
2. Ouvrez l'intégration, vérifiez la configuration, enregistrez.
3. Ouvrez l'onglet Découverte et ajoutez l'appareil EnergyZero.
4. Sur un tableau de bord, ajoutez le widget Prix de l'électricité.

Configuration

Champ	Défaut	Rôle
Prix de l'électricité	Tout compris	Prix consommateur tout compris, ou prix du marché EPEX day-ahead seul
Inclure la TVA	Oui	Prix avec la TVA néerlandaise (21 %)
Prix du gaz	Oui	Lire aussi le prix du gaz du jour ; le changer ajoute ou retire une fonctionnalité (mettre à jour)
Langue des noms de fonctionnalités	Français	Utilisée à l'ajout de l'appareil : les noms ne changent plus ensuite

Le bouton Relever les prix maintenant interroge EnergyZero tout de suite et affiche ce qu'il publie pour aujourd'hui et demain : pratique pour vérifier la connexion.

L'appareil EnergyZero

Un seul appareil, en lecture seule, rafraîchi par l'intégration elle-même chaque minute (les prix sont relevés chez EnergyZero une fois par heure).

Fonctionnalité	Type	Valeur
Prix actuel (€/kWh)	Prix	Prix de l'heure en cours
Prix heure suivante (€/kWh)	Prix	Prix de l'heure suivante (après 23 h, une fois demain connu)
Prix moyen du jour (€/kWh)	Prix	Moyenne des heures du jour
Prix min du jour (€/kWh)	Prix	Heure la moins chère du jour
Prix max du jour (€/kWh)	Prix	Heure la plus chère du jour
Heure la moins chère du jour	Texte	Début de l'heure la moins chère, HH:MM
Heure la plus chère du jour	Texte	Début de l'heure la plus chère, HH:MM
Rang de l'heure (1 = moins chère)	Compteur	Rang de l'heure en cours dans la journée, de 1 à 24 (23 ou 25 aux changements d'heure)
Prix du gaz du jour (€/m³)	Prix	Prix du gaz de la journée gazière (6 h à 6 h), s'il est activé

Gladys n'a pas d'unité €/kWh : les prix s'affichent en euros, le nom dit par quoi. Quand une fonctionnalité est la seule de son type sur l'appareil, le tableau de bord affiche le libellé générique du type (« Compteur entier ») à la place de son nom.

Widget du tableau de bord

Prix de l'électricité affiche le type de prix, trois tuiles (maintenant, heure suivante, moyenne du jour), la courbe du jour et du lendemain avec l'heure la moins chère et la plus chère de chaque jour marquées et un trait à l'heure actuelle, puis l'heure la moins chère d'aujourd'hui et de demain, la moyenne de demain et le prix du gaz. Avant 15 h, il indique que les prix de demain arrivent après 15 h.

Déclencheurs de scène

Deux déclencheurs, dans l'éditeur de scènes sous EnergyZero. Tous deux portent sur l'électricité et sur les heures de la journée en cours (de minuit à minuit).

Les heures les moins chères du jour commencent

Se déclenche une fois par jour, au début de la plage d'heures consécutives la moins chère du jour. Choisissez la durée de la plage : de 1 à 6 ou 8 heures (1 heure, c'est l'heure la moins chère du jour). Variables : prix moyen de la plage, heures de début et de fin.

Une des heures les moins chères commence

Se déclenche au début de chacune des N heures les moins chères du jour, consécutives ou non. Choisissez N : de 1 à 6, 8, 10 ou 12. Variables : prix de l'heure, son rang, heures de début et de fin.

Les déclencheurs partent quand l'heure commence, avec au plus 10 minutes de retard (redémarrage de Gladys ou de l'intégration) : une heure commencée depuis plus longtemps ne déclenche rien. « Le prix passe sous X » n'est pas un déclencheur : utilisez la fonctionnalité Prix actuel avec la condition de seuil de l'éditeur de scènes.

Exemples de scènes

• Lave-vaisselle sur les 3 heures les moins chères : déclencheur Les heures les moins chères du jour commencent, 3 heures → allumer la prise du lave-vaisselle.
• Ballon d'eau chaude sur les 4 heures les moins chères : déclencheur Une des heures les moins chères commence, 4 → allumer le ballon ; une seconde scène sur Rang de l'heure supérieur à 4 → l'éteindre.
• Alerte heure chère : quand Prix actuel dépasse 0,40 → envoyer le message « L'électricité est chère en ce moment, attendez pour lancer le sèche-linge ».

Rafraîchissement et usage de l'API

EnergyZero ne publie pas de quota pour cette API publique. L'intégration en use peu :

• deux requêtes par heure (électricité, et gaz s'il est activé), chacune répondant sur trois jours (hier, aujourd'hui, demain) ;
• à partir de 14 h, une requête d'électricité de plus toutes les 15 minutes tant que les prix du lendemain ne sont pas publiés, puis de nouveau une par heure ;
• après un échec, nouvel essai après 5, 10, 20, 40 puis 60 minutes ; les derniers prix connus restent utilisés en attendant (les prix sont connus un jour à l'avance).

Les états ne sont publiés que lorsqu'ils changent, avec un rappel toutes les 6 heures.

Dépannage

• « EnergyZero est injoignable » dans l'écran de configuration : Gladys n'a pas accès à internet, ou EnergyZero est en panne. Les derniers prix connus restent utilisés ; appuyez sur Relever les prix maintenant pour réessayer.
• « ne publie aucun prix d'électricité pour aujourd'hui » : EnergyZero a répondu sans prix pour la journée, ce qui arrive lors d'un incident de publication. L'intégration réessaie chaque heure.
• Aucune valeur sur l'appareil : ajoutez d'abord l'appareil depuis l'onglet Découverte ; ses valeurs arrivent aussitôt.
• La fonctionnalité gaz manque ou reste affichée : après avoir changé le réglage du gaz, ouvrez l'onglet Découverte et appuyez sur Mettre à jour sur l'appareil.
• Logs détaillés : définissez LOG_LEVEL=debug sur le conteneur pour voir chaque relève.

Limites

• Prix horaires seulement. Le marché day-ahead néerlandais se négocie au quart d'heure depuis octobre 2025 : l'intégration affiche les prix horaires d'EnergyZero.
• Pays-Bas uniquement, prix d'EnergyZero (et des marques qu'il fournit). Votre propre contrat peut avoir une autre marge.
• Les déclencheurs ne regardent que la journée en cours : une plage la moins chère ne passe jamais minuit.
• Lecture seule : l'intégration ne pilote rien elle-même.
• Les noms des fonctionnalités sont fixés à l'ajout de l'appareil ; changer la langue ensuite ne les renomme pas.

Comparaison avec Nord Pool

Une intégration Nord Pool donne le prix brut du marché day-ahead d'une zone de cotation, hors TVA et taxes. EnergyZero apporte, pour les Pays-Bas, le prix consommateur (taxe sur l'énergie, frais d'achat et TVA compris, ce que paie un client EnergyZero) et le prix du gaz ; son prix du marché (EPEX day-ahead, zone NL) est le même marché que la zone NL de Nord Pool.

Paramètres de configuration

Voici les paramètres demandés par EnergyZero dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Prix de l'énergie aux Pays-Bas	section	Non	EnergyZero publie les prix horaires de l'électricité du marché day-ahead néerlandais et le prix journalier du gaz, sans compte ni clé. Les prix d'électricité du lendemain arrivent entre 14 h et 15 h. Ajoutez l'appareil EnergyZero depuis l'onglet Découverte, et le widget des prix depuis le tableau de bord. Sans lien avec EnergyZero.
Prix de l'électricité	select	Non	Tout compris : ce que paie un client EnergyZero (prix du marché, taxe sur l'énergie et frais d'achat). Marché : le prix day-ahead EPEX de la zone néerlandaise seul.
Inclure la TVA	boolean	Non	Prix avec la TVA néerlandaise (21 %).
Prix du gaz	boolean	Non	Lire aussi le prix du gaz du jour (€/m³, de 6 h à 6 h). Le changer ajoute ou retire une fonctionnalité : mettez à jour l'appareil dans l'onglet Découverte.
Langue des noms de fonctionnalités	select	Non	Utilisée quand l'appareil est ajouté à Gladys : les noms ne changent plus ensuite.

Comment installer EnergyZero dans Gladys

1. Dans Gladys, ouvrez Intégrations : EnergyZero apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/guim31/gladys-energyzero:1.0.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-energyzero.

EnergyZero nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes

EnergyZero est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.

• Parcourir toutes les intégrations, natives et communautaires
• Créer et publier votre propre intégration externe
• Code source sur GitHub — source de cette documentation

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂