Flux de Commissions Agent Commercial

Modules impliqués : Factures · Paiements · Commissions (Politique · Personnel Applicable · Hiérarchie · Reçu) · Agent Commercial · Objectifs · DataPulse
Qui l'utilise : Directeur Commercial · Agents Commerciaux · Administrateur Finance
Durée typique : Instantanée après paiement facture (déclencheur automatique) + cycle mensuel pour versement commissions

Vue d'ensemble

Le module Commissions calcule automatiquement la commission due à un agent commercial dès qu'une facture est payée. Aucune action manuelle n'est requise pour le calcul — tout est déclenché par le hook after_payment_added.

Diagramme de flux

[CONFIGURATION — une seule fois]
  │
  ├── Politique de Commission (type 1–5, plage dates, pourcentage/échelle)
  ├── Personnel Applicable → assigner agent à politique
  ├── Hiérarchie (optionnel) → coordinateur reçoit % de la commission de l'agent
  └── Options générales → calculate_after_days · payment_trigger_mode
  │
  ↓
[FACTURATION]
  │  Facture créée → sale_agent défini sur la facture (ou sur le client/groupe)
  │
  ↓
[PAIEMENT FACTURE — déclencheur automatique]
  │
  ├── Paiement enregistré → hook after_payment_added se déclenche
  ├── Système vérifie : âge facture ≥ calculate_after_days ?
  ├── Système vérifie : payment_trigger_mode ?
  │     'partial_allowed' (défaut) → tout paiement > 0 génère une commission
  │     'full_only' → commission seulement si somme paiements = total facture
  └── Système résout l'agent : sale_agent sur facture → customer_admin du client
  │
  ↓
[COMMISSION GÉNÉRÉE]
  │  Ligne créée dans tblcommission : staffid, invoice_id, amount, paid=0
  │
  ↓
[APPROBATION / CONSULTATION]
  │
  ├── Manager → /admin/commission → voit commissions avec paid=0
  └── Agent → voit ses propres commissions
  │
  ↓
[VERSEMENT COMMISSION]
  │
  ├── Manager crée Reçu de Commission : sélectionne commissions impayées
  ├── Reçu peut être converti en Dépense (pour comptabilité)
  └── Commissions sélectionnées → paid=1 dans tblcommission
  │
[COMMISSION VERSÉE ✓]

5 types de politiques de commission

Modules impliqués

Factures · Paiements · Commissions · Politique Commissions · Paiements Commissions · Agent Commercial · Objectifs · DataPulse

← Retour aux Flux de Travail