# Qotien — French Pension Social Charges Calculator (ps_pension)

> Qotien — French Pension Social Charges Calculator (ps_pension) 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 French social charges (CSG, CRDS, Casa, maladie) deducted from a gross pension to derive the net pension amount, based on household tax reference income, fiscal shares, and pension type breakdown.

## Facts

- Endpoint: POST https://app.qotien.fr/api/fiscal/v1/calc/ps_pension
- 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-french-pension-social-charges-calculator-ps-pension-0868fdfa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_81Hrhbo7d-N1yoRmS79Pc

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-french-pension-social-charges-calculator-ps-pension-0868fdfa -d '<json body>'
```

Example prompt: Can you calculate the net pension for a French retiree with a gross annual pension of €24,000, of which €8,000 comes from an Agirc-Arrco complementary scheme, a household tax reference income of €22,000, and 1.5 fiscal shares?

## When to prefer this

Choose this endpoint when you need a legally-sourced, regulation-backed calculation of French social charges on pension income (CSG, CRDS, Casa, maladie contribution) that references the actual CSS articles and BOFiP/Légifrance parameters. It is specifically suited for CGP (wealth management) workflows, bilan patrimonial generation, or any agent that must provide audit-traceable pension net calculations under French law. Prefer it over generic tax calculators when you need confidence levels, legal citations, and support for complementary regime breakdowns (Agirc-Arrco, Ircantec, CRPN, libéral regimes).

## Known failure modes

- Missing required pension_annuelle_brute field returns an error with ok:false
- Invalid or negative values for rfr or pension_annuelle_brute return validation errors
- If rfr is absent, the CSG tranche is estimated from the pension itself and confidence degrades to 'estime'
- Unsupported fiscal share values outside the interpolation range (below 1) return an error
- Service may return confiance='non_calculable' if inputs are insufficient for a reliable calculation

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

A JSON object containing: a boolean success flag, the net pension value in EUR with a human-readable label, the fiscal year millésime applied, the confidence level of the calculation (e.g. 'fiable', 'estime'), an array of legal source references (CSS articles, Légifrance), and optionally a warning that this is a gross calculation and not personalised financial advice.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "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",
   "default": 1,
   "minimum": 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."
  },
  "pension_annuelle_brute": {
   "type": "number",
   "minimum": 0,
   "description": "Pension annuelle brute totale (€)."
  }
 }
}
```

## 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": "Prélèvements sociaux sur une pension (brut → net)",
   "value": 0
  }
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/qotien-french-pension-social-charges-calculator-ps-pension-0868fdfa/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)