> ## Documentation Index
> Fetch the complete documentation index at: https://help.agatabo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Enregistrement des Paiements de Prêt

> Guide étape par étape pour enregistrer les remboursements de prêts des membres et mettre à jour les soldes

## Aperçu

L'enregistrement des paiements de prêt est une opération quotidienne critique qui met à jour les soldes de prêts des membres, suit les arriérés et assure un reporting financier précis. Lorsque les membres effectuent des remboursements, le paiement est déduit de leur solde d'épargne et alloué entre le capital, les intérêts et les pénalités.

**Utilisez ceci lorsque** : Un membre souhaite payer sur son prêt à partir de son solde d'épargne (paiement complet d'une échéance, paiement partiel ou paiement supplémentaire).

## Avant de Commencer

<Note>
  **Prérequis :**

  * Vous avez l'autorisation `loans:write`
  * Le prêt existe et est en statut actif (non entièrement remboursé ou amorti)
  * Le membre dispose d'un solde d'épargne suffisant pour couvrir le montant du paiement
  * Vous connaissez le montant exact du paiement et la date
</Note>

<Note>
  **Trouver le prêt** : Vous pouvez rechercher des prêts par nom de l'emprunteur, identifiant de prêt ou numéro de demande dans la section **Prêts**.
</Note>

## Instructions Étape par Étape

### Étape 1 : Accéder au Prêt

<Steps>
  <Step title="Ouvrir la section Prêts">
    Cliquez sur **Prêts** dans la barre latérale gauche
  </Step>

  <Step title="Trouver le prêt">
    * Utiliser la barre de recherche pour trouver le nom de l'emprunteur
    * Ou parcourir la liste des prêts actifs
    * Cliquer sur le prêt pour ouvrir les détails
  </Step>

  <Step title="Ouvrir la boîte de dialogue de paiement">
    Cliquer sur le bouton **"Enregistrer un Paiement"** (généralement en haut des détails du prêt)
  </Step>
</Steps>

### Étape 2 : Saisir les Détails du Paiement

La boîte de dialogue d'enregistrement des paiements contient les champs suivants :

| Champ                | Description                                                | Obligatoire | Exemple           |
| -------------------- | ---------------------------------------------------------- | ----------- | ----------------- |
| **Montant**          | Montant du paiement à déduire de l'épargne du membre       | Oui         | 50 000 RWF        |
| **Date de Paiement** | Date du paiement                                           | Oui         | 2026-06-08        |
| **Document**         | Télécharger un reçu de paiement ou une preuve (facultatif) | Non         | PDF/image du reçu |

<Note>
  **Important** : Les paiements sont déduits du solde d'épargne du membre. Le membre doit disposer d'une épargne suffisante pour couvrir le montant du paiement. Si ce n'est pas le cas, le paiement sera rejeté.
</Note>

#### Exemple : Enregistrement d'un Paiement d'Échéance Complet

```
Montant : 44 500 RWF
Date de Paiement : 2026-06-08
Document : reçu.pdf (facultatif)
```

### Étape 3 : Vérifier l'Allocation du Paiement

Avant de soumettre, Agatabo affiche **comment le paiement sera alloué** :

**Exemple d'allocation pour un paiement de 50 000 RWF :**

| Composant                     | Montant    | Nouveau Solde                      |
| ----------------------------- | ---------- | ---------------------------------- |
| **Intérêts**                  | 12 000 RWF | 0 RWF (intérêts payés en totalité) |
| **Capital**                   | 38 000 RWF | 400 000 RWF (réduit de 438 000)    |
| **Pénalité** (le cas échéant) | 0 RWF      | 0 RWF                              |
| **Paiement Total**            | 50 000 RWF | -                                  |

<Note>
  L'allocation suit l'**Ordre d'Allocation des Paiements** défini lors de la création du prêt :

  * **INTÉRÊTS\_D'ABORD** : Paie les intérêts en totalité, puis le capital
  * **CAPITAL\_D'ABORD** : Paie le capital en totalité, puis les intérêts
  * **PROPORTIONNEL** : Répartit selon le ratio capital/intérêts

  La plupart des prêts utilisent INTÉRÊTS\_D'ABORD pour garantir la perception des intérêts.
</Note>

### Étape 4 : Soumettre le Paiement

<Steps>
  <Step title="Vérifier l'allocation">
    Examiner la ventilation du paiement — s'assurer qu'elle est correcte
  </Step>

  <Step title="Vérifier le solde restant">
    Noter le nouveau solde en cours après ce paiement
  </Step>

  <Step title="Cliquer sur 'Enregistrer' ou 'Enregistrer le Paiement'">
    Soumet la transaction
  </Step>
