DOCS

目录 API

直接从您自己的系统,以编程方式构建您的 Verified Account 目录。

目录 API 是构建 Verified Account 目录的三种方式之一,适用于拥有开发资源、且已有系统保存其商品数据的发货方——例如 ERP、WMS、PIM 或发货平台。该系统始终作为唯一数据来源,直接将商品写入 Zonos,而不是通过渠道集成同步或上传 CSV 文件。如果您通过受支持的渠道销售,或者不想编写代码,这两种方式能以更少的工作量构建同样的目录。

通过 API 创建的商品与其他任何来源的商品享有完全相同的处理方式——商品一旦进入您的目录,Zonos 并不关心它是如何进入的。每件商品都会在您未提供 HS 编码时进行海关归类,接受美国合作政府机构(PGA)要求审查,并用于计算其所在货件的关税和税费。

其中有一个环节不在 API 范围内。当 PGA 审查将某件商品标记为 Needs attention 时,该标记背后的合规问卷必须在 Dashboard 中回答并确认——没有相应的 API。Zonos 会尽可能预填答案,因此大部分工作只是审核和确认。构建此集成的人通常并不是处理这些标记的人,因此请安排您组织中的相关人员在目录导入完成后,在 Dashboard 中逐一处理这些标记。被标记的商品不会被阻止发货,但在发货前清除这些标记,才能避免货件在美国边境被扣留。

工作原理 

  1. 为您发运的每件商品创建一个目录商品。

  2. 确保每个商品都带有您的邮政承运商会传递的标识符。

  3. 当您的货件数据到达 Zonos 时,每个行项目都会与您的目录商品进行匹配,并将该商品的产品数据应用于计算。

GraphQL API ReferenceTypes, inputs, and operations used in this guide
预约演示

这个页面有帮助吗?


获取支持·法律文件·© 2026 Zonos