---
title: "Plus-value immobilière (IR + PS + surtaxe)"
method: POST
path: "/api/fiscal/v1/calc/plus_value_immobiliere"
tags: ["fiscal"]
---

# Plus-value immobilière (IR + PS + surtaxe)

`POST /api/fiscal/v1/calc/plus_value_immobiliere`

## Request

- Base URL: `https://app.qotien.fr`
- URL: `https://app.qotien.fr/api/fiscal/v1/calc/plus_value_immobiliere`
- Auth: none declared

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 €. Point d'entrée pour une cession complète : la surtaxe est DÉJÀ incluse — ne pas y ajouter fiscal_surtaxe_pv_immobiliere (réservé au calcul de la surtaxe seule sur une plus-value nette déjà connue). — palier etude · 0.250000 USD (x402 v2, USDC/Base).

## Request body

- object
  - `prix_acquisition` number, required: Prix d'acquisition du bien (€).
  - `prix_cession` number, required: Prix de cession (€).
  - `annees_detention` number, required: Durée de détention en années (abattements dès 6 ans ; exonération IR à 22 ans, PS à 30 ans).
  - `residence_principale` boolean: Si vrai : exonération totale (art. 150 U II 1° CGI).
  - `lmnp_reel` boolean: LMNP au réel : réintègre les amortissements déduits au prix d'acquisition majoré (réforme 2025).
  - `amortissements_deduits` number: Amortissements déduits à réintégrer si lmnp_reel (€).
  - `frais_acquisition` number: Frais d'acquisition réels (€). Absent → forfait 7,5 % du prix d'acquisition (achat seulement).
  - `acquisition_gratuite` boolean: Bien reçu par donation ou succession : pas de forfait 7,5 %, seuls les frais réels saisis (art. 150 VB II 2°).
  - `quote_part` number: Fraction détenue (indivision ou démembrement), 0-1. Le seuil d'exonération de 15 000 € s'apprécie par quote-part en pleine propriété (art. 150 U II 6°).
  - `valeur_pleine_propriete` number: Bien démembré : valeur de l'immeuble entier en pleine propriété, pour le seuil de 15 000 € (et non le prix du droit cédé).
  - `terrain` boolean: Terrain non bâti : pas de forfait travaux 15 %.
  - `frais_cession` number: Frais de cession — diagnostics, agence… (€).
  - `travaux` number: Travaux (€). Absent → forfait 15 % du prix d'acquisition si détention ≥ 5 ans.

## Response `200`

Résultat sourcé — enveloppe commune (ok/confiance/sources/millesime), jamais un chiffre nu.

- Envelope
  - `ok` boolean, required: true = succès ; false = erreur (champ "error" présent à la place de result).
  - `domaine` 'fiscal' | 'retraite' | 'referentiel' | 'qotien', required: Domaine de la capacité.
  - `capability` string, required: Nom de la capacité appelée.
  - `result` object, required: Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.
    - `value` number: Valeur principale (quand le résultat est scalaire).
    - `unit` string: Unité de value (EUR, PERCENT, RATE…).
    - `label` string: Libellé lisible du résultat.
    - `confiance` 'fiable' | 'estime' | 'partiel' | 'non_calculable' | 'sourcee' | 'variable': Confiance propre au résultat retraite (prime sur la confiance de capacité).
  - `confiance` 'fiable' | 'estime' | 'partiel' | 'non_calculable' | 'sourcee' | 'variable', required: Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable).
  - `sources` string[], required: Sources primaires/légales du calcul.
  - `referentiel` string: Version du référentiel sourcé utilisé.
  - `millesime_fiscal` string, required: Millésime fiscal (année des barèmes appliqués).
  - `annee_revenus` number: Année des revenus concernés.
  - `avertissement` string: Avertissement d'usage (résultat brut, pas un conseil personnalisé).

## Other responses

- `400`: Entrée invalide.
- `402`: Paiement requis (x402 v2, USDC/Base) — 0.250000 USD.
- `429`: Rate limit dépassé.

---

[API](https://skmtc.dev/qotien/apis/qotien-api-fiscale-retraite-sourcee-datee.md) · [All operations](https://skmtc.dev/qotien/apis/qotien-api-fiscale-retraite-sourcee-datee/llms.txt) · [OpenAPI document](https://skmtc.dev/qotien/apis/qotien-api-fiscale-retraite-sourcee-datee/revisions/c130d35543dd?raw)