Integración domótica Gaz de Bordeaux, gratuita y de código abierto
Consumo y coste de gas y electricidad de su cuenta de cliente Gaz de Bordeaux.
Publicado por prohand
- Dispositivos
- Versión 1.0.10
- Requiere Gladys >=5.2.0
- ★ 0
Esta integración conecta Gladys con su cuenta de cliente Gaz de Bordeaux (life.gazdebordeaux.fr). Lee allí su consumo de gas y de electricidad, y su coste, para mostrarlos en Gladys, dibujar sus gráficos y lanzar escenas.
Funciona por Internet (insignia cloud): nada que instalar en casa, ningún módulo en el contador.
Antes de empezar
- Necesita una cuenta en life.gazdebordeaux.fr que muestre su consumo. Inicie sesión una vez desde un navegador para comprobarlo.
- Gaz de Bordeaux publica el consumo de un día uno o dos días después (lo que tarda el contador Gazpar o Linky en enviarlo). Gladys muestra por tanto siempre el último día leído, no el de hoy.
- Se necesita Gladys 5.2 o posterior.
Configuración
- Abra la pestaña Configuración de la integración.
- Introduzca el correo electrónico y la contraseña de su cuenta de cliente.
- Ajuste si hace falta:
- Intervalo de actualización (horas): frecuencia de lectura de la cuenta, cada 6 horas por defecto (de 1 a 24). Las lecturas solo cambian una vez al día: no sirve de nada bajar más.
- Días de historial a importar: días pasados enviados a Gladys al crear un dispositivo, 30 por defecto (hasta 90), para que los gráficos no empiecen vacíos.
- Umbral de alerta gas / electricidad (kWh/día): por encima, se lanza el disparador «Consumo diario elevado». 0 lo desactiva.
- Guarde. El botón Probar la conexión comprueba el correo y la contraseña y lista los contratos encontrados.
- Abra la pestaña Descubrimiento: se ofrece un dispositivo por contrato («Gaz de Bordeaux – Gaz», «Gaz de Bordeaux – Électricité»). Añada los que quiera seguir.
La contraseña es un campo secreto: nunca se escribe en los registros.
Lo que obtiene
Cada dispositivo «contrato» lleva sensores de solo lectura:
| Función | Unidad | Contrato | Valor |
|---|---|---|---|
| Consumo del día leído | kWh | todos | un valor por día, fechado en ese día |
| Coste del día leído | € | todos | un valor por día, fechado en ese día |
| Volumen de gas del día leído | m³ | gas | un valor por día, fechado en ese día |
| Consumo del mes | kWh | todos | desde el día 1 del mes |
| Coste del mes | € | todos | desde el día 1 del mes |
| Consumo del año | kWh | todos | total del año dado por Gaz de Bordeaux |
| Coste del año | € | todos | total del año dado por Gaz de Bordeaux |
| Consumo diario | kWh | electricidad | enviado al módulo Energía de Gladys |
Los valores diarios están fechados en el día que describen, no en la hora de lectura: el gráfico muestra el consumo del lunes en el lunes, aunque haya llegado el miércoles.
Al crear un dispositivo, se importan los últimos días (ver Días de historial a importar). Nunca se envían dos veces, ni siquiera tras un reinicio.
La insignia de conexión
- Cloud: la última lectura ha funcionado.
- Cloud con un punto naranja: la cuenta responde, pero la última lectura tiene más de 4 días. Puede que el contador ya no envíe sus índices: compruébelo en el sitio de Gaz de Bordeaux.
- Inaccesible: la última lectura ha fallado (ver «Solución de problemas»).
Acciones
- Probar la conexión: inicia sesión con el correo y la contraseña introducidos y lista los contratos encontrados.
- Actualizar ahora: lee la cuenta de cliente en el acto e indica el último día leído.
- Mis precios de contrato: muestra los precios actuales de sus contratos, tal como los da espaceclient.gazdebordeaux.fr (ver «Contratos de energía»).
Escenas
La integración añade sus tarjetas al editor de escenas, en Integraciones.
Disparadores
- Nueva lectura diaria: Gaz de Bordeaux ha publicado un nuevo día. Filtre
si quiere por contrato o energía. Las acciones siguientes pueden leer
{{triggerEvent.data.date}},{{triggerEvent.data.kwh}},{{triggerEvent.data.cost}}y{{triggerEvent.data.volume}}(gas). - Consumo diario elevado: el nuevo día supera el umbral de alerta definido
en la configuración. Variables:
date,kwh,threshold. - Cuenta de cliente inaccesible: la lectura ha fallado cuando antes
funcionaba. Filtre por la causa (inicio de sesión rechazado, solicitud
bloqueada, red, respuesta inesperada, ningún contrato). Variables:
reason,message. - Precios del contrato cambiados: un precio actual de
espaceclient.gazdebordeaux.fr ha cambiado (kWh, punta/valle o suscripción,
IVA incl.). Filtre si quiere por energía. Variables:
offer,kwh_price,peak_price,off_peak_price,subscription, y el valor anterior de cada uno (previous_kwh_price…). Los precios se leen en cada actualización y se comparan tal como los da el sitio: ninguna falsa alarma por redondeo. El aviso llega cuando el sitio muestra el nuevo precio.
Un día, o un cambio de precio, solo se anuncia una vez, incluso tras un reinicio. En la primerísima lectura no se anuncia nada: solo los cambios siguientes.
Ejemplo: Precios del contrato cambiados y luego Enviar un mensaje «Nuevo precio Gaz de Bordeaux: {{triggerEvent.data.kwh_price}} €/kWh (antes {{triggerEvent.data.previous_kwh_price}}), suscripción {{triggerEvent.data.subscription}} €/mes». Cree entonces un nuevo contrato de energía de Gladys (ver «Cuando cambian sus precios»).
Acciones
- Actualizar las lecturas de Gaz de Bordeaux: lee la cuenta de cliente en
el acto. Salidas:
successycontracts(número de contratos leídos). - Obtener un consumo de Gaz de Bordeaux: elija un contrato y un periodo
(último día leído, este mes, este año). Salidas:
kwh,cost,volume,dateyavailable(falso si no hay datos). Útil para un mensaje «Ayer: 42 kWh, 5,10 €».
Ejemplo: cada mañana a las 8, Obtener un consumo (último día leído) y luego Enviar un mensaje «Gas del {{date}}: {{kwh}} kWh, {{cost}} €».
Panel
Añada el widget Consumo Gaz de Bordeaux a un panel. Muestra:
- el consumo y el coste del último día leído y del mes;
- un gráfico de barras de los últimos 30 días;
- la energía, el último día leído, el volumen de gas, el precio actual (leído en espaceclient), el total del año, la hora de la última lectura y el estado de la conexión;
- un botón Actualizar.
En los ajustes del widget, elija el contrato a mostrar; si se deja vacío, es el primero.
Contratos de energía (electricidad)
La integración añade plantillas de contrato al asistente de contratos de Gladys (Energía → contrato del contador), para que Gladys calcule el coste de su electricidad a los precios de Gaz de Bordeaux. Una plantilla por oferta y opción:
| Oferta | Precios | Plantillas |
|---|---|---|
| NovaFixe Élec | fijos 3 años desde la contratación, un 10 % bajo la tarifa regulada | Base, Horas valle |
| NovaFixe Bonus Élec | como NovaFixe, más 100 € de regalo el primer año | Base, Horas valle |
| NovaFlex Élec | indexados a la tarifa regulada (TRV), kWh sin impuestos un 5 % por debajo | Base, Horas valle |
¿Su oferta no está en la lista? (por ejemplo Ecodigo Elec, o una oferta antigua que ya no se vende): elija la plantilla Mi contrato (más abajo), sirve para todas las ofertas. Su oferta figura en su cuenta de cliente, línea «Votre tarif».
Lo más sencillo: las plantillas «Mi contrato»
Las plantillas Gaz de Bordeaux – Mi contrato – Base y – Horas valle toman sus propios precios, para cualquier oferta (Ecodigo, NovaFixe, NovaFlex…). Son los de su cuenta de cliente (espaceclient.gazdebordeaux.fr, línea «Votre prix actuel»), que da el botón Mis precios de contrato:
- Pulse Mis precios de contrato (pestaña Configuración de la integración).
- En Gladys, Energía → contrato del contador eléctrico de Gaz de Bordeaux, elija la plantilla Mi contrato de su opción (Base u Horas valle).
- Introduzca los precios que da el botón: precio del kWh (Horas valle: precios punta y valle, y las horas valle) y suscripción al mes.
Los precios están en el contrato, como con las otras plantillas: el asistente y el JSON del contrato los muestran. Gladys no permite a una integración rellenar el asistente: se introducen pues una vez. Cuando cambian, el disparador de escena Precios del contrato cambiados le avisa: cree un nuevo contrato (ver «Cuando cambian sus precios»).
Sus precios: el botón «Mis precios de contrato»
Una oferta a precio fijo conserva el precio del día de la contratación, una oferta indexada (Ecodigo Elec) cambia con los impuestos y el mercado: su precio no es necesariamente el de la tarifa de hoy. El botón Mis precios de contrato (pestaña Configuración) lee sus precios actuales en espaceclient.gazdebordeaux.fr (mismo correo y contraseña), línea «Votre prix actuel» de la página de su contrato, y los da tal cual, sin cálculo. Ejemplo:
Electricidad, OFFRE ECODIGO ELEC 100% ÉLECTRICITÉ VERTE (BASE, 6 kVA): 0.160164 €/kWh, suscripción 15.87 €/mes.
Son precios con IVA e impuestos (CTA en la suscripción, impuesto especial en el kWh), como los contratos que ofrece Gladys. Cópielos en el asistente de contratos de Gladys (plantilla Mi contrato, o la de su oferta). Escríbalos con punto (15.87), como los escribe el botón: el campo puede quitar una coma pegada (15,87 pasa a 1587, una suscripción de unos 51 € al día en el gráfico de energía). Si ha ocurrido, corrija el precio en el contrato: es una errata, no un cambio de precio.
Para un contrato de electricidad, el botón da también estos precios como tarifa Gladys (JSON), lista para pegar donde Gladys pide la tarifa de un contrato. Es la tarifa que recibe un contrato Mi contrato. En Horas valle se añade una regla de horas valle con sus horarios (si espaceclient los da).
{
"tariff_version": 1,
"components": [
{ "key": "energy", "kind": "consumption", "rules": [], "fallback": { "price": 0.160164 } },
{ "key": "subscription", "kind": "fixed", "amount": 15.87, "per": "month" }
]
}
Si la cuenta de cliente no se puede leer, el botón lo indica: copie entonces los precios de la página de su contrato en espaceclient.gazdebordeaux.fr.
Cuando cambian sus precios
Deje vacía la fecha de fin de su contrato de Gladys mientras sus precios no cambien. Pueden cambiar por el camino: nueva tarifa (NovaFlex, Ecodigo Elec, fin de un periodo a precio fijo) o un impuesto (impuesto especial, IVA) que cambia el precio con IVA. Gaz de Bordeaux le avisa, y también el disparador de escena Precios del contrato cambiados; el botón Mis precios de contrato da entonces los nuevos precios.
- En el contrato actual, ponga la fecha de fin el día anterior al cambio.
- Cree un nuevo contrato que empiece el día del cambio, con los nuevos precios.
Así los días pasados conservan sus precios antiguos. No modifique los precios del contrato existente: Gladys recalcularía todo el historial desde el inicio del contrato con el nuevo precio.
Los precios por defecto: las tarifas oficiales
Los valores propuestos por defecto son los de las tarifas oficiales de Gaz de Bordeaux (IVA incluido, aquí las del 1 de octubre de 2026). Se descargan cada mes de gazdebordeaux.fr: cuando cambia un precio, una nueva versión de la integración propone los nuevos precios para los contratos creados después. Un contrato ya creado conserva sus precios: vea Cuando cambian sus precios.
| Potencia | Suscripción / mes | NovaFixe: kWh Base | NovaFixe: punta / valle | NovaFlex: kWh Base | NovaFlex: punta / valle |
|---|---|---|---|---|---|
| 3 kVA | 12,13 | 0,18373 | – | 0,19190 | – |
| 6 kVA | 15,87 | 0,18373 | 0,19648 / 0,14669 | 0,19190 | 0,20536 / 0,15280 |
| 9 kVA | 19,88 | 0,18233 | 0,19648 / 0,14669 | 0,19042 | 0,20536 / 0,15280 |
| 12 kVA | 23,76 | 0,18233 | 0,19648 / 0,14669 | 0,19042 | 0,20536 / 0,15280 |
| 15 kVA | 27,40 | 0,18233 | 0,19648 / 0,14669 | 0,19042 | 0,20536 / 0,15280 |
| 18 kVA | 31,14 | – | 0,19648 / 0,14669 | – | 0,20536 / 0,15280 |
| 24 kVA | 39,13 | – | 0,19648 / 0,14669 | – | 0,20536 / 0,15280 |
| 30 kVA | 46,46 | – | 0,19648 / 0,14669 | – | 0,20536 / 0,15280 |
| 36 kVA | 53,88 | – | 0,19648 / 0,14669 | – | 0,20536 / 0,15280 |
La suscripción es la misma para las tres ofertas. NovaFixe Bonus Élec tiene los precios de NovaFixe Élec.
Conviene saber
- Base funciona con el consumo diario que esta integración envía al módulo Energía.
- Horas valle necesita un consumo cada media hora (un contador Linky leído cada 30 minutos por otra integración). Con el consumo diario solo, Gladys no puede saber qué kWh fueron en horas valle: no use esta plantilla en ese caso.
- El gas no está incluido: los contratos de energía de Gladys solo cubren la electricidad. El coste del gas sigue siendo el que da Gaz de Bordeaux (funciones «Coste del día leído», «Coste del mes»…).
Solución de problemas
El mensaje de estado de la pestaña Configuración indica lo que falla:
- Inicio de sesión rechazado: el correo o la contraseña son incorrectos. Use los de life.gazdebordeaux.fr y compruebe que puede iniciar sesión desde un navegador.
- El sitio bloqueó la solicitud: el sitio de Gaz de Bordeaux filtra a veces las solicitudes automáticas. La integración vuelve a intentarlo en la próxima actualización; si persiste, abra una incidencia en el repositorio de GitHub.
- Inaccesible: Gladys no tiene acceso a Internet o el sitio está caído.
- Ningún contrato: la cuenta no tiene contratos de gas ni de electricidad visibles.
Los registros de la integración (Gladys → Integraciones → Gaz de Bordeaux → registros) dan el detalle. Nunca contienen la contraseña ni el token de sesión.
Esta integración no está publicada por Gaz de Bordeaux: lee los mismos datos que su cuenta de cliente. Si el sitio cambia, puede dejar de funcionar hasta una actualización.
Parámetros de configuración
Estos son los parámetros que Gaz de Bordeaux te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Primeros pasos | section | No | Introduzca el correo electrónico y la contraseña de su cuenta de cliente Gaz de Bordeaux (los del sitio life.gazdebordeaux.fr). La integración lee allí su consumo varias veces al día: Gaz de Bordeaux publica la lectura de un día uno o dos días después. Se ofrece un dispositivo por contrato (gas, electricidad). |
| Correo electrónico | string | Sí | El correo con el que inicia sesión en su cuenta de cliente Gaz de Bordeaux. |
| Contraseña | secret | Sí | |
| Intervalo de actualización (horas) | number | No | Frecuencia de lectura de la cuenta de cliente. Las lecturas cambian una vez al día: cada 6 horas es suficiente. |
| Días de historial a importar | number | No | Lecturas diarias importadas en Gladys al crear un dispositivo, para que sus gráficos no empiecen vacíos. |
| Umbral de alerta gas (kWh/día) | number | No | El disparador de escena «Consumo diario elevado» se lanza cuando un día de gas lo supera. 0 lo desactiva. |
| Umbral de alerta electricidad (kWh/día) | number | No | El disparador de escena «Consumo diario elevado» se lanza cuando un día de electricidad lo supera. 0 lo desactiva. |
Cómo instalar Gaz de Bordeaux en Gladys
- En Gladys, abre Integraciones: Gaz de Bordeaux aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/prohand/gladys-gazdebordeaux:1.0.10), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/prohand/gladys-gazdebordeaux.
Gaz de Bordeaux requiere Gladys >=5.2.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Gaz de Bordeaux es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene prohand, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación