DOCS

捆绑产品

首页全球电商 产品目录 捆绑产品

捆绑产品

以准确的完税成本和灵活的装箱选项销售捆绑产品。

捆绑产品是作为单个（父级）单位销售的产品，在结账时会分解为单个组件项。当客户购买捆绑产品时，Zonos将其展开为各组件，将每个组件的价格折扣以匹配捆绑产品价格，并根据每个组件的HS编码和原产地计算关税和税费。

例如，商家单独销售衬衫，每件30美元，或以4件100美元的价格捆绑销售。当客户购买该捆绑产品时：

  • 订单和商业发票显示4件衬衫，每件25美元（而不是1个捆绑产品100美元，或4件衬衫每件30美元）
  • 每件衬衫的HS编码和原产地用于完税成本计算
  • 运费根据商家实际运送时使用的箱子尺寸计算

装箱模式 

捆绑产品支持两种装箱模式，用于控制运输时物品的装箱方式：

指定箱子

商家预先将物品分配到具有已知尺寸的特定箱子。每个箱子都定义了长度、宽度、高度和承重能力。分箱使用这些确切的箱子，而不是进行估算。

**最适合：**您已知装运箱子的产品，或始终装运在同一箱子中的捆绑产品。

自动装箱

商家将物品分组为捆绑产品，而不指定箱子。在下单时，Zonos使用其分箱算法，根据物品的尺寸和可用的包装选项确定最佳装箱方式。

**最适合：**装箱方式各异的捆绑产品、具有灵活包装的产品，或者您希望Zonos自动优化箱子选择的情况。

两种模式都会将捆绑产品展开为具有按项HS编码、原产地和折扣定价的单个组件。区别仅在于箱子的确定方式。

捆绑产品如何工作 

在Catalog中创建捆绑产品时，您需要定义：

  • 捆绑产品SKU或产品ID——与您商店匹配的产品标识符
  • 捆绑产品价格——商店中显示的总价格
  • 装箱模式——指定箱子或自动装箱
  • 组件项——捆绑产品中包含的每个单个产品，通过其catalog项ID引用。在将组件添加到捆绑产品之前，组件必须已存在为catalog项。
  • 箱子分配（仅限指定箱子模式）——哪些组件装运在哪个箱子中，包含真实的尺寸和重量

当放置包含捆绑产品的订单时，Zonos会自动：

  1. 展开捆绑产品为其各个组件
  2. 对每个组件进行折扣，使用计算出的价格比率，使每项价格与捆绑产品价格相匹配
  3. 计算完税成本，使用每个组件的HS编码、原产地和箱子尺寸——提供准确的关税、税费和运费总额
  4. 生成标签——指定箱子的捆绑产品每个定义的箱子获得一个标签；自动装箱的捆绑产品根据分箱结果生成标签

前提条件 

在创建捆绑产品之前，请确保：

  • 所有组件项都存在为Zonos Catalog中的catalog项。捆绑产品通过其catalog项ID引用组件——您不能添加不存在的项。组件不需要在商店中单独销售——它们可以仅作为捆绑产品部分存在于您的catalog中。
  • 每个组件都有准确的HS编码、原产地和尺寸（重量和尺寸）。这些用于在捆绑产品展开时进行完税成本计算。
  • 捆绑产品的SKU或产品ID与您的电子商务平台发送给Zonos的标识符以及您的Zonos Dashboard中的Item key偏好匹配。对于Shopify商店，捆绑产品的产品ID必须是捆绑产品的Shopify变体ID。

每个捆绑产品必须至少包含2个组件项。单项捆绑产品应改为独立的catalog项。

  1. 转到Dashboard > Products > Bundles。
  2. 单击右上角的Add Bundle。
  3. 输入捆绑产品SKU或产品ID——必须与您的商店发送给Zonos的标识符相匹配。您的Zonos Dashboard的Item key偏好也必须设置为正确的标识符。
  4. 输入捆绑产品名称、价格和货币。
  5. 选择指定箱子作为装箱模式。
  6. 添加具有特定尺寸（长度、宽度、高度和承重能力）的箱子。
  7. 通过搜索您的catalog添加组件项，并将每个组件分配给一个箱子。对于每个组件，指定：
    • 数量——该组件在捆绑产品中有多少单位
    • 箱子——该组件装运在哪个箱子中
    • 价格比率——该组件代表的捆绑产品价格的部分（如果留空则自动计算）
  8. 单击Save。

