Intégration domotique Foncia, gratuite et open source
Votre compte MyFoncia dans Gladys : solde, appels de fonds, documents et incidents.
Publiée par prohand
- Appareils
- Version 2.0.0
- Nécessite Gladys >=5.3.0
- ★ 0
Cette intégration amène votre compte MyFoncia (Foncia, syndic de copropriété et gestion locative) dans Gladys : solde du compte, prochaine somme à payer, incidents ouverts, nouveaux documents et prochaine assemblée générale. Elle ajoute aussi des déclencheurs de scène, des actions de scène et un widget de tableau de bord.
Intégration non officielle. Foncia ne publie pas d'API : l'intégration lit votre compte comme le fait le site my-foncia.fonciamillenium.net. Si Foncia modifie son site, l'intégration peut cesser de fonctionner jusqu'à sa mise à jour.
Prérequis
- Gladys Assistant 5.3 ou plus récent.
- Un compte MyFoncia (e-mail et mot de passe) sans second facteur (code SMS ou application à chaque connexion) : l'intégration ne peut pas y répondre.
- Un accès Internet pour Gladys. C'est une intégration cloud : rien ne tourne sur votre réseau local.
Configuration
| Champ | Quoi saisir |
|---|---|
| E-mail MyFoncia | L'e-mail avec lequel vous vous connectez sur my-foncia.fonciamillenium.net. |
| Mot de passe MyFoncia | Votre mot de passe. Stocké par Gladys comme secret, envoyé uniquement à la page de connexion de Foncia. |
| Intervalle de synchro (min) | Fréquence de lecture de MyFoncia. 60 par défaut, 15 minimum. |
| Rappel d'échéance (jours) | Combien de jours avant une échéance le déclencheur « Échéance à payer » se déclenche. 7 par défaut. |
| Réglages avancés | Laissez vide, voir Réglages avancés. |
Appuyez ensuite sur Tester la connexion : le message liste les comptes trouvés. Synchroniser maintenant lit MyFoncia tout de suite.
Appareils
Un appareil Gladys par compte MyFoncia (un lot de copropriété, une location),
nommé Foncia – <compte>. Créez-le depuis l'onglet Découverte. Ses
fonctionnalités sont en lecture seule et gardent leur historique :
| Fonctionnalité | Unité | Signification |
|---|---|---|
| Solde du compte | € | Tel qu'affiché par MyFoncia (négatif : vous devez de l'argent). |
| Prochaine somme à payer | € | Montant du prochain appel de fonds ou loyer. |
| Jours avant l'échéance | jours | Négatif une fois la date passée. |
| Incidents ouverts | — | Demandes faites à Foncia (travaux, incidents, questions) pas encore clôturées. |
| Nouveaux documents | — | Documents ajoutés depuis la dernière fois où vous les avez marqués comme vus. |
| Jours avant l'assemblée générale | jours | Prochaine AG de la copropriété. |
Le badge de l'appareil indique cloud, ou injoignable quand la dernière synchronisation a échoué.
Déclencheurs de scène
Ils ne se déclenchent que pour ce qui est nouveau : la première synchronisation après l'installation apprend seulement ce qui existe déjà. Au plus 5 événements de chaque sorte par synchronisation, pour qu'une scène qui envoie une notification par document n'inonde jamais votre téléphone.
| Déclencheur | Filtres | Variables |
|---|---|---|
| Nouveau document Foncia | compte, type de document | compte, titre, date |
| Incident Foncia mis à jour | compte, nouveau statut | compte, titre, statut précédent |
| Échéance à payer | compte | compte, montant, date d'échéance, jours restants |
| AG annoncée | compte | compte, titre, date, jours restants |
Types de document : appel de fonds, assemblée générale, relevé / décompte de charges, facture ou quittance, autre. Statuts d'incident : ouvert, en cours, clôturé.
Exemple : « Quand un nouveau document Foncia de type appel de fonds arrive, m'envoyer un message : Nouvel appel de fonds : {{triggerEvent.data.title}} ».
Actions de scène
- Synchroniser Foncia : lit MyFoncia maintenant et donne aux actions suivantes les chiffres d'un compte (vide = le premier) : réussite, compte, solde, somme à payer, date d'échéance, incidents ouverts, nouveaux documents.
- Marquer les documents Foncia comme vus : remet à 0 le compteur « Nouveaux documents » (d'un compte, ou de tous).
Widget de tableau de bord
Compte Foncia : solde, somme à payer (0 € si rien n'est dû), dernier règlement et nouveaux documents, connexion et dernière synchro, prochaine échéance et prochaine AG, les cinq derniers documents, et deux boutons : Synchroniser et Marquer comme vu. Dans ses réglages, choisissez le compte à afficher (vide = le premier).
Un tiret (—) veut dire que MyFoncia n'a pas pu être lu : consultez les logs de l'intégration.
Confidentialité
- Le mot de passe n'est envoyé qu'à la page de connexion de Foncia
(
login.my-foncia.fonciamillenium.net). Il n'est jamais écrit dans les logs. - Les jetons d'accès restent en mémoire. Le seul fichier écrit est
/data/foncia-state.json: les identifiants des documents, incidents et assemblées déjà vus, pour qu'aucun déclencheur ne parte deux fois après un redémarrage.
Dépannage
| Message | Que faire |
|---|---|
| MyFoncia a refusé l'e-mail ou le mot de passe | Vérifiez-les en vous connectant sur my-foncia.fonciamillenium.net. |
| demande un second facteur | Non pris en charge : le compte demande un code à chaque connexion. |
| Le compte MyFoncia est bloqué | Débloquez-le sur my-foncia.fonciamillenium.net, puis appuyez sur Tester la connexion. |
| L'identifiant client MyFoncia manque | Voir Réglages avancés. |
| MyFoncia est injoignable | Vérifiez l'accès Internet de Gladys. |
| MyFoncia a répondu par une erreur | Consultez les logs de l'intégration ; Foncia a peut-être modifié son site. |
Réglages avancés
L'intégration se connecte et lit votre compte avec les mêmes réglages que le site MyFoncia : son identifiant client Okta et l'adresse de son API. Les deux sont intégrés : laissez ces deux champs vides.
Si un jour Foncia les change et que chaque synchronisation échoue avec une
erreur d'API, lisez les nouvelles valeurs dans
https://my-foncia.fonciamillenium.net/config.js : clientId sous oktaConfig
est l'identifiant client Okta, url sous graphql est l'URL de l'API
MyFoncia. Saisissez-les dans les réglages avancés, enregistrez, puis appuyez
sur Tester la connexion. Ouvrez aussi un ticket sur le dépôt pour que les
valeurs intégrées soient mises à jour pour tout le monde.
Paramètres de configuration
Voici les paramètres demandés par Foncia dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Pour commencer | section | Non | Saisissez l'e-mail et le mot de passe que vous utilisez sur my-foncia.fonciamillenium.net. L'intégration lit votre compte toutes les heures : un appareil Gladys par compte, avec son solde, la prochaine somme à payer, les incidents ouverts et les nouveaux documents. Les comptes protégés par un second facteur (SMS, application) ne sont pas pris en charge. |
| E-mail MyFoncia | string | Oui | |
| Mot de passe MyFoncia | secret | Oui | |
| Intervalle de synchro (min) | number | Non | Fréquence de lecture de MyFoncia, en minutes (15 minimum). |
| Rappel d'échéance (jours) | number | Non | Le déclencheur de scène « Échéance à payer » se déclenche ce nombre de jours avant l'échéance. |
| Réglages avancés | section | Non | Intégrés : laissez ces champs vides. Ne les remplissez que si Foncia change ses réglages (voir la documentation). |
| Identifiant client Okta | string | Non | |
| URL de l'API MyFoncia | string | Non |
Comment installer Foncia dans Gladys
- Dans Gladys, ouvrez Intégrations : Foncia apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/prohand/gladys-foncia:2.0.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/prohand/gladys-foncia.
Foncia nécessite Gladys >=5.3.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
Foncia est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par prohand, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation