Installation et activation
Prérequis et comptabilité :
- Dolibarr : Version 14.0 minimum, 22.0 maximum
- PHP : 7.0 minimum, 8.4 maximum.
- Le module « Tiers » de Dolibarr :
Activé. - Le module « Factures et avoirs » : Activé.
- Le module « Fournisseurs » : Activé.
- Le module « Multi-devises » : Activé.
- Le module InfraSPack Plus : Activé.
- Base de données : MySQL ou MariaDB. Les requêtes du module sont compatibles avec le mode strict ONLY_FULL_GROUP_BY (MySQL 5.7.5 et supérieur).
Procédure :
Étape 1 : déposer le module
Si vous avez accès aux dossiers et fichiers de votre Dolibarr, dézippez l'archive du module dans le dossier custom de son arborescence. Le module zippé peut également être installé directement depuis la page ACCUEIL >CONFIGURATION > MODULES/APPLICATIONS, onglet DÉPLOYER UN MODULE EXTERNE.
Étape 2 : activer le module
À l'activation, le module :
- Enregistre la constante MODULE_EXTRAITCOMPTECLIENT_VERSION ;
- Déclare le hook sur la fiche tiers (contexte « thirdpartycard ») ;
- Déclare ses modèles de documents ;
- Crée la permission « Génération de l'état du compte tiers ».
Étape 3 : activer les modèles de documents
IMPORTANT : les modèles d'extrait de compte doivent être activés dans la configuration du module Tiers pour être proposés dans la fenêtre de génération.
- Account_statut : Modèle d'état du compte tiers PDF ;
- Account_statut_csv : Modèle d'état du compte tiers CSV ;
- InfraSPlus_account_statut : Modèle PDF InfraS (uniquement si le module InfraSPack Plus est activé).
Seuls les modèles activés ici sont proposés dans la fenêtre de génération. Si aucun modèle n'est activé, la liste « Type de fichier/modèle » de la fenêtre est vide et la génération se rabat sur le modèle PDF de base.
Étape 4 : vérifier les permissions des utilisateurs
Le module crée une seule permission :
- Module : Extrait Compte Client / Fournisseur
- Libellé : Génération de l'état du compte tiers
- Code interne : extraitcompteclient -> societe -> generate_account_statut
Cette permission se règle par utilisateur ou par groupe : Menu Accueil > Utilisateurs & Groupes > fiche de l'utilisateur ou du groupe > onglet « Permissions ».
Effets de la permission :
- Utilisateur AVEC la permission : le bouton « Générer l'état du compte » est visible sur la fiche tiers et la génération est possible.
- Utilisateur SANS la permission : le bouton n'est pas affiché. Si une demande de génération est malgré tout envoyée, elle est ignorée.
La permission est marquée comme « accordée par défaut » : elle est attribuée automatiquement aux administrateurs à l'activation du module et proposée par défaut aux nouveaux utilisateurs. Vérifier néanmoins les groupes existants.