Manage > Import中提供两种导入选项：

导入捆绑产品

创建引用现有catalog项的捆绑产品。组件项必须在导入前已存在于您的catalog中。

  1. 转到Dashboard > Products > Bundles。
  2. 单击Manage > Import bundles。
  3. 下载示例CSV模板——选择指定箱子或自动装箱格式。
  4. 为每个组件项填写一行。捆绑产品级别字段（SKU、名称、价格）在同一捆绑产品的每一行中重复。
  5. 上传您完成的CSV并单击Import。

捆绑产品CSV字段 

列↕描述↕
Bundle SKU捆绑产品在您商店中显示的SKU。
Bundle Product ID捆绑产品在您商店中显示的产品ID。
Bundle Name捆绑产品的名称。
Bundle Description捆绑产品的描述。
Bundle Image URL捆绑产品的图像URL。
Bundle Amount捆绑产品的总价格。
Bundle Currency捆绑产品价格的货币，例如USD。
Box Number该行组件装运在的箱子号，例如1或2。对同一箱子中的所有组件使用相同编号。
Box Length该行箱子的长度。
Box Width该行箱子的宽度。
Box Height该行箱子的高度。
Box Dimensional Unit箱子的尺寸单位，例如INCH。
Box Weight Capacity箱子的最大承重能力。
Box Weight Unit箱子承重能力的重量单位，例如POUND。
Item SKU该组件项的SKU。必须与现有catalog项匹配。
Item Product ID该组件项的产品ID。必须与现有catalog项匹配。
Item Quantity该组件在捆绑产品中的单位数量。

**注意：**为向后兼容，"Bundle"和"Kit"两种列前缀均可接受（例如，"Kit SKU"与"Bundle SKU"效果相同）。

CSV导入验证规则 

以下验证规则适用于所有捆绑产品CSV导入：

  • 最少2个项——每个捆绑产品必须至少包含2个组件项。单项捆绑产品应改为独立的catalog项。
  • 箱子字段全有或全无——对于指定箱子的捆绑产品，每行必须包含全部6个箱子字段：Box Length、Box Width、Box Height、Box Dimensional Unit、Box Weight Capacity和Box Weight Unit。如果设置了任何一个箱子字段，则全部6个都为必填。如果所有箱子字段均为空，则该捆绑产品被视为自动装箱。
  • 不可混合装箱模式——单个捆绑产品不能混合指定箱子行（含箱子尺寸）和自动装箱行（不含箱子尺寸）。同一捆绑产品的所有行必须使用相同的模式。
  • HS编码归一化——导入时HS编码会自动格式化。非字母数字字符（点、破折号、空格）会被去除，编码将归一化为偶数位数格式。

导入捆绑产品和catalog项 

在一次上传中同时创建catalog项和捆绑产品。当您的组件项尚不存在于catalog中时使用此选项——它们将自动创建或更新。

  1. 转到Dashboard > Products > Bundles。
  2. 单击Manage > Import bundles + catalog items。
  3. 下载示例CSV模板——选择指定箱子或自动装箱格式。
  4. 为每个组件项填写一行，包括项目详情列（名称、HS编码、原产地、尺寸）。
  5. 上传您完成的CSV并单击Import。

导入首先创建或更新子catalog项，然后创建引用这些项的捆绑产品。如果具有相同SKU或产品ID的项已存在，其详情将使用CSV中的值进行更新。HS编码在导入期间会自动归一化（非字母数字字符会被移除，编码将格式化为标准偶数位数格式）。

组合CSV字段 

包括所有捆绑产品CSV字段以及项目详情列：

