# 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**.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> 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"</callout>`

### 4.2.2 Description des filtres disponibles

<table id="bkmrk-filtre-type-descript"><thead><tr><th>Filtre</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>**Recherche**</td><td>Champ texte</td><td>Recherche par nom de fichier, référence Equity ou description</td></tr><tr><td>**Statut**</td><td>Liste déroulante</td><td>Filtre par statut du fichier (voir tableau ci-dessous)</td></tr><tr><td>**Date début**</td><td>Sélecteur de date</td><td>Filtre les fichiers créés à partir de cette date</td></tr><tr><td>**Date fin**</td><td>Sélecteur de date</td><td>Filtre les fichiers créés jusqu'à cette date</td></tr><tr><td>**Réinitialiser**</td><td>Bouton</td><td>Efface tous les filtres actifs</td></tr></tbody></table>

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> 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</callout>`

---

### 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.

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

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> 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</callout>`

---

### 4.2.4 Description des colonnes du tableau

<table id="bkmrk-colonne-description-"><thead><tr><th>Colonne</th><th>Description</th></tr></thead><tbody><tr><td>**Nom du fichier / Référence Equity**</td><td>Nom technique du fichier CSV généré (format : TMP210\_\[codes\]*PAAF*\[séquence\].csv)</td></tr><tr><td>**Statut**</td><td>Badge coloré avec libellé explicite de l'état du fichier</td></tr><tr><td>**Nb école(s)**</td><td>Nombre d'instructions de paiement (écoles) incluses dans ce fichier</td></tr><tr><td>**Montant total**</td><td>Montant total de toutes les instructions du fichier en CDF</td></tr><tr><td>**Généré par**</td><td>Nom de l'utilisateur ayant déclenché la génération + date et heure</td></tr><tr><td>**Actions**</td><td>Menu à trois points (voir section suivante)</td></tr></tbody></table>

---

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

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> 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)</callout>`

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> 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)</callout>`

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

⚠️ **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.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> 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</callout>`

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.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> 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</callout>`

**Principaux motifs de rejet Equity et actions correctives :**

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

ℹ️ **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).

---