Crédit Capital — Guide utilisateur
Simulateur de capital empruntable pour les conseillers en gestion de patrimoine (CGP). À partir d'une mensualité maximale que le client peut supporter, d'une durée, d'une périodicité et d'un taux nominal annuel, l'outil calcule le capital qu'il est possible d'emprunter et produit un tableau d'amortissement complet.
Utilisation
Dashboard
La page d'accueil liste toutes vos simulations enregistrées localement dans le navigateur. Chaque ligne récapitule les paramètres essentiels et le capital empruntable calculé.
- + Nouvelle simulation : crée un nouveau plan avec les valeurs par défaut.
- Importer JSON : recharge un plan précédemment exporté.
- Dupliquer : crée une copie d'une simulation existante.
- Supprimer : retire définitivement la simulation.
Paramètres (sidebar)
| Champ | Description |
|---|---|
| Mensualité maximale | Montant maximal que le client peut rembourser par période (€). |
| Durée | Nombre de périodes du crédit. |
| Périodicité | Mensuelle (12), trimestrielle (4), semestrielle (2) ou annuelle (1). |
| Taux nominal annuel | Taux d'intérêt affiché au client, exprimé en % annuel. |
| Interprétation du taux | Par défaut Annuel (V3) : le taux saisi est un taux annuel converti en interne. L'option Par période (legacy) reproduit le comportement historique de l'API où le taux était utilisé tel quel comme taux par période. |
Onglets de résultats
- Résultats — Indicateurs clés (capital empruntable, total remboursé, coût des intérêts, durée) et synthèse des paramètres.
- Amortissement — Tableau période par période : intérêts, capital remboursé, échéance, capital restant dû.
- Graphique — Courbe du capital restant dû et répartition capital / intérêts par échéance.
Modèle de calcul
Soit :
Mla mensualité maximale,Nla durée (en périodes),rle taux par période.
C = M × (1 − (1 + r)^(−N)) / r si r > 0
C = M × N si r = 0Le taux r est dérivé du taux nominal annuel divisé par la périodicité (interprétation V3) ou utilisé tel quel (interprétation legacy).
Interprétation du taux : pourquoi deux modes ?
Le backend historique /v3/Credit/credit-capital interprète le paramètre tauxNominal comme un taux par période, alors que l'UI legacy l'affiche comme un taux annuel. Cette ambiguïté produit des résultats incohérents entre la saisie et le retour API.
La refonte V3 clarifie ce point :
- Mode V3 (recommandé) : le taux saisi est un taux annuel. Le simulateur convertit en taux périodique (
taux / 100 / periodicite). - Mode legacy : le taux saisi est utilisé tel quel comme taux par période. À n'utiliser que pour cross-checker avec l'API historique.
Compatibilité payload legacy : periodicite=0 est interprété comme une périodicité mensuelle, et tauxNominal est accepté comme alias de tauxNominalAnnuel. Si tauxNominal est fourni sans interpretationTaux, le simulateur active automatiquement le mode legacy.
Export / Impression
- Export JSON : sauvegarde le plan et ses résultats pour partage ou archivage.
- Imprimer PDF : ouvre la boîte d'impression du navigateur pour produire une version imprimable.
Notes
- Les résultats sont des estimations et ne constituent pas une offre de prêt.
- Les assurances emprunteur et frais annexes ne sont pas pris en compte.
- Les données sont stockées uniquement en local (localStorage) : rien n'est envoyé sur un serveur.