列↕描述↕
Bundle SKU捆绑产品的SKU。
Bundle Product ID捆绑产品的产品ID。
Bundle Name捆绑产品的名称。
Bundle Description捆绑产品的描述。
Bundle Image URL捆绑产品的图像URL。
Bundle Amount捆绑产品的总价格。
Bundle Currency捆绑产品价格的货币，例如USD。
Box Number该组件装运在的箱子号。
Box Length箱子的长度。
Box Width箱子的宽度。
Box Height箱子的高度。
Box Dimensional Unit尺寸单位，例如INCH。
Box Weight Capacity箱子的承重能力。
Box Weight Unit重量单位，例如POUND。
Item SKU组件项的SKU。
Item Product ID组件项的产品ID。
Item Namecatalog项的显示名称。
Item Description项目的描述。
Item HS Code用于海关分类的协调制度编码。
Item Country of Origin项目生产国的两字母国家代码，例如CN。
Item Weight项目的重量。
Item Weight Unit重量单位，例如POUND。
Item Length项目的长度。
Item Width项目的宽度。
Item Height项目的高度。
Item Dimensional Unit项目尺寸的尺寸单位，例如INCH。
Item Quantity该组件在捆绑产品中的单位数量。
Item Amount单个组件项的价格。用于创建或更新catalog项。
Item Currency项目价格的货币，例如USD。
Item Packing Preference该项应如何装箱。对在指定箱子中装箱的项使用ASSIGNED_BOX，对由分箱确定装箱方式的项使用CONSOLIDATED，对必须单独装运的项使用SHIPS_ALONE。可选——如果存在箱子列，则默认为ASSIGNED_BOX。
  1. 转到Dashboard > Products > Bundles。
  2. 单击Manage > Export。
  3. 选择导出选项：
    • Export all bundles——导出所有捆绑产品
    • Export assigned box bundles——仅导出具有预先分配箱子的捆绑产品
    • Export auto bundles——仅导出自动装箱的捆绑产品
  4. 单击Export。CSV准备好后将通过电子邮件发送给您。

**注意：**对捆绑产品的编辑仅影响未来订单。已放置和履行的订单不受影响。

  1. 转到Dashboard > Products > Bundles。
  2. 单击要编辑的捆绑产品。
  3. 更新字段并单击Save。

您可以更改装箱模式、添加或删除组件、更新箱子分配以及修改捆绑产品价格。

要删除单个捆绑产品，请打开该捆绑产品并单击Delete。

要一次删除多个捆绑产品：

  1. 使用复选框选择要删除的捆绑产品。
  2. 单击Delete selected。
  3. 确认删除。

要删除当前页面上的所有捆绑产品，请单击Manage → Delete page。

您可以直接从报价工具将捆绑产品添加到报价中，以便在下单前预览完税成本。

  1. 在报价工具中，切换到Items部分的Search bundles选项卡。
  2. 按名称、SKU或产品ID搜索捆绑产品。
  3. 选择一个捆绑产品。Zonos会自动：
    • 展开捆绑产品为项目列表中的单个组件项，每个组件都有其自己的HS编码、原产地和折扣价格。
    • 填充箱子（仅限指定箱子的捆绑产品）——捆绑产品预定义的箱子会被添加到Boxes部分，并预先填充其尺寸。
    • 跳过箱子填充（自动装箱的捆绑产品）——计算报价时由分箱确定箱子。
  4. 组件项在项目列表中按捆绑产品名称分组显示。
  5. 计算报价。完税成本反映了实际的捆绑产品结构——基于真实或自动确定的箱子尺寸计算的按组件关税、税费和运费。

您可以将多个捆绑产品和独立项添加到同一报价中。每个捆绑产品独立展开。

为什么捆绑产品对完税成本很重要 

没有捆绑产品，Zonos只能看到单个行项（例如，"Truck Tire 4-Pack — $1,000"），无法了解其中包含的内容。这会导致以下问题：

  • 没有按项目的HS编码——Zonos无法对组件进行分类以获得准确的关税率
  • 没有真实的箱子尺寸——运费使用自动打包算法估算，而不是商家的实际箱子
  • 没有按项目定价——使用完整捆绑产品价格进行关税计算，而不是折扣后的按组件价格

