Classification + Tariff Calculation API 企业级HTS归类与关税API
调用一次API，商品描述和原产国就变成10位HTS编码和每一层关税，以JSON返回。
示意图，使用API参考文档中的批量示例：POST /openapi/v1/tariff/batch的请求记录显示一个200 OK的JSON响应，包含两件纯棉T恤，其中hts_code 6109.10.0012高亮；旁边的“商品列表”面板显示总数2、成功2、失败0。
先说结论。
Classification + Tariff Calculation API（归类与关税计算API）是GingerControl面向企业客户的REST API，用于HTS编码（美国海关编码）归类和美国关税计算。您的系统提交一段纯文本的商品描述和原产国，可以是单个产品，也可以批量提交（默认120条），返回JSON：10位HTS编码、General税率和Special优惠税率，以及每一项301条款和232条款关税及其第99章税号。第91章手表这类拆分编码商品，会按组件返回。返回结果用于报关准备，并由持牌报关行复核。
三步：从您的系统发出，带着编码回来。
用POST提交单个产品，或批量提交，每一条都带上自己的item_id。API Key放在请求头里。
示意图，使用API参考文档中的批量示例：从您系统发出的请求在“请求”标签页显示JSON请求体，包含两件纯棉T恤，原产国分别为DE和FR，各带自己的item_id。旁边是请求头，API Key已遮盖，下方的“商品列表”面板还没有编码。
结果按提交顺序返回，单个产品失败不会拖垮整批。遇到429时，Retry-After会告诉您要等多久。
示意图，使用API参考文档中的批量示例：状态显示“发送中”，“商品列表”面板按发送顺序列出两个item_id，状态仍在等待中。
10位HTS编码、General税率和Special优惠税率、每一项301条款和232条款关税，以及成功情况汇总。
示意图，使用API参考文档中的批量示例：“响应”标签页显示200 OK和JSON响应，hts_code 6109.10.0012高亮；“商品列表”面板显示总数2、成功2、失败0，每个商品的HTS编码都标为OK。
用POST提交单个产品，或批量提交，每一条都带上自己的item_id。API Key放在请求头里。
示意图，使用API参考文档中的批量示例：从您系统发出的请求在“请求”标签页显示JSON请求体，包含两件纯棉T恤，原产国分别为DE和FR，各带自己的item_id。旁边是请求头，API Key已遮盖，下方的“商品列表”面板还没有编码。
结果按提交顺序返回，单个产品失败不会拖垮整批。遇到429时，Retry-After会告诉您要等多久。
示意图，使用API参考文档中的批量示例：状态显示“发送中”，“商品列表”面板按发送顺序列出两个item_id，状态仍在等待中。
10位HTS编码、General税率和Special优惠税率、每一项301条款和232条款关税，以及成功情况汇总。
示意图，使用API参考文档中的批量示例：“响应”标签页显示200 OK和JSON响应，hts_code 6109.10.0012高亮；“商品列表”面板显示总数2、成功2、失败0，每个商品的HTS编码都标为OK。
编码、基础税率，以及每一层关税和对应的第99章税号，都在一个响应里。
熔炼浇铸国钢材在哪里熔炼浇铸，铝材在哪里冶炼铸造。232条款金属关税取决于这两项。
10位HTS编码该产品的美国HTS编码，报关前交由报关行复核。
基础税率General（最惠国）税率和Special优惠税率，与HTS所列一致。
301条款每一行是一个第99章税号及其税率，也就是报关行在报关单上申报的那一行。
232条款金属纯棉T恤这里为空。如果含钢或铝，对应的第99章税号会列在这里。
拆分编码组件第91章的手表按部件分别计征关税：返回8位上级编码，以及机芯、表壳、表带和电池，各带自己的10位编码和关税。
示意图，数据为示例：带注释的POST /openapi/v1/tariff请求和响应，一件原产CN的纯棉T恤返回HTS编码、General税率和Special优惠税率、两行301条款关税和一个空的232条款列表；接着一块手表拆分为四个组件编码。
返回进入美国货物的10位HTS编码、General（最惠国）税率和Special优惠税率，以及每一层关税各一个列表，例如301条款和232条款金属关税，列表里每一项都是一个第99章税号及其税率。列表为空，表示该层关税不适用。拆分编码产品则改为返回components数组。
从ERP（企业资源计划）、报价工具或报关准备流程中调用Classification + Tariff Calculation API。提交商品描述和原产国，即以JSON返回10位HTS编码、基础税率和每一层第99章关税；可以单个调用，也可以批量调用（默认每次120条）。编码用于报关之前，仍须由持牌报关行复核。
它覆盖落地成本（货价加运费、关税和各项费用的总成本）中的关税部分。API返回税率和第99章税号，由您的系统把它们套用到完税价格上（美国按成交价格计，不含国际运费和保险费），再加上运费、保险费和各项费用。它面向进口前决策和报关准备。如果需要在结账时向消费者展示关税及税费，并保证最终金额不变，Zonos、Avalara这类结账工具就是为此设计的。
有些商品，例如第91章的手表，是按部件分别计征关税，而不是按整件。对这类商品，API返回8位上级编码和一个components数组：每个部件都有自己的10位HTS编码和关税数据，由我们在同一次调用中算好。
默认每次批量调用120个产品，可按您的吞吐量调整；每个产品的描述最长10,000个字符。每一项都带您自己的item_id，并按提交顺序返回各自的状态（ok或failed），所以一个产品无法归类，也不会让整批失败。单个产品接口和批量接口共用您Key下的同一份条目配额。
取决于您的API Key（API密钥）怎么配置。每个Key都有自己的限流和条目配额，我们会先了解您的调用模式、IP白名单和峰值QPS，再配置生产环境的Key。超出时，API返回429 Too Many Requests，并附Retry-After响应头，告诉您的客户端要等几秒。
这个API面向企业客户，所以需要先预约沟通：点击本页顶部的“申请API Key”按钮。我们了解您的调用模式、IP白名单和峰值QPS后，按需设置Key的限流和条目配额，再通过邮件等线下渠道把Key发给您。
不需要。API返回的是研究结果：HTS编码和各层关税，供您的系统用于报价和报关准备。根据美国海关与边境保护局（CBP）裁定HQ H290535，为进口目的把具体货物归类到6位以上，属于19 U.S.C. § 1641规定的报关业务，因此编码用于报关之前须由持牌报关行复核。GingerControl不是报关行。
不能。这个API只覆盖美国进口归类和关税。出口管制归类在Export Control Classifier（ECCN判定工具）网页版工具中进行，该工具目前没有API。
在API参考页：gingercontrol.com/products/openapi。其中说明两个接口、每个请求和响应字段、错误码、请求头和限流规则，并附可以直接粘贴的curl示例。
