批量修改与撤销参考

在批量修改或撤销操作数据时，请先下载 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)

**如果原始 Amount = 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）。

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

要查看包含字段说明的完整详细参数参考，请参阅 impact.com 操作和转化数据参考.

原因代码

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

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

代码	说明
CONS_FRAUD	消费者欺诈
CONS_ERROR	消费者错误
ITEM_RETURNED	商品已退回
APPROVED	操作已批准 注意： 如果您正在尝试批准操作， 批准 需要被设置为 自定义处置代码.
ORDER_ERROR	订单错误
ORDER_UPDATE	订单已更新
PUB_ACT_DISPUTE	合作伙伴活动争议
ADV_ACT_DISPUTE	品牌活动争议
NOT_COMPLIANCE_TERMS	不符合条款
ITEM_OUT_OF_STOCK	商品缺货
TEST_ACTION	测试操作
PARTNER_NOT_ACTIVE	合作伙伴帐户已停用
CREDITED_DIFFERENT_MP	记入了另一个合作伙伴
其他	其他原因