DOCS

物品分类

物品分类

了解如何在 Dashboard 和通过 API 请求分类。

下面您将找到说明如何通过 Dashboard 或 API 请求通用和特定国家分类的示例。如需更全面的技术细节和详尽文档,请访问我们的 Zonos GraphQL API 参考开发者网站。此全面资源提供了有关 API 端点、GraphQL 变更和详尽技术信息的深入见解。

输入字段 

虽然仅需提供描述即可生成分类,但您提供的产品细节越多,您的分类就越准确。或者,您可以简单地提供产品网址,Classify 将自动提取所有相关物品详情。下面是 Classify 接受的每个输入字段的全面说明。通过理解这些输入字段,您可以最大化其使用并生成高度准确的分类。

字段描述
名称 (必需)产品的名称
产品网址 (可选)粘贴产品网址,Classify 将自动获取页面并提取相关物品详情(名称、描述、类别等)用于分类。在 Dashboard 中,通过点击 + 图标或在主文本字段中直接添加即可。对于 API 集成,请联系您的 Zonos 代表。虽然非常适合演示和测试,但生产实现通过直接从后端系统传递物品数据可以实现最优性能和成本效率。
描述 (可选)产品的深入、长篇描述
图像网址 (可选)产品图像的链接。注意:确保您使用的是实际图像网址的链接,而不是产品页面网址
类别 (可选)常规子产品类别,例如 服装和配件、宠物用品、办公产品婴儿衣服、宠物床、胶粘剂和胶带
材料 (可选)产品由什么材料制成,例如 塑料、木材、钢铁
原产地 (可选)产品制造或生产所在国家的 两字母缩写 (ISO 代码)
提供的 HS 代码 (可选)在分类请求中包含现有 HS 代码来指导您的请求。根据您的偏好和提供的 HS 代码的来源,Classify 可以验证 HS 代码并检查其与物品描述详情的一致性。了解更多
目的地国家 (可选)确定产品将被分类到哪个国家。目的地国家必须使用该国家的 两字母缩写 (ISO 代码) 显示,而不是实际国家名称,例如 AU,而不是 Australia。包含此字段将使 Classify 能够返回 8 位或更多位数字的特定国家 HS 代码,而不是通用的 6 位代码。详见了解 通用 HS 代码和特定国家 HS 代码的区别
产品 ID (可选)您的产品 ID 或任何可用于唯一识别每个产品的数字。如果未提供产品 ID,Classify 将分配从 1 开始的产品 ID

注意: 如果您在 Dashboard 中上传批量请求 CSV,目的地国家将不是模板的一部分;相反,您将在上传批量请求 CSV 后选择您的目的地国家。

请求分类 

要在 Dashboard 或通过 API 请求分类,请遵循以下步骤和变更。

下面的示例展示了通用 (6 位数) 请求。要请求特定国家的分类,请在 Classify 请求中添加这些国家的 ISO 代码,如下面的示例所示。要请求通用 HS 代码,在 Classify 请求中将配送到国家设置为 null

输入接受列表,因此您可以一次请求许多或单个分类。

注意: 要通过 API 生成 审计跟踪,请在您的查询中包含 auditTrail 字段。请联系您的 Zonos 代表以获取访问权限和实现详情。

1mutation ClassifyItems($input: [ClassificationCalculateInput!]!) {
2 classificationsCalculate(input: $input) {
3 id
4 name
5 categories
6 imageUrl
7 hsCode {
8 code
9 description {
10 full
11 }
12 }
13 }
14}

可能的 API 响应

当 Classify 收到分类请求时,它会尝试根据最高置信度分数将请求中包含的输入物品数据与 Classify 数据库中的匹配相匹配。根据找到的内容,Classify 将返回以下响应之一:

  1. 当返回 hsCode 且包含 6 位到 8+ 位的 HS 代码时,取决于请求中是否包含配送到国家,您的分类请求成功。
  2. 当返回 {"errors": [ { "message": "No adequate response"}]} 时,意味着 Classify 由于输入信息不足而无法找到分类。
GraphQL API ReferenceTypes, inputs, and operations used in this guide
预约演示

这个页面有帮助吗?


在此页面: