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

# Ajout d'Immobilisations

> Enregistrer les actifs de l'organisation acquis par achat en espèces, saisie de nantissement ou donation

## Aperçu

L'enregistrement des immobilisations garantit que tous les biens importants de l'organisation sont suivis dans Agatabo. Cela crée des écritures comptables, met à jour les soldes bancaires (pour les achats en espèces) et maintient des enregistrements financiers précis.

## Avant de Commencer

<Note>
  **Prérequis :**

  * Vous avez l'autorisation `assets:write`
  * Vous disposez d'une documentation pour l'actif (reçu, évaluation ou lettre de donation)
  * Vous connaissez la valeur d'acquisition ou le prix d'achat
  * Pour les achats en espèces : vous savez quel compte bancaire a payé
  * Pour la saisie de nantissement : le prêt a été marqué DÉFAILLANT avec les créances douteuses passées en pertes
  * Pour les dons : vous avez une évaluation à la valeur marchande juste
</Note>

## Types d'Acquisition Pris en Charge

| Type                 | Quand Utiliser                                    | Impact Bancaire           | Écriture Comptable                                                              |
| -------------------- | ------------------------------------------------- | ------------------------- | ------------------------------------------------------------------------------- |
| **Achat en Espèces** | Acheter un actif avec les fonds de l'organisation | Diminue le solde bancaire | Dt IMMOBILISATION / Ct CAISSE                                                   |
| **Nantissement**     | Saisir un bien mis en gage d'un prêt défaillant   | Pas d'impact bancaire     | Dt IMMOBILISATION / Ct RÉCUPÉRATION\_CRÉANCES\_DOUTEUSES + EXCÉDENT\_EMPRUNTEUR |
| **Don**              | Recevoir un actif en donation                     | Pas d'impact bancaire     | Dt IMMOBILISATION / Ct AUTRES\_CAPITAUX\_PROPRES                                |

## Enregistrement d'un Achat en Espèces

### Quand Utiliser

Utiliser **Achat en Espèces** lors de l'achat d'un actif avec les fonds de l'organisation depuis un compte bancaire.

### Informations Requises

| Champ                  | Description                    | Exemple                                                |
| ---------------------- | ------------------------------ | ------------------------------------------------------ |
| **Titre**              | Nom/description de l'actif     | "Ordinateur Portable HP ProBook 450 G8 - Série ABC123" |
| **Montant**            | Prix d'achat (min 0,01)        | 850 000 RWF                                            |
| **Date d'Acquisition** | Date d'achat (format ISO)      | 2026-06-10                                             |
| **Compte Bancaire**    | Quel compte a payé (optionnel) | "Compte Courant BK"                                    |

### Informations Optionnelles

| Champ                       | Description                                                  | Exemple                                                                                 |
| --------------------------- | ------------------------------------------------------------ | --------------------------------------------------------------------------------------- |
| **Description**             | Détails supplémentaires (fournisseur, garantie, emplacement) | "Acheté chez Tech Store Kigali, garantie 3 ans expire 2029-06-10, assigné au Trésorier" |
| **Montant Frais Bancaires** | Frais de virement, frais de traitement                       | 5 000 RWF                                                                               |
| **Documents**               | Reçus, factures, photos, cartes de garantie                  | PDF reçus, photos du produit                                                            |
| **Notifier les Membres**    | Envoyer une notification par email à tous les membres        | vrai/faux                                                                               |

### Ce qui se Passe

**Écriture Comptable Créée** :

```
Nature : ACHAT_ACTIF_ESPÈCES
Date : Date d'acquisition

Dt IMMOBILISATION              Montant
   Ct CAISSE (Compte Bancaire) Montant
```

**Exemple** :

```
Achat ordinateur pour 850 000 RWF + 5 000 RWF frais virement

Écriture 1 - Achat Actif :
Dt IMMOBILISATION (Ordinateur)        850 000
   Ct CAISSE (Compte Courant BK)      850 000

Écriture 2 - Frais Bancaires (auto-liée) :
Dt CHARGES_BANCAIRES  5 000
   Ct CAISSE (BK Courant)  5 000

Total diminution bancaire : 855 000 RWF
```

### Étape par Étape

<Steps>
  <Step title="Accéder aux Immobilisations">
    Cliquer sur **Immobilisations** dans la barre latérale, puis **Nouvel Actif** ou **Ajouter Actif**
  </Step>

  <Step title="Sélectionner Achat en Espèces">
    Choisir **Achat en Espèces** comme type d'acquisition
  </Step>

  <Step title="Saisir les détails de l'actif">
    * **Titre** : "Ordinateur Portable HP ProBook 450 G8 - Série ABC123456"
    * **Montant** : 850 000
    * **Date d'Acquisition** : 2026-06-10
    * **Description** : "Acheté chez Tech Store, garantie 3 ans expire 2029-06-10"
  </Step>

  <Step title="Sélectionner le compte bancaire">
    Choisir quel compte a payé l'achat (ou laisser vide pour le compte par défaut)
  </Step>

  <Step title="Ajouter des frais bancaires (optionnel)">
    Si vous avez payé des frais de virement ou de traitement, saisir le montant
  </Step>

  <Step title="Télécharger des documents (optionnel)">
    Joindre le reçu, la facture, la carte de garantie ou les photos du produit
  </Step>

  <Step title="Soumettre">
    Cliquer sur **Enregistrer Actif** ou **Enregistrer**
  </Step>
