批量修改与撤销参考

在批量修改或撤销操作数据时，请先下载 impact.com 提供的模板文件之一，并将示例数据替换为您自己的数据。添加自己的数据时，请务必遵循相关参考表中的指南，以确保您的文件提交格式正确。准备好提交文件后，您可以继续 提交批量修改/撤销 文件。

本参考文章包含用于批量修改和撤销的最常用字段。要查看包含字段描述的完整详细参考，请参阅 操作和转化字段参考.

查看以下参考以：

• 了解在 FTP/SMTP 批量修改或撤销中应使用哪些字段

• 下载带有占位示例数据的模板文件

• 了解应何时以及应用哪些原因代码

订单级修改

当您希望以订单级而非商品级批量更新操作数据时使用，例如，为多个订单更改订单总金额。

接受的参数

字段	必填？	可编辑？	备注
ActionID	有条件必填*	不可编辑	在去重窗口较短时，建议提供此标识符。
Oid / OrderId	有条件必填*	不可编辑	在使用以下项时，需提供此标识符 ActionTrackerId.
ActionTrackerID	有条件必填*	不可编辑	在使用以下项时，需提供此标识符 OrderId/Oid.
金额	可选	可编辑	设置订单的新总金额。
currencyCode	可选	可编辑	设置该操作的收入货币。如果未提供，默认为您的 impact.com 帐户货币。
CustomerStatus	可选	可编辑	设置转化时客户的状态，例如 NEW / EXISTING。
原因	必填	可编辑	为修改提供一个有效的原因代码。

*必须至少提供一种标识路径，即： ActionId 或 (*OrderId/Oid *+ ActionTrackerId)

模板文件

• 订单级修改模板

• 订单级审批模板

订单级撤销

当您希望以订单级而非商品级批量撤销合作伙伴驱动的操作时使用，例如，撤销多个订单。

接受的参数

字段	必填？	可编辑？	备注
ActionID	有条件必填*	不可编辑	在去重窗口较短时，建议提供此标识符。
Oid / OrderId	有条件必填*	不可编辑	在使用以下项时，需提供此标识符 ActionTrackerId.
ActionTrackerID	有条件必填*	不可编辑	在使用以下项时，需提供此标识符 OrderId/Oid.
金额	有条件必填**	可编辑	设置为 0 以撤销订单，除非原始金额 = 0**
原因	必填	可编辑	为撤销提供一个有效的原因代码。

*必须至少提供一种标识路径，即： ActionId 或 (OrderId/Oid + ActionTrackerId)

**如果原始 金额 = 0，请保持 金额 不变以避免被误分类为修改。

模板文件

• 订单级撤销模板

商品级修改

当您希望以商品级而非订单级批量更新操作数据时使用，例如，为订单中的多个商品更改金额。

接受的参数

字段	必填？	可编辑？	备注
ActionID	有条件必填*	不可编辑	在去重窗口较短时，建议提供此标识符。
Oid / OrderId	有条件必填*	不可编辑	在使用以下项时，需提供此标识符 ActionTrackerId.
ActionTrackerID	有条件必填*	不可编辑	在使用以下项时，需提供此标识符 OrderId/Oid.
SKU**	必填	不可编辑	提供您要修改的商品的 SKU 值。
金额**	有条件必填	可编辑	设置商品的新金额，即 价格*数量。如果您修改数量，此字段也需要相应修改。
数量**	可选	可编辑	设置订单中商品的新数量。
类别**	可选	可编辑	设置商品的类别。
原因**	必填	可编辑	为撤销提供一个有效的原因代码。

*必须至少提供一种标识路径，即： ActionId 或 (OrderId/Oid + ActionTrackerId)

**您修改的每个商品都必须包含这些字段。标识字段每个订单仅包含一次。

模板文件

• 商品级修改模板

• 商品级审批模板

商品级撤销

当您希望以商品级而非订单级批量撤销操作数据时使用，例如，撤销订单中的多个商品。

接受的参数

字段	必填？	可编辑？	备注
ActionID	有条件必填*	不可编辑	在去重窗口较短时，建议提供此标识符。
Oid / OrderId	有条件必填*	不可编辑	在使用以下项时，需提供此标识符 ActionTrackerId.
ActionTrackerID	有条件必填*	不可编辑	在使用以下项时，需提供此标识符 OrderId/Oid.
SKU**	必填	不可编辑	提供您要修改的商品的 SKU 值。
金额**	有条件必填	可编辑	设置商品的新金额，即 价格*数量。如果您修改数量，此字段也需要相应修改。
数量**	可选	可编辑	设置订单中商品的新数量。
原因**	必填	可编辑	为修改提供一个有效的原因代码。

*必须至少提供一种标识路径，即： ActionId 或 (OrderId/Oid + ActionTrackerId)

**您修改的每个商品都必须包含这些字段。标识字段每个订单仅包含一次。

模板文件

• 商品级撤销模板

在此示例中 SKU O7427540 出现两次，因为一行是撤销（Amount=0），一行是修改（Amount=15）。

注意： 注：如果您预计会有重复的 OrderIds 并选择使用组合 OrderId + ActionTrackerId，impact.com 默认会将您的更新应用于最新的 ActionId 。如果您想将更新应用于较旧的 ActionId ，请使用旧的 ActionId.

原因代码

每次修改或撤销操作数据时，您都必须提供一个原因。使用下列相关原因代码来说明为何要更新该操作。

警告： 传入不被接受的值将导致该条目无法处理并返回错误。如果您需要自定义原因代码，请联系您的客户成功经理或 联系支持 讨论处置代码.