Importer un relevé Mobile Money

SynkriaOps embarque un parseur dédié Mobile Money (profil Orange Money CM en production, MTN MoMo en roadmap) qui digère les exports Excel et PDF du wallet opérateur en quelques secondes. Le parseur détecte automatiquement le sens (débit/crédit) selon l’émetteur et le destinataire de chaque ligne, et sépare les frais d’opération en une ligne comptable distincte.

Formats supportés

Source	Format	Détection sens
Orange Money Cameroun — export web	.xlsx	Numéro émetteur/destinataire vs identifiants tenant
Orange Money Cameroun — PDF wallet	.pdf	Idem (extraction texte pdf-parse)
MTN MoMo Cameroun	Roadmap
Afriland Mobile / Wave / autres	Roadmap

Astuce

Le naming « Mobile Money » est volontairement générique côté code (cf. apps/api/src/modules/transactions-bancaires/engines/mobile-money-parser.ts) — l’ajout d’un nouvel opérateur passe par l’écriture d’un profil de colonnes, sans toucher au reste du pipeline.

Pré-requis

Avant l’import, configurez les identifiants du compte Mobile Money dans le paramétrage du dossier :

1. Paramètres → Banque & Mobile Money → Comptes Mobile Money.

2. Ajoutez un compte :

   • Numéro de téléphone rattaché au wallet (ex. 699787694)
   • Code marchand si vous utilisez un compte marchand (optionnel)
   • Compte comptable de trésorerie associé (typiquement un sous-compte 521xxxx du plan SYSCOHADA classe 5)

3. Sauvegardez. Le parseur utilise ces identifiants pour différencier les transactions où vous êtes l’émetteur (débit du wallet) ou le destinataire (crédit du wallet).

Importer le relevé

1. Banque & trésorerie → Imports → Nouveau.

2. Sélectionnez le compte Mobile Money créé à l’étape précédente.

3. Glissez-déposez le fichier .xlsx ou .pdf exporté depuis votre wallet Orange Money.

4. SynkriaOps analyse en quelques secondes (selon la taille — un relevé de 500 transactions prend ~3 s en .xlsx, ~15 s en .pdf).

5. La prévisualisation s’affiche avec :

   • Nombre total de lignes parsées
   • Nombre de lignes en statut “Échec” (filtrées automatiquement)
   • Période détectée (date début/fin)
   • Total débits / crédits
   • Écart de solde reconstitué (validation R5 — warning non bloquant)

6. Validez l’import. Les opérations sont créées en BROUILLON dans le journal de banque/trésorerie. Vous pourrez les lettrer ensuite contre vos factures clients/fournisseurs.

Règles métier appliquées

Le parseur Mobile Money respecte 5 règles métier :

Règle	Comportement
R1 — Statut Échec	Lignes avec statut Echec ignorées (comptées dans lignesRejetees)
R2 — Détection sens	DEBIT si vous êtes émetteur, CREDIT si destinataire ; règles spéciales pour AFRefund (refund opérateur → CREDIT), Afriland (passerelle bancaire → CREDIT entrant), ROLLBACK, Dépôt d'argent
R3 — Séparation frais	Si la colonne Frais opération > 0, une ligne supplémentaire DEBIT (frais) est générée — toujours à votre charge
R4 — Colonne Montant total ignorée	Somme déjà décomposée en montant + frais, redondance évitée
R5 — Validation solde chronologique	Le solde de fin du relevé est reconstitué et comparé au solde affiché ; un écart est remonté en warning non bloquant

Exemple

Un retrait de 5 000 XAF avec 79 XAF de frais génère 2 lignes comptables :

Date	Libellé	Débit	Crédit	Compte
2026-05-19	Retrait d'argent - CALL BOX	5 000		521xxxx (votre compte MoMo)
2026-05-19	Frais - CALL BOX	79		6271xxxx (charges bancaires)

Total débit = 5 079 — passe la validation D=C lorsque combinée avec la contrepartie (typiquement un compte caisse ou un fournisseur lors d’un paiement).

Erreurs courantes

Erreur	Cause	Solution
« Format non reconnu »	Fichier Excel modifié manuellement	Réexporter depuis le wallet sans toucher aux colonnes
« Sens indéterminable »	Émetteur/destinataire non-standard	La ligne passe en erreur — la traiter manuellement dans le journal banque
« Écart de solde X XAF »	Mismatch entre solde affiché et reconstitué	Vérifier qu’aucune opération n’a été supprimée manuellement du relevé

Pour aller plus loin

• Lettrer une transaction Mobile Money avec une facture client → (à venir)
• Configurer le webhook Mobile Money pour l’import temps réel → (à venir)
• Trésorerie prévisionnelle → (à venir)