</Steps>

## Enregistrement d'une Saisie de Nantissement

### Quand Utiliser

Utiliser **Nantissement** lors de la saisie d'un bien mis en gage par un emprunteur défaillant sur son prêt.

### Prérequis

<Warning>
  **Exigences critiques :**

  * Le prêt doit avoir le statut **DÉFAILLANT**
  * Le prêt doit avoir des **créances douteuses passées en pertes** (montantCreancesDouteuses > 0)
  * Le système génèrera une erreur si ces conditions ne sont pas remplies
</Warning>

Défauter d'abord le prêt, puis enregistrer l'actif nantissement.

[En savoir plus sur le défaut de prêt →](/fr/tontines/loans/loan-defaulting)

### Informations Requises

| Champ                  | Description                               | Exemple                                 |
| ---------------------- | ----------------------------------------- | --------------------------------------- |
| **Titre**              | Description du bien saisi                 | "Moto - Yamaha FZ 150"                  |
| **Montant**            | Valeur évaluée du nantissement (min 0,01) | 1 200 000 RWF                           |
| **Date d'Acquisition** | Date de saisie (format ISO)               | 2026-06-10                              |
| **ID du Prêt**         | Quel prêt défaillant récupérer            | "PR-00123" (Jean Doe - Prêt Commercial) |

### Calcul de la Récupération de Créance Douteuse

```
récupérationCreanceDouteuse = MIN(valeurNantissement, montantCreancesDouteuses)
excédentEmprunteur = MAX(0, valeurNantissement - montantCreancesDouteuses)
```

### Exemples

**Exemple 1 : Nantissement = Créance Douteuse**

```
Créance douteuse prêt défaillant : 1 000 000 RWF
Valeur moto saisie : 1 000 000 RWF

Dt IMMOBILISATION (Moto)                   1 000 000
   Ct RÉCUPÉRATION_CRÉANCES_DOUTEUSES      1 000 000

Résultat :
- Actif : +1 000 000 RWF
- Produit (récupéré) : +1 000 000 RWF
- Passif envers l'emprunteur : 0 RWF
```

**Exemple 2 : Nantissement > Créance Douteuse**

```
Créance douteuse : 800 000 RWF
Valeur moto saisie : 1 200 000 RWF

Dt IMMOBILISATION (Moto)                   1 200 000
   Ct RÉCUPÉRATION_CRÉANCES_DOUTEUSES        800 000
   Ct EXCÉDENT_EMPRUNTEUR                    400 000

Résultat :
- Actif : +1 200 000 RWF
- Récupération : 800 000 RWF
- Passif envers l'emprunteur : 400 000 RWF (dû si actif vendu)
```

<Warning>
  **Passif Excédent Emprunteur** : Si la valeur du nantissement dépasse la créance douteuse, l'organisation doit l'excédent à l'emprunteur. Ce passif doit être réglé si/quand l'actif est vendu.
</Warning>

### Étape par Étape

<Steps>
  <Step title="Défauter d'abord le prêt">
    Avant d'enregistrer le nantissement, s'assurer que le prêt est marqué DÉFAILLANT avec créances douteuses passées en pertes
  </Step>

  <Step title="Accéder aux Immobilisations">
    Cliquer sur **Immobilisations** dans la barre latérale, puis **Nouvel Actif**
  </Step>

  <Step title="Sélectionner Nantissement">
    Choisir **Nantissement** comme type d'acquisition
  </Step>

  <Step title="Saisir les détails de l'actif">
    * **Titre** : "Moto - Yamaha FZ 150"
    * **Montant** : 1 200 000 (valeur évaluée)
    * **Date d'Acquisition** : 2026-06-10 (date de saisie)
  </Step>

  <Step title="Sélectionner le prêt défaillant">
    Choisir le prêt défaillant dans la liste déroulante
  </Step>

  <Step title="Soumettre">
    Cliquer sur **Enregistrer Actif** — le système calcule automatiquement la récupération de créance douteuse
  </Step>
</Steps>

## Enregistrement d'un Don (Donation)

### Quand Utiliser

Utiliser **Don** lors de la réception d'un actif en donation d'un membre, d'une partie externe ou d'une organisation.

### Informations Requises

