Integración domótica Octopus Energy France, gratuita y de código abierto
Consumo Linky y Gazpar, coste, saldo y horas valle de su contrato de Octopus Energy Francia.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.2.0
- ★ 0
Siga su contrato de Octopus Energy France (electricidad y gas, antes Plüm Énergie) en Gladys: el consumo que comunica su contador Linky o Gazpar, su coste, el saldo de su cuenta, el próximo pago y, sobre todo, las horas valle (heures creuses) de su contrato, al minuto, para poner en marcha el termo eléctrico o la carga del coche en el momento oportuno.
La electricidad alimenta además el seguimiento de energía de Gladys 5.2, día a día, en la fecha en que se consumió realmente, aunque Enedis envíe las lecturas con uno o dos días de retraso.
Sin relación con Octopus Energy. Developed without the hardware: feedback welcome — desarrollada sin cuenta de Octopus Energy: sus comentarios son bienvenidos (issues de GitHub o foro de Gladys). Los intercambios con Octopus siguen los de la integración libre de Home Assistant ha-octopus-french, pero no se han podido probar con una cuenta real.
Presentación
- Un dispositivo de Gladys por punto de suministro: un contador de electricidad (el número PRM de su Linky) y un contador de gas (el número PCE de su Gazpar), si su contrato incluye ambos.
- Electricidad: el consumo fechado va al seguimiento de energía de Gladys; además, el consumo y el coste del último día leído y del mes, el saldo de la cuenta, el próximo pago, el nombre de la oferta y el periodo tarifario actual (horas punta u horas valle) con su precio.
- Gas: los mismos resúmenes en kWh y euros, el saldo y el próximo pago.
- Un widget de panel, tres disparadores de escena y una acción de escena.
- La cuenta se lee cada 3 horas. Las horas valle se siguen al minuto, sin conectarse a Octopus.
Requisitos
- Gladys 5.2.0 o posterior (importación de un consumo fechado en el pasado).
- Un contrato de electricidad o de gas con Octopus Energy France y acceso a su área de cliente (correo electrónico y contraseña). Los clientes de Octopus en el Reino Unido, en España o en otro país no están incluidos: su plataforma es otra.
- Un contador inteligente (Linky, Gazpar) para el consumo diario. Sin él, solo se muestran el saldo, el pago y el contrato.
- Acceso a Internet para su Gladys: la integración se comunica con la API de
Octopus Energy France (
api.oefr-kraken.energy).
Configuración
Instale la integración desde Integraciones → Instalar desde GitHub (o desde la tienda) y rellene:
| Campo | Qué introducir |
|---|---|
| Correo electrónico | La dirección de acceso a su área de cliente de Octopus Energy |
| Contraseña | La contraseña de esa área de cliente |
| Historial que importar | Días de electricidad enviados al seguimiento de energía en la primera lectura (7 días a 1 año) |
| Idioma de los nombres de dispositivos | Idioma de los nombres de las funciones (francés por defecto), fijados al añadir un contador |
Guarde: la integración inicia sesión, lee la cuenta y propone sus contadores en la pestaña Descubrimiento. Añádalos; sus valores llegan enseguida.
El botón Iniciar sesión y actualizar vuelve a leer la cuenta sin esperar al ciclo de 3 horas (como mucho una vez cada cuarto de hora).
Si Octopus rechaza la dirección o la contraseña, la integración se detiene y no vuelve a intentarlo hasta que usted corrija la configuración: demasiados fallos podrían bloquear su cuenta.
Dispositivos
Cada contador es un dispositivo con el nombre de su energía y las cuatro últimas cifras de su número, por ejemplo «Octopus Electricidad …0123».
Contador de electricidad
| Función | Unidad | Qué es |
|---|---|---|
| Consumo diario | kWh | El consumo de cada día, fechado, para el seguimiento de energía de Gladys |
| Consumo del último día | kWh | El último día completo leído por Enedis (a menudo anteayer) |
| Coste del último día | € | Su coste con impuestos calculado por Octopus, sin el término fijo |
| Consumo del mes | kWh | El mes de la última lectura, hasta ese día |
| Coste del mes | € | Su coste con impuestos sin término fijo, solo si cada día del mes tiene coste |
| Saldo de la cuenta | € | El saldo de su cuenta de electricidad en Octopus: positivo a su favor, negativo si debe |
| Próximo pago | € | El importe del próximo cargo previsto |
| Fecha del próximo pago | texto | Su fecha |
| Oferta | texto | El nombre de su oferta |
| Horas valle ahora | sí/no | 1 durante las horas valle de su contrato, 0 si no |
| Periodo tarifario | texto | «Horas valle», «Horas punta» o «Tarifa única» |
| Precio actual del kWh | € | El precio del kWh con impuestos del periodo actual |
| Horas valle del contrato | texto | Las franjas de horas valle, por ejemplo «22:00–06:00» |
Contador de gas
Los mismos resúmenes, sin el consumo diario ni las horas valle: Consumo del último día, Coste del último día, Consumo del mes, Coste del mes (en kWh, como en sus facturas), Saldo de la cuenta, Próximo pago, Fecha del próximo pago y Oferta. Octopus no da el coste de las lecturas de gas: se calcula al precio del kWh con impuestos de su contrato, sin el término fijo. Un Gazpar que solo envía una lectura mensual muestra solo el mes.
Seguimiento de energía
Enedis envía las lecturas del Linky a Octopus con uno o dos días de retraso. Gladys 5.2 sabe importar un consumo fechado en el pasado: la integración envía cada día en su fecha real, por el punto de entrada propio del núcleo, y vuelve a enviar los tres últimos días en cada lectura (Enedis corrige a veces sus lecturas recientes; Gladys solo escribe lo que cambia). Los gráficos de energía de Gladys y el coste calculado según su contrato son, por tanto, correctos a pesar del retraso.
No se publica ningún índice acumulado, a propósito: Gladys convertiría un índice recibido con un día de retraso en una sola media hora de consumo.
Para que Gladys calcule los costes, elija la función Consumo diario de su contador de electricidad como contador principal en los ajustes de energía y cree allí su contrato. Las funciones Coste del último día y Coste del mes vienen de Octopus y no dependen de ese contrato.
El gas no se envía al seguimiento de energía: Gladys 5.2 solo valora la electricidad, y un consumo de gas se sumaría al de la electricidad.
Horas valle y periodo tarifario
La integración lee las horas valle de su contrato, de la fuente más precisa a la menos precisa:
- las franjas de la tarifa de horas valle de su contrato con Octopus;
- el calendario del proveedor de su contador;
- las horas valle que anuncia el Linky («HC (22H00-6H00)»).
Cada minuto, sin conectarse a Octopus, deduce el periodo actual, en hora legal francesa (cambios de hora incluidos), publica Horas valle ahora, Periodo tarifario y Precio actual del kWh, y activa las escenas al cambiar de periodo.
- Oferta Base: un solo periodo, todo el día.
- Oferta horas punta / horas valle: el periodo y su precio.
- Oferta de dos temporadas (horas punta y valle de verano y de invierno): las franjas y el precio de la temporada actual.
- Oferta de tipo Tempo: se da el periodo, pero no el precio, que depende del color del día que Octopus no anuncia en la cuenta.
Widget de panel
Octopus Energy muestra, para un contador (el primer contador de electricidad si no elige ninguno): la fecha de la última lectura, el consumo de ese día y del mes, su coste, los 14 últimos días en barras, el periodo tarifario actual y hasta cuándo, el precio del kWh, el saldo de la cuenta y el próximo pago. Se actualiza en cada lectura y en cada cambio de periodo. Cuando falta la configuración o se rechaza la contraseña, el widget lo indica.
Disparadores y acción de escena
- Comienzo de las horas valle (disparador): se activa en el minuto en
que empiezan las horas valle de su contrato. Elija opcionalmente el
contador. Variables: el fin de las horas valle (
until, HH:MM) y el precio en horas valle (price, €/kWh). - Fin de las horas valle (disparador): se activa en el minuto en que
terminan y empiezan las horas punta. Variables: la hora de las próximas
horas valle (
until) y el precio en horas punta (price). - Nuevo día de lecturas (disparador): Octopus recibió un nuevo día
completo del Linky o del Gazpar, a menudo uno o dos días después. Filtre
opcionalmente por contador o por energía. Variables: el día (
date, AAAA-MM-DD), su consumo (consumption, kWh) y su coste (cost), el consumo y el coste del mes (month_consumption,month_cost), la energía (energy:electricityogas). Se activa una vez por día nuevo; la primera lectura tras la instalación solo fija el punto de partida. - Leer el resumen de un contador Octopus (acción): da el último día
leído, su consumo y su coste, el consumo y el coste del mes, el saldo, el
próximo pago y su fecha, el periodo tarifario (
base,peakuoff_peak) y el precio actual, para las acciones siguientes de la escena. Una cifra desconocida queda vacía.
¿Por qué disparadores además de Horas valle ahora? El estado se vuelve a publicar con regularidad (cada 6 horas) para que Gladys no lo considere caducado: una escena «cuando el estado vale 1» podría volver a ejecutarse. Los disparadores solo se activan una vez, al cambiar de periodo, y nunca en un reinicio. Use el estado como condición («solo en horas valle») y los disparadores para iniciar una escena.
Ejemplos de escenas
- Termo eléctrico en horas valle: disparador Comienzo de las horas valle → encender el enchufe del termo; disparador Fin de las horas valle → apagarlo.
- Carga del coche: disparador Comienzo de las horas valle → encender el punto de carga, enviar «Carga iniciada hasta las {{triggerEvent.data.until}}».
- Lavadora diferida: al pulsar el botón «iniciar más tarde», condición Horas valle ahora = 1 → iniciar enseguida; si no, esperar al disparador.
- Informe diario: disparador Nuevo día de lecturas (energía: electricidad) → mensaje «{{triggerEvent.data.date}}: {{triggerEvent.data.consumption}} kWh, {{triggerEvent.data.cost}} €. Mes: {{triggerEvent.data.month_cost}} €.»
- Informe semanal: una escena programada los domingos → Leer el resumen de un contador Octopus → mensaje con el coste del mes y el saldo.
Actualización y cuotas
- Una lectura de la cuenta cada 3 horas; un nuevo intento al cabo de una hora si Octopus no responde o pide reducir el ritmo (límite de solicitudes de la API, error KT-CT-1199).
- Una lectura cuesta unas diez solicitudes: el inicio de sesión (el token de acceso dura una hora, el de renovación una semana, sin volver a enviar la contraseña), la lista de cuentas, la cuenta y las lecturas de cada contador. La primera lectura importa el historial elegido: cuatro solicitudes más para un año. La integración de Home Assistant lee cada hora: esto es tres veces menos.
- Las horas valle se calculan en Gladys, sin solicitudes.
- La integración se consulta a sí misma: no depende del sondeo de Gladys.
- Las condiciones de uso de Octopus Energy se aplican a su cuenta: esta integración solo lee sus propios datos, en modo de solo lectura.
Solución de problemas
- «Octopus Energy rechaza el correo electrónico o la contraseña»: compruébelos iniciando sesión en su área de cliente de Octopus y corrija después la configuración (la integración vuelve a intentarlo enseguida).
- «Octopus Energy no responde por ahora»: la API no respondió; nuevo intento en una hora. Si persiste, quizá Octopus cambió su API: abra un issue de GitHub con los registros.
- Ningún contador propuesto: la cuenta aún no tiene ningún punto de suministro activo (un contador dado de baja no se propone).
- El último día es de anteayer: es normal, Enedis y GRDF envían las lecturas con retraso.
- Sin consumo diario: puede que su contador no sea inteligente o que no haya autorizado la recogida de sus datos de consumo en su área de cliente.
- Sin periodo tarifario: Octopus no dio ni las franjas de horas valle del contrato ni las del contador. Comuníquelo con el nombre de su oferta.
- Registros: ponga
LOG_LEVEL=debugpara ver cada lectura. Los registros nunca muestran el correo electrónico, la contraseña ni los tokens.
Limitaciones
- Developed without the hardware: feedback welcome — desarrollada sin cuenta de Octopus. Las solicitudes siguen las de la integración de Home Assistant ha-octopus-french, no una prueba real: los primeros usos reales pueden revelar diferencias.
- Las lecturas tienen uno o dos días de retraso: sin potencia instantánea, sin «hoy». Para el tiempo real, use un módulo de teleinformación en su Linky.
- El seguimiento de energía recibe días, no medias horas: un contrato de horas punta / horas valle creado en Gladys no puede repartir un día entre sus dos precios. Las funciones de coste de Octopus sí lo hacen.
- El gas queda fuera del seguimiento de energía.
- Ofertas Tempo: sin precio actual ni color del día. Las ofertas gestionadas (Octopus Intelligent, carga de vehículos) no son compatibles.
- El coste del gas se estima al precio del kWh de su contrato; los costes nunca incluyen el término fijo.
- Una sola conexión por integración; se proponen todas las cuentas y todos los contadores de esa conexión.
- Ningún mando: la integración no controla nada en Octopus.
Privacidad y datos
El correo electrónico y la contraseña permanecen en la configuración de
Gladys. El archivo /data/octopus-state.json guarda el token de renovación
de Octopus (para no enviar la contraseña en cada lectura) y, para cada
contador, hasta dónde se ha alimentado el seguimiento de energía. Solo la
integración puede leerlo. No se envía nada a ningún sitio salvo a la API de
Octopus Energy France y a su Gladys.
Créditos
Las solicitudes GraphQL y la lectura de las respuestas de Octopus Energy France están adaptadas de ha-octopus-french de domodom30 (licencia MIT), la integración de Home Assistant para Octopus Energy France; sus pruebas aportaron las formas de respuesta usadas en las pruebas de aquí. Octopus Energy, Linky, Gazpar, Enedis y GRDF son marcas de sus respectivos propietarios.
Parámetros de configuración
Estos son los parámetros que Octopus Energy France te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su área de cliente de Octopus Energy | section | No | Inicie sesión con el correo electrónico y la contraseña de su área de cliente de Octopus Energy Francia. Las lecturas Linky y Gazpar llegan con uno o dos días de retraso y se leen cada 3 horas. Sin relación con Octopus Energy. |
| Correo electrónico | string | Sí | |
| Contraseña | secret | Sí | |
| Historial que importar | select | No | Días de electricidad enviados al seguimiento de energía de Gladys en la primera lectura. |
| Idioma de los nombres de dispositivos | select | No | Los nombres se fijan al añadir un contador a Gladys. |
Cómo instalar Octopus Energy France en Gladys
- En Gladys, abre Integraciones: Octopus Energy France 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-octopus-fr:1.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/guim31/gladys-octopus-fr.
Octopus Energy France 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
Octopus Energy France 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, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación