# Qotien — Calculateur de surcote parentale (retraite)

> Qotien — Calculateur de surcote parentale (retraite) 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).

Calcule la surcote parentale applicable à la pension de retraite française (majoration de 1,25 % par trimestre, plafonnée à 5 %), basée sur les conditions légales de la MDA et du Code de la Sécurité Sociale.

## Facts

- Endpoint: POST https://app.qotien.fr/api/fiscal/v1/calc/surcote_parentale
- 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-calculateur-de-surcote-parentale-retraite-d1da0e78
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_etzLvPHsff6vsNKX9JN2J

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-calculateur-de-surcote-parentale-retraite-d1da0e78 -d '<json body>'
```

Example prompt: J'ai 62 ans, je suis née le 15 mars 1963, j'ai 168 trimestres acquis sur 172 requis, 3 enfants (donc MDA parentale oui), et une pension brute annuelle de 24 000 €. Calcule ma surcote parentale via Qotien pour savoir combien je vais gagner en euros.

## When to prefer this

Choisir cet endpoint quand on a besoin du calcul réglementaire précis de la surcote parentale française (majoration CSS L351-1-2-1) avec traçabilité légale (sources Légifrance/BOFiP). Préférer Qotien à des estimateurs génériques quand la rigueur juridique et l'audit des sources sont requis, notamment pour des CGP (conseillers en gestion de patrimoine) préparant un bilan patrimonial ou une déclaration. Moins adapté si l'on cherche une simulation multi-régimes complète (utiliser alors les endpoints retraite globaux de Qotien) ou des calculs fiscaux IR/IFI.

## Known failure modes

- Paramètres manquants ou invalides (age < 16, trimestres_requis < 1) → réponse avec ok:false et champ 'error'
- Date de naissance mal formatée (non YYYY-MM-DD) → erreur de validation
- Nombre de trimestres incohérent (acquis > réel) → confiance dégradée à 'estime' ou 'partiel'
- RFR ou parts non fournis → calcul partiel possible avec confiance réduite
- Changement de barème légal non encore intégré → avertissement millésime fiscal

## 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

L'endpoint retourne un objet JSON contenant : un booléen 'ok' indiquant le succès, un objet 'result' avec la valeur numérique de la surcote parentale (en EUR ou %), son libellé lisible, son unité, et un niveau de confiance propre au résultat. Il inclut également les sources légales primaires (articles CSS), le millésime fiscal appliqué, le domaine ('retraite'), le nom de la capacité, et un avertissement rappelant que le résultat est indicatif et non un conseil personnalisé.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "age": {
   "type": "number",
   "minimum": 16
  },
  "rfr": {
   "type": "number",
   "minimum": 0
  },
  "parts": {
   "type": "number",
   "default": 1,
   "minimum": 1
  },
  "age_legal": {
   "type": "number",
   "minimum": 60,
   "description": "Alternative à la date de naissance : âge légal en années."
  },
  "nb_enfants": {
   "type": "number",
   "minimum": 0,
   "description": "À défaut de mda_parentale : ≥ 1 enfant → hypothèse de MDA."
  },
  "mda_parentale": {
   "type": "boolean",
   "description": "≥ 1 trimestre de MDA pour enfant (maternité/adoption/éducation)."
  },
  "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."
  },
  "trimestres_acquis": {
   "type": "number",
   "minimum": 0
  },
  "trimestres_requis": {
   "type": "number",
   "default": 172,
   "minimum": 1
  },
  "pension_brute_annuelle": {
   "type": "number",
   "minimum": 0,
   "description": "Pension de base brute annuelle — chiffre le gain en €."
  },
  "trimestres_cotises_fenetre": {
   "type": "number",
   "maximum": 4,
   "minimum": 0,
   "description": "Trimestres cotisés dans la fenêtre [âge légal − 1 ; âge légal) — sinon estimé."
  }
 }
}
```

## 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": "Surcote parentale (+1,25 %/trim, max 5 %)",
   "value": 0
  },
  "dom
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/qotien-calculateur-de-surcote-parentale-retraite-d1da0e78/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)