Calculez les droits de douane selon la valeur et la catégorie
Prévoyez le coût d’importation avec un montant vérifiable : une valeur déclarée de 1 250 dans la catégorie chaussures à 12,5 % donne des droits estimés de 156,25. Vous fournissez la table des taux, rien n’est deviné. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Valeur déclarée
- 1 250
- Catégorie
- footwear
- Taux de droits de douane (%)
- 12,5
- Droits de douane estimés
- 156,25
Cet estimateur applique à la valeur déclarée d'un envoi le pourcentage de la catégorie figurant dans votre tableau. Il renvoie le taux trouvé et les droits estimés afin que le calcul soit vérifiable. Il ne classe pas les marchandises, ne consulte aucun tarif officiel, n'ajoute pas de taxes et ne décide pas des exonérations. Utilisez des données adaptées à votre envoi et considérez le résultat comme une estimation, non comme un avis de douane.
Préparez la valeur déclarée et le barème
Commencez par la valeur déclarée qui doit servir de base dans votre scénario. Saisissez un nombre positif ou nul, sans symbole monétaire ni séparateur de milliers. La catégorie de l'envoi doit correspondre exactement à une ligne, y compris la casse et les espaces.
Cette correspondance stricte empêche de retenir discrètement une classification proche mais juridiquement différente. Conservez la même devise pour tous les montants, car aucun cours de change n'est consulté. Avant le calcul, vérifiez que valeur, classification et barème conviennent au pays de destination et à la date.
Les règles d'évaluation, l'origine préférentielle et les exonérations peuvent modifier la base ou le taux applicable.
Comprenez le calcul et sa réponse
L'estimateur recherche la catégorie exacte, récupère son pourcentage, puis multiplie la valeur déclarée par le taux divisé par cent. Aucun arrondi n'est imposé : le résultat arithmétique reste déterministe et n'imite pas une convention décimale universelle. Votre processus peut ensuite appliquer l'arrondi réglementaire.
Un taux nul ou une valeur nulle donne des droits nuls. Si la catégorie manque, une erreur de saisie est renvoyée au lieu d'utiliser un taux par défaut. Les doublons sont également refusés, car ils rendent le tableau ambigu même si leurs pourcentages sont identiques.
Intégrez l'estimation au coût rendu
Utilisez ce résultat comme une composante du coût rendu, et non comme la somme définitive réclamée par la douane. Les frais réels peuvent inclure TVA à l'importation, accises, mesures antidumping, courtage, manutention et autres prélèvements. Certaines autorités retiennent une valeur en douane comprenant transport, assurance, redevances ou ajustements, plutôt que la seule facture.
L'origine préférentielle ou un seuil de franchise peut réduire le montant, mais exige des informations non recueillies ici. Pour vos prévisions, conservez le barème avec l'estimation. Pour un catalogue, calculez par article ou classification et n'additionnez qu'après avoir vérifié le traitement par ligne ou par envoi.
Recommencez si classification, valeur, origine, destination, devise ou tarif change.
Cas d’usage
Planifiez un coût rendu
Appliquez un taux vérifié à la valeur fournisseur avant de comparer les options d'approvisionnement.
Contrôlez une hypothèse du catalogue
Validez les droits issus du barème utilisé dans votre processus de prix en ligne.
Auditez un calcul manuel
Affichez le pourcentage retenu avec les droits pour remonter à la ligne du tableau.
Questions fréquentes
Trouve-t-il la bonne catégorie ou le bon tarif ?
Non. Vous devez fournir la catégorie de l'envoi et le barème applicable.
Que se passe-t-il si la catégorie est absente ?
La requête renvoie une erreur de saisie précisant la catégorie manquante, sans taux de remplacement.
Les taxes, le courtage ou le transport sont-ils inclus ?
Non. Seuls la valeur déclarée et le pourcentage que vous fournissez entrent dans le calcul.
Quelle devise faut-il employer ?
Utilisez la devise requise pour votre évaluation et gardez-la pour la valeur comme pour les droits.
Faut-il saisir le taux en pourcentage ou en décimal ?
En pourcentage. Écrivez 7,5 pour sept et demi pour cent, et non 0,075. Les droits estimés valent la valeur déclarée multipliée par le taux divisé par cent, donc 1 250 à 12,5 % donnent 156,25.
Outils associés
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre stack
curl -X POST https://api.kit.forhosting.com/ecom/customs-duty-estimate \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"declared_value":1250,"category":"footwear","duty_rates":[{"category":"books","rate_percent":0},{"category":"footwear","rate_percent":12.5}]}'const res = await fetch("https://api.kit.forhosting.com/ecom/customs-duty-estimate", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"declared_value": 1250,
"category": "footwear",
"duty_rates": [
{
"category": "books",
"rate_percent": 0
},
{
"category": "footwear",
"rate_percent": 12.5
}
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/ecom/customs-duty-estimate",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"declared_value": 1250,
"category": "footwear",
"duty_rates": [
{
"category": "books",
"rate_percent": 0
},
{
"category": "footwear",
"rate_percent": 12.5
}
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/customs-duty-estimate", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"declared_value":1250,"category":"footwear","duty_rates":[{"category":"books","rate_percent":0},{"category":"footwear","rate_percent":12.5}]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"declared_value":1250,"category":"footwear","duty_rates":[{"category":"books","rate_percent":0},{"category":"footwear","rate_percent":12.5}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/customs-duty-estimate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemple de requête
{
"declared_value": 1250,
"category": "footwear",
"duty_rates": [
{
"category": "books",
"rate_percent": 0
},
{
"category": "footwear",
"rate_percent": 12.5
}
]
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ecom.customs_duty_estimate",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Limites
max_items | 500 |
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |
Notes techniques
Préparez la valeur déclarée et le barème
Fournissez ensuite un tableau dont chaque ligne contient un nom de catégorie unique et un rate_percent positif ou nul. Les taux sont exprimés en pourcentage : un rate_percent de 7.5 signifie sept et demi pour cent, et non 0.075.
Comprenez le calcul et sa réponse
La relation est donc : droits estimés égale valeur déclarée multipliée par rate_percent, puis divisée par cent. La réponse contient declared_value, la catégorie, duty_rate_percent et estimated_duty afin qu'un tiers puisse contrôler les données sans refaire la recherche.
Intégrez l'estimation au coût rendu
Le navigateur convient aux contrôles manuels ; l'API coûte $0.002 par requête pour automatiser achats, tarification ou rapports.
Questions techniques
Quelle formule est utilisée ?
L'outil multiplie declared_value par duty_rate_percent, puis divise par cent.
Combien coûte une requête API ?
L'API coûte $0.002 par requête. La version navigateur s'exécute localement pour les estimations manuelles.