C.4.4.2 — Suivi des paiements Equity BCDC

4.2 Suivi des paiements Equity BCDC

4.2.1 Accéder à l'écran de suivi Equity

Menu latéral → Gestion des paiements → Equity BCDC → Suivi.

📸 Capture d'écran à insérer : Page de suivi Equity BCDC, état avec fichiers en cours : zone de filtres (Recherche textuelle, Statut — liste déroulante, Date début / Date fin, bouton Réinitialiser), tableau "Fichiers Equity H2H" avec 2 fichiers visibles, colonnes Nom du fichier / Statut (badge coloré) / Nb écoles / Montant total / Généré par / Actions. Total affiché en haut à droite "85 564 400 CDF"

4.2.2 Description des filtres disponibles

Filtre Type Description
Recherche Champ texte Recherche par nom de fichier, référence Equity ou description
Statut Liste déroulante Filtre par statut du fichier (voir tableau ci-dessous)
Date début Sélecteur de date Filtre les fichiers créés à partir de cette date
Date fin Sélecteur de date Filtre les fichiers créés jusqu'à cette date
Réinitialiser Bouton Efface tous les filtres actifs

📸 Capture d'écran à insérer : Zone de filtres de l'écran de suivi Equity : champ "Recherche : nom fichier, référence, description..." / liste déroulante "Statut : Tous les statuts" développée montrant toutes les options / champs date début et fin / bouton Réinitialiser


4.2.3 Comprendre les statuts des fichiers H2H

Chaque fichier H2H passe par une série de statuts reflétant son état dans le circuit de traitement bancaire Equity.

Statut Couleur Signification Action recommandée
Non envoyé Gris Fichier généré côté plateforme, pas encore transmis au SFTP Equity Envoyer depuis l'écran Envoi
Envoi en cours Bleu Transmission SFTP en cours Patienter, actualiser la page dans quelques minutes
Envoyé Bleu ciel Fichier déposé sur le SFTP Equity, en attente d'accusé de réception (ACK) Patienter (Equity traite sous 30 min à quelques heures)
Reçu Vert clair ACK reçu — Equity confirme avoir reçu et accepté le fichier Patienter la confirmation de traitement (PSR)
Traité avec succès Vert foncé PSR reçu — Paiements exécutés, fonds décaissés aux écoles Aucune action requise
Rejeté Rouge NACK reçu — Equity a rejeté le fichier (motif dans le fichier NACK) Télécharger le fichier NACK, analyser le motif, contacter IT GROUP
Erreur Orange Problème technique lors de la transmission SFTP Utiliser "Renvoyer" depuis le menu Actions

📸 Capture d'écran à insérer : Tableau de suivi Equity avec plusieurs fichiers aux statuts différents : ligne 1 "TMP210_43100189266_...PAAF_00001.csv" / badge vert clair "ENVOYÉ, ATTENTE ACCUSÉ DE RÉCEPTION" / 1 école / 2 836 200 CDF / Emmanuel 20/11/2025 / bouton Actions. Ligne 2 même structure avec badge vert foncé "TRAITÉ AVEC SUCCÈS" pour un autre fichier


4.2.4 Description des colonnes du tableau

Colonne Description
Nom du fichier / Référence Equity Nom technique du fichier CSV généré (format : TMP210_[codes]PAAF[séquence].csv)
Statut Badge coloré avec libellé explicite de l'état du fichier
Nb école(s) Nombre d'instructions de paiement (écoles) incluses dans ce fichier
Montant total Montant total de toutes les instructions du fichier en CDF
Généré par Nom de l'utilisateur ayant déclenché la génération + date et heure
Actions Menu à trois points (voir section suivante)

4.2.5 Actions disponibles sur un fichier H2H (menu trois points)

📸 Capture d'écran à insérer : Menu Actions (bouton à trois points) ouvert sur une ligne de fichier Equity avec statut "Envoyé" : liste des options : "Voir détails" (icône œil), "Télécharger — Fichier H2H envoyé" (icône téléchargement), "Télécharger — Fichier ACK" (grisé si non disponible), "Télécharger — Fichier NACK" (grisé si non disponible), "Télécharger — Fichier PSR" (grisé si non disponible)

📸 Capture d'écran à insérer : Menu Actions ouvert sur un fichier en statut "Non envoyé" ou "Erreur" : mêmes options avec en plus "Renvoyer" (icône flèche circulaire, actif) et "Supprimer" (icône corbeille, rouge)