</Steps>

## Ce qui se Passe Ensuite

Lorsque vous enregistrez un paiement de prêt, Agatabo automatiquement :

1. **Valide le solde d'épargne** : Vérifie que le membre dispose d'une épargne suffisante

2. **Déduit de l'épargne du membre** : Le montant du paiement est déduit de son solde d'épargne

3. **Alloue le paiement** entre les intérêts, le capital et les pénalités selon l'ordre d'allocation du prêt

4. **Met à jour le solde du prêt** : Réduit le capital restant et marque les échéances comme payées

5. **Crée une écriture comptable** :
   * **Débit** : Épargne (compte du membre, -50 000 RWF)
   * **Crédit** : Créance sur Prêt (-38 000 RWF)
   * **Crédit** : Intérêts à Recevoir (-12 000 RWF)

6. **Marque les échéances comme payées** : Si le paiement couvre une ou plusieurs échéances, elles sont marquées "Payées"

7. **Met à jour les arriérés** : Si le prêt était en retard, les arriérés sont recalculés

8. **Enregistre dans la piste d'audit** : Consigne le paiement avec l'identifiant utilisateur, l'horodatage et tous les détails

9. **Envoie une notification** (si activé) : L'emprunteur peut recevoir une confirmation de paiement

## Scénarios Courants

### Enregistrement d'un Paiement d'Échéance Complet

Lorsqu'un membre paie exactement le montant d'échéance prévu :

<Steps>
  <Step title="Saisir le montant de l'échéance">
    Le montant doit correspondre à l'échéance prévue (affiché dans les détails du prêt)
  </Step>

  <Step title="Vérifier l'allocation complète">
    Le paiement doit couvrir la totalité du capital et des intérêts de l'échéance
  </Step>

  <Step title="Soumettre">
    L'échéance est marquée "Payée" sans arriérés
  </Step>
</Steps>

### Enregistrement d'un Paiement Partiel

Lorsqu'un membre paie moins que l'échéance prévue :

<Steps>
  <Step title="Saisir le montant réellement reçu">
    Exemple : 20 000 RWF lorsque 44 500 RWF sont dus
  </Step>

  <Step title="Vérifier l'allocation">
    * Si INTÉRÊTS\_D'ABORD : 20 000 vont aux intérêts, laissant 24 500 d'intérêts non payés
    * Le capital reste inchangé
  </Step>

  <Step title="Noter les arriérés">
    La part non payée devient des arriérés et peut déclencher des frais de retard
  </Step>
</Steps>