| Champ                  | Description                       | Exemple                         |
| ---------------------- | --------------------------------- | ------------------------------- |
| **Titre**              | Description de l'actif donné      | "Bureau et Ensemble de Chaises" |
| **Montant**            | Valeur marchande juste (min 0,01) | 150 000 RWF                     |
| **Date d'Acquisition** | Date de réception (format ISO)    | 2026-06-10                      |

### Ce qui se Passe

**Écriture Comptable Créée** :

```
Nature : ACTIF_DON
Date : Date d'acquisition

Dt IMMOBILISATION              ValeurMarchéJuste
   Ct AUTRES_CAPITAUX_PROPRES  ValeurMarchéJuste
```

**Exemple** :

```
Membre fait don de mobilier de bureau valant 150 000 RWF

Dt IMMOBILISATION (Mobilier)   150 000
   Ct AUTRES_CAPITAUX_PROPRES  150 000

Résultat :
- Actif : +150 000 RWF
- Capitaux propres : +150 000 RWF
- Valeur nette de l'organisation augmentée par le don
```

### Étape par Étape

<Steps>
  <Step title="Accéder aux Immobilisations">
    Cliquer sur **Immobilisations** dans la barre latérale, puis **Nouvel Actif**
  </Step>

  <Step title="Sélectionner Don">
    Choisir **Don** comme type d'acquisition
  </Step>

  <Step title="Saisir les détails de l'actif">
    * **Titre** : "Bureau et Ensemble de Chaises"
    * **Montant** : 150 000 (valeur marchande juste)
    * **Date d'Acquisition** : 2026-06-10
    * **Description** : "Donné par Marie Uwase - 1 bureau, 4 chaises. Évalué selon liste de prix ABC Mobilier."
  </Step>

  <Step title="Télécharger des documents (optionnel)">
    Joindre la lettre de donation, les photos de l'actif, le certificat d'évaluation
  </Step>

  <Step title="Activer les notifications (optionnel)">
    Basculer "Notifier tous les membres" pour annoncer le don
  </Step>

  <Step title="Soumettre">
    Cliquer sur **Enregistrer Actif**
  </Step>
</Steps>

## Conventions de Nommage

**Meilleure pratique** : Utiliser le format "Type - Marque Modèle - Identifiant"

**Exemples** :

* "Ordinateur Portable - HP ProBook 450 G8 - Série ABC123456"
* "Véhicule - Toyota Corolla - Plaque RAB 123A"
* "Mobilier - Ensemble Bureau Exécutif"
* "Équipement - Imprimante Industrielle Canon MX920"

## Erreurs Courantes

| Erreur                                         | Cause                                                   | Solution                                                            |
| ---------------------------------------------- | ------------------------------------------------------- | ------------------------------------------------------------------- |
| "Aucun prêt défaillant disponible"             | Aucun prêt ne remplit les conditions de nantissement    | Vérifier que le prêt est DÉFAILLANT avec créances passées en pertes |
| "Le prêt n'a pas de créances douteuses"        | Sélectionné prêt sans créances passées en pertes        | S'assurer que le défaut a passé le montant irrécouvrable en pertes  |
| "Solde insuffisant"                            | Compte bancaire n'a pas assez de fonds pour l'achat     | Vérifier le solde ou sélectionner un autre compte                   |
| "Impossible de modifier le type d'acquisition" | Essayer de changer le type après création               | Le type d'acquisition est immuable — supprimer et recréer           |
| "Date dans une période clôturée"               | Essayer d'antidater dans une période comptable clôturée | Utiliser la date de la période actuelle                             |

## Autorisations Requises

| Action                    | Autorisation   | Portée |
| ------------------------- | -------------- | ------ |
| Consulter les actifs      | `assets:read`  | TOUTE  |
| Créer un actif            | `assets:write` | TOUTE  |
| Télécharger des documents | `assets:write` | TOUTE  |

## Sujets Connexes

<CardGroup cols={2}>
  <Card title="Aperçu des Immobilisations" icon="building" href="/fr/tontines/fixed-assets/overview">
    Comprendre les types et fonctionnalités des actifs
  </Card>

  <Card title="Cession d'Actifs" icon="trash" href="/fr/tontines/fixed-assets/asset-disposal">
    Supprimer ou vendre des actifs
  </Card>

  <Card title="Comptes Bancaires" icon="building-columns" href="/fr/tontines/bank-accounts/overview">
    Gérer les comptes de l'organisation
  </Card>

  <Card title="Défaut de Prêt" icon="triangle-exclamation" href="/fr/tontines/loans/loan-defaulting">
    Gérer les prêts défaillants
  </Card>

  <Card title="Bilan" icon="scale-balanced" href="/fr/tontines/reports/balance-sheet">
    Voir la valeur totale des actifs
  </Card>
</CardGroup>