如何用 API 查一家公司的海关进出口记录

海关申报里的公司名写法非常混乱：同一家公司可能出现 “ACME INC”、“Acme Incorporated”、“ACME INC.” 三种写法。直接用用户输入的名字去查，命中率会很低。先调用企业匹配接口，把名称或域名映射到一个标准实体上。

• 输入优先用域名，其次是公司全称，最后才是简称。
• 拿到标准名后保存实体 ID，后续所有查询都用 ID。
• 同名公司返回多条时，用国家和行业做二次过滤。

拿到实体后，按角色（收货人 / 发货人）拉取海关记录。建议第一次调用先限制时间范围，例如最近 12 个月，确认字段和数据量之后再做全量回溯。

典型返回字段包括：发货人、收货人、HS 编码、品名、数量、金额、起运港、目的港、船公司、提单日期。

原始提单本身不是结论。真正有用的是聚合视图：这家公司主要进口哪些 HS 编码、前五大供应商是谁、采购频次是否在上升、最近是否换过供应商。这几个信号直接决定要不要跟进以及用什么话术开场。

• 按 HS 编码分组，得到采购品类结构。
• 按对手方分组，得到现有供应商名单。
• 按月分组，得到采购趋势和季节性。

• 覆盖度因国家而异：美国、印度、越南等国家的提单数据最完整，部分欧洲国家仅有汇总数据。
• 不要把金额字段当成成交价，它是申报价值。
• 做增量同步时用响应里的时间戳，而不是本地时间。