SaaS平台的嵌入式HS归类:不自己开发,怎样加进产品
本次更新:工具清单、排名和参考资料已更新。
SaaS平台嵌入HS归类的做法,是在自己的产品(ERP、订单系统、TMS(运输管理系统)或电商平台)里调用归类API,并在自家的工作流程里显示结果,而不是自己开发归类引擎。真正要紧的设计取舍有三个:API返回什么(编码、关税、理由),用户在编码进入报关单之前怎样复核,以及法律界线:CBP认定,为他人将要进口的货物提供6位以上的编码,属于报关业务。如果你的平台服务500家进口商,要做的是复核环节,而不是归类引擎。
嵌入式HS归类,是指你的用户直接在你的软件里拿到税则编码,编码来自你调用的API,而不是另一个单独的工具。GingerControl的Classification + Tariff Calculation API(归类与关税计算API)就是这样一个API:一次调用返回10位HTS编码(美国海关编码)及其美国各层关税;它面向企业客户,从一次沟通开始,之后你会拿到一个按你的调用模式配置的API Key(API密钥)。我是GingerControl联合创始人Chen Cui。本文讲的是嵌入任何API时都适用的设计和法律界线,不构成法律意见。
不自己开发,怎样在SaaS平台里嵌入HS归类?
在你的产品里调用归类API,把编码连同相关信息一起显示,再加上一道复核步骤,按这个顺序做:
- 映射产品字段(名称、描述、材质、用途、原产地),对应到API的输入。描述太简略,编码也就靠不住。
- 调用API,服务商允许的话就批量调用;GingerControl的API默认每次调用120条,按你的吞吐量配置。
- 把编码连同相关信息一起显示:HTS描述、按用户的原产国和日期计算的关税,以及API返回的任何理由或置信度。
- 让用户复核并审批,要用于报关的编码,转给用户的持牌报关行。
- 记录每个结果,连同日期和HTS修订版;税则一变,就重新核对。
可引用的观点:对SaaS平台来说,归类引擎是可以买来的部分;复核环节才是用户评判你的地方。一个编码如果连同关税、理由和一个审批按钮一起出现,能帮进口商尽到合理注意义务。一个编码如果悄无声息地出现在某个字段里,对谁都没有帮助,还可能让平台越过CBP划定的报关业务界线。
嵌入的功能应该向用户显示什么?
显示的信息要足够让用户核对编码,而不只是照抄。
| 要素 | 为什么重要 |
|---|---|
| 编码及其官方描述 | 用户能看到这个编码涵盖什么 |
| 发送给API的产品信息 | 信息错了,就能解释编码为什么错 |
| 按用户的原产国和日期计算的关税 | 这是编码的实际成本;Section 301和232取决于原产国和报关日期 |
| 理由或置信度(如果API返回) | 让用户有东西可以复核,而不只是接受 |
| 日期和HTS修订版 | 按我们对USITC版本列表的统计,截至2026年10月9日,2026年版HTS已有21次修订[1] |
| 复核和审批状态 | 谁核对过,报关行是否已确认 |
平台的法律界线在哪里?
界线在于:平台是否为用户将要进口的货物提供6位以上的编码,以及这些输出是否与报关申报分开。「替他人」归类货物属于报关业务,需要报关行执照,而6位归类不属于(HQ H290535)[2]。在HQ H350722中,CBP把这一点适用于一个平台的AI工具:「超过6位层级……如果被归类的商品将要报关」的建议属于报关业务;而一个工具如果提供「与实际或预期的进口脱钩」的一般信息,「与对接进口商和报关行的门户分开运行」,并且免责声明得到「切实落实」,就是被允许的[3]。同一份裁定还认定,仅仅在进口商和报关行之间传输数据,不属于报关业务。
这份裁定按服务逐项拆解,见CBP裁定HQ H350722对AI归类工具说了什么;你的用户可以照着做的流程,见如何合法使用AI归类工具。你的产品设计怎样对应这条界线,请向关务律师请教。
平台可以嵌入哪些归类API?
好几家服务商都在卖归类API;区别在于一次调用返回什么,以及怎样开通。
| API | 一次调用返回什么(来自它自己的页面) | 开通方式 |
|---|---|---|
| GingerControl Classification + Tariff Calculation API | 10位HTS编码和调用时有效的美国各层关税;拆分编码组合货品的关税按组成部分返回 | 企业客户,从一次沟通开始 |
| Gaia Dynamics Platform API | 「归类建议……附带理由和置信度」以及关税估算 | 申请开通;未公布API价格 |
| Zonos Classify | 近200个国家的6至14位HS编码 | 1,000次免费,之后每月US$500起 |
| Avalara Item Classification API | 180多个国家的各国编码;供AI智能体使用的MCP服务器 | 需报价 |
| TariffLens API | 美国HTS和欧盟CN的hts_code、reasoning、supporting_rulings | 申请开通;未公布价格 |
来源:[4]。这几家的并排评分,见最佳HTS归类API;和Avalara归类产品(前身为3CE)的正面对比,见3CE vs GingerControl。GingerControl没有公布白标或转售条款;API开通从一次沟通开始。GingerControl的归类结果仅供一般参考、教育和规划用途;编码写进报关单之前,由你的用户的持牌报关行复核。GingerControl不是报关行,不代为报关,也不提供法律意见。
该自建、嵌入,还是两者都做?
归类是为你的产品服务时,就嵌入;只有归类本身就是你的产品时,才自建。其中的取舍见HTS归类:自建还是采购;平台可以和归类API搭配使用、提供税则数据的免费USITC API,在HTS查询API与人工归类对比里有说明。
把归类接进你的平台
先设计用户会看到的复核界面,再挑能把它填满的API。如果你的用户向美国进口,需要编码及其美国各层关税,Classification + Tariff Calculation API一次调用就能同时返回两者。和我们聊聊怎样嵌入这个API
参考资料
- U.S. International Trade Commission, HTS release list (read October 11, 2026)
引用数据:2025年版HTS共32次修订;2026年版HTS的Revision 21自2026年10月9日起生效
来源:USITC HTS release list - U.S. Customs and Border Protection, ruling HQ H290535 (September 29, 2022)
引用数据:「替他人归类货物属于『报关业务』」;归类到6位层级不属于报关业务
来源:CBP CROSS, HQ H290535 - U.S. Customs and Border Protection, ruling HQ H350722 (January 16, 2026)
引用数据:6位这条线和与报关的关联性;「与实际或预期的进口脱钩」的一般信息;「与对接进口商和报关行的门户分开运行」;免责声明「切实落实」;在进口商和报关行之间传输数据不属于报关业务;「工具不构成『人』」
来源:CBP CROSS, HQ H350722 - Gaia Dynamics Platform API and API access pages; Zonos Classify page and plans page; Avalara Tariff Code Classification and Classification MCP Server pages; TariffLens API docs; SimplyDuty Pricing page; Descartes Product Classification and Duty Determination page (all read October 11, 2026)
引用数据:Gaia「归类建议……附带理由和置信度」以及关税估算,API申请开通,未公布API价格;Zonos 6至14位、近200个国家、1,000次免费之后每月500美元起;Avalara 180多个国家、MCP服务器;TariffLens字段hts_code、reasoning和supporting_rulings,覆盖US-HTS和EU-CN,申请开通,未公布价格;SimplyDuty Product Classification API每次API调用0.10英镑;Descartes「强大的API与SaaS可扩展性」,未公布价格
常见问题
SaaS平台不自己开发,怎样加入HS归类功能?
在自己的产品里调用归类API,并在自家的工作流程里显示结果。对服务500家进口商的ERP或电商平台来说,要做的是:把产品字段映射到API的输入,显示编码及其关税和理由,加上一道复核和审批步骤,记录每个结果及其日期,并在HTS变化时重新核对编码。
SaaS平台可以向用户显示10位HTS编码吗?
要看这些编码怎么用,所以请教关务律师。CBP认定,替他人把货物归类到6位以上属于报关业务(HQ H290535),并把这一点适用于一个平台上的AI工具,而这个平台用户的货物将要报关(HQ H350722)。在那份裁定中,作为一般参考、与报关行门户分开、并切实落实了免责声明的输出,是被允许的;6位归类不属于报关业务。
用于嵌入时,归类API应该返回什么?
至少要有编码及其描述;最好还有按用户的原产国和日期计算的关税、编码背后的理由或置信度,以及一个能对应到HTS修订版的时间戳。对每月处理3,000个SKU的TMS(运输管理系统)来说,GingerControl的Classification + Tariff Calculation API返回10位HTS编码,以及调用时有效的美国各层关税。
HTS变化时,怎样让嵌入的HS编码保持最新?
每个编码都连同日期和HTS修订版一起存储,一旦某次修订涉及你的用户商品所在的章,就重新核对。按我们对USITC版本列表的统计,2025年版HTS共有32次修订,截至2026年10月9日,2026年版HTS已有21次。对存有50,000个用户SKU的平台来说,免费的USITC API有一个releaseList接口,会告诉你什么时候发布了新的修订版。
嵌入式归类API要花多少钱?
2026年10月11日读取的公开价格:SimplyDuty的归类API每次调用0.10英镑;Zonos Classify在1,000次免费归类之后,每月500美元起。Avalara、Descartes和GingerControl的企业级API需报价。对每月调用20,000次的平台来说,请每家服务商书面写明每次调用的上限和用量条款。
嵌入式归类API适合电商平台吗?
适合,最合适的选择要看具体做什么。如果电商平台要在结账时计算多个国家的关税,Zonos和Avalara就是为此设计的。如果平台上的卖家向美国进口,需要编码及其美国各层关税,GingerControl的API一次调用就同时返回两者,默认每次调用120条。
归类决定该由平台负责,还是由用户负责?
由进口货物的用户负责:登记进口商(IOR)依照19 U.S.C. 1484,尽合理注意义务申报归类;CBP在HQ H350722中说,工具不是人,所以凡是涉及报关业务,都必须由持牌报关行来判定。对服务300家进口商的平台来说,产品要设计成由用户和他们的报关行复核并审批编码。
签约之前,SaaS团队应该问归类API服务商哪些问题?
问清楚每个响应包含什么(编码、关税、理由)、每次调用的上限、Key怎样发放、结果用的是哪个HTS修订版、结果怎样标注日期,以及服务商说用户可以拿这些编码做什么。对计划每月调用10,000次的平台团队来说,还要拿50个用户的报关行已经归类过的条目测一遍,并做比较。
还在一条一条查裁定来给SKU归类?
交给GingerOS处理。
在下一页选一个30分钟的时段,与我们的CEO Chen Cui通话。带上一份公告或一份SKU清单(ERP导出文件、Excel表格或一封邮件都行),看看GingerOS怎么处理。
审校:Michael Weick, LCB / CCS




