Beem Energy (integración externa) — presentación de la v1.0.0
¡Hola a todos! 
Os presento una nueva integración externa para Gladys: Beem Energy, para seguir tus kits solares Beem (BeemBox de los kits de 300 W, Beem On de los kits de 500 W). Este tema servirá luego para anunciar las novedades y recoger vuestros comentarios.
¿Qué es?
Una integración externa de Gladys que funciona en su propio contenedor, se instala desde el catálogo de integraciones (sección Energía) y sube la producción de todas las box de tu cuenta Beem, a través del cloud Beem (las box no tienen acceso local).
Funcionalidades
- Cada box se convierte en un dispositivo Gladys, con:
- la potencia solar en tiempo real (W);
- un índice de producción (kWh), para vincularlo al Seguimiento de energía de Gladys y ver tu producción por media hora junto a tu consumo;
- la producción del día (kWh);
- la señal Wi-Fi (%).
- Todas las box en una sola consulta, cada 2 minutos por defecto.
- De noche, una box en modo de espera muestra 0 W, y no su última potencia.
- Nada se pierde a medianoche, al cambiar de mes o durante una parada de Gladys: el índice se recalcula a partir de los totales mensuales del cloud.
- Historial mensual recuperado al inicio (24 meses por defecto), para el año, el total y la amortización.
- Protección contra el límite de la API Beem: el token se guarda durante una hora, y después de un rechazo (429), la integración espera 20 minutos en lugar de insistir.
4 widgets de panel de control
En un panel de control: Modificar → Añadir una caja → Widgets de integración.
- Box Beem: una box, con su curva del día, la parte de su potencia máxima, el día, el mes, el rendimiento en kWh/kWc (comparable entre un kit de 300 W y un kit de 500 W), el Wi-Fi, la hora del último registro y los paneles.
Instalación solar: toda la instalación, en monofásico o trifásico. En trifásico, asignas las box de cada fase (L1, L2, L3) y obtienes una curva por fase, una línea por fase, el equilibrio de las fases y las box en subproducción.
Ahorros solares (estimación): ahorros del día, del mes, del año y en total. Con el coste de tus kits, también muestra la jauge y la fecha de amortización, además del CO₂ evitado y los ahorros de los últimos 12 meses.
Historial de producción: barras en 30 días o 12/24 meses, récords, comparación con el año pasado, clasificación de las box.
Los ahorros, ¿cómo funciona?
Un kit plug-and-play no tiene contador de red: la estimación se basa en tu tarifa, indicada en la pestaña Configuración.
- Tarifa: Base o Horas punta/valle. En HP/HC, el precio del kWh solar se pondera por las horas en las que tus paneles producen realmente.
- Tasa de autoconsumo: 100 % por defecto.
- Reventa del excedente: opcional, si tienes un contrato.
- Coste de la instalación: para la amortización.
Escenas
- Disparador Box en subproducción: una box está muda durante 30 minutos mientras las otras producen, o rinde mucho menos que ellas. Se dispara una vez por box y por día, práctico para detectar un microinversor desconectado o un Wi-Fi perdido.
- Disparador Balance de producción del día: se dispara una vez finalizado el día solar, con los kWh del día, el ahorro, el CO₂ y la mejor box. Ideal para un mensaje de la noche: « 12,3 kWh hoy, 2,45 € ahorrados».
- Acción Leer la producción solar: potencia, día, mes, año, parte de la potencia máxima y ahorros, de una box o de toda la instalación. Por ejemplo, para poner en marcha el lavavajillas cuando brilla el sol.
Instalación
- En Gladys: Integraciones → busca Beem → Instalar.
- Pestaña Configuración: el correo electrónico y la contraseña de la aplicación Beem, luego Guardar. El botón Probar la conexión lista tus box.
- Tus box aparecen en la pestaña Descubrimiento: créalas.
- Opcional: indica tu tarifa para los ahorros, y vincula el índice de producción de cada box en Integraciones → Seguimiento de energía.
La documentación completa está accesible desde el enlace «Documentación» de la pantalla de configuración.
Requisitos previos
- Gladys ≥ 5.1.0.
- Una cuenta Beem con tus box visibles en la aplicación.
Consejos útiles
- Evita conectar la misma cuenta Beem a varias herramientas a la vez (Home Assistant, scripts…): el cloud Beem bloquea las cuentas demasiado insistentes.
- El historial día a día se acumula a partir de la instalación de la integración. El cloud Beem solo proporciona el historial mes a mes.
Comentarios bienvenidos
La API Beem no es pública: gracias a la integración Home Assistant CharlesP44/Beem_Energy que ha documentado sus intercambios. Por mi parte, la pruebo en 6 box: 3 BeemBox (3 × 300 W) y 3 Beem On (2 × 500 W), una de cada por fase.
- ¿Los valores son coherentes con la aplicación Beem?
- Si un valor te parece incorrecto, el botón Diagnosticar las box de la pestaña Configuración muestra lo que el cloud sube (sin correo electrónico, contraseña ni token): pégalo aquí o en una issue.
Depósito y notas de versión: Releases · Terdious/gladys-beem-energy · GitHub
Actualización: v1.1.0 — un widget Box más expresivo
Cortes del día
Frente a las otras cajas
Para disfrutarlo