Integración domótica TotalEnergies, gratuita y de código abierto
Ofertas de electricidad TotalEnergies: contratos, periodos tarifarios, precios y días Éclair.
Publicado por prohand
- Dispositivos
- Versión 0.0.1
- Requiere Gladys >=5.2.0
- ★ 0
Esta integración añade las ofertas de electricidad de TotalEnergies al seguimiento de la energía de Gladys, y le da el periodo tarifario y el precio del kWh actuales para controlar su casa: encender el calentador de agua en horas valle, cargar el coche en horas supervalle, bajar la calefacción durante las horas de vigilancia de un día Éclair.
Todo se calcula en la integración, a partir de su contrato: no hace falta ninguna cuenta TotalEnergies y nada sale de su red.
Integración comunitaria, sin relación con TotalEnergies. Los precios rellenados vienen de la tarifa pública del 1 de octubre de 2026 (9 kVA, con impuestos): compruébelos siempre en su factura.
Requiere Gladys 5.2 o posterior.
Ofertas disponibles
| Plantilla de contrato | Periodos |
|---|---|
| Access – Base / – Punta/Valle | Base, o horas punta / valle |
| Heures Eco – Base / – Punta/Valle | Base, o horas punta / valle |
| Fixe 2 ans – Base / – Punta/Valle | Base, o horas punta / valle |
| Charge'Heures – P/V/SV | Supervalle 2-6 h, valle 23-2 h y 6-7 h, punta |
| Heures Eco+ – P/V/HV | Punta, valle y horas de vigilancia (días Éclair) |
| Otra oferta – Base / – Punta/Valle | Para Verte Fixe, Standard Fixe, Online… |
Primeros pasos
- Instale la integración desde el catálogo de Gladys.
- Abra Energía > Contratos y cree su contrato: elija la plantilla TotalEnergies que corresponde a su oferta.
- Copie los precios de su factura (precio del kWh y suscripción mensual, con impuestos) y, para una opción punta / valle, sus franjas de horas valle: Enedis las fija para su contador y figuran en su factura.
- Asocie el contrato a su contador, como cualquier contrato de Gladys: Gladys calcula entonces sus costes.
- Abra la pestaña Descubrimiento de la integración: aparece un dispositivo por contrato, con dos funciones — precio del kWh y periodo tarifario. Añádalo.
Un contrato creado más tarde aparece en Descubrimiento en 15 minutos como máximo, o al instante con el botón Ver mis contratos TotalEnergies.
Configuración
- Aviso antes de vigilancia (minutos) — Heures Eco+: cuántos minutos antes de cada franja de vigilancia se dispara el activador «Horas de vigilancia pronto» (60 por defecto).
Botones de la pantalla de configuración:
- Ver mis contratos TotalEnergies — lista los contratos de Gladys creados con las plantillas TotalEnergies, con su periodo y su precio actuales.
- Declarar un día Éclair — introduzca la fecha anunciada por TotalEnergies (AAAA-MM-DD, vacío = mañana).
- Anular un día Éclair — vuelve a convertir en día normal un día declarado por error.
Heures Eco+ y días Éclair
La oferta Heures Eco+ tiene 20 días Éclair al año, entre el 15 de octubre y el 15 de abril. Esos días, las horas de vigilancia (7-15 h y 18-20 h) cuestan unas tres veces el precio habitual.
TotalEnergies anuncia un día Éclair la víspera por la tarde, solo por correo y SMS: no existe ningún servicio en línea para leerlos. Por eso usted declara cada día Éclair en la integración, como prefiera:
- con el botón Mañana día Éclair del widget «Tarifa TotalEnergies»;
- con el widget «Días Éclair»;
- con el botón Declarar un día Éclair de la pantalla de configuración;
- desde una escena, con la acción Declarar un día Éclair.
La integración guarda esos días en el calendario tarifario eclair-days de
Gladys, que lo usa para calcular el coste de las horas de vigilancia. Los
demás días se anotan como «normales» automáticamente.
Escenas
Activadores (categoría Integraciones del editor de escenas):
- Cambio de periodo tarifario — un contrato entra en horas punta, valle,
supervalle o de vigilancia. Filtre por contrato y por nuevo periodo.
Variables:
period,previous_period,price. - Horas de vigilancia pronto — Heures Eco+: una franja de vigilancia
empieza pronto. Variables:
starts_at,ends_at,minutes_before. - Día Éclair anunciado — se acaba de declarar un día Éclair desde la
pantalla de configuración o el panel. Variables:
date,is_tomorrow,season_count.
Acciones:
- Leer la tarifa actual — devuelve
period,price,next_period,next_change_at,eclair_today,eclair_tomorrow(yfound). - Declarar un día Éclair — hoy o mañana. No dispara «Día Éclair anunciado», para que una escena no pueda entrar en bucle.
Los periodos son base, hp, hc, hsc o hv.
Ejemplo: Cuando el periodo de mi contrato pase a hc, encender el
calentador de agua; cuando pase a hp, apagarlo.
Panel
- Tarifa TotalEnergies — precio y periodo actuales, próximo cambio, precio de las próximas 24 horas y, para Heures Eco+, los días Éclair de hoy y mañana. Elija el contrato en los ajustes del widget (vacío = el primero).
- Días Éclair — días Éclair de la temporada (x/20), el próximo, y botones para declarar o anular uno.
Conviene saber
- El precio mostrado es el precio del kWh con impuestos introducido en el contrato; Gladys añade la suscripción a sus costes por sí mismo.
- Los precios de TotalEnergies cambian (hasta dos veces al año en algunas ofertas): actualice el contrato en Energía > Contratos.
Solución de problemas
- Ningún dispositivo en Descubrimiento: compruebe que hay un contrato creado con una plantilla TotalEnergies y que está activo (fecha de inicio pasada). El botón Ver mis contratos TotalEnergies lo confirma.
- El precio no cambia nunca: hay que añadir el dispositivo desde Descubrimiento para que reciba sus valores.
- Consulte los registros de la integración desde Gladys (o
docker logs).
Parámetros de configuración
Estos son los parámetros que TotalEnergies te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Primeros pasos | section | No | 1. Abra Energía > Contratos en Gladys y cree su contrato a partir de una de las plantillas TotalEnergies de esta integración, con los precios de su factura. 2. Vuelva a la pestaña Descubrimiento: aparece un dispositivo de tarifa por contrato, con su periodo y su precio actuales. Todo se calcula en la integración: no hace falta ninguna cuenta TotalEnergies. |
| Aviso antes de vigilancia (minutos) | number | No | Heures Eco+: cuántos minutos antes de cada franja de vigilancia se dispara el activador «Horas de vigilancia pronto». |
Cómo instalar TotalEnergies en Gladys
- En Gladys, abre Integraciones: TotalEnergies 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-totalenergies:0.0.1), 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-totalenergies.
TotalEnergies 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
TotalEnergies 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