Application Bank
Application Bank
L'application Bank connecte un site Dokos à ses banques par l'agrégateur Bridge. Elle importe les opérations des comptes en Transactions bancaires. Pour l'utiliser, lisez Synchronisation bancaire.
Cette page s'adresse aux administrateurs et aux développeurs.
Ce que l'application ajoute
- Sur la fiche Banque : le panneau de connexion Bridge et des champs cachés (identifiant de l'élément Bridge, statut, synchronisation autorisée, dernière erreur).
- Sur la fiche Compte bancaire : l'identifiant du compte Bridge et la Date de synchronisation initiale.
- Sur la Catégorie de transaction bancaire : l'identifiant de catégorie Bridge.
- Une tâche quotidienne qui lit l'état de chaque connexion et crée une notification quand il change.
- Un point d'entrée de webhook : quand Bridge a rafraîchi une banque, il prévient le site, qui importe les nouvelles opérations.
Configuration
Le site ne parle pas directement à Bridge. Il passe par le service de connexion bancaire de Dokos, avec une authentification OAuth2. Le fichier site_config.json du site contient :
| Clé | Rôle |
|---|---|
bank_connector_url | Adresse du service de connexion bancaire. |
bank_connector_token_uri | Adresse qui délivre le jeton d'accès. |
bank_connector_client_id | Identifiant du client OAuth2. |
bank_connector_client_secret | Secret du client OAuth2. |
Sans bank_connector_url, la fiche Banque ne lit pas l'état de la connexion. Sans bank_connector_token_uri, Dokos affiche « bank_connector_token_uri n'est pas configuré ».
Pour recevoir les webhooks, le site doit être joignable depuis Internet à son nom d'hôte, sans numéro de port. En développement, un tunnel (par exemple localtunnel) et la clé host_name du site_config.json le permettent.
bank_connector_key et bank_connector_secret ne servent plus.Installation
bench get-app bank --branch <branche de votre version> https://gitlab.com/dokos/bank.git
bench --site <site> install-app bank