--- title: "Installation" weight: 10 description: "Prérequis, déploiement du module capcompta, activation et première ouverture." --- # 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. | Prérequis | Pourquoi | |---|---| | Dolibarr 18 minimum | Le module a été profilé sur cette version du moteur comptable | | PHP 7.4 minimum | Version exigée par le module | | Module **Comptabilité en partie double** activé | capcompta est une interface sur ce moteur : sans lui, il n'y a ni tables, ni classes, ni droits comptables | | Module **SmartAuth** activé | Il porte l'authentification de l'interface et le routage de ses appels | 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 : ```bash cd /chemin/vers/dolibarr/htdocs/custom git clone 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. ![Ligne du module capcompta dans la liste des modules Dolibarr, avec l'interrupteur d'activation](screenshots/activation-module.webp) À 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é : | Droit natif, libellé exactement comme dans Dolibarr | Ce qu'il ouvre dans capcompta | |---|---| | Consulter les rapports et exports de rapports (chiffre d'affaires, solde, journaux, grand livre) | Le tableau de bord, la liste des journaux et la prévisualisation du transfert | | Lire les opérations du Grand livre | La complétion des comptes par leur numéro dans les grilles | | Lier les produits et factures avec des comptes comptables | L'écran de liaison et la mémorisation des comptes | | Créer/modifier des opérations dans le Grand livre | Le transfert en comptabilité | | Gérer le plan comptable, configurer la comptabilité | L'écran de mise en service et le chargement d'un plan comptable | 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](/capcompta/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](/capcompta/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.