每次批量调用
200
每次调用商品数
一次批量请求并行归类并计价最多 200 件商品,3 到 5 分钟内完成。
产品
为大批量进口商打造的归类与到岸成本 API
货运代理、跨境电商平台、邮政与包裹运营商,以及大批量进口商,每天都有成千上万件商品要过关。GingerControl API 把一段普通的产品描述加原产国,转换成 HTS 编码与完整的关税叠加,让您的系统无需逐行人工归类,就能报出到岸成本、准备报关。
为整本目录而建,而非一次一件
生产层级
200K+
每日归类量
标准生产容量。企业定制层级可扩展至每小时 10 万件归类。
开发者
完整的请求、响应与错误约定都在 API 参考文档中。
API 参考文档或来信 chen@gingercontrol.com 申请测试 Key。
吞吐量数据来自标准生产层级 API Key 在真实流量下的测量。实际容量会依各客户的调用模式与峰值 QPS 配置。归类输出为研究材料,需经持照报关行复核后才可用于报关。
从一条产品线到到岸成本,一次调用搞定
POST/v1/tariff
descriptionCotton T-shirt
countryVN
送出产品与原产国
POST 一段产品描述与原产国,单件或最多 200 件的批量皆可。不必查税则,不必排队等报关行。
6109.10.0012
MFN
301
232
Ginger 归类并计算
引擎先判定 HTS 编码,再组装完整的关税叠加:MFN 基础税率,加上 Section 301、232、122 以及所有适用的 Chapter 99 条目。
200 OK
hts_code
general_rate
Section 301
Section 232
取回可直接算到岸成本的数据
一份 JSON 响应返回 HTS 编码与每一层关税,可直接接入您的到岸成本报价、报关准备或定价引擎。
一个请求进,完整关税全貌出
送出描述与原产国,一次调用即取回 HTS 编码与完整关税明细。以下是行销示意,API 参考文档记录了每个字段、错误码与批量行为。
请求
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"
}响应
{
"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%" }
]
}
}批量请求、拆分编码组件、错误语义与速率限制,请见完整 API 参考文档。
API 为您的系统提供什么
归类
在整本目录规模下依然站得住脚的 HTS 归类,连多数 API 默默跳过的组合商品也涵盖在内。
6109.10
6109.10
6109.10
6109.10
6109.10
目录规模的 HTS 归类
送进真实世界里杂乱的产品描述,取回 10 位 HTS 编码。在我们针对 1,000+ 件商品的内部基准中,引擎达到 99.86% 准确率,而每个结果都是供持照报关行复核后才用于报关的研究输出。
计算
不只是基础税率,而是真正会落在报关单上的整套叠加。
MFN
301
232
122
Ch 99
Total
完整的到岸关税叠加
每个响应都带有 General(MFN)与 Special 税率,加上 Section 301、Section 232、Section 122 以及所有适用的 Chapter 99 条目,让您的到岸成本数字反映海关实际会课征的金额。
集成
可预期的约定与清晰的失败模式,这些是运营团队能据以规划的东西。
POST/tariff1 item
POST/tariff/batch200
单件与批量端点
为实时结账报价归类单件商品,或在一次批量调用中推送最多 200 件做夜间目录跑批。两个端点共用同一套响应结构与同一份额度。
谁在用它来搭建
这套 API 是为每天把大量零售商品、杂货与包裹送进海关的运营而建,在这种场景下,逐行人工归类根本无法规模化。
货运代理
在卡车出发前就把客户整份货运清单归类并计价,而不是每一行都等报关行回覆。
跨境电商
在结账时呈现准确的含税到岸成本,让买家不会在收货时被海关费用吓一跳。
邮政与包裹运营商
对大批量入境包裹流跑出 HTS 编码与税额,用以喂入海关申报与预缴。
平台与零售市集
为成千上万的第三方卖家提供正确的 HTS 编码与税额估算,无需自建归类团队。
3PL 与履约
把归类与到岸成本内建进入驻流程,让每一份新客户目录在第一天就可报关。
ERP、TMS 与定价引擎
把实时税额数据嵌入您自己客户已在使用的平台,无需维护任何税则。
它解决的工作
"我们一周流转数千个 SKU。我们没办法在每一行上都放一个人,但报价时一个错误的税额估算,会让我们丢掉订单或赔掉利润。"
这具体对应到什么
| 在货物移动前就算出到岸成本 | 一次调用返回 HTS 编码与完整关税叠加,快到足以用于结账报价或货运清单。 |
|---|---|
| 处理整本目录,而非单次查询 | 批量端点每次调用处理最多 200 件商品,并可扩展至每日 200K+ 件归类。 |
| 信得过进入报价的那个数字 | 含 Section 301、232、122 的完整关税叠加,加上拆分编码的组件税额,专为报关前的报关行复核而设计。 |
API 常见问题
使用 API 需要持照报关行执照吗?
+
不需要。API 返回的是研究输出:供您系统用于报价与准备的 HTS 编码与完整关税叠加。该结果设计为在用于报关前先经持照报关行复核。它加快工作,但不取代报关行的签核。
一次归类有多快?
+
单件商品归类通常远低于一分钟即可返回。最多 200 件的批量会并行处理,约 3 到 5 分钟完成,这正是标准生产 Key 每日能处理 200K+ 件归类的原因。
API 能给我含税的到岸成本吗?
+
它返回会落在报关单上的每一层税额:General(MFN)与 Special 税率,加上 Section 301、232、122 与适用的 Chapter 99 条目。把这套关税叠加与您自己的运费与杂费相加,即可算出用于报价或结账的到岸成本数字。
我要怎么取得 API Key?
+
申请测试 Key,我们会透过电子邮件等线下渠道交付。测试 Key 额度较小,7 到 30 天内到期,仅供开发使用。准备上线时,我们会依您的调用模式、IP 白名单与峰值 QPS 配置一把生产 Key。
批量上限是多少?
+
批量端点每次调用最多接受 200 件商品。每件都会回报自己的状态,因此一件无法归类的商品不会让整批失败;单件与批量端点共用同一份逐件额度,均归属您的 Key。
完整的技术文档在哪里?
+
API 参考文档记录了每个端点、请求与响应字段、错误码、标头与速率限制规则,并附可直接复制的 curl 示例。拿到 Key 之后,就照着这页来开发。
合规提示
这是一款 HTS 税则归类研究工具。研究结果仅供一般参考、教育和规划用途，旨在促进贸易合规团队、进口商与持牌报关行之间的沟通。根据 CBP Ruling HQ H290535，为拟进口的特定商品提供超过 6 位数的 HTS 归类属于 19 U.S.C. § 1641 项下的「报关业务」。请勿在未经持牌报关行独立审核的情况下将本工具的结果直接用于报关单据。
阅读完整合规声明 →