Grilles Tarifaires

Les grilles tarifaires definissent les frais de transaction par operateur de mobile money (TELECEL, Orange Money, MTN).

Vue d'ensemble

┌─────────────────────────────────────────────────────────────────────────────┐
│                        GRILLES TARIFAIRES                                    │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  ┌──────────────┐   ┌──────────────┐   ┌──────────────┐                     │
│  │   TELECEL    │   │ Orange Money │   │     MTN      │                     │
│  │   🔴         │   │     🟠       │   │     🟡       │                     │
│  └──────────────┘   └──────────────┘   └──────────────┘                     │
│         │                  │                  │                              │
│         ▼                  ▼                  ▼                              │
│  ┌──────────────────────────────────────────────────────────────────────┐   │
│  │                    TRANCHES DE MONTANTS                               │   │
│  │  Tranche 1:     1 - 2 500 FCFA     → 200 + 100 = 300 FCFA            │   │
│  │  Tranche 2:  2 501 - 5 000 FCFA    → 200 + 200 = 400 FCFA            │   │
│  │  Tranche 3:  5 001 - 10 000 FCFA   → 200 + 300 = 500 FCFA            │   │
│  │  ...                                                                  │   │
│  │  Tranche 11: 1 500 001 - 2 000 000 → 200 + 11 200 = 11 400 FCFA     │   │
│  └──────────────────────────────────────────────────────────────────────┘   │
│                                                                              │
└─────────────────────────────────────────────────────────────────────────────┘

Operateurs supportes

Operateur	Code	Couleur
TELECEL	telecel	Rouge 🔴
Orange Money	orange_money	Orange 🟠
MTN Mobile Money	mtn	Jaune 🟡

Structure d'une tranche

Chaque tranche definit les frais pour une plage de montants :

Champ	Description
Numero tranche	Ordre sequentiel (1, 2, 3...)
Montant minimum	Borne inferieure (incluse)
Montant maximum	Borne superieure (incluse)
Taxe administrative	Frais fixe (200 FCFA)
Frais de retrait	Frais variable selon la tranche
Cout total	Taxe + Frais de retrait

Exemple de grille TELECEL

Tranche	Montant Min	Montant Max	Taxe Admin	Frais Retrait	Total
1	1	2 500	200	100	300
2	2 501	5 000	200	200	400
3	5 001	10 000	200	300	500
4	10 001	25 000	200	500	700
5	25 001	50 000	200	800	1 000
6	50 001	100 000	200	1 200	1 400
7	100 001	250 000	200	2 200	2 400
8	250 001	500 000	200	4 000	4 200
9	500 001	1 000 000	200	6 500	6 700
10	1 000 001	1 500 000	200	9 000	9 200
11	1 500 001	2 000 000	200	11 200	11 400

Acceder aux grilles

1. Acceder a Transferts > Comptes Operateurs
2. Onglet Grilles Tarifaires
3. Selectionner un operateur pour voir ses tranches

Gerer les tranches

Ajouter une tranche

1. Cliquer sur Nouvelle tranche
2. Selectionner l'operateur
3. Renseigner :
   • Numero de tranche
   • Montant minimum
   • Montant maximum
   • Taxe administrative
   • Frais de retrait
4. Cliquer sur Enregistrer

Modifier une tranche

1. Cliquer sur l'icone Modifier de la tranche
2. Modifier les valeurs
3. Enregistrer

attention

L'operateur ne peut pas etre modifie apres creation. Cela garantit l'integrite des calculs de frais existants.

Desactiver une tranche

Les tranches ne sont jamais supprimees definitivement :

1. Cliquer sur l'icone Supprimer
2. Confirmer la desactivation
3. La tranche devient inactive (actif = false)

Simulateur de frais

Le simulateur permet de calculer les frais avant d'appliquer un paiement :

1. Cliquer sur Simuler
2. Saisir un montant (ex: 70 000 FCFA)
3. Selectionner un operateur
4. Voir le detail :

Montant beneficiaire : 70 000 FCFA
Taxe administrative  :    200 FCFA
Frais de retrait     :  1 200 FCFA
─────────────────────────────────────
Total transaction    : 71 400 FCFA

Comparaison des operateurs

Pour comparer les frais entre operateurs :

1. Ouvrir le simulateur
2. Saisir le montant
3. Cliquer sur Comparer tous les operateurs
4. Voir le classement (du moins cher au plus cher)

Integration avec les cycles

Les grilles tarifaires sont utilisees lors de la preparation des paiements :

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   Cycle     │ --> │  Calcul     │ --> │  Paiements  │
│  Paiements  │     │   Frais     │     │   + Frais   │
└─────────────┘     └─────────────┘     └─────────────┘
       │                  │                    │
       │ montant          │ grille             │ montantNet
       │ beneficiaire     │ operateur          │ taxeAdmin
       │                  │                    │ fraisRetrait
       └──────────────────┴────────────────────┘

1. Un cycle contient des paiements avec des montants beneficiaires
2. L'operateur est selectionne (via le compte operateur)
3. Les frais sont calcules pour chaque paiement
4. Le paiement final inclut : montant + frais

Bonnes pratiques

:::tip Recommandations

1. Verifiez les chevauchements : Les plages de montants ne doivent pas se chevaucher
2. Completez toutes les tranches : Assurez-vous de couvrir tous les montants possibles
3. Utilisez le simulateur : Verifiez les frais avant d'appliquer en lot
4. Mettez a jour regulierement : Les tarifs operateurs peuvent changer :::

Permissions requises

Action	Permission
Consulter les grilles	ROLE_USER
Calculer/Simuler	ROLE_USER
Creer/Modifier	ROLE_ADMIN
Desactiver	ROLE_ADMIN