Pour les développeurs
Les mêmes calculs, dans votre application
L'API de Phynanx expose les simulateurs d'impôts du site : un calcul déterministe, versionné par année, dont chaque étape est tracée avec ses textes de loi.
Ce que l'API apporte
Calcul déterministe
Un même jeu de données donne toujours le même résultat : aucun modèle de langage ne calcule, les montants viennent du moteur.
Chaque étape tracée et sourcée
La réponse détaille les étapes du calcul, la formule appliquée et les textes cités (CGI, BOFiP, Code de la sécurité sociale…), avec un lien Légifrance quand il existe.
Versionné par année
Chaque simulateur porte son millésime et sa version de règles (rulesVersion) : un calcul d'une année close reste identique.
Simulateurs disponibles
12 simulateurs sont exposés aujourd'hui : impôt sur le revenu (un par millésime), salaire brut → net, TVA et impôt sur la fortune immobilière (IFI).
Un exemple réel
Requête et réponse relevées sur l'API (calcul de TVA sur 1 000 € hors taxes), recopiées telles quelles. $API_URL désigne l'adresse de l'API, communiquée à l'ouverture des accès.
curl -X POST "$API_URL/v1/calculators/calcul-tva-2025/calculate" \
-H "Content-Type: application/json" \
-d '{"montantHT": "1000"}'{
"slug": "calcul-tva-2025",
"version": "1.0.0",
"legalCorrections": [],
"engineExtensions": [],
"result": {
"montantTVA": "200",
"montantTTC": "1200"
},
"cotisations": [],
"steps": [
{
"id": "calcul_tva",
"descriptionFr": "Application du taux normal de TVA (20 %)",
"formula": "montantHT × 20 %",
"inputs": { "montantHT": "1000" },
"output": "200",
"citations": [
{
"authority": "CGI",
"reference": "art. 278",
"url": "https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000026950057/",
"asOfDate": "2014-01-01"
}
],
"moduleId": "fr_tva_standard_2025"
},
{
"id": "calcul_ttc",
"descriptionFr": "Calcul du montant TTC",
"formula": "montantHT + montantTVA",
"inputs": { "montantHT": "1000", "montantTVA": "200" },
"output": "1200",
"citations": [],
"moduleId": "fr_tva_standard_2025"
}
],
"warnings": [],
"rulesVersion": "[email protected]"
}La traçabilité, au cœur de la réponse
Chaque étape de la réponse porte sa description, sa formule, ses entrées, son résultat et ses citations : de quoi afficher le détail du calcul à vos utilisateurs, texte de loi à l'appui.
Application du taux normal de TVA (20 %)
montantHT × 20 % = 200
CGI, art. 278 · en vigueur au 2014-01-01Les routes de l'API
GET /v1/calculatorsRenvoie la liste des simulateurs (identifiant, nom, version).GET /v1/calculators/{slug}Renvoie la définition d'un simulateur : son formulaire, ses champs et ses sorties.GET /v1/calculators/{slug}/legal-basisRenvoie la base légale de chaque case (article du CGI, doctrine BOFiP).POST /v1/calculators/{slug}/calculateEffectue le calcul complet et renvoie le résultat, les étapes tracées, les citations et les avertissements.POST /v1/calculators/{slug}/solveEffectue un calcul inverse : il trouve la valeur d'entrée qui atteint un résultat visé.POST /v1/calculators/{slug}/explainExplique le calcul en français ou en anglais, avec les mécanismes déclenchés et les textes.
Simulateurs exposés
| Nom | slug |
|---|---|
| Calcul de la TVA 2025 | calcul-tva-2025 |
| Calcul salaire brut → net 2025 | calcul-salaire-brut-net-2025 |
| Calcul salaire brut → net 2026 | calcul-salaire-brut-net-2026 |
| Impôt sur le revenu 2019 | impot-revenu-2019 |
| Impôt sur le revenu 2020 | impot-revenu-2020 |
| Impôt sur le revenu 2021 | impot-revenu-2021 |
| Impôt sur le revenu 2022 | impot-revenu-2022 |
| Impôt sur le revenu 2023 | impot-revenu-2023 |
| Impôt sur le revenu 2024 | impot-revenu-2024 |
| Impôt sur le revenu 2025 | impot-revenu-2025 |
| Impôt sur le revenu 2026 | impot-revenu-2026 |
| Impôt sur la fortune immobilière 2026 | ifi-2026 |
Lire la documentation de l'API : référence des routes et guides en français.
Accès
L'accès à l'API se fera sur demande. Les clés et la facturation ne sont pas encore ouvertes : laissez-nous vos coordonnées pour être prévenu.