<Warning>
  **Les paiements partiels augmentent les arriérés** : Si un membre paie régulièrement moins que le montant de l'échéance, les arriérés s'accumulent. Vous pourrez avoir besoin d'appliquer des pénalités ou de restructurer le prêt.

  [En savoir plus sur l'application des pénalités →](/fr/tontines/loans/applying-penalties)
</Warning>

### Enregistrement d'un Paiement Supplémentaire (Surpaiement)

Lorsqu'un membre paie plus que l'échéance prévue :

<Steps>
  <Step title="Saisir le montant total reçu">
    Exemple : 100 000 RWF lorsque 44 500 RWF sont dus
  </Step>

  <Step title="Vérifier l'allocation">
    * Échéance courante payée en totalité (44 500)
    * L'excédent (55 500) s'applique aux échéances futures ou au capital
  </Step>

  <Step title="Vérifier le nouveau calendrier">
    Les échéances futures peuvent être marquées prépayées, ou le capital diminue plus rapidement
  </Step>
</Steps>

### Le Membre Doit d'Abord Déposer

Si un membre souhaite effectuer un paiement de prêt mais n'a pas d'épargne suffisante :

<Steps>
  <Step title="Le membre dépose des espèces">
    Enregistrer le dépôt pour augmenter son solde d'épargne
  </Step>

  <Step title="Puis enregistrer le paiement du prêt">
    Une fois le solde d'épargne suffisant, enregistrer le paiement du prêt
  </Step>
</Steps>

<Note>
  **Processus en deux étapes** : Si un membre apporte des espèces pour payer son prêt, enregistrez-les d'abord comme dépôt d'épargne, puis enregistrez immédiatement le paiement du prêt. Cela garantit une comptabilisation correcte de la réception des espèces et du paiement du prêt.
</Note>

### Paiement Antidaté (Date Passée)

Si vous enregistrez un paiement qui a eu lieu dans le passé :

<Steps>
  <Step title="Vérifier le statut de la période">
    S'assurer que la date cible est dans une période **ouverte** (non clôturée)
  </Step>

  <Step title="Sélectionner la date de paiement correcte">
    Modifier le champ **Date de Paiement** à la date réelle de réception du paiement
  </Step>

  <Step title="Ajouter une note explicative">
    Exemple : "Paiement reçu le 2026-05-28, enregistré le 2026-06-08 (saisie tardive)"
  </Step>
</Steps>

<Warning>
  **Restriction de clôture de période** : Vous ne pouvez pas enregistrer de paiements dans des périodes comptables clôturées. Si la période est clôturée, contactez votre comptable pour le traitement approprié (peut nécessiter des écritures d'ajustement).

  [En savoir plus sur la clôture de période →](/fr/tontines/advanced/period-closing)
</Warning>

## Consultation de l'Historique des Paiements

Après l'enregistrement, vous pouvez vérifier le paiement :

<Steps>
  <Step title="Vérifier les détails du prêt">
    **Prêts → \[Prêt]** affiche le solde mis à jour et le tableau de l'historique des paiements
  </Step>

  <Step title="Vérifier le calendrier d'échéances">
    Les échéances sont marquées "Payée", "Partiellement Payée" ou "En Souffrance"
  </Step>

  <Step title="Vérifier les écritures comptables">
    **Grand Livre → Écritures Comptables** → Rechercher par date ou référence
  </Step>
</Steps>

## Gestion des Erreurs de Paiement

### Montant Enregistré Incorrect

<AccordionGroup>
  <Accordion title="Avant la clôture de période">
    1. Accéder à **Prêts → \[Prêt] → Historique des Paiements**
    2. Trouver le paiement incorrect
    3. Cliquer sur **Modifier** (si disponible selon les autorisations)
    4. Corriger le montant
    5. Enregistrer les modifications
  </Accordion>

  <Accordion title="Après la clôture de période">
    Les paiements dans des périodes clôturées ne peuvent pas être modifiés. Vous devez :

    1. Enregistrer un **paiement d'extourne** (montant négatif) dans la période courante pour annuler l'erreur
    2. Enregistrer le **paiement correct** avec le bon montant
    3. Documenter clairement les deux transactions dans les notes
    4. Consulter le comptable pour un traitement approprié
  </Accordion>
</AccordionGroup>

### Paiement Enregistré sur le Mauvais Prêt

<AccordionGroup>
  <Accordion title="Avant la clôture de période">
    1. **Supprimer** le paiement incorrect (si la suppression est activée)
    2. Accéder au bon prêt
    3. Enregistrer le paiement correctement
    4. Si la suppression n'est pas activée, contacter votre comptable pour le processus d'extourne
  </Accordion>

  <Accordion title="Après la clôture de période">
    Nécessite l'assistance d'un comptable :

    1. Écritures d'extourne sur le mauvais prêt
    2. Écritures de correction sur le bon prêt
    3. Documentation complète de la correction
  </Accordion>
</AccordionGroup>

## Bonnes Pratiques

<Note>
  **Conseils pour l'enregistrement des paiements :**

  * S'assurer que le membre dispose d'un solde d'épargne suffisant avant d'enregistrer le paiement
  * Si le membre apporte des espèces, d'abord enregistrer un dépôt, puis enregistrer le paiement du prêt
  * Vérifier le nom de l'emprunteur et l'identifiant du prêt avant de soumettre
  * Pour les paiements importants, vérifier le montant avant de soumettre
  * Télécharger les reçus de paiement ou preuves en utilisant le champ Document
  * Enregistrer les paiements rapidement pour maintenir des arriérés précis
  * Vérifier l'aperçu de l'allocation du paiement avant de soumettre
</Note>

## Opérations Connexes

<CardGroup cols={2}>
  <Card title="Détails du Prêt" icon="file-lines" href="/fr/tontines/loans/viewing-loan-details">
    Consulter le calendrier d'échéances et l'historique des paiements
  </Card>

  <Card title="Application des Pénalités" icon="circle-exclamation" href="/fr/tontines/loans/applying-penalties">
    Facturer des frais de retard pour les paiements en souffrance
  </Card>

  <Card title="Analytiques des Prêts" icon="chart-line" href="/fr/tontines/loans/loan-analytics">
    Surveiller la santé du portefeuille et les arriérés
  </Card>

  <Card title="Enregistrement des Dépôts" icon="plus" href="/fr/tontines/deposits/recording-deposits">
    Ajouter des dépôts en espèces pour augmenter l'épargne du membre
  </Card>
</CardGroup>