如何在 Zonos Catalog 中创建产品？

您可以通过 Dashboard 或 API 在 Zonos Catalog 中创建产品。在 Dashboard 中，转到 Catalog 并点击右上角的"Add product"。添加您的产品详情并点击 save product。如果您想一次创建多个产品，请按照导入产品的步骤进行。在 API 中，创建 catalogItemInputs 列表以将产品添加到您的目录。

如何在 Zonos Catalog 中编辑产品？

您可以通过 Dashboard 或 API 在 Zonos Catalog 中编辑产品。在 Dashboard 中，点击"All products"选项卡，选择您想要编辑的产品，进行更改，然后点击 save product。在 API 中，使用 CatalogItemUpdate 变更来编辑产品。

如何在 Zonos Catalog 中删除产品？

您可以通过 Dashboard 或 API 在 Zonos Catalog 中删除产品。在 Dashboard 中，点击"All products"选项卡，选择您想要删除的产品或多个产品，然后点击 delete。在 API 中，使用 CatalogItemDelete 变更来删除产品。

如何在 Zonos Catalog 中限制产品？

如果您想防止发送到某个国家（或多个国家），您可以在 Zonos Catalog 中创建或更新产品时添加限制。在 Dashboard 中，选择您想要添加限制的产品，在编辑页面底部找到限制部分，添加您想要限制您的产品的国家，然后点击 save product。在 API 中，在创建或更新 catalogItem 时添加 restrictedCountries。

如何在 Zonos Dashboard 中导出您的产品？

当您在 Zonos Dashboard 中导出您的产品时，它将自动以 CSV 文件形式导出您的整个产品目录。转到您的 Catalog 的主页，点击"Add product"旁边的 Export 按钮，并在您的下载中找到您的完整目录文件。

如何通过 API 对目录产品进行分类？

您可以通过在 ClassificationsCreateFromCatalog 变更中使用 catalogItemId 从您的目录对产品进行分类。请注意，要从您的目录对产品进行分类，需要 name。要同时创建和分类目录产品，请将 ClassificationsCreateFromCatalog 变更添加到您的 CatalogItemsCreate 变更。

首页全球电商产品目录管理产品

管理目录

创建和修改产品。

了解如何在 Dashboard 或通过 API 添加、修改和删除您的 Zonos Catalog 产品。如果您想避免编写代码或进行小的更改，请在 Dashboard 中使用 Catalog。如果您要直接与 Catalog 集成以进行生产实施，请使用 API。

创建产品

在 Catalog 中创建产品：

转到 Catalog，然后点击右上角的 Add product。
添加您的产品详情。创建产品所需的唯一字段是 SKU 和/或产品 ID 字段。这些字段将用于引用您的目录产品。详细了解 Catalog 的标识符。
可选—添加您的 HS 代码。
可选—添加您的运输信息（重量、尺寸、度量单位等）。
可选—添加限制国家。
点击 save product。

在 Catalog 中创建多个产品：

一次上传多个产品或您的整个产品目录。

重要提示： 如果您尝试创建已存在的产品，Catalog 将根据 SKU 和/或产品 ID 识别该产品，并使用新详情覆盖原始产品的详情。

将产品标记为危险品 (DHL)

对于 DHL 货运，您可以将产品标记为危险品，以便每次为该产品创建标签时都自动应用正确的 DHL 增值服务。这涵盖了管制货物的"低风险"或豁免等级—技术上受管制但在特殊条款或数量豁免下运输的物品。

危险品标签存储为目录项目属性：产品上的 key/value 对。属性通过 API 设置（catalogItemsCreate 或 catalogItemsUpdate）—Dashboard 中没有字段或 CSV 列。

仅限 DHL

危险品标记仅影响 DHL 货运。对于其他承运商，该标签将被忽略。

支持的属性键

DANGEROUS_GOODS 是用于 DHL 危险品标记的受支持属性键。它尚未列在 ItemAttributeInput 参考中的批准键中，但 API 接受它。

要标记产品，请添加键为 DANGEROUS_GOODS 的属性和以下支持类别之一的值。

1mutation CatalogItemsCreate(

2$sku: String!

3$name: String

4$attributes: [ItemAttributeInput!]

5) {

6 catalogItemsCreate(

7 input: [{ sku: $sku, name: $name, attributes: $attributes }]

8 ) {

9 id

10 name

11 sku

12 attributes {

13 key

14 value

15 }

16 }

17}

支持的危险品值

