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

# Modification des Prêts

> Augmenter le capital, prolonger la durée ou ajuster le taux d'intérêt des prêts actifs

## Aperçu

La modification de prêt dans Agatabo vous permet d'ajuster les modalités globales du prêt — augmenter le montant du capital, prolonger la durée ou modifier le taux d'intérêt. Le système régénère le calendrier de remboursement à partir de la date de modification tout en conservant les échéances passées inchangées.

<Note>
  **Important** : Il s'agit d'un **système de modification au niveau des modalités**, pas au niveau des échéances individuelles. Vous ne pouvez pas modifier les montants ou les dates d'échéance individuels. À la place, vous modifiez les modalités globales du prêt et le système recalcule l'ensemble du calendrier.
</Note>

## Ce qui Peut être Modifié

### Montant du Capital (Complément)

**Augmenter** le montant du capital du prêt :

* Ajouter des fonds à un prêt existant
* Le membre reçoit un décaissement supplémentaire
* Nouveau calendrier calculé à partir de la date de modification
* **Restriction** : Impossible de réduire le capital (augmentation uniquement)

**Exemple** : Prêt de 500 000 RWF → modifier à 700 000 RWF

* 200 000 RWF supplémentaires décaissés au membre
* Calendrier recalculé pour la durée restante avec le nouveau capital

### Durée du Prêt (Prolongation)

**Prolonger** la durée du prêt :

* Ajouter des mois supplémentaires à la période de remboursement
* Réduit la charge de paiement mensuelle
* Augmente le total des intérêts payés
* **Restriction** : Impossible de raccourcir la durée (prolongation uniquement)

**Exemple** : Prêt de 12 mois → prolonger à 18 mois

* 6 mois supplémentaires ajoutés
* Paiements mensuels recalculés avec la nouvelle durée

### Taux d'Intérêt

**Modifier** le taux d'intérêt :

* Ajuster à la hausse ou à la baisse
* Le nouveau taux s'applique à partir de la date de modification
* **Facultatif** : Peut conserver le même taux

**Exemple** : 5 % mensuel → modifier à 3 % mensuel

* Nouvelles échéances calculées avec le taux de 3 %

## Ce qui Ne Peut Pas être Modifié

