# Qotien CEHR Calculator — Contribution Exceptionnelle sur les Hauts Revenus

> Qotien CEHR Calculator — Contribution Exceptionnelle sur les Hauts Revenus is a paid API for AI agents from app.qotien.fr, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Calculates the French exceptional high-income surtax (CEHR / CGI art. 223 sexies) based on household marital status and fiscal reference income.

## Facts

- Endpoint: POST https://app.qotien.fr/api/fiscal/v1/calc/cehr
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/qotien-cehr-calculator-contribution-exceptionnelle-sur-les-hauts-5b592903
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Bh7Fip6EpVjCMCxQJjeVa

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability qotien-cehr-calculator-contribution-exceptionnelle-sur-les-hauts-5b592903 -d '<json body>'
```

Example prompt: Calculate the CEHR (contribution exceptionnelle sur les hauts revenus) for a married couple with a revenu fiscal de référence of 650 000 euros using Qotien's fiscal calculator.

## When to prefer this

Use this endpoint when you need a legally-sourced, rule-based calculation of the French CEHR surtax (CGI art. 223 sexies) for a single household, with explicit citation of Légifrance and BOFiP references. Prefer it over generic tax calculators when you need traceable legal provenance and structured JSON output suitable for wealth management workflows (CGP/bilan patrimonial). It handles the married/PACS 500k vs. single 250k threshold distinction natively.

## Known failure modes

- Missing or negative revenu_fiscal_reference returns an error with ok:false
- Invalid situation enum value causes validation error
- Income below CEHR threshold returns value:0 (not an error, but a valid zero result)
- Network or service unavailability returns non-200 HTTP status
- Truncated or malformed JSON body if request Content-Type is incorrect

## How this service works

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.

## Output

Returns a JSON object with: a boolean success flag, the CEHR amount in euros (value + unit + label), a confidence level (e.g. 'fiable'), the fiscal year millesime applied, the legal sources cited (CGI art. 223 sexies, BOFiP BOI-IR-CHR), the capability name, and an advisory disclaimer that the result is not personalized tax advice.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "situation": {
   "enum": [
    "Célibataire",
    "Marié(e)",
    "Pacsé(e)",
    "Divorcé(e)",
    "Veuf(ve)"
   ],
   "type": "string",
   "default": "Célibataire",
   "description": "Situation familiale (seuils célibataire 250 k / couple 500 k)."
  },
  "revenu_fiscal_reference": {
   "type": "number",
   "minimum": 0,
   "description": "Revenu fiscal de référence du foyer (€)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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": "Contribution exceptionnelle sur les hauts revenus (CEHR)",
   "value"
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/qotien-cehr-calculator-contribution-exceptionnelle-sur-les-hauts-5b592903/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from app.qotien.fr](https://www.zero.xyz/host/app.qotien.fr/llms.txt)