{"name":"qotien-fr","version":"0.1.0","description":"API de calcul fiscal ET retraite français, sourcée et datée (millésime 2026). Chaque réponse porte confiance, sources et référentiel — le moteur ne devine jamais un fait. Fiscal = déterministe (confiance « fiable ») ; retraite = estimation cadrée avec confiance variable (estime/partiel/non_calculable), jamais un chiffre nu.","doctrine":{"confiance":true,"sources":true,"millesime_fiscal":"2026","referentiel":"references_officielles.json v0.8.6"},"plan_hints":{"fiscal":{"confiance":"fiable","nature":"déterministe","note":"IR, TMI, IFI, CEHR/CDHR, prélèvements sociaux, plus-values — résultat certain sur des entrées correctes."},"retraite":{"confiance":"variable","nature":"estimation cadrée","note":"Régimes en points = fiable/partiel selon le régime ; sans relevé de carrière (RIS) = fourchette + niveau de confiance ; RIS requis pour un total certain. Jamais un chiffre de pension nu."},"referentiel":{"confiance":"sourcée","nature":"fait daté","note":"Valeur + source primaire + référence légale + date de vérification + niveau de fiabilité ; millésime = referentiel (_meta.version), lu au runtime."}},"domaines":["fiscal","retraite","referentiel"],"endpoints":{"calculate":{"method":"POST","path":"/api/fiscal/v1/calculate","body":{"capability":"string","input":"object"}},"openapi":{"method":"GET","path":"/openapi.json","format":"OpenAPI 3.1"},"mcp":{"method":"POST","path":"/api/fiscal/v1/mcp","transport":"jsonrpc-2.0"}},"output_envelope":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"tarification":{"devise":"USDC","reseau":"eip155:8453","paliers":{"protocole":0,"bareme":50000,"etude":250000,"optimiseur":1000000},"note":"Montants en atomique USDC (6 décimales). Toute capacité livrant un fait est payante dès le premier appel, sur REST comme sur MCP. Un appel non réglé reçoit un HTTP 402 (x402 v2) sur les deux transports — en MCP, le corps porte à la fois les champs x402 (accepts) et une erreur JSON-RPC -32002 ; un client MCP incapable de payer voit une erreur de transport (l'appel n'a pas eu lieu). Aucune franchise anonyme ; évaluation via clé d'essai nominative (en-tête X-Qotien-Trial, délivrance manuelle). Une licence commerciale en euros existe pour un usage applicatif — contact@qotien.fr."},"capabilities":[{"name":"impot_revenu","domaine":"fiscal","confiance_defaut":"fiable","tarif":"bareme","title":"Impôt sur le revenu (barème 2026)","description":"Impôt sur le revenu brut d'un foyer (barème progressif, quotient familial plafonné, décote). Revenus 2025.","unit":"EUR","inputSchema":{"type":"object","additionalProperties":false,"required":["revenu_net_imposable"],"properties":{"revenu_net_imposable":{"type":"number","minimum":0,"description":"Revenu net imposable du foyer (€), après abattements."},"parts":{"type":"number","minimum":1,"default":1,"description":"Nombre de parts de quotient familial."},"situation":{"type":"string","enum":["Célibataire","Marié(e)","Pacsé(e)","Divorcé(e)","Veuf(ve)"],"default":"Célibataire","description":"Situation familiale (détermine les parts de base pour le plafonnement du QF et la décote)."}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["CGI art. 197","BOFiP BOI-IR-LIQ-20","LFI 2026 (barème + décote + plafond QF)"]},{"name":"tmi","domaine":"fiscal","confiance_defaut":"fiable","tarif":"bareme","title":"Taux marginal d'imposition (TMI)","description":"Tranche marginale d'imposition du foyer au barème 2026, en tenant compte du plafonnement du quotient familial. Renvoie le taux en POINTS DE POURCENTAGE (unit PERCENT, ex. 30 = 30 %) — à distinguer de prelevements_sociaux qui renvoie une fraction (unit RATE, 0-1).","unit":"PERCENT","inputSchema":{"type":"object","additionalProperties":false,"required":["revenu_net_imposable"],"properties":{"revenu_net_imposable":{"type":"number","minimum":0,"description":"Revenu net imposable du foyer (€)."},"parts":{"type":"number","minimum":1,"default":1,"description":"Nombre de parts de quotient familial."},"situation":{"type":"string","enum":["Célibataire","Marié(e)","Pacsé(e)","Divorcé(e)","Veuf(ve)"],"default":"Célibataire","description":"Situation familiale."}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["CGI art. 197","BOFiP BOI-IR-LIQ-20"]},{"name":"cehr","domaine":"fiscal","confiance_defaut":"fiable","tarif":"bareme","title":"Contribution exceptionnelle sur les hauts revenus (CEHR)","description":"CEHR due sur le revenu fiscal de référence (art. 223 sexies CGI). Distincte de la CDHR.","unit":"EUR","inputSchema":{"type":"object","additionalProperties":false,"required":["revenu_fiscal_reference"],"properties":{"revenu_fiscal_reference":{"type":"number","minimum":0,"description":"Revenu fiscal de référence du foyer (€)."},"situation":{"type":"string","enum":["Célibataire","Marié(e)","Pacsé(e)","Divorcé(e)","Veuf(ve)"],"default":"Célibataire","description":"Situation familiale (seuils célibataire 250 k / couple 500 k)."}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["CGI art. 223 sexies","BOFiP BOI-IR-CHR"]},{"name":"prelevements_sociaux","domaine":"fiscal","confiance_defaut":"fiable","tarif":"bareme","title":"Taux de prélèvements sociaux par nature de revenu","description":"Taux de PS applicable (17,2 % dérogatoire ou 18,6 % droit commun post-LFSS 2026) selon la nature du revenu du capital. Renvoie une FRACTION 0-1 (unit RATE, ex. 0,172) + un champ \"pourcentage\" (17,2) — à distinguer de tmi qui renvoie des points de pourcentage (unit PERCENT, 0-100).","unit":"RATE","inputSchema":{"type":"object","additionalProperties":false,"required":["type_revenu"],"properties":{"type_revenu":{"type":"string","enum":["rf_location_nue","pv_immo_particuliers","assurance_vie","pel_cel","pep","fonds_euros","rcm_dividendes","rcm_interets","pv_mobiliere","pea_post_2018","bic_lmnp","sci_is_dividendes","per_assurantiel_gains","per_bancaire_gains","actifs_numeriques","epargne_salariale","exit_tax","aga_gain_acquisition","bspce","stock_options_gain_acquisition"],"description":"Nature du revenu (ex. rf_location_nue, rcm_dividendes, bic_lmnp)."}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["LFSS 2026 art. 12 (loi 2025-1403)","CSS art. L.136-1 s."]},{"name":"surtaxe_pv_immobiliere","domaine":"fiscal","confiance_defaut":"fiable","tarif":"bareme","title":"Surtaxe sur les plus-values immobilières","description":"Taxe additionnelle sur les plus-values immobilières nettes imposables supérieures à 50 000 € (barème par tranches).","unit":"EUR","inputSchema":{"type":"object","additionalProperties":false,"required":["plus_value"],"properties":{"plus_value":{"type":"number","minimum":0,"description":"Plus-value nette imposable (€)."}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["CGI art. 1609 nonies G"]},{"name":"plus_value_immobiliere","domaine":"fiscal","confiance_defaut":"fiable","tarif":"etude","title":"Plus-value immobilière (IR + PS + surtaxe)","description":"Impôt total sur la plus-value de cession d'un bien immobilier hors résidence principale : IR 19 % + PS 17,2 % + surtaxe, APRÈS abattements pour durée de détention (exonération IR à 22 ans, PS à 30 ans). Réintègre les amortissements LMNP au réel dans le prix majoré (réforme 2025). Rend l'impôt total, chaque composante et le net vendeur. Exonérations gérées : résidence principale et cession < 15 000 €.","unit":"EUR","inputSchema":{"type":"object","additionalProperties":false,"required":["prix_acquisition","prix_cession","annees_detention"],"properties":{"prix_acquisition":{"type":"number","minimum":0,"description":"Prix d'acquisition du bien (€)."},"prix_cession":{"type":"number","minimum":0,"description":"Prix de cession (€)."},"annees_detention":{"type":"number","minimum":0,"description":"Durée de détention en années (abattements dès 6 ans ; exonération IR à 22 ans, PS à 30 ans)."},"residence_principale":{"type":"boolean","default":false,"description":"Si vrai : exonération totale (art. 150 U II 1° CGI)."},"lmnp_reel":{"type":"boolean","default":false,"description":"LMNP au réel : réintègre les amortissements déduits au prix d'acquisition majoré (réforme 2025)."},"amortissements_deduits":{"type":"number","minimum":0,"description":"Amortissements déduits à réintégrer si lmnp_reel (€)."},"frais_acquisition":{"type":"number","minimum":0,"description":"Frais d'acquisition réels (€). Absent → forfait 7,5 % du prix d'acquisition."},"frais_cession":{"type":"number","minimum":0,"description":"Frais de cession — diagnostics, agence… (€)."},"travaux":{"type":"number","minimum":0,"description":"Travaux (€). Absent → forfait 15 % du prix d'acquisition si détention ≥ 5 ans."}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["CGI art. 150 U à 150 VH","CGI art. 200 B (taux IR 19 %)","CGI art. 1609 nonies G (surtaxe)","LFSS 2026 (PS 17,2 % maintenu sur PV immobilière)"]},{"name":"per_plafond","domaine":"fiscal","confiance_defaut":"fiable","tarif":"bareme","title":"Plafond de déduction PER de l'année","description":"Plafond de versement PER déductible du revenu de l'année. Salarié (art. 163 quatervicies CGI) : 10 % des revenus pro et du PASS de l'année N-1 (versements 2026 → PASS 2025 = 47 100 €, plancher 4 710 €, max 37 680 €). TNS/BNC (art. 154 bis) : 10 % du bénéfice + 15 % de la fraction entre 1 et 8 PASS de l'année N (PASS 2026 = 48 060 €, plancher 4 806 €). Version « express » : un seul revenu, HORS reliquats et HORS mutualisation entre conjoints.","unit":"EUR","inputSchema":{"type":"object","additionalProperties":false,"required":["revenu_professionnel"],"properties":{"revenu_professionnel":{"type":"number","minimum":0,"description":"Revenu professionnel net (salaire net imposable, ou bénéfice pour un TNS/BNC) (€)."},"tns":{"type":"boolean","default":false,"description":"Vrai = TNS/BNC (art. 154 bis, tranche majorée 15 % entre 1 et 8 PASS) ; faux = salarié (art. 163 quatervicies)."}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["CGI art. 163 quatervicies (salariés)","CGI art. 154 bis (TNS/BNC)","PASS 2026 — arrêté 22/12/2025 (JO 23/12/2025)"]},{"name":"ifi","domaine":"fiscal","confiance_defaut":"fiable","tarif":"etude","title":"Impôt sur la fortune immobilière (IFI)","description":"IFI dû à partir du patrimoine immobilier taxable : limitation des dettes (art. 974, patrimoine > 5 M€), barème progressif (art. 977, seuil d'assujettissement 1,3 M€ mais barème dès 800 k€), décote (base 1,3–1,4 M€). Le plafonnement art. 979 (IFI + IR + PS ≤ 75 % des revenus) est appliqué SEULEMENT si revenu_foyer et autres_impots_annuels sont fournis — sinon l'IFI est rendu avant plafonnement. Version stateless : la base et les dettes sont des entrées (aucune lecture de dossier).","unit":"EUR","inputSchema":{"type":"object","additionalProperties":false,"required":["patrimoine_immobilier_taxable"],"properties":{"patrimoine_immobilier_taxable":{"type":"number","minimum":0,"description":"Valeur du patrimoine immobilier taxable BRUT (avant dettes) entrant dans l'assiette IFI (€) — résidence principale après abattement 30 %, biens locatifs, SCPI part immobilière, etc."},"dettes":{"type":"number","minimum":0,"default":0,"description":"Dettes déductibles rattachées à l'immobilier taxable (€). La limitation art. 974 s'applique au-delà de 5 M€ de patrimoine."},"revenu_foyer":{"type":"number","minimum":0,"description":"Revenus du foyer de l'année (€). Fourni → déclenche le plafonnement art. 979. Absent → IFI rendu avant plafonnement."},"autres_impots_annuels":{"type":"number","minimum":0,"default":0,"description":"IR + prélèvements sociaux + CEHR déjà dus au titre de l'année (€), pour le calcul du plafonnement art. 979. Ignoré si revenu_foyer absent."}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["CGI art. 964 (seuil 1,3 M€)","CGI art. 977 (barème + décote)","CGI art. 974 (limitation des dettes)","CGI art. 979 (plafonnement 75 %)"]},{"name":"cdhr","domaine":"fiscal","confiance_defaut":"fiable","tarif":"etude","title":"Contribution différentielle sur les hauts revenus (CDHR)","description":"CDHR due (art. 224 CGI) : imposition minimale de 20 % du RFR ajusté − imposition effective (IR au barème + PFU 12,8 % sur les revenus financiers + CEHR + majorations 12 500 €/couple et 1 500 €/personne à charge), après décote art. 224 V. DISTINCTE de la CEHR (art. 223 sexies). Version stateless.","unit":"EUR","inputSchema":{"type":"object","additionalProperties":false,"required":["revenu_fiscal_reference"],"properties":{"revenu_fiscal_reference":{"type":"number","minimum":0,"description":"RFR du foyer (€)."},"parts":{"type":"number","minimum":1,"default":1,"description":"Parts de quotient familial."},"situation":{"type":"string","enum":["Célibataire","Marié(e)","Pacsé(e)","Divorcé(e)","Veuf(ve)"],"default":"Célibataire","description":"Situation familiale (seuils célib 250 k / couple 500 k, majoration 12 500 € couple)."},"revenus_financiers_pfu":{"type":"number","minimum":0,"default":0,"description":"Revenus financiers imposés au PFU 12,8 % (dividendes + intérêts) inclus dans le RFR (€) — corrige l'imposition de référence."},"nb_personnes_charge":{"type":"number","minimum":0,"default":0,"description":"Personnes à charge (majoration 1 500 € chacune de l'imposition de référence)."},"rfr_ajuste":{"type":"number","minimum":0,"description":"RFR ajusté art. 224 II (assiette CDHR) si connu. Absent → = RFR."},"impot_reference":{"type":"number","minimum":0,"description":"Imposition effective exacte de la déclaration (€). Absent → reconstruite (IR barème + PFU + CEHR + majorations)."}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["CGI art. 224 (CDHR)","CGI art. 223 sexies (CEHR)","FAQ CDHR impots.gouv.fr"]},{"name":"per_gain","domaine":"fiscal","confiance_defaut":"fiable","tarif":"etude","title":"Gain d'impôt d'un versement PER","description":"Économie d'impôt TOTALE d'un versement PER déductible = Δ(IR au barème + CEHR + CDHR). Le versement réduit le RFR ; pour un foyer plafonné par la CDHR le gain marginal réel est ≈ 20 % (PAS la TMI) → recalcul complet, jamais TMI × versement. Version stateless.","unit":"EUR","inputSchema":{"type":"object","additionalProperties":false,"required":["versement","revenu_fiscal_reference"],"properties":{"versement":{"type":"number","minimum":0,"description":"Versement PER déductible envisagé (€)."},"revenu_fiscal_reference":{"type":"number","minimum":0,"description":"RFR du foyer AVANT versement (€)."},"parts":{"type":"number","minimum":1,"default":1,"description":"Parts de quotient familial."},"situation":{"type":"string","enum":["Célibataire","Marié(e)","Pacsé(e)","Divorcé(e)","Veuf(ve)"],"default":"Célibataire","description":"Situation familiale."},"revenus_financiers_pfu":{"type":"number","minimum":0,"default":0,"description":"Revenus financiers au PFU inclus dans le RFR (€) — pour le calcul CDHR."},"nb_personnes_charge":{"type":"number","minimum":0,"default":0,"description":"Personnes à charge (majoration CDHR)."}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["CGI art. 163 quatervicies (déductibilité PER)","CGI art. 197 (barème/décote)","CGI art. 223 sexies (CEHR)","CGI art. 224 (CDHR)"]},{"name":"niches_plafond","domaine":"fiscal","confiance_defaut":"fiable","tarif":"etude","title":"Plafonnement global des niches fiscales","description":"Réduction d'IR effective et plafonnement global des avantages fiscaux (art. 200-0 A CGI) : plafond 10 000 € (18 000 € si SOFICA / Girardin / Pinel Outre-Mer). Certaines niches sont HORS plafond (dons Coluche, Malraux, Monuments historiques, déficit foncier, PER). La liste des niches est fournie en entrée.","unit":"EUR","inputSchema":{"type":"object","additionalProperties":false,"required":["niches"],"properties":{"niches":{"type":"array","description":"Liste des avantages : [{type, montant}]. `type` = libellé de niche (ex. \"Emploi à domicile\", \"FCPI\", \"SOFICA\", \"Dons organismes intérêt général\").","items":{"type":"object","additionalProperties":false,"required":["type","montant"],"properties":{"type":{"type":"string"},"montant":{"type":"number","minimum":0}}}}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["CGI art. 200-0 A (plafonnement global)","CGI art. 200 (dons)"]},{"name":"flat_tax_vs_bareme","domaine":"fiscal","confiance_defaut":"fiable","tarif":"etude","title":"PFU (flat tax) vs barème progressif","description":"Compare l'imposition d'un revenu du capital au PFU (12,8 % IR + PS) vs à l'option barème (case 2OP : abattement 40 % dividendes, CSG 6,8 % déductible, IR marginal), et dit quelle option est la plus favorable. Taux PS 2026 par nature (18,6 % mobilier, 17,2 % AV/immo). Version stateless.","unit":"EUR","inputSchema":{"type":"object","additionalProperties":false,"required":["type_revenu","montant","revenu_net_imposable"],"properties":{"type_revenu":{"type":"string","enum":["dividendes","interets","pv_mobiliere","crypto","pea","immo","av_plus8ans","av_moins8ans"],"description":"Nature du revenu du capital."},"montant":{"type":"number","minimum":0,"description":"Montant du revenu / gain (€)."},"revenu_net_imposable":{"type":"number","minimum":0,"description":"Revenu net imposable du foyer HORS ce revenu (€) — détermine la TMI pour l'option barème."},"parts":{"type":"number","minimum":1,"default":1,"description":"Parts de quotient familial."},"situation":{"type":"string","enum":["Célibataire","Marié(e)","Pacsé(e)","Divorcé(e)","Veuf(ve)"],"default":"Célibataire","description":"Situation familiale."},"av_encours":{"type":"number","minimum":0,"description":"Pour av_plus8ans : encours total des primes (détermine le taux réduit 7,5 % vs 12,8 %) (€)."}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["CGI art. 200 A (PFU + option 2OP)","CGI art. 158-3-2° (abattement 40 %)","CGI art. 154 quinquies (CSG déductible)","LFSS 2026 art. 12 (PS par nature)"]},{"name":"jeanbrun","domaine":"fiscal","confiance_defaut":"fiable","tarif":"etude","title":"Dispositif Jeanbrun (amortissement bailleur, LF 2026)","description":"Nouveau dispositif d'amortissement du bailleur privé (LF 2026 art. 47, successeur de Pinel), fenêtre 21/02/2026 → 31/12/2028. Amortit 80 % du prix du logement au taux du couple logement (neuf / ancien rénové) × location (intermédiaire / social / très social), plafonné par an et par foyer, déductible du revenu foncier imposé à TMI + PS 17,2 %. Calcule l'amortissement annuel retenu et l'économie d'impôt (an et sur 9 ans). La TMI est fournie ou dérivée du revenu net imposable. ⚠️ BOFiP dédié attendu S2 2026 (calcul fondé sur le texte de loi). Version stateless.","unit":"EUR","inputSchema":{"type":"object","additionalProperties":false,"required":["prix_logement"],"properties":{"prix_logement":{"type":"number","minimum":0,"description":"Prix du logement (€). L'assiette amortissable = 80 % (terrain forfait 20 %)."},"type_logement":{"type":"string","enum":["Neuf","Ancien rénové"],"default":"Neuf","description":"Neuf ou ancien rénové (taux d'amortissement différents)."},"type_location":{"type":"string","enum":["Intermédiaire","Social","Très social"],"default":"Intermédiaire","description":"Catégorie de location (taux et plafond annuel croissants)."},"revenu_net_imposable":{"type":"number","minimum":0,"description":"Revenu net imposable du foyer (€) — sert à dériver la TMI pour l'économie d'impôt. Ignoré si tmi_pourcentage fourni."},"parts":{"type":"number","minimum":1,"default":1,"description":"Parts de quotient familial (pour la TMI dérivée)."},"situation":{"type":"string","enum":["Célibataire","Marié(e)","Pacsé(e)","Divorcé(e)","Veuf(ve)"],"default":"Célibataire","description":"Situation familiale (pour la TMI dérivée)."},"tmi_pourcentage":{"type":"number","minimum":0,"maximum":45,"description":"TMI en points de % (ex. 30) si connue — court-circuite la dérivation depuis le revenu."}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["LF 2026 art. 47 (loi n° 2026-103 du 19/02/2026)","CGI (amortissement bailleur — dispositif Jeanbrun)","BOFiP dédié attendu S2 2026"]},{"name":"ps_pension","domaine":"retraite","confiance_defaut":"fiable","tarif":"bareme","title":"Prélèvements sociaux sur une pension (brut → net)","description":"CSG (taux 0/3,8/6,6/8,3 % selon le RFR et les parts) + CRDS + CASA + 1 % maladie sur la part de pension complémentaire. Rend la pension nette, la tranche CSG et le taux effectif. Barème 2026 (seuils RFR 2024).","unit":"EUR","inputSchema":{"type":"object","additionalProperties":false,"required":["pension_annuelle_brute"],"properties":{"pension_annuelle_brute":{"type":"number","minimum":0,"description":"Pension annuelle brute totale (€)."},"rfr":{"type":"number","minimum":0,"description":"Revenu fiscal de référence 2024 du foyer (€) — détermine la tranche CSG. Si absent, la pension sert de proxy et la tranche est « estimée »."},"parts":{"type":"number","minimum":1,"default":1,"description":"Parts fiscales du foyer (interpolation linéaire des seuils entre 1 et 2 parts)."},"montant_complementaire":{"type":"number","minimum":0,"description":"Part de la pension relevant d'un régime complémentaire (Agirc-Arrco, Ircantec, CRPN, comp. libéraux…), soumise en plus au 1 % maladie aux tranches médiane/normale. Défaut 0 = base seule."}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["CSS art. L136-8 (CSG pensions)","CSS art. L131-2 (1 % maladie retraite complémentaire)","Barème CSG des pensions 2026 (seuils RFR 2024, circulaire CNAV 22/12/2025)"]},{"name":"estimation","domaine":"retraite","confiance_defaut":"estime","tarif":"etude","title":"Estimation de pension (données partielles)","description":"Pension approchée à partir du statut, du revenu, de l'âge et de l'âge de départ : carrière reconstituée, SAM plafonné au PASS, décote. Rend un point central, une fourchette et un niveau de confiance. Ce N'est PAS un calcul certain — il remplace un relevé de carrière (RIS) manquant, pas l'inverse.","unit":"EUR","inputSchema":{"type":"object","additionalProperties":false,"required":["statut","revenu_net_imposable","age"],"properties":{"statut":{"type":"string","description":"Statut (insensible à la casse et aux accents). Valeurs reconnues : \"salarié cadre\", \"salarié non-cadre\" (ou \"salarié\" seul = non-cadre), \"fonctionnaire\", \"profession libérale\" / \"TNS\" / \"indépendant\" (= libéral)."},"revenu_net_imposable":{"type":"number","minimum":0,"description":"Revenu net imposable annuel actuel (€)."},"age":{"type":"number","minimum":16,"description":"Âge actuel (ans)."},"age_depart":{"type":"number","minimum":50,"default":64,"description":"Âge de départ souhaité (défaut 64)."},"annee_debut_carriere":{"type":"number","description":"Année de début de carrière — resserre la fourchette si fournie."},"trimestres_acquis":{"type":"number","minimum":0,"description":"Trimestres déjà acquis (RIS) — resserre la fourchette si fourni."},"traitement_indiciaire":{"type":"number","minimum":0,"description":"Fonctionnaire uniquement : dernier traitement indiciaire brut annuel, hors primes."}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["CNAV — taux plein 50 %, SAM 25 meilleures années plafonné au PASS","Agirc-Arrco — barème de points 2026","PASS 2026 = 48 060 €","Fonction publique — 75 % du traitement indiciaire"]},{"name":"pension_regime","domaine":"retraite","confiance_defaut":"fiable","tarif":"etude","title":"Pension d'un régime en points (Agirc-Arrco, complémentaires, bases CNAVPL)","description":"Pension brute d'UN régime calculé en points (points × valeur de service 2026 × coefficient). Couvre Agirc-Arrco, Ircantec, RCI, RAFP, les 10 bases CNAVPL libérales et les complémentaires/ASV de caisse (CARMF, CIPAV, CARPIMKO, CARCDSF, CAVEC…). Contrôle de vraisemblance intégré (anti-erreur de sous-régime). Pour un régime en annuités/SAM (CNAV) ou en traitement (fonction publique), utiliser retraite_estimation.","unit":"EUR","inputSchema":{"type":"object","additionalProperties":false,"required":["code_regime","points"],"properties":{"code_regime":{"type":"string","enum":["agirc_arrco","ircantec","rci","rafp","cipav_base","carmf_base","carpimko_base","carcdsf_base","cavec_base","cavom_base","cavamac_base","carpv_base","cprn_base","cavp_base","cipav_comp","carmf_rcv","carmf_asv","carpimko_comp","carpimko_asv","carcdsf_comp","cnbf_comp","cavec_comp","cavom_comp","cavamac_comp","carpv_comp","cprn_b","cprn_c","ircec_raap"],"description":"Code du régime (voir la capacité retraite_regimes pour la liste). Ex. agirc_arrco, carmf_rcv, cipav_base."},"points":{"type":"number","minimum":0,"description":"Nombre de points acquis dans ce régime (relevé de carrière / relevé de caisse)."},"age_depart":{"type":"number","minimum":50,"description":"Âge de liquidation (ans). Défaut = taux plein (pas de décote ni de majoration). Un départ anticipé/reporté applique le coefficient du régime."},"age_legal":{"type":"number","minimum":60,"default":64,"description":"Âge légal du régime (ancre du temps choisi). Défaut 64."},"trimestres_manquants":{"type":"number","minimum":0,"description":"Trimestres manquants pour le taux plein — décote sur les régimes qui l'appliquent (complémentaires salariés). Défaut 0."},"trimestres_acquis":{"type":"number","minimum":0,"description":"Bases CNAVPL uniquement : trimestres tous régimes acquis (pour le prorata/décote). Défaut 0."},"trimestres_requis":{"type":"number","minimum":1,"default":172,"description":"Bases CNAVPL uniquement : trimestres requis pour le taux plein. Défaut 172."}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["references_officielles.json v0.8.6 (valeurs de service 2026)","retraite_registre.js (routage 47 régimes, source unique)","retraite_engine.js (formules golden-testées, exemples officiels)"]},{"name":"pension_annuites","domaine":"retraite","confiance_defaut":"fiable","tarif":"etude","title":"Pension d'un régime en ANNUITÉS (fonction publique, régimes spéciaux, IEG-CNIEG)","description":"Pension brute d'UN régime en annuités : traitement/salaire de référence × 75 % × (trimestres liquidables ÷ requis) × coefficient de décote. Couvre la fonction publique (SRE/CNRACL), les régimes spéciaux FP-like (SNCF, RATP, Banque de France, CRPCEN, Opéra, Comédie-Française, FSPOEIE) et l'IEG (CNIEG — EDF/GDF/Engie/Enedis/RTE/GRDF). Pour un régime EN POINTS (Agirc-Arrco, complémentaires, bases CNAVPL), utiliser retraite_pension_regime.","unit":"EUR","inputSchema":{"type":"object","additionalProperties":false,"required":["code_regime","salaire_reference"],"properties":{"code_regime":{"type":"string","enum":["fonction_publique","fspoeie","sncf","ratp","banque_de_france","crpcen","opera","comedie_francaise","ieg"],"description":"Code du régime en annuités (voir retraite_regimes). Ex. fonction_publique, sncf, ratp, banque_de_france, ieg."},"salaire_reference":{"type":"number","minimum":0,"description":"Assiette annuelle brute : dernier traitement indiciaire (fonction publique) ou salaire/traitement de référence des derniers mois (régimes spéciaux, IEG), HORS primes."},"trimestres_liquidables":{"type":"number","minimum":0,"default":0,"description":"Trimestres liquidés au régime (numérateur du prorata durée liquidée ÷ requise)."},"trimestres_requis":{"type":"number","minimum":1,"default":172,"description":"Durée d'assurance requise pour le taux plein (défaut 172)."},"age_depart":{"type":"number","minimum":50,"description":"Âge de liquidation (ans). Défaut = taux plein (aucune décote). Un départ avant l'âge d'annulation applique la décote 1,25 %/trim (plafond 20)."},"age_legal":{"type":"number","minimum":60,"default":64,"description":"Âge légal du régime (ancre du temps). Défaut 64."}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["references_officielles.json v0.8.6","retraite_registre.js (routage, source unique)","retraite_engine.js (formules golden-testées ; fonction publique = exemple officiel SRE)"]},{"name":"pension_totale","domaine":"retraite","confiance_defaut":"fiable","tarif":"etude","title":"Pension totale consolidée (multi-régimes, le détail du RIS)","description":"Somme les régimes EN POINTS d'un relevé (base CNAVPL + tous les complémentaires/ASV), splitte base/complémentaire, applique la couche brut→net (1 % maladie sur la seule part complémentaire). Le régime de base salarié (CNAV) et la fonction publique ne sont pas en points : les fournir via pensions_fournies (issues de retraite_estimation ou du RIS) pour un total réellement total. Chaque jambe est vraisemblance-vérifiée ; la confiance globale suit la jambe la plus faible.","unit":"EUR","inputSchema":{"type":"object","additionalProperties":false,"required":["regimes"],"properties":{"regimes":{"type":"array","description":"Régimes en points du relevé. Chaque item : { code_regime, points, [age_depart, age_legal, trimestres_manquants, trimestres_acquis, trimestres_requis] }.","items":{"type":"object","additionalProperties":false,"required":["code_regime","points"],"properties":{"code_regime":{"type":"string","enum":["agirc_arrco","ircantec","rci","rafp","cipav_base","carmf_base","carpimko_base","carcdsf_base","cavec_base","cavom_base","cavamac_base","carpv_base","cprn_base","cavp_base","cipav_comp","carmf_rcv","carmf_asv","carpimko_comp","carpimko_asv","carcdsf_comp","cnbf_comp","cavec_comp","cavom_comp","cavamac_comp","carpv_comp","cprn_b","cprn_c","ircec_raap"]},"points":{"type":"number","minimum":0},"age_depart":{"type":"number","minimum":50},"age_legal":{"type":"number","minimum":60},"trimestres_manquants":{"type":"number","minimum":0},"trimestres_acquis":{"type":"number","minimum":0},"trimestres_requis":{"type":"number","minimum":1}}}},"pensions_fournies":{"type":"array","description":"Jambes NON calculées par nous (ex. CNAV base, fonction publique) : { label, montant_annuel, [etage:\"base\"|\"complementaire\"] }. Additionnées telles quelles, flaggées « fourni » (confiance non assertée par le hub).","items":{"type":"object","additionalProperties":false,"required":["montant_annuel"],"properties":{"label":{"type":"string"},"montant_annuel":{"type":"number","minimum":0},"etage":{"type":"string","enum":["base","complementaire"]}}}},"rfr":{"type":"number","minimum":0,"description":"RFR 2024 du foyer — active le calcul du net (prélèvements sociaux). Sinon le total brut sert de proxy."},"parts":{"type":"number","minimum":1,"default":1,"description":"Parts fiscales du foyer."},"inclure_net":{"type":"boolean","default":true,"description":"Calculer la pension nette après prélèvements sociaux (défaut true)."}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["retraite_registre.js (routage 47 régimes)","retraite_engine.js (formules golden-testées)","CSS art. L136-8/L131-2 (prélèvements sociaux + 1 % maladie complémentaire)"]},{"name":"regimes","domaine":"retraite","confiance_defaut":"fiable","tarif":"bareme","title":"Liste des régimes de retraite calculables par points","description":"Découverte : renvoie les régimes en points calculables via retraite_pension_regime (code, libellé, machine, étage, valeur de service 2026, taux de réversion). Filtrable par famille.","unit":"LIST","inputSchema":{"type":"object","additionalProperties":false,"required":[],"properties":{"famille":{"type":"string","enum":["salarie","independant","liberal","fonction_publique","agricole"],"description":"Filtrer par famille (facultatif)."}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["retraite_registre.js (source unique des 47 régimes)","references_officielles.json v0.8.6"]},{"name":"optimisation","domaine":"retraite","confiance_defaut":"estime","tarif":"optimiseur","title":"Optimisation de fin de carrière (menu classé des leviers)","description":"À partir d'une situation (âge, trimestres, SAM, statut, enfants…), renvoie le MENU CLASSÉ des leviers d'optimisation retraite avec gain/ROI/confiance/sources : rachat de trimestres (2 options), surcote parentale, retraite progressive, âge de départ optimal, cumul emploi-retraite, optimisation du SAM, PER fin de carrière. PAS de total sommé (les leviers ne s'additionnent pas naïvement) — chaque levier chiffré séparément, classé par pertinence. Chaque montant porte sa confiance et sa source (Legifrance/BOFiP/service-public).","unit":"EUR","inputSchema":{"type":"object","additionalProperties":false,"required":["age"],"properties":{"age":{"type":"number","minimum":16,"description":"Âge actuel (ans)."},"age_legal":{"type":"number","minimum":60,"default":64,"description":"Âge légal de départ (défaut 64)."},"date_naissance":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Date de naissance (YYYY-MM-DD) — recale le gel LFSS 2026 et la fenêtre surcote parentale."},"statut":{"type":"string","description":"Statut (insensible à la casse/accents). Reconnus : \"salarié\" (défaut), \"fonctionnaire\", \"profession libérale\" / \"TNS\" / \"indépendant\"."},"sam":{"type":"number","minimum":0,"description":"Salaire annuel moyen (25 meilleures années) — active les gains chiffrés."},"trimestres_acquis":{"type":"number","minimum":0},"trimestres_requis":{"type":"number","minimum":1,"default":172},"trim_manquants":{"type":"number","minimum":0,"description":"Trimestres manquants pour le taux plein — active le levier rachat."},"pension_brute_annuelle":{"type":"number","minimum":0,"description":"Pension de base brute annuelle — active les gains nets."},"pension_complementaire_annuelle":{"type":"number","minimum":0},"nb_enfants":{"type":"number","minimum":0,"description":"Nombre d'enfants — active surcote parentale (MDA) + majoration ≥3."},"mda_parentale":{"type":"boolean","description":"≥1 trimestre de majoration de durée d'assurance pour enfant."},"tmi":{"type":"number","minimum":0,"maximum":1,"description":"TMI en FRACTION 0-1 (ex. 0,30 pour 30 %) — chiffre l'économie d'IR du rachat / PER. ⚠️ l'outil \"tmi\" RENVOIE un pourcentage (30) ; ici on attend la fraction (0,30)."},"rfr":{"type":"number","minimum":0,"description":"RFR — active le net (prélèvements sociaux)."},"parts":{"type":"number","minimum":1,"default":1},"quotite_travail":{"type":"number","minimum":0.1,"maximum":1,"description":"Retraite progressive : quotité de temps partiel (0-1)."},"salaires_annuels":{"type":"array","description":"Optionnel : carrière année par année pour l'optimisation du SAM.","items":{"type":"object","additionalProperties":false,"required":["annee","salaire_brut"],"properties":{"annee":{"type":"number","description":"Année civile (ex. 2018)."},"salaire_brut":{"type":"number","minimum":0,"description":"Salaire brut de cette année (€)."}}}}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["CSS art. L351-14-1 (rachat), L351-1-2-1 (surcote parentale), L161-22-1-5 (retraite progressive), L161-22 (cumul)","Circulaire CNAV 2026-04 (barème VPLR)","Service-Public F15675/F16336/F12842/F13243","retraite_engine.js (leviers golden-testés, exemples officiels)"]},{"name":"rachat","domaine":"retraite","confiance_defaut":"fiable","tarif":"etude","title":"Rachat de trimestres (VPLR — coût, gain, ROI)","description":"Coût et rentabilité d'un rachat de trimestres (versement pour la retraite, art. L351-14-1). Barème 2026 (Circulaire CNAV 2026-04) selon âge/option/revenu, 2 options (taux seul / taux et durée), coût net d'IR (déductible), gain de pension et ROI en années. Gère le rachat d'études (abattement ≤ 40 ans) et de stage (12 % PMSS). Plafond légal 12 trimestres tous motifs.","unit":"EUR","inputSchema":{"type":"object","additionalProperties":false,"required":["age","n_trim"],"properties":{"age":{"type":"number","minimum":20,"maximum":66,"description":"Âge au rachat (20-66)."},"n_trim":{"type":"number","minimum":1,"maximum":12,"description":"Nombre de trimestres à racheter (max 12 tous motifs)."},"option":{"type":"string","enum":["taux","taux_duree"],"default":"taux","description":"\"taux\" (taux seul) ou \"taux_duree\" (taux et durée). Le stage est taux seul uniquement."},"motif":{"type":"string","enum":["etudes","incompletes","stage"],"description":"Études (abattement ≤ 40 ans), années incomplètes, ou stage (12 % PMSS, ≤ 30 ans, max 2)."},"revenu_moyen":{"type":"number","minimum":0,"description":"Moyenne des revenus des 3 dernières années (D351-8) — détermine la tranche du barème."},"sam":{"type":"number","minimum":0,"description":"SAM (25 meilleures années) — chiffre le gain de pension."},"tmi":{"type":"number","minimum":0,"maximum":1,"description":"TMI en FRACTION 0-1 (ex. 0,30 pour 30 %) — chiffre l'économie d'IR (rachat déductible). ⚠️ l'outil \"tmi\" RENVOIE un pourcentage (30) ; ici on attend la fraction (0,30)."},"trim_acquis":{"type":"number","minimum":0},"trim_requis":{"type":"number","minimum":1,"default":172},"trim_manquants":{"type":"number","minimum":0,"description":"Trimestres manquants pour le taux plein (pilote la décote et le gain)."},"pension_brute_annuelle":{"type":"number","minimum":0,"description":"Pension brute annuelle — chiffre le gain net."},"rfr":{"type":"number","minimum":0},"parts":{"type":"number","minimum":1,"default":1}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["CSS art. L351-14-1, D351-14 à D351-18","Circulaire CNAV 2026-04 (barème VPLR)","Service-Public F15675","Service-Public F19666 (gain décote)"]},{"name":"surcote_parentale","domaine":"retraite","confiance_defaut":"estime","tarif":"bareme","title":"Surcote parentale (+1,25 %/trim, max 5 %)","description":"Majoration de pension pour les parents au taux plein un an avant l'âge légal (art. L351-1-2-1). 1,25 % par trimestre travaillé dans la fenêtre [âge légal − 1 an ; âge légal), plafonné à 4 trimestres (5 %). Conditions : âge légal ≥ 63 ans, durée requise atteinte, ≥ 1 trimestre de majoration enfant (MDA). Gère le gel LFSS 2026.","unit":"EUR","inputSchema":{"type":"object","additionalProperties":false,"required":[],"properties":{"date_naissance":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Date de naissance (YYYY-MM-DD) — détermine l'âge légal + le gel LFSS 2026."},"age_legal":{"type":"number","minimum":60,"description":"Alternative à la date de naissance : âge légal en années."},"age":{"type":"number","minimum":16},"trimestres_acquis":{"type":"number","minimum":0},"trimestres_requis":{"type":"number","minimum":1,"default":172},"mda_parentale":{"type":"boolean","description":"≥ 1 trimestre de MDA pour enfant (maternité/adoption/éducation)."},"nb_enfants":{"type":"number","minimum":0,"description":"À défaut de mda_parentale : ≥ 1 enfant → hypothèse de MDA."},"trimestres_cotises_fenetre":{"type":"number","minimum":0,"maximum":4,"description":"Trimestres cotisés dans la fenêtre [âge légal − 1 ; âge légal) — sinon estimé."},"pension_brute_annuelle":{"type":"number","minimum":0,"description":"Pension de base brute annuelle — chiffre le gain en €."},"rfr":{"type":"number","minimum":0},"parts":{"type":"number","minimum":1,"default":1}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["CSS art. L351-1-2-1, D351-1-4","CSS art. L351-4/L351-4-1/L351-5 (MDA)","Service-Public F16336"]},{"name":"progressive","domaine":"retraite","confiance_defaut":"estime","tarif":"etude","title":"Retraite progressive (fraction de pension + temps partiel)","description":"Fraction de pension perçue en travaillant à temps partiel en fin de carrière (art. L161-22-1-5). Depuis le 01/09/2025, accessible dès 60 ans (décret 2025-681) avec 150 trimestres. Fraction = 100 % − quotité travaillée (salarié 40-80 %, fonction publique 50-90 %, TNS : baisse de revenus 20-60 %). Continue d'acquérir des droits.","unit":"EUR","inputSchema":{"type":"object","additionalProperties":false,"required":["age","trimestres","quotite_travail"],"properties":{"age":{"type":"number","minimum":55,"description":"Âge actuel (≥ 60 depuis le 01/09/2025)."},"trimestres":{"type":"number","minimum":0,"description":"Trimestres acquis (≥ 150 requis)."},"quotite_travail":{"type":"number","minimum":0.1,"maximum":1,"description":"Quotité de temps partiel (0-1). Salarié 0,40-0,80 ; FP 0,50-0,90."},"diminution_revenus":{"type":"number","minimum":0,"maximum":1,"description":"TNS uniquement : baisse de revenus (0,20-0,60) — alternative à quotite_travail."},"statut":{"type":"string","description":"Statut (insensible à la casse/accents). Reconnus : \"salarié\" (défaut), \"fonctionnaire\", \"profession libérale\" / \"TNS\" / \"indépendant\". Détermine la plage de quotité."},"date_naissance":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD — recale l'âge min pour une date d'effet < 01/09/2025."},"date_effet":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Date d'effet de la retraite progressive (YYYY-MM-DD)."},"pension_brute_annuelle":{"type":"number","minimum":0,"description":"Pension totale brute annuelle (base + comp.) — chiffre la fraction en €."},"rfr":{"type":"number","minimum":0},"parts":{"type":"number","minimum":1,"default":1}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["CSS art. L161-22-1-5, D161-2-24 (décret 2025-681), R351-39, R351-41","Service-Public F12842"]},{"name":"valeur","domaine":"referentiel","confiance_defaut":"sourcee","tarif":"bareme","title":"Valeur du référentiel (sourcée + datée)","description":"La valeur 2026 d'une constante fiscale ou retraite par sa clé publique stable, avec sa source primaire, sa référence légale, sa date de vérification et son niveau de fiabilité. Jamais un chiffre nu.","unit":null,"inputSchema":{"type":"object","additionalProperties":false,"required":["cle"],"properties":{"cle":{"type":"string","description":"Clé publique stable (liste via referentiel_recherche). Ex. pass, cehr_seuil_celibataire, reversion_plafond_couple, carmf_rcv_valeur_point."}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["references_officielles.json v0.8.6"]},{"name":"recherche","domaine":"referentiel","confiance_defaut":"sourcee","tarif":"bareme","title":"Recherche dans le référentiel","description":"Liste les clés publiques du référentiel, filtrables par domaine (fiscal/retraite) et/ou par mot-clé. Renvoie un résumé par clé (valeur, libellé, fiabilité) ; utiliser referentiel_valeur pour le détail sourcé complet.","unit":null,"inputSchema":{"type":"object","additionalProperties":false,"properties":{"domaine":{"type":"string","enum":["fiscal","retraite","succession"],"description":"Filtre par domaine."},"q":{"type":"string","description":"Mot-clé cherché dans la clé publique ou le libellé."}}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["references_officielles.json v0.8.6"]},{"name":"versions","domaine":"referentiel","confiance_defaut":"sourcee","tarif":"protocole","title":"Versions et fraîcheur du référentiel","description":"Millésime courant, historique des versions, cadence et prochaine revue globale, niveaux de fiabilité — pour savoir de quand datent les valeurs et quand elles seront re-vérifiées.","unit":null,"inputSchema":{"type":"object","additionalProperties":false,"properties":{}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["references_officielles.json v0.8.6"]},{"name":"capacites","domaine":"qotien","confiance_defaut":"fiable","tarif":"protocole","title":"Capacités de Qotien (carte de planification)","description":"Ce que le moteur sait faire et avec quelle fiabilité, par domaine — à appeler AVANT de choisir un outil, pour planifier et savoir quand hédger. Ne calcule rien.","unit":null,"inputSchema":{"type":"object","additionalProperties":false,"properties":{}},"outputSchema":{"type":"object","required":["ok","domaine","capability","result","confiance","sources","millesime_fiscal"],"properties":{"ok":{"type":"boolean","description":"true = succès ; false = erreur (champ \"error\" présent à la place de result)."},"domaine":{"type":"string","enum":["fiscal","retraite","referentiel","qotien"],"description":"Domaine de la capacité."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"result":{"type":"object","description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.","properties":{"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}}},"confiance":{"type":"string","enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."},"annee_revenus":{"type":"number","description":"Année des revenus concernés."},"avertissement":{"type":"string","description":"Avertissement d'usage (résultat brut, pas un conseil personnalisé)."}}},"sources":["/api/fiscal/v1/manifest","references_officielles.json v0.8.6"]}],"avertissement":"Calcul déterministe indicatif fondé sur le référentiel fiscal français 2026 (revenus 2025). Résultat brut d'un moteur de calcul, il ne constitue pas un conseil personnalisé au sens de la réglementation CIF/DDA."}