值↕	类别↕
`NOT_RESTRICTED_A70`	不受限制，特殊条款 A70—加压物品，如气体支柱和减震器 (UN3164)。
`NOT_RESTRICTED_A67`	不受限制，特殊条款 A67—由易燃液体驱动的发动机或机械装置 (UN3528)。
`NOT_RESTRICTED_A02`	不受限制，特殊条款 A02—根据 ADR 公路运输小型装载条款豁免。
`LIMITED_QUANTITY`	有限数量 (ADR)—在监管限制内包装成小数量的危险品。
`EXCEPTED_QUANTITY`	豁免数量 (IATA)—数量极少，可豁免大多数航空运输危险品规则。
`CONSUMER_COMMODITY`	消费品 ID8000—可直接零售的日常产品，含有少量危险成分，如喷雾剂和香水。
`MAGNETIZED_MATERIAL`	磁化材料 (UN2807)—磁场强度足以影响飞机仪器的物品。
`BIOLOGICAL_SUBSTANCE`	生物物质 (UN3373)—B 类生物物质，如诊断或临床样本。

在标签上自动应用标签

标记产品是第一步。要让 Zonos 自动将类别应用于您的 DHL 标签，请在标签设置中打开 Ship dangerous goods。您也可以在单个标签上手动选择一个类别—请参阅声明危险品。

编辑产品

编辑产品允许您有效地使用其他或更新的信息更新现有产品。您无需删除和重新上传产品，而是可以上传更新的信息，Catalog 将根据您的 SKU 或产品 ID（取决于您的项目关键首选项）将其与现有产品匹配。这样，您可以使用最少的工作量保持目录最新，无论您是使用 Dashboard 还是 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 代码保持不变。

要编辑产品：

点击 Products 选项卡。
选择您想要编辑的产品。
进行您的更改。
点击 save product。

要一次性编辑多个或所有产品，只需上传更新的 CSV 文件到 Catalog，包括您的 SKU 或产品 ID。这将触发对您现有项目的自动更新。

删除产品

要删除产品：

在 Dashboard 中点击 Products 选项卡。
选择您想要删除的产品。选中您的产品后，将出现删除按钮。
点击 Delete，然后点击 Delete all 以确认您的删除。

要删除所有产品：

选择 Dashboard 中的 Products 选项卡。
点击右上角的 Manage Catalog，然后点击 Delete all。
再次点击 Delete all 以确认您的删除。

请注意，如果您删除大量项目（超过 20,000 个产品左右），将显示一条通知，表明您的删除正在进行中。在此期间，您将无法与 Catalog 交互，直到删除完成。但是，您可以关闭通知并导航离开，而不会中断删除过程。

限制产品

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

Zonos Duty & Tax 应用不支持在国际订单中删除特定产品的项目级限制。如果购物车中有受限项目，则整个购物车必须被阻止发送到该国家。这是通过购物车级限制规则处理的，必须在入职期间提前配置。虽然 Catalog 与 Duty & Tax 应用兼容，但项目级限制仅在使用 Zonos Checkout 时支持。

要在 Catalog 中限制单个产品：

点击 Products 选项卡。
选择您想要添加限制的产品，这将打开编辑页面。
在编辑页面底部找到 Restricted countries 部分。
通过选择或输入国家名称来添加您想要限制您的产品的国家。
点击 save product。

要在 Catalog 中限制多个产品：

点击 Import/export 选项卡。
下载 Catalog 模板 CSV。
用您的产品详情填写模板，包括您的 SKU/Product ID 和限制国家。输入用竖线分隔的 2 位数 ISO 代码，例如 AU|KR|MY|SG。要限制所有国家，只需输入 ALL 作为值。如果您想限制除一个或几个国家外的所有国家，请输入 ALL- 后跟您想要不限制的国家，用竖线分隔，例如 ALL-CA|FR|US。详细了解 CSV 格式。如果您想删除所有现有的限制国家，请输入 NONE 作为值。
将您的文件保存为 CSV 并上传到 Catalog，方法是从您下载 CSV 的同一页面上拖放或点击 browse 选择您的文件。
在预览屏幕中查看您上传的产品，然后点击 upload。

筛选限制产品：

您可以从 Dashboard 下载整个目录为 CSV 格式，并在 Excel 或 Google Sheets 中打开它，直接在目录中筛选限制产品。从那里，您可以使用筛选功能仅查看限制产品。这样您可以轻松找到和管理目录中的限制产品。

如果您需要在对 CSV 进行更改后更新目录，请重新上传该文件，任何匹配的产品将被替换为更新的版本。这是通过识别和匹配 SKU 和/或产品 ID 完成的。

如果您使用 Checkout，当产品受限于客户所在国家时，您的结账页面将显示一条限制消息。默认情况下，该消息会显示："此商品限制进口到您的国家。"

筛选产品

您可以通过 Dashboard 或使用 SKU、产品 ID 或产品名称通过 API 在 Catalog 中搜索产品。对于 SKU 和产品 ID 搜索，只有精确匹配才会返回结果；不支持部分匹配。但是，按产品名称搜索时，支持部分匹配。

