Integración domótica EDF Zen Week-End, gratuita y de código abierto
Contrato EDF Zen Week-End en Gladys: fines de semana, festivos y horas valle al precio correcto.
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.2.0
- ★ 0
Gladys calcula el coste de su electricidad a partir de su contador y de su contrato. Esta integración añade los contratos EDF Zen Week-End y Zen Week-End Plus (ofertas de mercado de EDF en Francia) al asistente de contratos de Gladys, para que cada kilovatio hora se cuente al precio correcto:
- todo el fin de semana al precio reducido, del sábado a las 0:00 al domingo a las 24:00;
- los festivos nacionales al precio reducido, calculados sin conexión por la integración;
- sus horas valle Enedis los demás días, con las opciones de horas valle (8 horas al día, las de su factura);
- el día elegido (lunes, miércoles o viernes) de la oferta Plus;
- el abono mensual de su potencia contratada.
También añade disparadores de escena en el minuto exacto en que el precio reducido empieza o termina (para encender el termo o la carga del coche), una acción de escena que indica a sus escenas el periodo en curso y un widget «Horas valle» para el panel.
Probada con su batería de pruebas automáticas y con el motor de tarifas de Gladys 5.2.0, todavía no en una instancia real de Gladys: sus comentarios son bienvenidos en el foro de Gladys o en las issues de GitHub.
Requisitos
- Gladys Assistant 5.2.0 o posterior (contratos de energía).
- Un contador eléctrico en Gladys cuyo consumo se conozca cada 30 minutos (integración Supervisión de energía: Linky a través de Enedis, un índice Lixee o Tasmota…).
- Un contrato EDF Zen Week-End o Zen Week-End Plus. Ni cuenta, ni clave de API, ni acceso a la red: todo se calcula en su Gladys.
Instalación y configuración
Instale la integración (Integraciones → Instalar desde GitHub, dirección
https://github.com/guim31/gladys-edf-zen-weekend). En su página de configuración no hay nada que rellenar,
salvo el idioma de los textos de escenas.
Crear el contrato
- Abra Integraciones → Supervisión de energía → Contratos y cree un contrato.
- Elija una de las cuatro plantillas EDF Zen Week-End (ver abajo), luego su contador eléctrico y la fecha de inicio de su contrato.
- Compruebe los valores prerrellenados con su factura: horas valle, precios, abono. Guarde.
Gladys cuenta entonces cada media hora de consumo con este contrato, desde su fecha de inicio, pasado incluido.
¿Qué plantilla?
| Plantilla | Precio reducido |
|---|---|
| EDF Zen Week-End (opción Week-End) | fin de semana y festivos |
| EDF Zen Week-End (horas valle + fin de semana) | fin de semana, festivos, horas valle Enedis |
| EDF Zen Week-End Plus (fin de semana + día elegido) | fin de semana, festivos, día elegido |
| EDF Zen Week-End Plus (horas valle + FDS + día) | fin de semana, festivos, día elegido, horas valle Enedis |
La opción Flex de Zen Week-End no se ofrece: sus «días de sobriedad» los anuncia EDF día a día, y ningún calendario de Gladys los proporciona todavía.
Precios y abono
Las plantillas vienen prerrellenadas con las tablas de precios oficiales de EDF aplicables desde el 15 de septiembre de 2026 (precios con impuestos, para nuevas contrataciones):
| Opción | Precio completo (€/kWh) | Precio reducido (€/kWh) |
|---|---|---|
| Zen Week-End, Week-End | 0,2285 | 0,1710 |
| Zen Week-End, horas valle + FDS | 0,2359 | 0,1762 |
| Zen Week-End Plus, FDS + día | 0,2259 | 0,1691 |
| Zen Week-End Plus, horas valle + día | 0,2314 | 0,1731 |
El abono mensual depende de su potencia contratada y es el mismo para todas las opciones (€/mes con impuestos): 3 kVA 12,13 (solo opción Week-End) · 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. La plantilla viene prerrellenada para 6 kVA: indique la suya.
Las horas valle las fija Enedis para cada vivienda: figuran en su factura y en enedis.fr. La plantilla viene prerrellenada con 04:00-08:00 y 12:30-16:30; la mayoría de las viviendas tienen horas nocturnas (por ejemplo 22:00-06:00): seleccione las suyas en la cuadrícula.
Idioma
El campo Idioma de los textos de escenas (francés por defecto) fija el idioma de los nombres de periodo y las horas enviados a las escenas. El widget sigue el idioma de cada usuario. Los nombres de periodo que muestra el widget «Precio de la electricidad» de Gladys vienen del contrato y quedan en francés («Heures creuses», «Week-end», «Jour férié»…), las palabras de la factura.
Lo que calcula Gladys
El contrato lo calcula la propia Gladys, con las reglas de la plantilla:
- un festivo (solo festivos nacionales: el Viernes Santo y el 26 de diciembre, festivos solo de Alsacia-Mosela, no tienen precio reducido en EDF) es reducido de 0:00 a 24:00;
- el fin de semana es reducido del sábado a las 0:00 al domingo a las 24:00;
- el día elegido de la oferta Plus es reducido de 0:00 a 24:00;
- las horas valle son reducidas los demás días;
- el resto del tiempo se aplica el precio completo.
La integración publica los festivos en el calendario holidays-fr de Gladys, una semana antes
aproximadamente (Gladys rechaza fechas más lejanas), y hasta el inicio de su contrato. Si la integración
está detenida, un festivo que no pudo publicar a tiempo se cuenta como un día laborable; una vez publicado,
Gladys recalcula los costes. Otras plantillas pueden leer el mismo calendario holidays-fr.
Widget del panel
Horas valle muestra el periodo en curso (horas valle, horas punta, fin de semana, festivo, día elegido), el precio actual, el tiempo restante hasta el próximo cambio, ese cambio, las horas valle de hoy y de mañana y el próximo festivo. Describe su contrato EDF Zen Week-End activo más reciente.
Completa el widget Precio de la electricidad de Gladys, que muestra el precio actual y el siguiente en las próximas 48 horas.
Disparadores de escena
- Inicio de las horas valle: empieza el precio reducido, al minuto. Filtro: el periodo que empieza (horas valle, fin de semana, festivo, día elegido; vacío para todos). Variables: periodo (clave y nombre), precio, minutos hasta el próximo cambio, hora del próximo cambio.
- Fin de las horas valle: vuelve el precio completo. Variables: precio, minutos hasta que vuelva el precio reducido, su hora, el próximo periodo reducido (clave y nombre).
El paso de un periodo reducido a otro (del domingo por la noche a las horas valle nocturnas del lunes) no dispara nada: el precio sigue reducido. El disparador Cambio de precio de la electricidad de Gladys también existe; se ejecuta cada 30 minutos y se dispara con cada cambio de precio o de nombre, incluido ese.
Acción de escena «Leer el periodo tarifario EDF»
Da a las acciones siguientes de la escena: off_peak (verdadero o falso), el periodo (clave y nombre), el
precio actual, los minutos hasta el próximo cambio y su hora. Falla si ningún contrato activo usa una
plantilla de la integración.
Ejemplos de escenas
- Termo eléctrico: disparador «Inicio de las horas valle» (periodo: horas valle) → encender el enchufe del termo; disparador «Fin de las horas valle» → apagarlo.
- Carga del coche solo a precio reducido: disparador «el coche está enchufado» → acción «Leer el periodo
tarifario EDF» → continuar solo si
off_peakes verdadero → iniciar la carga. - Lavadora: acción «Leer el periodo tarifario EDF», continuar solo si quedan 120 minutos o más hasta el cambio, luego iniciar la máquina.
- Notificación: disparador «Fin de las horas valle» → enviar «Precio completo hasta {{triggerEvent.data.next_change}}».
Cuando EDF cambia sus precios
EDF revisa los precios de sus ofertas de mercado hasta dos veces al año. Una nueva tabla se convierte en una nueva versión de la integración, con plantillas fechadas según la tabla. Gladys nunca modifica un contrato por sí sola: corrija los precios de su contrato, o cree un nuevo contrato desde la plantilla actualizada a partir de la fecha del cambio. Su factura prevalece siempre sobre los valores prerrellenados.
Solución de problemas
- Ninguna plantilla en el asistente: se necesita Gladys 5.2.0 o posterior, y la integración instalada.
- Un festivo a precio completo: compruebe que la integración funcionaba la semana anterior; en sus registros, «Published … public holiday(s)» lista las publicaciones.
- «Calendario de festivos: lo provee otra integración» en el widget: otra integración ya proporciona
holidays-fr; las plantillas lo leen. Los disparadores y el widget siguen los festivos nacionales calculados por esta integración: si el otro calendario tiene otros días, pueden no coincidir con el precio. - Horas valle incorrectas: modifique el contrato en Supervisión de energía → Contratos. La integración vuelve a leer los contratos en 10 minutos.
- Ningún evento de escena: la integración no envía ninguno cuando detecta un cambio con más de 15 minutos de retraso (Gladys inaccesible, equipo en reposo).
Límites
- Los precios son los de EDF del 15 de septiembre de 2026 para nuevas contrataciones; un contrato más antiguo puede tener otros.
- El recargo para autoproductores (9,84 € sin impuestos al año) no se incluye.
- La opción Flex no está soportada.
- Las horas valle siguen la cuadrícula de 30 minutos del asistente de Gladys.
- Cambiar el día elegido (dos veces por año contractual) supone un nuevo contrato a partir de la fecha del cambio.
- Sin relación con EDF ni con Enedis. «EDF» y «Zen Week-End» son marcas de sus propietarios.
Créditos
- Precios: tablas de precios EDF «Zen Week-End» y «Zen Week-End Plus», aplicables desde el 15 de septiembre de 2026 (particulier.edf.fr).
- Motor de tarifas y asistente de contratos: Gladys Assistant 5.2.0 (Apache 2.0).
Parámetros de configuración
Estos son los parámetros que EDF Zen Week-End te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Funcionamiento | section | No | Nada que configurar aquí. Abra Integraciones → Supervisión de energía → Contratos, cree un contrato a partir de una plantilla EDF Zen Week-End y revise sus precios y horas valle. Gladys calcula el coste; esta integración aporta los festivos. |
| Idioma de los textos de escenas | select | No | Idioma de los nombres de periodo y las horas enviados a las escenas (disparadores y acción de escena). El widget sigue el idioma de cada usuario. |
Cómo instalar EDF Zen Week-End en Gladys
- En Gladys, abre Integraciones: EDF Zen Week-End 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/guim31/gladys-edf-zen-weekend:1.0.0), 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/guim31/gladys-edf-zen-weekend.
EDF Zen Week-End 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
EDF Zen Week-End 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 guim31, no el equipo principal de Gladys.
- Explorar todas las integraciones externas
- Descubrir las integraciones nativas incluidas en Gladys
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación