ForHosting KIT · Outils pour développeurs

Calculez les droits de douane selon la valeur et la catégorie

Cet estimateur applique à la valeur déclarée d'un envoi le pourcentage de la catégorie figurant dans votre tableau.

● BetaGratuit · dans votre navigateur

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

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. Fournissez ensuite un tableau dont chaque ligne contient un nom de catégorie unique et un rate_percent positif ou nul. 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. Les taux sont exprimés en pourcentage : un rate_percent de 7.5 signifie sept et demi pour cent, et non 0.075. 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. 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. 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. Le navigateur convient aux contrôles manuels ; l'API coûte $0.002 par requête pour automatiser achats, tarification ou rapports.

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

Quelle formule est utilisée ?

L'outil multiplie declared_value par duty_rate_percent, puis divise par cent.

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.

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.

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

POSThttps://api.kit.forhosting.com/ecom/customs-duty-estimate

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

par requête$0.002

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.

Consulter la documentation complète du KIT →