{"uid":"cap_hoBiDS7nQgnvpjVS4JDfn","slug":"qotien-surtaxe-plus-value-immobili-re-a6cb9aa8","name":"Qotien — Surtaxe Plus-Value Immobilière","description":"Simulateur IFI, PER, IR et retraite (32 régimes). Logiciel CGP : bilan patrimonial, déclaration 2042, LMNP. Chiffres sourcés Légifrance et BOFiP. 14 jours d'essai.","url":"https://app.qotien.fr/api/fiscal/v1/calc/surtaxe_pv_immobiliere","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"plus_value":{"type":"number","minimum":0,"description":"Plus-value nette imposable (€)."}}},"responseSchema":{"type":"json","schema":{"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)."},"result":{"type":"object","properties":{"unit":{"type":"string","description":"Unité de value (EUR, PERCENT, RATE…)."},"label":{"type":"string","description":"Libellé lisible du résultat."},"value":{"type":"number","description":"Valeur principale (quand le résultat est scalaire)."},"confiance":{"enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"type":"string","description":"Confiance propre au résultat retraite (prime sur la confiance de capacité)."}},"description":"Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime."},"domaine":{"enum":["fiscal","retraite","referentiel","qotien"],"type":"string","description":"Domaine de la capacité."},"sources":{"type":"array","items":{"type":"string"},"description":"Sources primaires/légales du calcul."},"confiance":{"enum":["fiable","estime","partiel","non_calculable","sourcee","variable"],"type":"string","description":"Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."},"capability":{"type":"string","description":"Nom de la capacité appelée."},"referentiel":{"type":"string","description":"Version du référentiel sourcé utilisé."},"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é)."},"millesime_fiscal":{"type":"string","description":"Millésime fiscal (année des barèmes appliqués)."}}},"example":{"ok":true,"result":{"unit":"EUR","label":"Surtaxe sur les plus-values immobilières","value":0},"domaine":"fiscal","sources":["CGI art. 1609 nonies G"],"confiance":"fiable","capability":"surtaxe_pv_immobiliere","referentiel":"references_officielles.json v0.8.6","annee_revenus":2025,"millesime_fiscal":"2026"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7UAFri7NGHqORW9owTA1u","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates the French high-gain real estate capital gains surtax (surtaxe sur les plus-values immobilières) given a net taxable gain amount, sourced from CGI art. 1609 nonies G.","exampleAgentPrompt":"I just sold a French property and my net taxable capital gain is €320,000 — can you calculate the surtaxe sur les plus-values immobilières I'd owe on that?","exampleUseCases":[{"title":"Pre-sale tax estimate for high-value property","prompt":"I'm planning to sell an apartment in Paris with an expected net taxable gain of €480,000 — what surtaxe sur les plus-values immobilières will I have to pay on top of the regular capital gains tax?"},{"title":"CGP client advisory session","prompt":"My client is selling a rental property with a net plus-value of €250,000. Can you compute the surtaxe immobilière they'd face so I can include it in their bilan patrimonial?"},{"title":"Zero-check for gain below threshold","prompt":"My net taxable real estate gain is only €45,000 — can you confirm whether any surtaxe sur les plus-values immobilières applies, or if it's zero?"}],"resultDescription":"Returns a JSON object with 'ok' status, the surtax amount in EUR with a human-readable label, the fiscal year (millésime_fiscal), a confidence level ('fiable' for this fiscal endpoint), the legal sources used (e.g. CGI art. 1609 nonies G), and an advisory disclaimer that the result is not personalised tax advice.","failureModes":["Negative or missing plus_value value — API returns ok:false with error field","plus_value below the statutory threshold — returns value:0 EUR (not an error, valid zero result)","Malformed request body — HTTP 400 or ok:false","Referential data out of date with latest Légifrance update — confiance may downgrade"],"whenToPreferThis":"Use this endpoint when you need a legally sourced, precise computation of the French high-gain real estate capital gains surtax (CGI art. 1609 nonies G) based on a single net taxable gain figure. Prefer it over generic tax calculators when accuracy traceable to Légifrance/BOFiP is required, or when building a broader CGP wealth advisory workflow that includes IFI, PER, or retirement simulations on the same platform.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:44:24.966Z","isFirstParty":false}