API développeurs
Le moteur de calcul TVA, en une requête
Intégrez les calculs HT/TTC, TVA, marges et prix de vente de MonCalculTVA à votre ERP, votre back-office ou vos scripts. Même moteur décimal que le site (arrondi commercial au centime), réponses JSON, taux officiels vérifiés. L'accès API est inclus dans l'offre Business.
Authentification
Créez une clé depuis votre espace → API. La clé (format mctva_live_…) n'est affichée qu'une seule fois : nous n'en stockons qu'une empreinte SHA-256. Envoyez-la dans l'en-tête Authorization de chaque requête — depuis votre serveur uniquement, jamais depuis du code navigateur.
Authorization: Bearer mctva_live_xxxxxxxxxxxxxxxx
Limite par défaut : 60 requêtes/minute et par clé (en-têtes X-RateLimit-Limit et X-RateLimit-Remaining sur chaque réponse, statut 429 au-delà). Une clé révoquée cesse de fonctionner immédiatement.
POST/api/v1/calculer
Exécute un calcul. Corps JSON : un type parmi 9 et ses entrées. Les montants sont des chaînes — virgule ou point décimal, espaces de milliers et symbole € acceptés (« 1 234,56 » ⇔ « 1234.56 »).
curl -X POST https://moncalcultva.fr/api/v1/calculer \
-H "Authorization: Bearer VOTRE_CLE" \
-H "Content-Type: application/json" \
-d '{
"type": "HT_TO_TTC",
"entrees": { "montant": "100", "taux": "20" }
}'{
"type": "HT_TO_TTC",
"entrees": { "montant": "100", "taux": "20" },
"resultats": { "ht": 100, "tva": 20, "ttc": 120, "taux": 20 },
"taux_applique": "20"
}| Type | Calcul | Exemple d'entrées |
|---|---|---|
HT_TO_TTC | HT → TTC | { "montant": "100", "taux": "20" } |
TTC_TO_HT | TTC → HT | { "montant": "120", "taux": "20" } |
VAT_AMOUNT | Montant de TVA | { "montant": "250", "taux": "10", "base": "ht" } |
MARGIN | Marge commerciale | { "pa": "60", "pv": "100" } |
MARKUP | Taux de marque | { "sens": "objectif", "pa": "60", "marque": "40" } |
COEFFICIENT | Coefficient multiplicateur | { "sens": "prix", "pa": "50", "coef": "2,4", "taux": "20" } |
SELLING_PRICE | Prix de vente conseillé | { "pa": "80", "objectif": "marge", "pct": "35", "taux": "20" } |
DISCOUNT | Remise | { "sens": "appliquer", "base": "TTC", "prix": "199", "remise": "15", "taux": "20" } |
MULTI_LINE | Devis multi-lignes | { "lignes": [ { "quantite": "2", "prixUnitaireHt": "45", "tauxTva": "20" } ] } |
GET/api/v1/taux
Taux de TVA français en vigueur, issus de notre registre tenu à jour depuis les sources officielles, avec la date de dernière vérification.
curl https://moncalcultva.fr/api/v1/taux \ -H "Authorization: Bearer VOTRE_CLE"
{
"pays": "FR",
"taux": [
{ "valeur": 20, "libelle": "Taux normal", "categorie": "standard", "source": "…" },
{ "valeur": 10, "libelle": "Taux intermédiaire", "categorie": "intermediate", "source": "…" },
{ "valeur": 5.5, "libelle": "Taux réduit", "categorie": "reduced", "source": "…" },
{ "valeur": 2.1, "libelle": "Taux particulier", "categorie": "super_reduced", "source": "…" }
],
"derniere_verification": "2026-08-01T09:00:00.000Z"
}Erreurs
Toutes les erreurs partagent le même format : { "erreur": "message en français" }.
| Statut | Signification |
|---|---|
| 400 | Type inconnu ou entrées invalides (le message indique le champ en cause). |
| 401 | Clé manquante, invalide ou révoquée. |
| 403 | L'abonnement du compte n'inclut plus l'accès API. |
| 429 | Limite de débit atteinte — réessayez après le délai Retry-After. |
Prêt à intégrer ?
L'accès API et les widgets intégrables font partie de l'offre Business (29 €/mois). Créez votre clé en deux clics depuis votre espace.