Installation

Prérequis

Vérifiez ces quatre points avant d'installer capcompta. Les trois premiers bloquent l'activation du module ; le quatrième est pris en charge automatiquement par Dolibarr.

Ces deux modules sont déclarés comme dépendances de capcompta, mais Dolibarr ne les traite pas de la même manière :

• si la Comptabilité en partie double n'est pas active, capcompta refuse son activation et affiche un message explicite ;
• si SmartAuth n'est pas actif, Dolibarr l'active automatiquement en même temps que capcompta.

Rien n'empêche en revanche de désactiver l'un des deux après coup, et Dolibarr ne vous en avertira pas. Sans la comptabilité native, le menu capcompta disparaît ; sans SmartAuth, l'interface ne répond plus. Désactivez donc capcompta avant eux.

Côté poste de travail, prévoyez un navigateur récent et un écran large. capcompta est une interface de bureau, elle n'a pas de rendu adapté au téléphone.

Vérifier l'état des modules requis

Ouvrez Accueil > Configuration > Modules/Applications, onglet Comptabilité, et assurez-vous que Comptabilité en partie double est actif. Vérifiez ensuite que SmartAuth est actif dans son propre onglet.

Installer le module

Deux méthodes, selon la façon dont vous avez reçu le module.

Par archive zip (méthode recommandée)

1. Ouvrez Accueil > Configuration > Modules/Applications.
2. Cliquez sur l'onglet Déployer/Installer un module externe.
3. Sélectionnez le fichier zip de capcompta et lancez l'envoi.
4. Dolibarr décompresse le module et l'ajoute à la liste des modules disponibles.

Si l'onglet de déploiement est absent, c'est que l'installation de modules externes depuis l'interface est désactivée sur votre instance. Demandez à votre administrateur d'utiliser la seconde méthode.

L'archive contient déjà l'interface compilée. Aucune étape de compilation n'est nécessaire sur le serveur.

Par dépôt git (administrateur système)

Cette méthode s'adresse à l'administrateur qui gère le serveur. Le dépôt du module se clone dans le dossier des modules externes de Dolibarr :

cd /chemin/vers/dolibarr/htdocs/custom
git clone <url-du-depot-capcompta> capcompta

Le dossier doit s'appeler exactement capcompta et être lisible par l'utilisateur du serveur web. Une mise à jour se fait ensuite par un git pull suivi de la procédure de mise à jour décrite plus bas.

Activer le module

1. Retournez dans Accueil > Configuration > Modules/Applications.
2. Cherchez capcompta dans la liste, onglet Comptabilité.
3. Basculez l'interrupteur d'activation.

À l'activation, le module ajoute son entrée de menu principale et ne crée aucune table : il travaille directement dans les tables du module comptable natif.

Accorder les droits

capcompta ne définit aucun droit qui lui soit propre. Il réutilise intégralement les permissions du module Comptabilité en partie double. Une personne qui a déjà accès à la comptabilité native a immédiatement accès à capcompta, avec exactement le même périmètre.

Les droits utilisés sont les suivants, dans Accueil > Utilisateurs et groupes > fiche de l'utilisateur > Permissions, section Comptabilité :

Un utilisateur sans aucun de ces droits ne voit pas le menu capcompta.

Première ouverture

Le menu capcompta apparaît dans la barre de menu principale. Cliquez dessus : le Plan de travail s'ouvre.

Sur une instance dont la comptabilité est déjà paramétrée, vous arrivez directement sur le tableau de bord.

Sur une installation neuve, vous arrivez sur l'écran de Mise en service. C'est normal : le programme d'installation de Dolibarr n'installe volontairement aucun plan comptable, et une comptabilité sans plan comptable n'a rien à afficher. Cet écran vous liste ce qui manque et propose l'action qui corrige chaque point. La marche à suivre est détaillée dans la page Configuration.

Vérification après installation

Trois contrôles rapides :

1. Le menu capcompta est présent dans la barre principale.
2. Le plan de travail s'ouvre et affiche soit le tableau de bord, soit l'écran de mise en service, mais jamais une page vide ni une erreur.
3. Dans Accueil > Configuration > Modules/Applications, l'icône de configuration de capcompta ouvre bien sa page de réglages.

Si le plan de travail reste vide ou renvoie un refus d'accès, reportez-vous à la FAQ.

Mettre à jour le module

1. Remplacez les fichiers du module : nouvelle archive déployée par-dessus l'ancienne, ou git pull dans le dossier custom/capcompta.
2. Dans Accueil > Configuration > Modules/Applications, désactivez puis réactivez capcompta.

Cette désactivation/réactivation n'est pas facultative : c'est elle qui applique les éventuelles évolutions et qui rafraîchit la déclaration des routes de l'interface. Sans elle, une fonction nouvellement ajoutée peut répondre un refus d'accès sans autre explication.

Vos données comptables ne sont jamais touchées par cette opération : elles vivent dans les tables du module natif.

Désinstaller le module

Désactivez capcompta depuis Accueil > Configuration > Modules/Applications.

Le module ne possède pas de table à lui : sa désactivation ne supprime aucune écriture, aucune liaison et aucun paramétrage comptable. Tout ce que vous avez saisi via capcompta reste en place et reste visible dans les écrans natifs de la comptabilité. Seules les options d'interface propres au module sont retirées.