Integración domótica Foncia, gratuita y de código abierto
Su cuenta MyFoncia en Gladys: saldo, derramas, documentos e incidencias.
Publicado por prohand
- Dispositivos
- Versión 2.0.0
- Requiere Gladys >=5.3.0
- ★ 0
Esta integración lleva su cuenta MyFoncia (Foncia, administración de fincas: comunidades de propietarios y alquileres) a Gladys: saldo de la cuenta, próximo importe a pagar, incidencias abiertas, documentos nuevos y la próxima junta de propietarios. También añade disparadores de escena, acciones de escena y un widget para el panel.
Integración no oficial. Foncia no publica ninguna API: la integración lee su cuenta como lo hace el sitio my-foncia.fonciamillenium.net. Si Foncia cambia su sitio, la integración puede dejar de funcionar hasta que se actualice.
Requisitos
- Gladys Assistant 5.3 o posterior.
- Una cuenta MyFoncia (correo y contraseña) sin segundo factor (código por SMS o app en cada inicio de sesión): la integración no puede responderlo.
- Acceso a Internet para Gladys. Es una integración cloud: nada se ejecuta en su red local.
Configuración
| Campo | Qué introducir |
|---|---|
| Correo de MyFoncia | El correo con el que inicia sesión en my-foncia.fonciamillenium.net. |
| Contraseña de MyFoncia | Su contraseña. Gladys la guarda como secreto y solo se envía a la página de inicio de sesión de Foncia. |
| Intervalo de sincronización (min) | Cada cuánto se lee MyFoncia. 60 por defecto, mínimo 15. |
| Aviso de vencimiento (días) | Cuántos días antes de un vencimiento se activa el disparador «Pago pendiente». 7 por defecto. |
| Ajustes avanzados | Déjelos vacíos, vea Ajustes avanzados. |
Pulse después Probar la conexión: el mensaje enumera las cuentas encontradas. Sincronizar ahora lee MyFoncia al momento.
Dispositivos
Un dispositivo de Gladys por cuenta MyFoncia (un piso de una comunidad, un
alquiler), llamado Foncia – <cuenta>. Créelo desde la pestaña Descubrir.
Sus funciones son de solo lectura y conservan su historial:
| Función | Unidad | Significado |
|---|---|---|
| Saldo de la cuenta | € | Tal como lo muestra MyFoncia (negativo: usted debe dinero). |
| Próximo importe a pagar | € | Importe de la próxima derrama o del próximo alquiler. |
| Días hasta el vencimiento | días | Negativo una vez pasada la fecha. |
| Incidencias abiertas | — | Solicitudes a Foncia (reparaciones, incidencias, preguntas) aún no cerradas. |
| Documentos nuevos | — | Documentos añadidos desde la última vez que los marcó como vistos. |
| Días hasta la junta | días | Próxima junta de la comunidad de propietarios. |
La insignia del dispositivo indica cloud, o inaccesible cuando la última sincronización ha fallado.
Disparadores de escena
Solo se activan con lo nuevo: la primera sincronización tras la instalación solo aprende lo que ya existe. Como máximo 5 eventos de cada tipo por sincronización, para que una escena que envía una notificación por documento nunca inunde su teléfono.
| Disparador | Filtros | Variables |
|---|---|---|
| Nuevo documento de Foncia | cuenta, tipo de documento | cuenta, título, fecha |
| Incidencia de Foncia actualizada | cuenta, nuevo estado | cuenta, título, estado anterior |
| Pago pendiente | cuenta | cuenta, importe, fecha de vencimiento, días restantes |
| Junta convocada | cuenta | cuenta, título, fecha, días restantes |
Tipos de documento: derrama / cuota, junta de propietarios, extracto de gastos, factura o recibo, otro. Estados de incidencia: abierta, en curso, cerrada.
Ejemplo: «Cuando llegue un nuevo documento de Foncia de tipo derrama / cuota, enviarme un mensaje: Nueva derrama: {{triggerEvent.data.title}}».
Acciones de escena
- Sincronizar Foncia: lee MyFoncia ahora y pasa a las acciones siguientes las cifras de una cuenta (vacío = la primera): éxito, cuenta, saldo, importe debido, fecha de vencimiento, incidencias abiertas, documentos nuevos.
- Marcar documentos de Foncia como vistos: pone a 0 el contador «Documentos nuevos» (de una cuenta o de todas).
Widget del panel
Cuenta Foncia: saldo, importe debido (0 € si no se debe nada), último pago y documentos nuevos, conexión y última sincronización, próximo vencimiento y próxima junta, los cinco últimos documentos y dos botones: Sincronizar y Marcar como visto. En sus ajustes, elija la cuenta que se muestra (vacío = la primera).
Un guion (—) significa que no se ha podido leer MyFoncia: consulte los registros de la integración.
Privacidad
- La contraseña solo se envía a la página de inicio de sesión de Foncia
(
login.my-foncia.fonciamillenium.net). Nunca se escribe en los registros. - Los tokens de acceso se quedan en memoria. El único archivo escrito es
/data/foncia-state.json: los identificadores de los documentos, incidencias y juntas ya vistos, para que ningún disparador se active dos veces tras un reinicio.
Resolución de problemas
| Mensaje | Qué hacer |
|---|---|
| MyFoncia ha rechazado el correo o la contraseña | Compruébelos iniciando sesión en my-foncia.fonciamillenium.net. |
| pide un segundo factor | No compatible: la cuenta pide un código en cada inicio de sesión. |
| La cuenta de MyFoncia está bloqueada | Desbloquéela en my-foncia.fonciamillenium.net y pulse Probar la conexión. |
| Falta el identificador de cliente de MyFoncia | Vea Ajustes avanzados. |
| No se puede acceder a MyFoncia | Compruebe el acceso a Internet de Gladys. |
| MyFoncia ha respondido con un error | Consulte los registros de la integración; puede que Foncia haya cambiado su sitio. |
Ajustes avanzados
La integración inicia sesión y lee su cuenta con los mismos ajustes que el sitio MyFoncia: su ID de cliente de Okta y la dirección de su API. Ambos están integrados: deje estos dos campos vacíos.
Si algún día Foncia los cambia y cada sincronización falla con un error de API,
lea los nuevos valores en https://my-foncia.fonciamillenium.net/config.js:
clientId bajo oktaConfig es el ID de cliente Okta, url bajo graphql
es la URL de la API de MyFoncia. Introdúzcalos en los ajustes avanzados,
guarde y pulse Probar la conexión. Abra también una incidencia en el
repositorio para que los valores integrados se actualicen para todos.
Parámetros de configuración
Estos son los parámetros que Foncia te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Primeros pasos | section | No | Introduzca el correo y la contraseña que usa en my-foncia.fonciamillenium.net. La integración lee su cuenta cada hora: un dispositivo de Gladys por cuenta, con su saldo, el próximo importe a pagar, las incidencias abiertas y los documentos nuevos. Las cuentas protegidas con un segundo factor (SMS, app) no son compatibles. |
| Correo de MyFoncia | string | Sí | |
| Contraseña de MyFoncia | secret | Sí | |
| Intervalo de sincronización (min) | number | No | Cada cuánto se lee MyFoncia, en minutos (mínimo 15). |
| Aviso de vencimiento (días) | number | No | El disparador de escena «Pago pendiente» se activa estos días antes del vencimiento. |
| Ajustes avanzados | section | No | Integrados: deje estos campos vacíos. Rellénelos solo si Foncia cambia sus ajustes (vea la documentación). |
| ID de cliente Okta | string | No | |
| URL de la API de MyFoncia | string | No |
Cómo instalar Foncia en Gladys
- En Gladys, abre Integraciones: Foncia 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-foncia:2.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/prohand/gladys-foncia.
Foncia requiere Gladys >=5.3.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
Foncia 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