Tutorial

批量添加订单行项目

手动向许多现有订单添加新行项目可能非常耗时。DataEase 让这一过程变得简单:导出订单,准备包含 itemCommand=CREATE 的行项目行,然后将它们导入回 Shopify——所有这些都经过验证。

🎯 目标

使用 CSV/Excel 和 DataEase 一次性向许多现有 Shopify 订单添加新行项目。


📋 分步说明

1. 导出订单(可选,用于获取 ID)

在 DataEase 中,进入 New Export → Orders。至少包括:

  • id(订单 ID)
  • 如果有帮助:name(订单号)、客户字段和当前行项目以供参考

应用过滤器(日期范围、财务/履行状态)以仅针对可编辑的订单。


2. 准备添加项目的文件

在 Excel 或 Google Sheets 中打开导出的文件。对于您正在编辑的每个订单,创建一个或多个行项目行:

  • 在订单的主行上设置 topRow = TRUE(您可以保持订单级字段不变或设置 command=UPDATE)
  • 添加 topRow = FALSE 和 itemCommand = CREATE 的行以添加新项目
  • 提供以下之一:variantId(首选)或 variantSKU
  • 设置 itemQuantity(整数)
  • (可选) itemPrice 以覆盖订单行上的价格;否则 Shopify 使用变体价格
  • (可选) itemProperties(例如,key=value; color=red)
  • 保持列名与您的导出模板完全一致

完成后,将文件保存为 .xlsx 或 .csv。


3. 导入和验证

  1. 在 DataEase 中,启动 New Import → Orders
  2. 上传您编辑过的文件
  3. 映射列(订单 ID,行项目字段)
  4. 运行 Validation

打开验证报告并修复任何问题(缺少 variantId/SKU、无效数量、不可编辑的订单)。


4. 运行导入并下载结果

验证通过后,点击 Run Import 将行项目添加到 Shopify。

完成后,下载结果文件并在 Shopify Admin 中检查编辑过的订单:新行项目应出现,总计/小计相应更新。


📝 重要说明

  • 仅可编辑订单: 已取消/全额退款/锁定的订单无法编辑。如有需要,请取消存档或恢复状态后再进行编辑
  • 库存和履行: 添加项目会增加需要履行的项目;确保库存存在并在之后调整履行
  • 定价和税费: 如果您设置了 itemPrice,税费/折扣将从该值重新计算。如果未设置,Shopify 使用变体的当前价格
  • 标识符: 使用 variantId 进行可靠匹配;仅在您的目录中唯一时使用 variantSKU

💡 最小 CSV 示例

向订单添加一个项目(通过变体 ID):

id,topRow,command,itemCommand,variantId,itemQuantity,itemPrice
gid://shopify/Order/123,TRUE,UPDATE,,,,
gid://shopify/Order/123,FALSE,,CREATE,gid://shopify/ProductVariant/111,2,24.99

向同一订单添加两个不同的项目(使用单独的行项目行):

id,topRow,command,itemCommand,variantId,itemQuantity
gid://shopify/Order/456,TRUE,UPDATE,,,
gid://shopify/Order/456,FALSE,,CREATE,gid://shopify/ProductVariant/222,1
gid://shopify/Order/456,FALSE,,CREATE,gid://shopify/ProductVariant/333,3

通过 SKU 添加项目(价格来自变体):

id,topRow,command,itemCommand,variantSKU,itemQuantity
gid://shopify/Order/789,TRUE,UPDATE,,,
gid://shopify/Order/789,FALSE,,CREATE,SKU-RED-M,2

🎉 就是这样!

您的行项目现在已批量添加到订单中。
如果您遇到任何问题或有疑问,请随时联系我们的支持团队。