要按 SKU 或产品 ID 筛选：

在 Dashboard 中点击 Products 选项卡。
在您的 Catalog 的左上角选择 SKU 或 Product ID。
输入您的 SKU、产品 ID 或产品名称。
点击 Apply 以查看您筛选的产品。

要搜索产品的名称：

在 Dashboard 中点击 Products 选项卡。
在您的 Catalog 的右上角，将产品名称输入到搜索字段中。
查看您筛选的产品。

导出您的产品

如果您从 Catalog 表中选择 50 个或更少的项目，您的目录将直接从 Dashboard 下载。但是，如果您选择 Export all 或超过 50 个项目，您的 CSV 将通过电子邮件导出。

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

直接从 Catalog 表中选择 50 个或更少的项目。
点击右上角的 Export。
在您的电子邮件收件箱中找到您的 CSV 文件。

导出所有产品：

转到 Dashboard -> Products -> Catalog。
点击 Add product 旁边的 Manage Catalog 下拉菜单，然后点击 Export all。
在您的下载中找到您的目录文件。

无法从电子邮件下载？

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

右键点击您的电子邮件中的"Download"按钮。
选择"Copy link address"以复制下载 URL。
将复制的 URL 粘贴到您的浏览器中并按 Enter 键。
您的目录将随后直接从您的浏览器下载。

对产品进行分类

您可以通过在 ClassificationsCreateFromCatalog 变更中使用 catalogItemId 通过 API 从您的目录对产品进行分类。

请注意，要从您的目录对产品进行分类，需要 name。有关完整的目录和分类字段列表，请参阅 GraphQL API 参考。

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

将目录产品分类为 8+ 位（国家特定）

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

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

1mutation ClassificationsCreateFromCatalog(

2$catalogItemToClassify: [ClassificationFromCatalogInput!]!

3) {

4 classificationsCalculateFromCatalog(input: $catalogItemToClassify) {

5 id

6 configuration {

7 shipToCountries

8 }

9 hsCode {

10 code

11 }

12 name

13 }

14}

这是一个请求示例。虽然 Zonos Classify 将仅用 name 生成分类，但我们强烈建议添加尽可能多的详情以获取最佳分类结果。

1{

2 "catalogItemToClassify": [

3 {

4 "catalogItemId": "catalog_item_893jkdkllg03k9khjd9",

5 "configuration": {

6 "shipToCountries"

API 错误和解决方案

错误↕	解决方案↕
*需要 SKU 或产品 ID 来创建产品*	创建、编辑或删除目录项目需要标识符（SKU/product ID）。要解决此问题，请添加 SKU 和/或产品 ID。
*您尝试编辑的产品不存在**	您不能编辑不存在的产品。要解决此问题，请使用您想要的 SKU 和/或产品 ID 创建一个新产品。
*海关描述超过 30 个字符的字符限制。*	默认情况下，海关描述限制为 30 个字符，这与商业发票最常见的字符限制一致。
*产品类型无效。Catalog 支持以下产品类型：digital_good。对于物理商品，请留空。*	Catalog 仅支持以下产品类型：`digital_good` 和 `physical_good`。如果您的产品是物理商品（最常见），请留空此字段。
*包装首选项无效。Catalog 支持以下包装首选项：ships_alone 和 consolidated。如果您的产品可以与其他产品合并，请留空。*	包装首选项无效。Catalog 支持以下包装首选项：`ships_alone` 和 `consolidated`。如果您的产品可以与其他产品合并，您可以将其留空，因为 `consolidated` 是默认值。
*提供 HS 代码时必须指定国家*	如果您在创建项目时提供国家特定的 HS 代码，则需要发货国。要解决此问题，请添加发货国。
*价格必须大于 0*	Catalog 不支持负价格值。要解决此问题，请添加大于零的价格。
*提供价格值时必须提供货币代码*	如果您提供价格，则需要货币代码。要解决此问题，请添加货币代码。
*提供货币代码时必须提供价格*	如果您提供货币代码，则需要价格。要解决此问题，请添加价格。
*伴随的维度字段不能留空*	如果提供了一个维度字段，则需要另外两个字段，例如，如果您提供 8 英寸的宽度，则需要高度和长度。
*度量值必须大于 0*	Catalog 不支持负数或零度量值。要解决此问题，请添加大于零的值。
*提供维度值时，维度单位不能留空*	如果您提供维度值，则需要维度单位。要解决此问题，请添加维度单位。
*提供重量值时，重量单位不能留空*	如果您提供重量值，则需要重量单位。要解决此问题，请添加重量单位。

* 仅限 API 错误

GraphQL API ReferenceTypes, inputs, and operations used in this guide

INPUTS

ItemAttributeInput

预约演示