<Warning>
  **Restrictions sur les modifications** :

  * **Impossible de réduire** le montant du capital (augmentation uniquement)
  * **Impossible de raccourcir** la durée du prêt (prolongation uniquement)
  * **Impossible de modifier** le type de calcul des intérêts (SIMPLE, SOLDE\_DÉGRESSIF, COMPOSÉ)
  * **Impossible de modifier** le type d'échéance (CAPITAL\_ÉGAL vs TOTAL\_ÉGAL)
  * **Impossible de modifier** l'ordre d'allocation des paiements
  * **Impossible de modifier** les montants ou dates d'échéances individuels
  * **Impossible de modifier** les prêts CLÔTURÉS ou EN\_DÉFAUT (actifs uniquement)
  * **Impossible de modifier** si des paiements ou pénalités ultérieurs existent (les extourner d'abord)
</Warning>

## Quand Modifier des Prêts

Modifiez les prêts lorsque :

* **Demande de complément** : Le membre a besoin de fonds supplémentaires
* **Difficultés financières** : Le membre a besoin de paiements plus faibles (prolonger la durée)
* **Ajustement du taux d'intérêt** : Conditions du marché ou changements de politique
* **Restructuration du prêt** : Prévenir le défaut avec de meilleures modalités

**Prérequis** :

* Le prêt doit être ACTIF
* Les deux parties acceptent les nouvelles modalités
* Approbation du comité (selon la politique de votre organisation)

## Le Processus de Modification en 3 Étapes

### Étape 1 : Saisir les Nouvelles Modalités

<Steps>
  <Step title="Accéder aux détails du prêt">
    Prêts → Sélectionner le prêt → Ouvrir les détails
  </Step>

  <Step title="Cliquer sur le bouton 'Modifier le Prêt'">
    Situé dans la carte Aperçu du Prêt (si vous avez l'autorisation)
  </Step>

  <Step title="Saisir les nouvelles modalités">
    Remplir le formulaire de modification :

    * **Nouveau Capital** : Doit être ≥ capital actuel
    * **Nouvelle Durée** : Doit être ≥ durée actuelle (en mois)
    * **Nouveau Taux d'Intérêt** : Facultatif, saisir le nouveau pourcentage
    * **Date de Modification** : Quand le changement prend effet
    * **Compte Bancaire** : Obligatoire si le capital augmente (pour le décaissement)
  </Step>

  <Step title="Cliquer sur 'Suivant'">
    Passe à l'étape d'aperçu
  </Step>
</Steps>

### Étape 2 : Aperçu des Modifications

L'aperçu montre l'impact financier de la modification :

**Affichage comparatif** :

* Anciens vs Nouveaux montants de capital
* Ancienne vs Nouvelle durée du prêt
* Anciens vs Nouveaux taux d'intérêt
* **Trésorerie Décaissée** : Montant supplémentaire à décaisser (si capital augmenté)
* **Ajustement des Intérêts** : Variation du total des intérêts

**Aperçu du calendrier** :

* Échéances avant la date de modification (inchangées)
* Échéances après la date de modification (nouveaux calculs)

<Steps>
  <Step title="Examiner l'impact">
    Vérifier que les modifications sont correctes
  </Step>

  <Step title="Vérifier le montant du décaissement">
    Si le capital augmente, confirmer le montant en trésorerie
  </Step>

  <Step title="Cliquer sur 'Suivant'">
    Passe à la confirmation
  </Step>
</Steps>

### Étape 3 : Confirmer et Soumettre

<Steps>
  <Step title="Ajouter la raison (facultatif)">
    Documenter pourquoi la modification est effectuée
  </Step>

  <Step title="Accepter les modalités">
    Confirmer que vous comprenez les modifications
  </Step>

  <Step title="Cliquer sur 'Confirmer la Modification'">
    Soumet la modification
  </Step>
</Steps>

## Ce qui se Passe Lors de la Modification

1. **Vérifications de validation** :
   * Confirme que le prêt est ACTIF
   * Vérifie que le nouveau capital ≥ capital actuel
   * Vérifie que la nouvelle durée ≥ durée actuelle
   * Vérifie qu'il n'y a pas de paiements/pénalités ultérieurs

2. **Écritures comptables créées** :
   * **Dt COMPTE\_BANCAIRE** : Trésorerie décaissée (si capital augmenté)
   * **Ct CRÉANCE\_SUR\_PRÊT** : Augmentation du capital
   * Écritures supplémentaires pour les intérêts (si intérêts payés à l'avance)

3. **Enregistrement LoanModificationMeta créé** :
   * Stocke les anciennes vs nouvelles modalités
   * Lie à l'écriture comptable
   * Enregistre la date, la raison et le créateur de la modification

4. **Calendrier du prêt régénéré** :
   * Échéances **avant** la date de modification : **inchangées**
   * Échéances **après** la date de modification : **recalculées** avec les nouvelles modalités

5. **Trésorerie décaissée** (si capital augmenté) :
   * Fonds supplémentaires libérés au membre
   * Du compte bancaire sélectionné

6. **Historique des modifications mis à jour** :
   * Apparaît dans les détails du prêt
   * Affiché dans le tableau de l'historique des modifications

## Comprendre la Régénération du Calendrier

La modification crée un calendrier "avant et après" :

**Exemple** : Prêt démarré le 1er juin 2026 (12 mois, 500 000 RWF)
Modifié le 1er septembre 2026 (prolonger à 18 mois, augmenter à 700 000 RWF)

**Échéances 1-3** (juin, juillet, août) :

* **Inchangées** — calculées avec les modalités originales
* Déjà payées ou en cours

**Échéances 4-18** (septembre et après) :

* **Recalculées** — utilise le nouveau capital (700 000 RWF) et la nouvelle durée (18 mois)
* Nouveaux montants mensuels basés sur le capital restant et les mois restants

<Note>
  **Important** : Le système ne "redémarre" pas le prêt. Il calcule quel est le solde restant à la date de modification et le répartit sur la nouvelle durée restante avec les nouvelles modalités.
</Note>

## Historique des Modifications

Toutes les modifications sont suivies et affichées dans les détails du prêt :

**L'historique affiche** :

* Date de modification
* Ancien → Nouveau capital
* Ancienne → Nouvelle durée
* Ancien → Nouveau taux d'intérêt
* Trésorerie décaissée
* Raison (si fournie)
* Qui a effectué la modification
* Quand elle a été créée

**Actions disponibles** :

* Voir les détails complets
* Annuler la dernière modification (si aucun événement ultérieur n'existe)

## Annulation d'une Modification

Vous pouvez inverser la **modification la plus récente** si nécessaire :

<Steps>
  <Step title="Aller aux détails du prêt">
    Trouver le prêt avec la modification
  </Step>

  <Step title="Voir l'Historique des Modifications">
    Dans la carte Aperçu du Prêt
  </Step>

  <Step title="Cliquer sur 'Annuler' (icône corbeille)">
    Disponible uniquement pour la dernière modification
  </Step>

  <Step title="Confirmer">
    Inverse la modification
  </Step>
</Steps>

**Ce qui se passe** :

* Inverse toutes les écritures comptables
* Supprime l'enregistrement de modification
* Le calendrier revient à l'état précédent
* Le décaissement de trésorerie est extourné (le cas échéant)

<Warning>
  **Impossible d'annuler si** :

  * Des paiements de prêt ont été effectués après la date de modification
  * Des pénalités ont été appliquées après la date de modification
  * Ces événements doivent être extournés d'abord, puis la modification annulée
</Warning>

## Scénarios de Modification Courants

### Complément (Fonds Supplémentaires)

Le membre a besoin de plus d'argent :

```
Original : 500 000 RWF, 12 mois, 5 % mensuel
Modifié : 800 000 RWF, 12 mois, 5 % mensuel (même durée et taux)

Résultat :
- 300 000 RWF supplémentaires décaissés
- Échéances restantes recalculées avec capital plus élevé
- Paiements mensuels augmentent
```

### Prolongation de Durée (Paiements Plus Faibles)

Le membre a besoin de paiements mensuels plus faibles :

```
Original : 500 000 RWF, 12 mois, 5 % mensuel
Modifié : 500 000 RWF, 18 mois, 5 % mensuel (même capital et taux)

Résultat :
- Pas de décaissement supplémentaire
- Échéances restantes réparties sur plus de mois
- Paiements mensuels diminuent
- Total des intérêts augmente
```

### Complément avec Prolongation

Modification combinée :

```
Original : 500 000 RWF, 12 mois, 5 % mensuel
Modifié : 700 000 RWF, 18 mois, 4 % mensuel

Résultat :
- 200 000 RWF supplémentaires décaissés
- Durée prolongée pour plus de flexibilité
- Taux réduit pour aider le membre
```

## Bonnes Pratiques

<Note>
  **Conseils de modification :**

  * Obtenir la demande écrite du membre
  * Obtenir l'approbation du comité selon la politique
  * Documenter clairement la raison
  * Vérifier les modifications avant de confirmer
  * Conserver l'historique des modifications pour l'audit
  * Utiliser les compléments stratégiquement (ne pas sur-prêter)
  * Tenir compte de la capacité de remboursement du membre
  * Communiquer le nouveau calendrier au membre
  * Imprimer/envoyer le calendrier mis à jour au membre
</Note>

## Autorisations Requises

| Action                        | Autorisation   | Portée |
| ----------------------------- | -------------- | ------ |
| Consulter les détails du prêt | `loans:read`   | TOUTE  |
| Modifier le prêt              | `loans:modify` | TOUTE  |
| Annuler une modification      | `loans:modify` | TOUTE  |

## Opérations Connexes

<CardGroup cols={2}>
  <Card title="Création de Prêts" icon="plus" href="/fr/tontines/loans/creating-loans">
    Comprendre la configuration initiale du prêt
  </Card>

  <Card title="Détails du Prêt" icon="file-lines" href="/fr/tontines/loans/viewing-loan-details">
    Vérifier l'historique des modifications
  </Card>

  <Card title="Enregistrement des Paiements" icon="money-bill-transfer" href="/fr/tontines/loans/recording-loan-payments">
    Gérer les paiements sur les prêts modifiés
  </Card>

  <Card title="Analytiques des Prêts" icon="chart-line" href="/fr/tontines/loans/loan-analytics">
    Surveiller la performance des prêts modifiés
  </Card>
</CardGroup>