1. Récupérez votre clé API Holded
Dans Holded, allez dans Paramètres → Développeurs → API et générez (ou copiez) votre clé API. C'est l'identifiant que Finance utilise pour lire vos documents — protégez-la comme n'importe quel mot de passe.
2. Connectez-la dans Finance
Ouvrez Paramètres, collez la clé Holded et enregistrez. Elle n'est jamais stockée qu'chiffrée : personne, pas même depuis la base de données, ne peut la lire en clair. L'écran confirme la connexion en affichant les quatre derniers chiffres de la clé, pour que vous sachiez laquelle c'est sans jamais la revoir en entier.
3. Lancez la première synchronisation
Cliquez sur Synchroniser maintenant. Un passage complet ramène taxes, contacts, devis, ventes, achats, avoirs, paiements, plan comptable et journal — cela peut prendre quelques minutes la première fois, selon le nombre de documents de votre compte Holded. Vous pouvez continuer à utiliser Finance entre-temps : l'écran vous prévient quand c'est terminé.
Les synchronisations suivantes sont automatiques (une fois par jour par défaut), et vous pouvez continuer à cliquer sur Synchroniser maintenant chaque fois que vous voulez voir l'état le plus récent.
4. Vérifiez que tout est bien arrivé
Ouvrez Ventes ou Achats et comparez le total du mois dernier avec ce que vous voyez dans Holded — ils devraient correspondre. En cas de souci, Paramètres affiche l'historique des synchronisations avec la raison de l'erreur du dernier passage.
5. (Facultatif) Attribuez des documents à des projets
Si vous utilisez aussi Projects, ouvrez Projets et rattachez vos premières factures ou devis au projet correspondant — vous verrez ses totaux de revenus et de coûts directs se mettre à jour immédiatement.
Pour la suite
- Devis, ventes, achats et contacts — comment filtrer et consulter ce que la synchronisation a ramené.
- Connecter un assistant — si vous voulez interroger Claude ou ChatGPT sur vos données.