Reconciliation des Paiements

La reconciliation permet de rapprocher les paiements generes par PCH-SIG avec les releves des operateurs de paiement mobile money (TELECEL, Orange Money, MTN).

Vue d'ensemble

Operateurs supportes

Operateur	Code	Couleur	Format fichier
TELECEL	telecel	Rouge 🔴	CSV (;) ou Excel
Orange Money	orange_money	Orange 🟠	CSV (;) ou Excel
MTN Mobile Money	mtn	Jaune 🟡	CSV (,) ou Excel

Creer une session de reconciliation

Etape 1 : Selection des parametres

1. Acceder a Paiements > Reconciliation
2. Cliquer sur Nouvelle reconciliation
3. Selectionner :

Champ	Description	Obligatoire
Operateur	TELECEL, Orange Money ou MTN	Oui
Periode debut	Date de debut des transactions	Oui
Periode fin	Date de fin des transactions	Oui
Cycle	Cycle de paiement concerne	Non

Etape 2 : Import du fichier operateur

Telecharger le releve de l'operateur et l'importer dans le systeme.

Format TELECEL

Colonne	Description
ID Transfert	Reference interne
Telephone	Numero beneficiaire
Montant (FCFA)	Montant transfere
Statut Transfert	SUCCES, ECHEC, EN COURS
Date	Date de transaction
Message / Ref. Operateur	Reference operateur
ID Ordre Transfert	Code du cycle (ex: PCH-GB-001-C-16)
Nom Beneficiaire	Nom du beneficiaire
Solde Restant (FCFA)	Solde compte operateur

Format Orange Money

Colonne	Description
Transaction ID	Reference transaction
Recipient Phone	Numero beneficiaire
Amount	Montant
Status	Statut
Transaction Date	Date/heure

Format MTN

Colonne	Description
TransRef	Reference transaction
MSISDN	Numero beneficiaire
Amount	Montant
TxnStatus	Statut
DateTime	Date/heure

Etape 3 : Execution du matching

Apres import, cliquer sur Executer le matching pour lancer l'algorithme de correspondance.

Algorithme de correspondance

Le systeme utilise un algorithme multi-criteres pour faire correspondre les transactions :

Priorite de matching

1. Cle de reconciliation (TELECEL uniquement, score 100)

   • Format : 245{telephone}-{codebeneficiaire}

2. Reference exacte (score 100)

   • Correspondance directe par reference externe

3. Matching flou (score 60+)

   • Telephone : +20 points
   • Montant exact (±1 FCFA) : +40 points
   • Montant proche (±1%) : +20 points
   • Meme jour : +40 points
   • ±3 jours : +20 points

Statuts de correspondance

Statut	Code	Description	Action
Correspondance exacte	exact	Tout correspond parfaitement	Accepter
Correspondance floue	fuzzy	Score >= 60, verification manuelle	Verifier
Ecart montant	ecart_montant	Paiement trouve, montant different	Corriger
Ecart statut	ecart_statut	Paiement trouve, statut different	Corriger
Non trouve interne	non_trouve_interne	Transaction externe sans paiement	Investiguer
Non trouve externe	non_trouve_externe	Paiement sans transaction	Investiguer

Resolution des ecarts

Actions disponibles

Action	Code	Description
Accepter	accepte	Valider l'entree telle quelle
Corriger	corrige	Mettre a jour le paiement avec les donnees externes
Rejeter	rejete	Marquer comme invalide/rejete

Resolution individuelle

1. Cliquer sur une entree avec ecart
2. Verifier les details (interne vs externe)
3. Ajouter un commentaire explicatif
4. Choisir l'action de resolution

Resolution en lot

1. Filtrer les entrees par statut
2. Selectionner plusieurs entrees
3. Cliquer sur Resolution en lot
4. Appliquer l'action a toutes les selections

Integration Telecel

Extraction automatique du solde

Le systeme extrait automatiquement le solde du compte operateur depuis la derniere ligne du fichier TELECEL :

Fichier TELECEL importe
    ↓
Extraction "Solde Restant (FCFA)"
    ↓
Mise a jour CompteOperateur.soldeActuel
    ↓
Creation mouvement d'ajustement

Code cycle

TELECEL inclut l'identifiant du cycle dans la colonne "ID Ordre Transfert" (ex: PCH-GB-001-C-16), permettant de lier automatiquement les transactions au cycle.

Impact sur les comptes operateurs

Lors de la resolution :

• Accepter + statut "reussi" → Debit du compte operateur
• Corriger + statut "reussi" → Debit du compte operateur + mise a jour paiement
• Rejeter → Aucun impact comptable

Statistiques de session

Indicateur	Description
Lignes importees	Total transactions du fichier
Correspondances	Exact + Fuzzy
Ecarts	Montant + Statut
Non trouves	Interne + Externe
Taux de matching	(Exact + Fuzzy) / Total * 100
Variance	Ecart montant total

Finalisation

Une fois toutes les entrees resolues :

1. Verifier qu'aucune entree n'est "En attente"
2. Cliquer sur Finaliser la session
3. La session passe en statut "Termine"
4. Le cycle peut etre mis a jour si necessaire

Export des resultats

Formats disponibles :

Format	Contenu
CSV	Donnees brutes pour analyse
Excel	Rapport detaille avec mise en forme
PDF	Rapport de synthese pour archivage

Contraintes par cycle

:::warning Important La reconciliation n'est pas possible sur les cycles avec statut termine. Les cycles valide et en_cours peuvent etre reconcilies. :::

Bonnes pratiques

:::tip Recommandations

1. Reconciliez regulierement : Chaque fin de cycle
2. Verifiez les ecarts : Ne pas ignorer les montants differents
3. Documentez les rejets : Ajoutez des commentaires explicatifs
4. Archivez les rapports : Conservez les exports PDF
5. Surveillez les non-trouves : Peut indiquer des problemes de donnees :::

Permissions requises

Action	Permission
Consulter les sessions	reconciliation.view
Creer une session	reconciliation.create
Resoudre les entrees	reconciliation.resolve
Finaliser	reconciliation.finalize

Voir aussi

• Export des paiements
• Cycles de paiement
• Grilles tarifaires