Commissions des représentants

Fin du mois : Sophie demande le montant de sa commission, Marc conteste la sienne parce qu'un client a retourné du matériel. Le calcul se fait dans un tableur, à partir d'un rapport de ventes exporté d'Acomba, en retranchant les notes de crédit à la main et en se demandant chaque fois si c'était avant ou après les taxes.

Dans cette recette, nous allons calculer automatiquement la commission de chaque représentant pour un mois : ventes avant taxes, notes de crédit déduites, taux fixe ou par paliers, avec un détail qui répond d'avance aux questions.

Ce que vous allez apprendre

créer un représentant et l'indiquer sur les factures ;

lire les ventes d'un mois par représentant, avant taxes et nettes des crédits ;

appliquer un taux de commission fixe ou par paliers.

Avant de commencer

une clé API en lecture pour le calcul, en écriture pour créer les représentants et les factures ;

le module Facturation actif ;

vos taux de commission : Acomba n'en conserve pas, le script les garde.

D'où vient la commission

Avant de calculer, voyons d'où vient chaque montant. Chaque facture d'Acomba porte un représentant. Les ventes du mois sont regroupées par représentant ; les notes de crédit du mois viennent en déduction, au représentant de la note. La commission s'applique aux ventes avant taxes.

Étape 1 : le représentant

Commençons par la fiche du représentant. Le numéro est le seul champ obligatoire.

cURL

Étape 2 : le représentant sur la facture

Chaque facture indique son représentant par sales_rep_code, son numéro. Sans représentant, la facture prend celui du client.

cURL

Une facture d'Acomba ne se modifie plus une fois créée : un retour se fait par une note de crédit (Retours et notes de crédit), qui garde le représentant de la facture.

Étape 3 : les ventes du mois par représentant

Le calcul part des ventes du mois, regroupées par représentant. subtotal est la base de la commission : les ventes avant taxes, nettes des notes de crédit du mois. revenue est le même montant, taxes comprises.

cURL

Réponse 200 (extrait)

Sophie a facturé 52 coins à 25 ) ; un client en a retourné 4 (100 taxes comprises) : sa base de commission est 1 200 $.

Le script complet

Assemblons le calcul : les taux sont dans COMMISSIONS, fixes ou par paliers ; le script lit les ventes du mois et affiche la commission de chaque représentant, et ceux qui n'ont pas de taux.

Python

JavaScript (Node.js)

Exemple de sortie :

$ python commissions.py 2026-10
Commissions de 2026-10 (ventes avant taxes, nettes des notes de crédit)
  représentant 9999                  1,515.00 $   sans taux de commission, crédits 6 (261.20 $ taxes incl.)
  Sophie Tremblay (essai R23)        1,200.00 $   commission     60.00 $  (2 facture(s), crédits 1 (114.98 $ taxes incl.))
  Marc Gagnon (essai R23)              950.00 $   commission     38.00 $  (2 facture(s))
Total des commissions : 98.00 $

Bon à savoir

Les taux ne sont pas dans Acomba : la fiche du représentant n'a pas de champ de commission. Gardez-les dans le script, ou dans un fichier que vos ventes peuvent tenir à jour.

Notes de crédit : un retour réduit la commission du mois où le crédit est émis, même si la facture date d'un mois précédent.

Représentant principal : chaque facture compte pour son représentant principal. Le partage d'une facture entre plusieurs représentants n'est pas pris en compte.

Commission à l'encaissement : ce calcul porte sur les ventes facturées. Pour ne payer que les factures encaissées, croisez avec les paiements du mois (Commande en ligne, facture et paiement).

Fin de mois : force_refresh=true recalcule les ventes (elles sont gardées 4 heures en cache pour le mois en cours).

Codes d'erreur : voir Codes d'erreur.

Et voilà

Les commissions du mois se calculent en quelques secondes, avant taxes, notes de crédit déduites, au taux de chaque représentant, et chaque montant s'explique par le nombre de factures et de crédits.

Pour aller plus loin

Retours et notes de crédit : créditer une facture, ce qui réduit la commission.

Rentabilité des produits : voir la marge derrière les ventes de chaque représentant.

Power BI et Excel : suivre les ventes par représentant dans un tableau de bord.

D'où vient la commission#

Étape 1 : le représentant#

Étape 2 : le représentant sur la facture#

Étape 3 : les ventes du mois par représentant#

Le script complet#

Bon à savoir#

Et voilà#

D'où vient la commission

Étape 1 : le représentant

Étape 2 : le représentant sur la facture

Étape 3 : les ventes du mois par représentant

Le script complet

Bon à savoir

Et voilà