捆绑产品通过预先提供组件分解、箱子分配（或自动装箱分组）和价格分配来解决这三个问题。结果是一个完税成本报价，反映了客户实际在边境支付的费用。

价格比率和组件定价 

当捆绑产品被售出时，Zonos需要知道每个组件的单独价值。这是因为国际货运要求在商业发票上为每个项目申报价值，并且关税/税费是针对每个项目单独计算的。

priceRatio控制捆绑产品的总价格如何在其各组件之间分配。您无需自行设置此项——如果留空，Zonos会自动在所有组件之间平均分配价格。

例如，一个包含4个轮胎且未设置价格比率的1,000美元捆绑产品，将自动为每个轮胎申报250美元（各占0.25）。如果您的组件具有不同的价值——例如2个高级轮胎和2个标准轮胎——您可以手动设置比率，例如0.35和0.15，以反映实际的价值差异。

Zonos会自动归一化比率，因此您无需担心计算问题：

  • 如果您将某些比率留空，剩余价值将在这些组件之间平均分配
  • 如果比率总和不等于1.0，Zonos会按比例缩放它们
  • 最终比率总是精确等于1.0

打包和标签 

指定箱子的捆绑产品组件使用商家定义的箱子，而不是标准的分箱算法。每个组件的packingPreference设置为ASSIGNED_BOX，这告诉分箱系统将其放置在由packageOptionId和packageOptionIdIndex指定的箱子中。

这是指定箱子捆绑产品的核心优势——商家确切知道其产品如何运送，因此用于完税成本计算的箱子尺寸和重量是准确的，而非估算的。

捆绑产品中的每个箱子都会生成带有自己跟踪号的运输标签。包含两个箱子的捆绑产品会生成两个标签。

混合订单

同一订单中的非捆绑产品项使用标准分箱算法单独打包，无论捆绑产品使用哪种装箱模式。

混合捆绑产品订单 

单个订单可以同时包含多个捆绑产品和独立项。例如，一个订单包含：

  • 1个采用指定箱子的4件装捆绑产品（装运在2个箱子中）
  • 1个3件装的自动装箱捆绑产品（由分箱确定装箱方式）
  • 1个独立项

Zonos独立展开每个捆绑产品。完税成本计算涵盖所有具有准确尺寸的箱子以及所有单个组件的价格。每个箱子获得自己的标签。

Shopify集成 

使用Shopify商店时，捆绑产品具有特定行为。

设置

Zonos Catalog中的捆绑产品产品ID必须与捆绑产品的Shopify变体ID匹配。这是Zonos将Shopify行项与捆绑产品定义匹配的方式。您可以在查看产品变体时，在Shopify管理员URL中找到变体ID。

订单流程

当客户在Shopify商店中订购捆绑产品时：

  1. Shopify发送捆绑产品父级的单个行项（例如，"Truck Tire 4-Pack x 1"）。
  2. Zonos将行项的变体ID与您catalog中捆绑产品的产品ID进行匹配。
  3. Zonos为完税成本计算将捆绑产品展开为其各个组件——每个组件的HS编码、原产地和折扣价格用于准确计算关税和税费。
  4. Shopify订单仍然显示单个捆绑产品行项——组件展开完全由Zonos处理。

履行

创建履行时，Zonos将展开的捆绑产品组件映射回原始Shopify捆绑产品行项。商家在Shopify中看到已履行的捆绑产品父级（例如，"Truck Tire 4-Pack x 1已履行"），而商业发票和海关文件则分别列出每个组件。

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

CatalogItemInput PackagingOptionCreateInput

MUTATIONS

catalogItemCreate catalogItemDelete catalogItemUpdate packagingOptionCreate

预约演示

这个页面有帮助吗？

获取支持·法律文件·© 2026 Zonos
在此页面：
  • 通过CSV导入捆绑产品
  • Shopify集成