API douanière DOM-TOM
L'API REST qui calcule droits de douane, octroi de mer et TVA pour La Réunion, la Guadeloupe, la Martinique, la Guyane et Mayotte — par code HS, en unitaire ou par lot de 100 lignes.
Pourquoi une API douane pour les DOM-TOM ?
Calculer les taxes d'importation vers les Outre-mer est complexe : chaque territoire vote ses propres taux d'octroi de mer, produit par produit, et la TVA varie de 0 % à 8,5 % selon la destination. L'API TropicaDouane encapsule toute cette complexité derrière deux appels REST : vous envoyez un prix, un code HS (ou une simple description produit) et un territoire — elle renvoie le détail complet des taxes.
E-commerce & marketplaces
Affichez les taxes exactes au panier pour vos clients ultramarins : plus de colis refusés à la livraison, moins de SAV. Le calcul se fait en une requête au moment du checkout.
Transitaires & logistique
Automatisez vos cotations : envoyez jusqu'à 100 lignes par appel batch et récupérez octroi de mer, OMR, TVA et total taxé pour chaque marchandise d'un dossier.
ERP & facturation
Intégrez les taxes DOM-TOM dans vos devis et factures. La recherche de codes HS en français évite à vos équipes de connaître la nomenclature douanière.
Comparateurs & fintech
Enrichissez vos produits d'un coût de revient rendu DOM précis. Les taux sont maintenus à jour à partir des données officielles (data.gouv.fr).
Démarrage rapide
1. Créez un compte et souscrivez le plan Premium (accès API inclus)
2. Générez votre clé API depuis le tableau de bord
3. Envoyez vos requêtes avec le header X-API-Key
curl -X POST https://tropicadouane.com/api/v1/public/calculate \
-H "Content-Type: application/json" \
-H "X-API-Key: td_votre_cle_ici" \
-d '{
"product_price": 150,
"shipping_cost": 25,
"hs_code": "8517.12",
"territory": "REU"
}'Authentification
Chaque requête doit inclure votre clé API dans le header HTTP :
X-API-Key: td_XXXXXX_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXLes clés sont au format td_ suivi d'un identifiant unique. Ne les partagez jamais publiquement.
Territoires supportés
La Réunion
REUGuadeloupe
GLPMartinique
MTQGuyane
GUFMayotte
MYTEndpoints
Calcule les taxes et droits de douane pour un produit.
Corps de la requête
{
"product_price": 150.00,
"shipping_cost": 25.00,
"insurance": 5.00,
"hs_code": "8517.12",
"territory": "REU"
}Réponse
{
"success": true,
"data": {
"input": { "product_price": 150, "territory": "REU", ... },
"calculation": {
"base_caf": 180.00,
"octroi_mer": 18.00,
"octroi_mer_regional": 4.50,
"droits_douane": 0,
"tva": 17.21,
"total_taxes": 39.71,
"total_with_product": 219.71
},
"rates_applied": { "om_rate": 10, "omr_rate": 2.5, "tva_rate": 8.5 }
}
}Calcule les taxes pour plusieurs produits en une seule requête (max 100 lignes).
Corps de la requête
{
"lines": [
{ "product_price": 100, "hs_code": "8517.12", "quantity": 2 },
{ "product_price": 50, "hs_code": "6404.11", "quantity": 1 }
],
"territory": "REU",
"shipping_cost": 30,
"insurance": 5
}Réponse
{
"success": true,
"data": {
"lines": [ ... ],
"grand_total_taxes": 42.50,
"grand_total_with_product": 292.50
}
}Recherche parmi les codes HS par mot-clé ou numéro (français).
Réponse
{
"success": true,
"data": [
{ "code": "8517.12", "description_fr": "Téléphones mobiles (smartphones)" },
{ "code": "8517.62", "description_fr": "Machines pour la réception..." }
]
}Renvoie les 5 territoires DOM-TOM supportés avec leurs codes.
Réponse
{
"success": true,
"data": [
{ "code": "REU", "name": "La Réunion" },
{ "code": "GLP", "name": "Guadeloupe" },
...
]
}Plans & limites
Standard
29€/mois
Rate limit : 3 000 calculs/mois (web)
- Simulateur web complet
- Historique & exports PDF
- Pas d'accès API
Premium
99€/mois
Rate limit : 1 000 req/min — 30 000 appels/mois
- Accès API complet (clés X-API-Key)
- Calcul unitaire, batch & recherche HS
- Priorité support
Gestion des erreurs
| Code | Signification | Action |
|---|---|---|
| 400 | Paramètres invalides | Vérifiez le corps de la requête |
| 401 | Clé API manquante ou invalide | Vérifiez le header X-API-Key |
| 429 | Rate limit dépassé | Attendez et réessayez |
| 404 | Code HS non trouvé | Utilisez la recherche HS pour valider |
| 500 | Erreur serveur | Contactez le support |
Questions fréquentes sur l'API
Qu'est-ce qu'une API douanière ?
C'est une interface de programmation qui permet à un logiciel (site e-commerce, ERP, outil logistique) de calculer automatiquement les taxes d'importation d'un produit. L'API TropicaDouane est spécialisée dans les DOM : elle renvoie l'octroi de mer, l'octroi de mer régional, la TVA locale et le total des taxes à partir du prix, du code HS et du territoire de destination.
Les taux utilisés sont-ils à jour ?
Oui. Les taux d'octroi de mer et de TVA proviennent des données officielles publiées par les collectivités (data.gouv.fr) et sont mis à jour à chaque changement de délibération. Chaque réponse de l'API indique les taux appliqués (rates_applied) pour une traçabilité complète.
Comment obtenir une clé API ?
Créez un compte puis souscrivez le plan Premium — c'est lui qui inclut l'accès API. Générez ensuite votre clé depuis le tableau de bord (onglet API). La clé s'utilise dans le header X-API-Key de chaque requête. Vous pouvez tester gratuitement le moteur de calcul via le simulateur en ligne avant de souscrire.
Quelles sont les limites de débit ?
Le plan Premium autorise 1 000 requêtes par minute et 30 000 appels par mois. Au-delà, l'API renvoie un code 429 — contactez-nous pour un volume supérieur.
Où l'API est-elle hébergée ?
L'API est hébergée en France (infrastructure OVH), les échanges sont chiffrés en TLS et aucune donnée personnelle de vos clients n'est requise pour un calcul : seuls le prix, le code HS et le territoire sont nécessaires.
Les plans détaillés sont sur la page Tarifs. Pour tester le moteur de calcul sans clé API, utilisez le simulateur en ligne.