Guide utilisateur – Commissions pour Dolibarr
Table des matières
Liste des illustrations
- 3.1. Extrait de la liste des modules
- 4.1. Permissions utilisateurs et groupes du module
- 4.2. Permissions par défaut du module
- 5.1. Page de configuration générale du module
- 5.2. Page de détermination des règles
- 6.1. Menu secondaire apporté par le module Commissions
- 6.2. Page de calcul des commissions
- 6.3. Commissions d’un utilisateur
- 6.4. Détail des commissions par ligne de facture
- 6.5. Constante
COMMISSION_NULL_LINESactivée
Table des matières
Le module Commissions apporte à Dolibarr les fonctionnalités de gestion des commissions de vos commerciaux.
 |
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.
Le module s’adresse à tous les utilisateurs de Dolibarr. Son utilisation ne nécessite aucune connaissance technique ou d’administration.
Tous nos modules sont distribués sur le Dolistore et sur notre boutique en ligne sous licence GPL v3.
- Notre site de démonstration
Le module est installé sur notre environnement de démonstration. Connectez-vous avec l’identifiant
demoet le mot de passedemo.- Forum
Consultez toutes les informations sur le module sur les discussions des forums français et anglais.
Nous créons pour chacun de nos modules une discussion sur le forum dolibarr. Ces discussions contiennent 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.
Note
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 le formulaire de contact disponible sur notre site. Par ailleurs, nous vous remercions de ne pas multiplier les canaux d’échange pour un même objet.
Table des matières
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.
Cette documentation s’appuie sur le module en version 2020.11 avec Dolibarr version 12. En cas d’utilisation d’autres versions ou selon le thème utilisé, vous pourrez constater des différences de fonctionnement ou d’affichage.
Le module commissions est compatible avec Dolibarr à partir de la version 10.
Pour une utilisation sur des versions antérieures de Dolibarr, reportez-vous au module Commissions – OLD.
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.
Les dernières versions de nos modules sont mises à disposition sur le Dolistore et sur notre site internet.
L’accès aux mises à jour de nos modules est gratuit pendant 1 an à compter de leur date d’achat.
Avant toute mise à jour, assurez-vous que le module est officiellement compatible avec la version de Dolibarr sur laquelle vous souhaitez l’installer.
Pour mettre à jour un module, téléchargez-le à nouveau sur le Dolistore avec l’identifiant utilisé lors de l’achat initial. Nous rendons systématiquement disponibles en téléchargement sur le Dolistore les dernières versions de nos modules.
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.
Note
Pour le bon déroulement d’une mise à jour, désactivez un module avant de lancer le remplacement de ses fichiers puis de le réactiver.
À l’issue de la mise à jour, il est conseillé de répéter l’opération de désactivation/activation pour être sûr du bon déroulement d’une éventuelle mise à jour de votre base de données.
Vérifiez enfin que de nouveaux paramétrages ne soient pas nécessaires.
Table des matières
Si vous avez accès aux fichiers de votre Dolibarr, dézipper l’archive du module dans le dossier custom de son arborescence.
Sur les versions récentes de Dolibarr, le module zippé peut être installé directement depuis la page accueil > configuration > modules/applications, onglet déployer un module externe.
Activez le module en affichant la liste des modules depuis les menus accueil > configuration > modules/applications, onglet modules/applications installés. Il sera affiché dans le tableau Altairis.
Les pastilles 
et 
indiquent l’état du module : activez-le en cliquant sur . Sa désactivation sera effectuée avec la pastille , cette dernière indiquant que le module est activé.
Table des matières
Les accès aux fonctionnalités du module peuvent être restreints aux utilisateurs et groupes, depuis leur fiche, onglet permissions, selon la liste suivante.
Cliquez sur le + pour accorder une permission et sur le – pour la retirer. Une permission accordée est symbolisée par la coche verte 
.
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 (voir Figure 6.1, « Menu secondaire apporté par le module Commissions »).
Astuce
Attribuez la permission consulter les commissions de tous les commerciaux aux responsables commerciaux et celle de consulter uniquement ses propres commissions aux commerciaux.
Table des matières
La page de configuration du module est accessible depuis la liste des modules installés (accueil > configuration > modules/applications) en cliquant sur son icône 
.
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 sur l’onglet configuration, puis l’ajout de règles qui viendront affiner les calculs selon de nombreux éléments sur l’onglet du même nom.
Cette page de configuration permet de définir le fonctionnement général du calcul des commissions.
Note
Nous verrons que cette page peut être rendue accessible depuis le lien configuration du menu secondaire apporté par le module sous réserve que vos utilisateurs disposent des permissions adéquates.
Vous avez cinq types de paramètres à ajuster :
- base de calcul des commissions
Sur le total HT ou sur les marges (nécessite d’avoir le module Marges activé et paramétré).
- méthode de commissionnement
Votre choix précédent portera sur les documents sélectionnés ici : prise en compte des commandes clôturées, du chiffre d’affaires : somme des factures émises, payées ou non et quel que soit leur type, y compris acompte ou avoir, des règlements enregistrés ou encore sur les factures au statut payées.
- cumul des commissions
Selon les règles de commissionnement que vous avez définies, un même commercial peut avoir plusieurs règles. Ce paramètre détermine si l’on cumule toutes les règles ou si l’on choisit de n’appliquer que la règle la plus précise (voir la section intitulée « Règles sur plusieurs lignes »).
- limiter le commissionnement aux contacts
Si un utilisateur interne de Dolibarr, est défini sur une facture via son onglet contacts/adresses, choisir s’il devient le seul commissionné ou si l’on commissionne également le (ou les) commerciaux définis sur la fiche du client.
Mettre ce paramètre à oui permet, en limitant le commissionnement au contact, d’avoir des factures sur lesquelles le commercial attitré n’est pas commissionné.
Exemple : Une facture relevant d’un suivi technique qui ne dépend pas du commercial mais d’un commercial remplaçant. Il suffit de déterminer un contact spécifique pour cette situation et de l’associer comme contact commercial sur la facture.
- gérer des commissions dépendant du montant de la remise
Choisir de gérer les commissions qui dépendent du montant de la remise accordée sur la ligne de produit/service (oui) ou bien sur les montant des factures (non).
Pour des commissions dépendant du montant de la remise accordée au client : on choisit un montant de remise et la commission associée, puis éventuellement un autre palier de remise et une autre commission associée. Palier à créer autant de fois que nécessaires.
Attention
Ce choix s’applique sur les lignes des factures, non sur le total global.
Une fois ces premiers éléments enregistrés, créons des règles.
Les règles vont déterminer, selon les conditions qu’elles contiennent, le calcul des commissions.
Note
Nous verrons que cette page peut être rendue accessible depuis le lien de menu secondaire définir les règles, apporté par le module, sous réserve que vos utilisateurs disposent des permissions adéquates.
Le tableau présente huit colonnes où définir vos critères de commissionnement. Pour définir une nouvelle règle, remplissez selon vos besoins la ligne vierge du tableau puis cliquez sur valider. Pour supprimer une règle, cliquez sur l’icône 
en bout de sa ligne.
Les règles créées s’affichent en liste sur la page.
| Paramètre | Utilisation |
|---|---|
| agent commercial | Permet d’indiquer un utilisateur à choisir dans la liste déroulante. Si vide, sera valable pour tous les commerciaux. |
| type de contact |
Choisir un type de contact à commissionner (onglet contacts/adresses de la commande ou facture) ou le commercial rattaché au client sur sa fiche. Vous pouvez créer vos propres types de contact avec les dictionnaires standards de Dolibarr.
NoteUne règle sans agent commercial ni type de contact attribuera les commissions aux commerciaux rattachés au client. |
| catégorie(s) produits |
Vous permet de choisir une ou plusieurs catégories de produits auxquelles s’appliquera cette règle.
NoteEn sélectionnant une catégorie, la règle prendra également en considération ses sous-catégories. |
| catégorie(s) clients ou client |
Vous permet de choisir une ou plusieurs catégories de clients auxquels s’appliquera cette règle, ou un client en particulier.
AttentionUne règle ne donnera aucun résultat si ces deux valeurs sont renseignées. Vous devrez laisser le champ vide ou faire un choix entre une catégorie de clients ou un client. Pour contourner cette limitation, créez de nouvelles règles. |
| produit ou service | Choisir dans la liste déroulante si la règle s’applique aux produits ou aux services. Si ce champ est laissé vide, alors il s’applique aux deux. |
|
factures inférieures à, |
À utiliser pour définir un taux de commission appliqué en fonction du montant de la remise accordée au client sur la ligne de commande ou facture. Saisir le montant de la remise (en %) : Ou, si le paramètre gérer des commissions dépendant du montant de la remise est à non : À utiliser pour définir des taux de commission différents selon le montant de la facture. Pour un montant supérieur à… (le plus haut) : laissez vide. |
| taux |
Indiquer le taux de commissionnement à appliquer sur cette règle. Saisir uniquement le nombre sans unité. Par exemple : 10 pour 10%.
|
Les critères des colonnes d’une même ligne se cumulent (opérateur logique ET).
Par exemple :
| Les critères : | type de contact = Commercial rattaché au tiers |
+ Taux = 3%
| |
| Donnent : | Tout commercial rattaché à un client aura 3% de commission. Valable pour tous les clients ayant des commerciaux rattachés. |
Ajoutons un critère supplémentaire :
| Les critères : | agent commercial = John Doe |
+ type de contact = Commercial rattaché au tiers
| |
+ taux = 4%
| |
| Donnent : | Si le commercial rattaché au client est John Doe, alors il sera commissionné à 4%. |
Ou encore :
| Les critères : | agent commercial = Alain Dupont |
+ facture inférieure à 1000 €
| |
+ taux = 3%
| |
| Donnent : | Si l’utilisateur (qu’il soit rattaché au client ou ajouté via l’onglet contact/Adresses) est Alain Dupont ET que la facture est inférieure à 1 000 €, alors Alain Dupont sera commissionné à 3%. |
Les différentes lignes de règles sont cumulatives (opérateur logique ET) ou non cumulatives (opérateur logique OU) selon le choix que vous avez fait dans la configuration du module, paramètre cumul des commissions.
- Paramètre cumuler des commissions activé (opérateur logique ET)
Si vous choisissez de cumuler les commissions, les règles de plusieurs lignes se cumulent.
Par exemple, les lignes suivantes :
| Ligne 1 : | type de contact = Commercial rattaché au client | |
+ taux = 3%
| ||
| Ligne 2 : | agent commercial = John Doe | |
+ type de contact = Responsable suivi facture
| ||
+ taux = 1%
| ||
| ||
| Donnent : |
Si l’utilisateur John Doe, rattaché au client, est aussi le responsable suivi facture client sur la facture, alors John Doe sera commissionné à 3 + 1 = 4% sur cette facture. En revanche, s’il n’est pas précisé sur l’onglet contacts/Adresses que cet utilisateur est responsable suivi facture client, alors il ne touchera que 3%. Ou encore, si John Doe n’est pas rattaché au client mais qu’il est désigné comme responsable suivi facture client sur l’onglet contacts/Adresses de la facture, alors il sera commissionné à 1%. | |
- Paramètre pas de cumul activé (opérateur logique OU)
Si vous choisissez de ne pas cumuler les différentes règles de plusieurs lignes, c’est la règle la plus précise, qui sera appliquée.
Par exemple, les lignes suivantes :
| Ligne 1 : | type de contact = Commercial rattaché au client | |
+ taux = 3%
| ||
| Ligne 2 : | agent commercial = Alain Dupont | |
+ type de contact = Commercial rattaché au client
| ||
+ taux = 3.5%
| ||
| ||
| Donnent : |
Si le commercial rattaché au client est Alain Dupont, il sera commissionné à 3.5%. Si ce n’est pas cet utilisateur, quelque soit le commercial rattaché au client, il sera commissionné à 3%. | |
Pour commissionner par exemple à 3% si la ligne de facture est inférieure à 1 000 €, à 2% si la ligne de facture est inférieure à 5 000 €, et à 1.5 % au-delà de 5 000 €, il faut trois règles générales, et avoir choisi dans la configuration de calculer sur le chiffre d’affaires, de ne pas cumuler les lignes et de gérer les commissions sur les montants des lignes de factures ou commandes :
| Ligne 1 : | ligne de factures inférieure à = 1000 € | |
+ taux = 3% | ||
| Ligne 2 : | ligne de factures inférieure à = 5000 € | |
+ taux = 2.5% | ||
| Ligne 3 : | ligne de factures inférieure à = [vide] | |
+ taux = 1.5% | ||
| ||
L’ordre dans lequel vous définissez vos lignes n’a pas d’importance : que vous commenciez par la facture la plus faible ou la plus haute, le calcul sera fait en tenant compte du montant de la facture. Les règles peuvent encore être affinées en définissant les agents commerciaux et/ou les types de contact concernés, ou encore les produits ou services.
Gardez la règle générale si elle s’applique à tout le monde et utilisez des lignes supplémentaires pour l’affiner.
Choisir dans la configuration de calculer sur le chiffre d’affaires, de ne pas cumuler les lignes et de gérer les commissions dépendant du montant de la remise sur les lignes de factures ou commandes.
Le principe est identique au cas d’usage précédent.
Pour commissionner plusieurs utilisateurs différemment sur une même facture :
Définir sur la fiche du client les commerciaux qui lui sont rattachés.
Pour chacun de ces utilisateurs, définir nommément (champ agent commercial) son taux de commissionnement.
Affiner si besoin en ajoutant des lignes pour chaque cas, en spécifiant le type de contact par exemple, ou les produits/services.
Vous avez un commercial attaché à votre client, mais parfois, vous devez facturer une intervention du service technique par exemple, sans que le commercial ait eu à intervenir : il ne doit pas être commissionné sur cette facture. Or par défaut, une fois qu’un commercial est attaché à un client, toutes les factures donnent lieu pour lui à une commission, automatiquement. Autre cas : le commercial attitré du client est remplacé, de manière exceptionnelle, par un autre.
Pour ne pas commissionner votre commercial dans ce cas précis, vous devez utiliser dans la configuration le paramètre limiter le commissionnement aux contacts positionné sur oui.
Cela n’empêche pas de commissionner par défaut le commercial attaché au client dans le cas général. Mais s’il y a un autre contact déclaré sur l’onglet contacts/adresses de la facture, alors le commercial rattaché au client ne sera pas commissionné : seul le contact ajouté sur la facture le sera. Notez que si vous avez plusieurs commerciaux attachés au client et/ou plusieurs contacts ajoutés à la facture, la fonctionnalité est identique.
Dans le cas d’une intervention technique, créez un type de contact « Intervention Technique » par exemple, et sur l’onglet contacts/adresses de la facture en question, ajoutez ce contact. Les commissions seront comptabilisées sur ce contact. Vous pouvez : soit ne pas tenir compte des commissions sur ce type de contact ou cet utilisateur, soit créer une règle qui indique que ce type de contact (ou cet utilisateur) reçoit des commissions égales à 0 %.
Dans le cas d’un commercial remplaçant, choisissez cet utilisateur comme contact commercial pour que les commissions lui soient attribuées en lieu et place du commercial habituel sur la base de la règle de commissionnement que vous définissez pour lui.
Table des matières
Le module ajoute un menu secondaire au menu principal comptabilité.
L’affichage des liens définir les règles et configuration est conditionné par les permissions accordées aux utilisateurs. Ces derniers renvoient vers les pages de configuration vues au Chapitre 5, Paramétrage.
Si vos utilisateurs n’ont pas de permissions d’accès à la comptabilité, créez-leur un marque-page menant vers cet écran. Une fois l’accès permis, vos commerciaux, si vous leur donnez les droits de voir leurs commissions, seront limités à la vue de leurs seules commissions.
Affichez la page de calcul des commissions selon les règles indiquées en paramétrage, depuis les liens de menu comptabilité > commissions > calculer les commissions.
Filtrage utilisateurs : attribuez à vos commerciaux la permission consulter uniquement ses propres commissions pour qu’ils ne voient que leurs propres commissions. Ils n’auront alors pas d’autre choix que leur propre utilisateur dans la liste déroulante. Pour les utilisateurs ayant besoin de voir l’ensemble des commissions générées, ne limitez pas les droits d’accès aux commissions de tous les commerciaux.
Ces utilisateurs pourront alors choisir soit de voir les commissions globales, pour tous les commerciaux en laissant vide la liste de sélection d’un utilisateur, soit de choisir les commerciaux un par un pour détailler leurs commissions.
et 
Filtrage par dates : utilisez le menu automatique par mois ou sélectionner manuellement une plage de dates et cliquer sur le bouton démarrer pour lancer le calcul : il est effectué
selon les éléments de la configuration générale et des règles applicables. Aussi,une fois la liste des commissions sur une période affichée, vous pouvez voir les résultats sous deux vues différentes.
Résumé par client et 
détail par facture : indiquez alors l’affichage que vous souhaitez et validez avec le bouton démarrer.
Le résumé par client présente un client par ligne et totalise les commissions par client pour la période considérée comme le montre la Figure 6.3, « Commissions d’un utilisateur ».
Le détail par facture liste l’ensemble des lignes concernées et présente les commissions correspondantes. Cette fonctionnalité sera utile aux commerciaux pour vérifier leurs commissions ligne par ligne de commande ou facture.
Affichage des lignes et factures ou commandes à 0 €
Par défaut, le module masque les factures ou commandes et leurs lignes d’un montant nul. Pour les afficher, activez la constante COMMISSION_NULL_LINES à la valeur 1 depuis l’écran accueil > configuration > divers.
Ce chapitre répertorie les difficultés rencontrées avec le module. Vous y trouverez donc des éléments de réponse quant à son utilisation.
Si vous rencontrez une autre erreur que celles décrites ci-dessous lors de l’utilisation de ce module :
désactivez et réactivez le module ;
vérifiez sur le ChangeLog si une nouvelle version a été publiée et sa compatibilité avec votre version de Dolibarr ;
ré-installez/mettez à jour le module ;
vérifiez qu’aucune incompatibilité avec un autre module ne soit indiquée. Le cas échéant, suivez nos préconisations.
Si, malgré ces manipulations, l’erreur persiste, contactez-nous en utilisant le formulaire de contact.
Pour plus d’efficacité dans l’étude de votre demande, précisez :
le nom et la version du module ;
la version de Dolibarr ;
la liste des modules additionnels activés ;
et tous les éléments nécessaires à la meilleure des prises en charge de votre demande : contexte, étapes successives pour reproduire l’erreur, captures d’écran, etc.
Table des matières
Pour accéder rapidement aux diverses ressources relatives au module, nous en avons listé les liens ci-dessous :
Nous assurons la maintenance corrective sur nos modules pendant un an à partir de leur date d’achat.
Un formulaire de contact est à votre disposition pour signaler le bogue rencontré.
Pour toute demande d’aide à l’utilisation, veuillez souscrire à l’un de nos forfaits de support.
Les fonctionnalités suivantes sont intégrées au module mais absente de cette documentation.
Aucune