# 1- Le module Commisions

Présentation générale, installation, activation

# 1.1- Présentation

#### <span style="color: rgb(0, 0, 0);">**1.1.1 - Fonctionnalités**</span>

<span style="color: rgb(0, 0, 0);">Le module Commissions permet de calculer des commissions de vos commerciaux.</span>

[![copie d'écran du calcul des commissions](https://doc.altairis.fr/uploads/images/gallery/2024-07/scaled-1680-/R5BF9HxSCjYkxO9S-image.png)](https://doc.altairis.fr/uploads/images/gallery/2024-07/R5BF9HxSCjYkxO9S-image.png)

<span style="color: rgb(0, 0, 0);">Les commissions peuvent être calculées sur le montant HT ou la marge, en prenant en compte soit les commandes, soit les factures, soit les règlements partiels ou complets de ces dernières. Des règles peuvent ensuite être appliquées pour affiner vos calculs et prendre en compte divers éléments tels que les catégories de produits, de clients ou le commissionnement des contacts de document plutôt que les commerciaux rattachés aux clients.</span>

#### <span style="color: rgb(0, 0, 0);">**1.1.2- Compatibilité et conformité du module** </span>

<span style="color: rgb(0, 0, 0);">Le module est compatible avec </span>[DoliRent ](https://www.altairis.fr/boutique/dolirent/)<span style="color: rgb(0, 0, 0);">notre solution de gestion de la location de matériel avec Dolibarr. Il fonctionne aussi avec les modules </span>[Sous-total](https://www.dolistore.com/fr/modules/907-Sous-total-V3.html) <span style="color: rgb(0, 0, 0);">et </span>[Multi-société](https://www.dolistore.com/fr/modules/69-Multi-soci--t--.html).

<span style="color: rgb(0, 0, 0);">Par ailleurs, il est conforme à la</span> [loi de finances 2016](https://bofip.impots.gouv.fr/bofip/10693-PGP.html/identifiant=ACTU-2016-00190).

#### <span style="color: rgb(0, 0, 0);">**1.1.3- Cible** </span>

<span style="color: rgb(0, 0, 0);">Le module s'adresse à tous les utilisateurs de Dolibarr. Son utilisation ne nécessite aucune connaissance technique ou d'administration.</span>

#### <span style="color: rgb(0, 0, 0);">**1.1.4 - Licence** </span>

<span style="color: rgb(0, 0, 0);">Tous nos modules sont distribués sur le</span> [Dolistore ](https://www.dolistore.com/fr/recherche?search_query=altairis)<span style="color: rgb(0, 0, 0);">et sur notre </span>[boutique ](https://www.altairis.fr/boutique/)<span style="color: rgb(0, 0, 0);">en ligne sous licence GPL v3.</span>

#### <span style="color: rgb(0, 0, 0);">**1.1.5 - Ressources** </span>

##### <span style="color: rgb(0, 0, 0);">1.1.5.1- La présente documentation</span>

<span style="color: rgb(0, 0, 0);">Nos guides utilisateur sont là pour vous accompagner dans l’utilisation de nos modules. Notre module Commission est simple et facile a utiliser.</span>

##### <span style="color: rgb(0, 0, 0);">1.1.5.2- Notre site de démonstration</span>

<span style="color: rgb(0, 0, 0);">Le module est installé sur</span> [notre environnement de démonstration](https://demo.altairis.fr/). <span style="color: rgb(0, 0, 0);">Connectez-vous avec l’identifiant demo et le mot de passe demo.</span>

##### <span style="color: rgb(0, 0, 0);">1.1.5.3- Forum sur dolibarr.org </span>

<span style="color: rgb(0, 0, 0);">Consultez toutes les informations sur le module dans les discussions du forum</span> <span style="color: rgb(0, 0, 0);">[français](https://www.dolibarr.fr/forum/t/module-commissionnement-commerciaux/9078/11). Nous créons pour chacun de nos modules une discussion sur le forum dolibarr. Ces discussions peuvent contenir de nombreuses informations. Aussi, si vous avez des commentaires et suggestions, pour une réponse plus rapide, il est préférable de continuer sur cette même conversation.</span>

<p class="callout info">**<span style="color: rgb(24, 139, 175);">Note : </span>**Le forum est un lieu d'échange autour de l'utilisation et des fonctionnalités de nos modules. En cas de difficultés d'utilisation ou pour toute remontée de bogue, privilégiez [notre plateforme de support](https://support.altairis.fr). Par ailleurs, nous vous remercions de ne pas multiplier les canaux d'échange pour un même objet.</p>

# 1.2- Avant de commencer

#### <span style="color: rgb(0, 0, 0);">**1.2.1- Avertissement**</span>

<span style="color: rgb(0, 0, 0);">Nous assurons le bon fonctionnement de nos modules sur les environnements natifs de Dolibarr. Nous ne pouvons pas en garantir le bon fonctionnement suite à des modifications effectuées sur les fichiers du noyau de Dolibarr ou en cas d'utilisation d'autres modules additionnels.</span>

<span style="color: rgb(0, 0, 0);">Cette documentation s'appuie sur le module en version 2024.04 avec Dolibarr version 19. En cas d'utilisation d'autres versions ou selon le thème utilisé, vous pourrez constater des différences de fonctionnement ou d'affichage..</span>

#### <span style="color: rgb(0, 0, 0);">**1.2.2-Pré-requis**</span>

<span style="color: rgb(0, 0, 0);">Le module Commissions est compatible avec Dolibarr à partir de version 10.</span>

<span style="color: rgb(0, 0, 0);">Pour une utilisation sur des versions antérieures de Dolibarr, reportez-vous au module </span>[Commissions\_OLD](https://www.dolistore.com/fr/modules/302-Commissions-OLD.html).

#### <span style="color: rgb(0, 0, 0);">**1.2.3- Maintenance** </span>  


<span style="color: rgb(0, 0, 0);">L'achat du module vous donne droit à un an de maintenance corrective. Cette maintenance corrective n'inclut pas d'aide à l'utilisation ou de support utilisateur, mais seulement la correction des bogues,sous réserve de la bonne utilisation du module et dans le cadre de la compatibilité avec la version utilisée de Dolibarr.</span>

#### <span style="color: rgb(0, 0, 0);">**1.2.4- Mises à jour**</span>

<span style="color: rgb(0, 0, 0);">Les dernières versions de nos modules sont mises à disposition sur le</span> [Dolistore ](https://www.dolistore.com/fr/recherche?search_query=altairis)<span style="color: rgb(0, 0, 0);">et sur notre </span>[boutique en ligne](https://www.altairis.fr/boutique/).

<span style="color: rgb(0, 0, 0);">L'accès aux mises à jour de nos modules est gratuit pendant 1 an à compter de la date d'achat.</span>

<p class="callout warning">**<span style="color: rgb(24, 139, 175);"><span style="color: rgb(186, 55, 42);">! Important !</span> </span>*Avant*** tout changement de version de votre Dolibarr, assurez-vous que le module est officiellement compatible avec la version de Dolibarr que vous souhaitez l'installer.</p>

<span style="color: rgb(0, 0, 0);">Pour mettre à jour un module, téléchargez-le à nouveau sur le </span>[Dolistore](https://www.dolistore.com/fr/recherche?search_query=altairis) <span style="color: rgb(0, 0, 0);">ou sur notre</span> [boutique en ligne](https://www.altairis.fr/boutique/) <span style="color: rgb(0, 0, 0);">avec l'identifiant utilisé lors de l'achat initial. Nous rendons systématiquement disponibles en téléchargement sur le</span> [Dolistore ](https://www.dolistore.com/fr/recherche?search_query=altairis)<span style="color: rgb(0, 0, 0);">ou sur notre</span> [boutique en ligne](https://www.altairis.fr/boutique/) <span style="color: rgb(0, 0, 0);">les dernières versions de nos modules.</span>

<span style="color: rgb(0, 0, 0);">Dézippez les fichiers de la dernière version du module dans le répertoire custom de votre environnement et confirmez le remplacement de ceux déjà présents, ou bien utilisez la fonction de déploiement de module de votre Dolibarr dans **A**ccueil &gt; **C**onfiguration &gt; **M**odules/Applications : onglet **D**éployer un module externe.  
</span>

<p class="callout info"><span style="color: rgb(24, 139, 175);">**Note :**</span> Pour le bon déroulement d'une mise à jour, désactivez un module avant de lancer le remplacement de ses fichiers puis réactivez-le une fois la mise à jour terminée. Vérifiez enfin que de nouveaux paramétrages ne soient pas nécessaires.   
</p>

# 1.3- Mise en route

#### <span style="color: rgb(0, 0, 0);">**1.3.1- Procédure d’installation**</span>

<span style="color: rgb(0, 0, 0);">Si vous avez accès aux fichiers de votre Dolibarr, dézipper l'archive du module dans le dossier custom de son arborescence.</span>

<span style="color: rgb(0, 0, 0);">Sur les versions récentes de Dolibarr, le module zippé peut être installé directement depuis la page **A**ccueil &gt; **c**onfiguration &gt; **M**odules/applications, onglet **D**éployer un module externe.</span>

#### <span style="color: rgb(0, 0, 0);">**1.3.2- Activation**</span>

<span style="color: rgb(0, 0, 0);">Activez le module en affichant la liste des modules depuis le menu : </span>

<span style="color: rgb(0, 0, 0);">**A**ccueil &gt; **c**onfiguration &gt; **M**odules/applications, onglet **M**odules/applications installés.</span>

<span style="color: rgb(0, 0, 0);">Il sera affiché dans le tableau Altairis.</span>

[![Le module Commission dans la page de configuration des modules](https://doc.altairis.fr/uploads/images/gallery/2024-07/scaled-1680-/6eIwzFHwLN74I0Rg-image.png)](https://doc.altairis.fr/uploads/images/gallery/2024-07/6eIwzFHwLN74I0Rg-image.png)

<span style="color: rgb(0, 0, 0);">Les pastilles ![pastille "module désactivé"](https://doc.altairis.fr/uploads/images/gallery/2023-12/scaled-1680-/image.png) et ![Pastille "module activé"](https://doc.altairis.fr/uploads/images/gallery/2023-12/scaled-1680-/fjcimage.png) indiquent l’état du module : pastille grisée, le module est désactivé. Pastille verte, le module est activé.  
Cliquez simplement sur la pastille pour activer ou désactiver le module.  
</span>

#### <span style="color: rgb(0, 0, 0);">**1.3.3- Permissions**</span>

##### <span style="color: rgb(0, 0, 0);">1.3.3.1- Permissions utilisateurs</span>

<span style="color: rgb(0, 0, 0);">Les accès aux fonctionnalités du module peuvent être restreints aux utilisateurs et groupes, depuis la fiche du groupe ou de l'utilisateur, onglet permissions, selon la liste suivante.</span>

<span style="color: rgb(0, 0, 0);">Cliquez sur le + pour accorder une permission et sur le - pour la retirer. Une permission accordée est [![image.png](https://doc.altairis.fr/uploads/images/gallery/2024-07/scaled-1680-/3ICOL5uUU66tq2ER-image.png) ](https://doc.altairis.fr/uploads/images/gallery/2024-07/3ICOL5uUU66tq2ER-image.png)symbolisée par la coche verte</span>

[![Permissions du module Commission](https://doc.altairis.fr/uploads/images/gallery/2024-07/scaled-1680-/dVZdzKTOXIFGPXw2-image.png)](https://doc.altairis.fr/uploads/images/gallery/2024-07/dVZdzKTOXIFGPXw2-image.png)

<span style="color: rgb(0, 0, 0);">Les permissions "définir les règles de commissionnement" et "paramétrer le module de commissionnement" déterminent respectivement l'affichage des liens d'accès à la page de configuration générale et à la page de gestion des règles de commissionnement. Ces permissions ne nécessitent pas d'être administrateur de Dolibarr : vous pouvez déléguer à n'importe quel utilisateur de votre choix la possibilité de configurer le module et la gestion des règles de commissionnement.  
</span>

##### <span style="color: rgb(0, 0, 0);">1.3.3.2- Astuce</span>

<span style="color: rgb(0, 0, 0);">Attribuez la permission **C**onsulter les commissions de tous les commerciaux : aux responsables commerciaux et celle de **C**onsulter uniquement ses propres commissions : aux commerciaux. </span>

##### <span style="color: rgb(0, 0, 0);">1.3.3.3- Permissions par défaut  
</span>

<span style="color: rgb(0, 0, 0);">Les fonctionnalités du module peuvent être restreintes aux utilisateurs et groupes existants ou créés ultérieurement à l'installation du module depuis la page **A**ccueil &gt; **C**onfiguration &gt; **S**écurité, onglet **P**ermissions par défaut. </span>

[![Permissions par défaut](https://doc.altairis.fr/uploads/images/gallery/2024-07/scaled-1680-/5B7linyFJ1lB1oRd-image.png)](https://doc.altairis.fr/uploads/images/gallery/2024-07/5B7linyFJ1lB1oRd-image.png)

#### <span style="color: rgb(0, 0, 0);">**1.3.4- Paramétrage**</span>

<span style="color: rgb(0, 0, 0);">La page de configuration du module est accessible depuis la liste des modules installés (accueil &gt; configuration &gt; modules/applications) en cliquant sur son icône ![icône "configuration"](https://doc.altairis.fr/uploads/images/gallery/2024-07/scaled-1680-/qtdXmDCFD3wHzNUp-image.png) ou bien via **C**omptabilité &gt; **C**ommissions &gt; **C**onfiguration pour les utilisateurs ayant cette permission.</span>

<span style="color: rgb(0, 0, 0);">Les paramétrages du module se déroulent en deux temps. D'abord, la définition des éléments de base de calcul des commissions dans la **C**onfiguration, puis l'ajout de règles qui viendront affiner les calculs selon de nombreux éléments dans le menu **D**éfinir les règles.  
</span>

<span style="color: rgb(0, 0, 0);">Il est bien entendu très fortement conseillé de prendre le temps de faire des tests correspondant votre situation en balayant tous les cas de figure, avant la mise en production.</span>

<span style="color: rgb(0, 0, 0);">Le chapitre suivant vous détaille comment configurer votre module.</span>