管理目录

重要： 如果您尝试创建一个已经存在的产品，Catalog 将根据 SKU 和/或产品 ID 识别该产品，并 用新细节覆盖原始产品的 细节。

编辑产品允许您高效地更新现有产品的附加或更新信息。您无需删除并重新上传产品，只需上传更新的信息，Catalog 将根据您的 SKU 或产品 ID 将其与现有产品匹配，具体取决于您的项目键首选项。这样，无论您使用 仪表板 还是 API 创建新产品或编辑现有产品，都可以以最小的努力保持您的目录最新。

如果您创建/编辑一个在 Catalog 中已经存在的目录产品，请期待以下情况：

Catalog 将覆盖现有项目的空白字段。

• 例如，如果现有产品 SKU 321 没有重量值，而同一产品 SKU 321 在新上传中有 1.3 磅的重量，则 1.3 磅的重量将覆盖之前的空白字段。

Catalog 将用新字段值覆盖现有字段。

• 例如，如果现有产品 SKU 123 的价格为 18.99 美元，而同一产品 SKU 123 的更新价格为 22.99 美元，则新价格 22.99 美元将覆盖之前的价格。

Catalog 不会用空白字段覆盖现有值。

• 例如，如果现有产品 SKU 456 的 HS 代码为 6109.10，但更新产品 SKU 456 的 HS 代码为空，则现有 HS 代码保持不变。

如果您想要防止向某个国家（或多个国家）发货，您可以在创建或更新产品时添加限制。

如果您正在使用 Checkout，当某个产品限制在客户的国家时，您的 checkout 中将显示一条限制消息。默认情况下，消息将显示为“此商品禁止进口到您的国家”，但您可以通过在添加国家限制时在 restrictedCountriesMessage 字段中提供自定义的限制消息来进行自定义。

您可以通过仪表板或 API 使用 SKU 或产品 ID 在目录中搜索产品。请注意，只有完全匹配的结果才会返回；部分匹配将不会被识别。

仪表板

API

要按 SKU 或产品 ID 进行过滤：

1. 点击 产品 标签。
2. 在目录的左上角选择 SKU 或 产品 ID。
3. 输入您的 SKU 或产品 ID。
4. 点击 应用 以查看您过滤后的产品。

如果您从目录表中选择 50 个或更少的项目，您的目录将直接从仪表板下载。然而，如果您选择 导出所有 或超过 50 个项目，您的 CSV 将通过电子邮件导出。

要导出 50 个或更少的项目，请按照以下步骤操作：

1. 从目录表中直接选择 50 个或更少的项目。
2. 点击右上角的 导出。
3. 在您的电子邮件收件箱中找到您的 CSV 文件。

要导出所有产品：

从您的电子邮件下载时遇到问题？

如果您在从电子邮件链接下载 CSV 时遇到问题，这可能是由于您的浏览器阻止了下载。如果是这样，请按照以下步骤操作：

1. 右键单击电子邮件中的“下载”按钮。
2. 选择“复制链接地址”以复制下载 URL。
3. 将复制的 URL 粘贴到您的浏览器中并按回车。
4. 您的目录将直接从浏览器下载。

您可以通过使用 catalogItemId 在 ClassificationsCreateFromCatalog 变更中，使用 API classify 您的目录中的产品。

请注意，classify 目录中的产品需要提供一个 name。请查阅 GraphQL API 参考 以获取完整的目录和分类字段列表。

要同时创建和 classify 目录产品，请将下面的 ClassificationsCreateFromCatalog 变更添加到您的 CatalogItemsCreate 变更。

Classify 目录产品到 8+ 位数字（特定国家）

当 shipToCountries 字段被填充时，分类将为 8+ 位数字（特定国家）HS 代码。如果未提供 shipToCountries，分类将默认为 6 位数字（通用）HS 代码。了解更多关于 通用和特定国家 HS 代码 之间的区别。

在下面的示例中，提供了 shipToCountries 字段以生成加拿大的特定国家代码。

mutation ClassificationsCreateFromCatalog(
  $catalogItemToClassify: [ClassificationFromCatalogInput!]!
) {
  classificationsCalculateFromCatalog(input: $catalogItemToClassify) {
    id
    configuration {
      shipToCountries
    }
    hsCode {
      code
    }
    name
  }
}

这里有一个请求的示例。虽然 Zonos Classify 只需一个 name 就能生成分类，但我们强烈建议添加尽可能多的细节，以获得 最佳分类结果。

{
  "catalogItemToClassify": [
    {
      "catalogItemId": "catalog_item_893jkdkllg03k9khjd9",
      "configuration": {
        "shipToCountries": ["CA"]
      }
    }
  ]
}

{
  "data": {
    "classificationsCreateFromCatalog": [
      {
        "id": "classification_8C49fk2945jmm232CcQtHtXdu",
        "configuration": {
          "shipToCountries": ["CA"]
        },
        "countryOfOrigin": "US",
        "hsCode": {
          "code": "6116.10.0020"
        },
        "name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter"
      }
    ]
  }
}

API 错误及解决方案

* 仅限 API 错误