Par appel par lots
200
Produits par appel
Une seule requête par lots classe et tarifie jusqu'à 200 produits en parallèle, terminant en 3 à 5 minutes.
Produit
L'API de classement et de landed cost pour les importateurs à fort volume
Les transitaires, les plateformes de e-commerce transfrontalier, les opérateurs postaux et de colis, ainsi que les importateurs en masse font passer chaque jour des milliers de produits en douane. L'API de GingerControl transforme une simple description produit et un pays d'origine en un code HTS et l'empilement tarifaire complet, pour que vos systèmes puissent chiffrer le landed cost et préparer les déclarations en douane sans qu'un humain classe chaque ligne.
Conçu pour des catalogues entiers, pas des coups isolés
Niveau production
200K+
Classements par jour
Capacité de production standard. Les niveaux entreprise sur mesure montent jusqu'à 100 K classements par heure.
Développeurs
Le contrat complet de requête, de réponse et d'erreur se trouve dans la référence API.
Référence APIOu écrivez à chen@gingercontrol.com pour une clé de test.
Les chiffres de débit décrivent des clés API standard de niveau production mesurées sur le trafic réel. La capacité effective est dimensionnée selon le schéma d'appel et le pic de QPS de chaque client. La sortie de classement est un matériel de recherche destiné à l'examen d'un commissionnaire en douane agréé avant la déclaration.
De la ligne de produits au landed cost en un seul appel
POST/v1/tariff
descriptionCotton T-shirt
countryVN
Envoyer le produit et l'origine
Envoyez en POST une description produit et un pays d'origine, un article ou un lot de jusqu'à 200. Pas de recherches dans la grille tarifaire, pas de file d'attente chez le commissionnaire.
6109.10.0012
MFN
301
232
Ginger classe et calcule
Le moteur détermine le code HTS, puis assemble l'empilement complet des droits : taux de base MFN plus Section 301, 232, 122 et chaque entrée Chapter 99 applicable.
200 OK
hts_code
general_rate
Section 301
Section 232
Récupérer des données prêtes pour le landed cost
Une seule réponse JSON renvoie le code HTS et chaque strate de droits, prête à intégrer dans votre devis de landed cost, votre préparation de déclaration ou votre moteur de tarification.
Une requête en entrée, le tableau tarifaire complet en sortie
Envoyez une description et une origine. Récupérez le code HTS et la ventilation complète des droits en un seul appel. Il s'agit d'un aperçu marketing ; la référence API documente chaque champ, code d'erreur et comportement par lots.
Requête
curl -X POST 'https://api.gingercontrol.com/openapi/v1/tariff' \
-H 'Content-Type: application/json' \
-H 'X-Api-Key: YOUR_API_KEY' \
-d {
"description": "Cotton knit short sleeve T-shirt",
"country_of_origin": "VN"
}Réponse
{
"hts_code": "6109.10.0012",
"tariffs": {
"general_rate": "16.5%",
"special_rate": "Free",
"Section 301": [],
"Section 232 - Metals": [],
"Section 122": [
{ "code": "9903.03.01", "rate": "10%" }
]
}
}Consultez la référence API complète pour les requêtes par lots, les composants à codes fractionnés, la sémantique d'erreur et les limites de débit.
Ce que l'API apporte à vos systèmes
Classer
Un classement HTS qui tient à l'échelle du catalogue, y compris les biens composites que la plupart des API esquivent discrètement.
6109.10
6109.10
6109.10
6109.10
6109.10
Classement HTS à l'échelle du catalogue
Envoyez des descriptions produit brutes du monde réel et récupérez un code HTS à 10 chiffres. Dans notre référentiel interne portant sur plus de 1 000 produits, le moteur a atteint 99,86 % de précision, et chaque résultat est une sortie de recherche à examiner par un commissionnaire en douane agréé avant la déclaration.
Calculer
Pas seulement le taux de base. L'empilement entier qui atterrit réellement sur la déclaration en douane.
MFN
301
232
122
Ch 99
Total
L'empilement complet des droits du landed cost
Chaque réponse porte les taux général (MFN) et spéciaux plus Section 301, Section 232, Section 122 et toutes les entrées Chapter 99 applicables, pour que votre chiffre de landed cost reflète ce que la douane évaluera réellement.
Intégrer
Des contrats prévisibles et des modes de défaillance clairs, ce autour de quoi une équipe ops planifie.
POST/tariff1 item
POST/tariff/batch200
Points de terminaison unique et par lots
Classez un produit pour un devis en direct au moment du paiement, ou envoyez jusqu'à 200 articles en un seul appel par lots pour un traitement de catalogue nocturne. Les deux points de terminaison partagent une même forme de réponse et un même quota.
Qui construit dessus
L'API est conçue pour les opérations qui font passer de gros volumes de biens de détail, de produits d'épicerie et de colis en douane chaque jour, là où classer ligne par ligne à la main ne passe tout simplement pas à l'échelle.
Transitaires
Classer et tarifer tout le manifeste d'envoi d'un client avant le départ du camion, au lieu d'attendre un commissionnaire pour chaque ligne.
E-commerce transfrontalier
Afficher un landed cost précis et droits inclus au moment du paiement pour que les acheteurs ne soient pas surpris par les frais de douane à la livraison.
Opérateurs postaux et de colis
Passer les codes HTS et les droits sur des flux entrants de colis à fort volume pour alimenter les déclarations en douane et le prépaiement.
Marketplaces et plateformes de retail
Fournir à des milliers de vendeurs tiers des codes HTS et des estimations de droits corrects sans mobiliser une équipe de classement.
3PL et fulfillment
Intégrer le classement et le landed cost dès l'onboarding pour que chaque nouveau catalogue client soit prêt pour la déclaration en douane dès le premier jour.
ERP, TMS et moteurs de tarification
Intégrer des données de droits en direct dans la plateforme que vos propres clients utilisent déjà, sans grille tarifaire à maintenir.
Le travail qu'elle accomplit
"Nous déplaçons des milliers de SKU par semaine. Nous ne pouvons pas mettre un humain sur chaque ligne, mais une estimation de droits erronée au moment du devis nous coûte l'affaire ou la marge."
Ce que cela signifie concrètement
| Chiffrer le landed cost avant que les marchandises ne bougent | Un seul appel renvoie le code HTS et l'empilement complet des droits, assez vite pour un devis au moment du paiement ou un manifeste d'envoi. |
|---|---|
| Gérer des catalogues entiers, pas des recherches isolées | Le point de terminaison par lots traite jusqu'à 200 produits par appel et passe à l'échelle de plus de 200 K classements par jour. |
| Faire confiance au chiffre qui entre dans le devis | Empilement tarifaire complet avec Section 301, 232 et 122, plus les droits par composant à codes fractionnés, conçu pour l'examen du commissionnaire avant la déclaration. |
FAQ API
Dois-je être un commissionnaire en douane agréé pour utiliser l'API ?
+
Non. L'API renvoie une sortie de recherche : un code HTS et l'empilement complet des droits que vos systèmes utilisent pour le chiffrage et la préparation. Le résultat est conçu pour être examiné par un commissionnaire en douane agréé avant d'être utilisé sur une déclaration en douane. Il accélère le travail, il ne remplace pas la validation du commissionnaire.
Quelle est la rapidité d'un classement ?
+
Le classement d'un produit unique revient généralement en bien moins d'une minute. Un lot de jusqu'à 200 produits s'exécute en parallèle et s'achève en environ 3 à 5 minutes, ce qui permet aux clés de production standard de gérer plus de 200 K classements par jour.
L'API peut-elle me donner un landed cost droits inclus ?
+
Elle renvoie chaque strate de droits qui atterrit sur la déclaration en douane : les taux général (MFN) et spéciaux plus Section 301, 232, 122 et les entrées Chapter 99 applicables. Combinez cet empilement des droits avec votre propre fret et vos propres frais pour produire un chiffre de landed cost pour un devis ou un paiement.
Comment obtenir une clé API ?
+
Demandez une clé de test et nous la livrons via un canal hors ligne tel que l'e-mail. Les clés de test comportent un petit quota et expirent au bout de 7 à 30 jours, pour le développement uniquement. Lorsque vous êtes prêt à passer en production, nous émettons une clé de production dimensionnée selon votre schéma d'appel, votre liste d'autorisation d'IP et votre pic de QPS.
Quelles sont les limites des lots ?
+
Le point de terminaison par lots accepte jusqu'à 200 produits par appel. Chaque article rapporte son propre statut, de sorte qu'un produit non classable ne fait pas échouer tout le lot, et les points de terminaison unique et par lots tirent tous deux du même quota d'articles sous votre clé.
Où se trouve la documentation technique complète ?
+
La référence API documente chaque point de terminaison, chaque champ de requête et de réponse, chaque code d'erreur, en-tête et règle de limite de débit, avec des exemples curl à copier-coller. C'est la page contre laquelle construire une fois que vous avez une clé.
Mettez un classificateur derrière votre opération
Demandez une clé de test pour commencer à intégrer, ou lisez la référence API complète pour construire contre le contrat.
À des fins de référence générale uniquement. Voir l'avertissement de conformité.
Rappel de conformité
Ceci est un HTS classification researcher. Les résultats sont fournis à des fins de référence générale, éducatives et de planification uniquement, conçus pour favoriser une meilleure communication entre les équipes de conformité commerciale, les importateurs et les commissionnaires en douane agréés. Selon la CBP Ruling HQ H290535, fournir des classements HTS au-delà de 6 chiffres pour des importations spécifiques constitue une « customs business » au sens du 19 U.S.C. § 1641. N'utilisez pas ces résultats directement dans les documents de déclaration en douane sans examen indépendant par un commissionnaire en douane agréé.
Lire l'avertissement de conformité complet →