Plugin GRDF Gazpar

Plugin permettant la récupération des consommations du compteur communicant Gazpar par l’interrogation du compte-client GRDF. Les données n’étant pas mises à disposition en temps réel, le plugin récupère chaque jour les données de consommation de gaz de la veille.

2 types de données de consommation sont accessibles :

la consommation journalière (en kWh et m3).
la consommation mensuelle (en kWh et m3).

Important
Il est nécessaire d’être en possession d’un compte-client GRDF. Le plugin récupère les informations à partir de la partie mon espace du site GRDF, il faut donc vérifier que vous y avez bien accès avec vos identifiants habituels et que les données y sont visibles. Dans le cas contraire, le plugin ne fonctionnera pas.

Configuration

Configuration du plugin

Le plugin GRDF Gazpar ne nécessite aucune configuration spécifique et doit seulement être activé après l’installation.

Deux options sont disponibles dans la configuration du plugin pour gérer la réaction en cas de détecion de captcha à la connexion:

Ajouter une entrée dans le centre de message (cochée par défaut)
Désactiver l’équipement

Vous pouvez également spécifier le nombre de jours de retard généralement constaté afin d’éviter au plugin d’interroger le site pour rien.

Le site GRDF vous permet de spécifier des seuils menusels que le plugin récupère et stocke dans la commande dédiée. Si vous préférez utiliser les valeurs mensuelles de l’année précédente comme seuils, décochez l’option correspondante.

Les données sont vérifiées toutes les heures entre 4h et 22h et mises à jour uniquement si non disponibles dans Jeedom.

Configuration des équipements

Pour accéder aux différents équipements GRDF Gazpar, dirigez-vous vers le menu Plugins → Energie → GRDF Gazpar.

A savoir
Le bouton + Ajouter permet d’ajouter un nouveau compte GRDF Gazpar.

Sur la page de l’équipement, renseignez l’identifiant ainsi que le mot de passe de votre compte-client GRDF puis cliquez sur le bouton Sauvegarder.

Vous pouvez également spécifier le numéro PCE de votre compteur si vous en avez plusieurs liés à votre compte.

L’option Forcer la récupération des données permet de récupérer les informations de consommation même si elles ont déjà été récupérées pour la période concernée.

Le plugin va alors vérifier la bonne connexion au site GRDF et récupérer et insérer en historique :

consommation journalière : les 365 derniers jours,
consommation mensuelle : les 12 derniers mois,
consommation mensuelles maximum, minimum et médiane des foyers similaires sur les 12 derniers mois
seuils mensuels comme définis dans votre espace

Quatre templates de widget sont disponibles. Ceux avec comparaison vous informent comment votre consommation du mois précédent se situe par rapport aux foyers similaires.

Problèmes potentiels

De temps en temps, il se peut que le site demande une résolution de captcha pour se connecter. Ce sera indiqué dans les logs du plugin t le plugin réagira en fonction de sa configuration. Dans ce cas, vous devez vous connecter “manuellement” au site GRDF afin de résoudre la captcha.

Remarques

Le site GRDF étant un peu “instable”, il se peut que la récupération des données ne marche pas à chaque fois. Pas de panique, le plugin est configuré pour essayer toutes les heures.

Le plugin se repose sur la manière dont le site GRDF est structuré. Tout changement sur le site entrainera vraisemblablement une erreur sur le plugin et nécessitera une adaptation de celui-ci plus ou moins difficile à faire.

Contributions

Ce plugin gratuit est ouvert à contributions (améliorations et/ou corrections). N’hésitez pas à soumettre vos pull-requests sur Github.

Crédits

Ce plugin s’est inspiré des travaux suivants :

Jeedom via leur plugin Enedis : plugin-enedis
empierre via son travail similaire pour Domoticz : domoticz_gaspar

Disclaimer

Ce plugin ne prétend pas être exempt de bugs.
Ce plugin vous est fourni sans aucune garantie. Bien que peu probable, si il venait à corrompre votre installation Jeedom, l’auteur ne pourrait en être tenu pour responsable.

ChangeLog

Disponible ici.