Action Disponibilité Description
Voir détails Toujours Ouvre la fenêtre modale de détail complet du fichier et de ses instructions
Télécharger — Fichier H2H envoyé Après envoi Télécharge le fichier CSV original déposé sur le SFTP Equity
Télécharger — Fichier ACK Après réception ACK Télécharge l'accusé de réception positif d'Equity
Télécharger — Fichier NACK Si fichier rejeté Télécharge le fichier de rejet Equity avec les motifs d'erreur
Télécharger — Fichier PSR Après traitement complet Télécharge le rapport de synthèse final (Payment Status Report)
Renvoyer Si statut "Non envoyé" ou "Erreur" Relance le dépôt SFTP du fichier vers Equity
Supprimer Si statut "Non envoyé" uniquement Supprime définitivement le fichier et toutes ses instructions

⚠️ Attention — Suppression d'un fichier H2H : La suppression d'un fichier H2H est irréversible et supprime également toutes les instructions de paiement associées dans la plateforme. Cette opération ne peut en aucun cas annuler un virement déjà en cours de traitement ou exécuté chez Equity Bank. Elle ne doit être utilisée qu'en cas d'erreur manifeste sur un fichier strictement non encore envoyé. Une fenêtre de confirmation forte s'affiche avant l'exécution, récapitulant le nom du fichier, le nombre d'instructions et le montant total concerné.


4.2.6 Consulter le détail d'un fichier H2H

Cliquez sur Voir détails dans le menu Actions pour ouvrir la fenêtre modale de détail.

📸 Capture d'écran à insérer : Fenêtre modale "Détails du fichier Equity H2H" complète : bloc supérieur "Informations fichier" (Nom du fichier, Référence Equity, Description/Commentaire, Statut avec badge coloré, Date de génération, Date d'envoi si disponible, Date de réception ACK si disponible, Liens de téléchargement ACK/NACK/PSR si disponibles), séparateur horizontal, bloc "Instructions de paiement associées" — tableau avec colonnes : École (lien vers fiche), Référence instruction, Compte Equity, Agent Equity, Montant (CDF), Workflow (3 étapes : "Généré par X le JJ/MM/AAAA" / "Validé par Y le JJ/MM/AAAA" / "Envoyé par Z le JJ/MM/AAAA"), Statut paiement individuel (badge : Payé en vert / Échoué en rouge / En attente en gris / En cours en bleu), bouton "Fermer" en bas à droite

Cette vue détaillée permet de descendre jusqu'au niveau de l'instruction individuelle et d'identifier :
- Quelle école a été payée ou non
- Qui a effectué chaque étape du workflow (génération, validation, envoi)
- Le statut précis de chaque virement individuel
- Les motifs d'échec éventuels (colonne Statut paiement)


4.2.7 Interpréter un fichier NACK (rejet Equity)

Lorsqu'un fichier passe au statut « Rejeté » (badge rouge), cela signifie qu'Equity Bank a refusé de traiter le fichier H2H. Le fichier NACK, téléchargeable via le menu Actions, contient les motifs de rejet.

📸 Capture d'écran à insérer : Extrait d'un fichier NACK au format CSV : entête du fichier avec référence et date, lignes d'erreur avec codes et libellés (ex. "COMPTE_INVALIDE", "BENEFICIAIRE_INTROUVABLE", "MONTANT_INFERIEUR_SEUIL"), instruction concernée identifiée par son numéro de compte

Principaux motifs de rejet Equity et actions correctives :

Code d'erreur NACK Signification Action corrective
COMPTE_INVALIDE Le numéro de compte Equity de l'école est incorrect ou inexistant Corriger le compte bancaire dans la fiche école (Admin Plateforme), puis régénérer
BENEFICIAIRE_INTROUVABLE L'école n'est pas reconnue dans la base Equity Bank Contacter Equity Bank pour vérifier l'enrôlement de l'école
MONTANT_INFERIEUR_SEUIL Le montant du virement est inférieur au seuil minimum Equity Vérifier la configuration des tranches de paiement (Admin Plateforme)
FORMAT_FICHIER_INVALIDE Structure du fichier CSV incorrecte Contacter l'équipe IT GROUP immédiatement
SIGNATURE_PGP_INVALIDE La clé PGP de chiffrement a expiré ou est incorrecte Contacter l'équipe IT GROUP immédiatement

ℹ️ Procédure après un NACK : Téléchargez le fichier NACK, identifiez les motifs d'erreur, transmettez-les à l'Admin Plateforme pour correction des données concernées. Une fois les corrections effectuées, l'Admin PAAF doit régénérer un nouveau lot pour les écoles affectées. Ce nouveau lot suivra l'intégralité du cycle (génération → validation → envoi).



Revision #1
Created 2026-06-14 21:09:09 UTC by Chris Muzele
Updated 2026-06-14 21:09:09 UTC by Chris Muzele