分类准备情况

customsDescriptionValidate 变更在分类运行之前检查商品的信息是否足以自信地分配一个 6 位数的 HS 代码。它返回一个准备情况状态，您可以应用自己的策略来处理该状态——继续分类、警告、向购物者或商家寻求更多详细信息，或拒绝该商品。

这是一个预飞行检查，而不是分类：customsDescriptionValidate 不会对商品进行分类，也不会返回 HS 代码。使用它可以预先捕获薄弱或无法使用的描述，以便您最终发送到 Classify 的描述能够产生准确、无假设的结果。

准备情况检查只是一个用途。由于相同的商品数据驱动 Zonos 的海关描述和分类服务，此变更是更广泛的 Customs Description 工作流程的入口点——把关数据质量，然后从商品生成符合规范的海关描述。请参阅下面的 不仅仅是分类把关。

准备情况状态 

每个验证都返回一个 status。状态是建议性的——您的集成决定了每个值的后果。

当状态为 INCOMPLETE 时，missingAttributes 字段返回缺失的属性作为短语形式（例如 "fiber content"（纤维含量）或 "material, construction"（材料、构造）），适合用于组成用户界面消息。对于任何其他状态，它为 null。

通过 API 验证商品 

直接提供商品字段——至少需要一个描述字段。下面的示例验证一个商品，其名称和描述将其识别为 T 恤，但省略了分类所需的纤维含量，所以变更返回 INCOMPLETE。

输入字段

提供 existingItemId 或直接提供商品字段——至少需要一个描述字段。

验证现有商品 

如果商品已经在 Zonos 中存在，请将其 ID 作为 existingItemId 传递，而不是重新发送每个字段。存储项的字段用作验证的基础，您在同一输入中也提供的任何字段都会覆盖存储值——对测试编辑是否会使薄弱商品达到分类就绪状态很有用。

响应 content 回显已验证的商品数据，其中 existingItemId 已解析，因此每个存储的 CustomsDescriptionValidation 都是自描述的。

不仅仅是分类把关 

由于准备情况状态是建议性的，相同的检查为多个工作流程提供支持——它不仅仅是关于决定是否分类。customsDescriptionValidate 评估 Zonos 的分类和海关描述服务使用的相同商品数据，这使其成为更广泛的 Customs Description 工作流程的自然首步：

• 数据质量把关 — 在输入点（在 PIM、目录导入或结账处）识别薄弱或无法使用的商品信息，并使用 missingAttributes 提示所需的内容，然后该数据向下游流动。
• 生成海关描述 — 一旦商品处于 READY 状态，将相同的数据提交给 customsDescriptionsCreate 变更，以让 Zonos 从商品生成简洁的、符合海关和 ICS2 规范的海关描述——可选择在同一调用中请求 HS 代码。提前验证准备情况意味着生成的描述是基于完整信息而不是假设构建的。
• 自信地分类 — 继续 Classify，了解描述足够丰富以分配准确的 6 位数 HS 代码，无需猜测。

典型的端到端流程是：验证准备情况 → 收集任何 missingAttributes → 生成符合规范的海关描述（和 HS 代码）→ 分类或存档。