> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md). # 批量修改和冲销参考 当批量修改或撤销动作数据时，请先下载 impact.com 提供的模板文件之一，并将示例数据替换为你自己的数据。添加你自己的数据时，请务必遵循相关参考表中的指南，以确保你提交的文件格式正确。准备好提交文件后，你可以继续进行 [提交你的批量修改/撤销](/brand/zh/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.md#submit-your-data-file-0-1) 文件。 {% hint style="info" %} 本文参考文章包含批量修改和撤销中最常用的字段。要查看包含字段说明的完整详细参考，请参阅 [动作与转化字段参考](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references). {% endhint %} **请参阅以下参考以：** * 了解在 FTP/SMTP 批量修改或撤销中应使用哪些字段 * 下载带有占位示例数据的模板文件 * 了解应应用哪些原因代码以及在何时应用 #### 订单级修改 当你希望按订单级而非项目级批量更新动作数据时使用，例如更改多个订单的金额。
接受的参数 | 字段 | 必填？ | 可编辑？ | 备注 | | ----------------- | ------- | ---- | --------------------------------------- | | `ActionID` | 有条件必填\* | 不可编辑 | 当去重窗口较短时，建议提供此标识符。 | | `Oid / OrderId` | 有条件必填\* | 不可编辑 | 在使用以下项时，需要提供此标识符 *ActionTrackerId*. | | `ActionTrackerID` | 有条件必填\* | 不可编辑 | 在使用以下项时，需要提供此标识符 *OrderId/Oid*. | | `金额` | 可选 | 可编辑 | 设置订单的新总金额。 | | `currencyCode` | 可选 | 可编辑 | 设置该动作的收入货币。如果未提供，默认为你的 impact.com 账户货币。 | | `CustomerStatus` | 可选 | 可编辑 | 设置转化时客户的状态，例如 NEW / EXISTING。 | | `原因` | 必填 | 可编辑 | 为该修改提供有效的原因代码。 | \*至少必须提供一条标识符路径，即以下任一项： *ActionId* **或** (\*OrderId/Oid \*+ *ActionTrackerId*)
模板文件 * [订单级修改模板](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_modifications_template.csv) * [订单级审批模板](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_approvals_template.csv)
#### 订单级撤销 当你希望按订单级而非项目级批量撤销合作伙伴驱动的动作时使用，例如撤销多个订单。
接受的参数 | 字段 | 必填？ | 可编辑？ | 备注 | | ----------------- | --------- | ---- | ----------------------------------- | | `ActionID` | 有条件必填\* | 不可编辑 | 当去重窗口较短时，建议提供此标识符。 | | `Oid / OrderId` | 有条件必填\* | 不可编辑 | 在使用以下项时，需要提供此标识符 *ActionTrackerId*. | | `ActionTrackerID` | 有条件必填\* | 不可编辑 | 在使用以下项时，需要提供此标识符 *OrderId/Oid*. | | `金额` | 有条件必填\*\* | 可编辑 | 设置为 **0** 用于撤销订单，除非原始金额 = 0\*\* | | `原因` | 必填 | 可编辑 | 为该撤销提供有效的原因代码。 | \*至少必须提供一条标识符路径，即以下任一项： *ActionId* **或** (*OrderId/Oid* + *ActionTrackerId*) \*\*如果原始 *金额 = 0*，则保留 *金额* 保持不变，以避免被误判为修改。
模板文件 * [订单级撤销模板](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_reversals_template.csv)
#### 项目级修改 当你希望按项目级而非订单级批量更新动作数据时使用，例如更改订单中多个项目的金额。
接受的参数 | 字段 | 必填？ | 可编辑？ | 备注 | | ----------------- | ------- | ---- | -------------------------------------------- | | `ActionID` | 有条件必填\* | 不可编辑 | 当去重窗口较短时，建议提供此标识符。 | | `Oid / OrderId` | 有条件必填\* | 不可编辑 | 在使用以下项时，需要提供此标识符 *ActionTrackerId*. | | `ActionTrackerID` | 有条件必填\* | 不可编辑 | 在使用以下项时，需要提供此标识符 *OrderId/Oid*. | | `SKU`\*\* | 必填 | 不可编辑 | 提供你要修改的商品 SKU 值。 | | `金额`\*\* | 有条件必填 | 可编辑 | 设置新的商品金额，即 price\*quantity。如果你修改数量，此字段也需要修改。 | | `数量`\*\* | 可选 | 可编辑 | 设置订单中商品的新数量。 | | `类别`\*\* | 可选 | 可编辑 | 设置商品类别。 | | `原因`\*\* | 必填 | 可编辑 | 为该撤销提供有效的原因代码。 | \*至少必须提供一条标识符路径，即以下任一项： *ActionId* **或** (*OrderId/Oid* + *ActionTrackerId*) \*\*每个你修改的商品都必须包含这些字段。标识符字段在每个订单中只需包含一次。
模板文件 * [项目级修改模板](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_modifications_template.csv) * [项目级审批模板](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_approvals_template.csv)
#### 项目级撤销 当你希望按项目级而非订单级批量撤销动作数据时使用，例如撤销订单中的多个项目。
接受的参数 | 字段 | 必填？ | 可编辑？ | 备注 | | ----------------- | ------- | ---- | -------------------------------------------- | | `ActionID` | 有条件必填\* | 不可编辑 | 当去重窗口较短时，建议提供此标识符。 | | `Oid / OrderId` | 有条件必填\* | 不可编辑 | 在使用以下项时，需要提供此标识符 *ActionTrackerId*. | | `ActionTrackerID` | 有条件必填\* | 不可编辑 | 在使用以下项时，需要提供此标识符 *OrderId/Oid*. | | `SKU`\*\* | 必填 | 不可编辑 | 提供你要修改的商品 SKU 值。 | | `金额`\*\* | 有条件必填 | 可编辑 | 设置新的商品金额，即 price\*quantity。如果你修改数量，此字段也需要修改。 | | `数量`\*\* | 可选 | 可编辑 | 设置订单中商品的新数量。 | | `原因`\*\* | 必填 | 可编辑 | 为该修改提供有效的原因代码。 | \*至少必须提供一条标识符路径，即以下任一项： *ActionId* **或** (*OrderId/Oid* + *ActionTrackerId*) \*\*每个你修改的商品都必须包含这些字段。标识符字段在每个订单中只需包含一次。
模板文件 * [项目级撤销模板](https://res.cloudinary.com/product-enablement/raw/upload/v1768298926/CSVs/Batch%20Action%20Processing/Item-level_reversals_template.csv) 该示例中 SKU O7427540 出现两次，因为一行是撤销（Amount=0），另一行是修改（Amount=15）。
{% hint style="info" %} **注意：** 如果你预计会有重复的 *订单ID* 并选择使用以下组合： *OrderId + ActionTrackerId*，impact.com 会默认将你的更新应用于最新的 *ActionId* 默认情况下。若要将更新应用于较旧的 *ActionId* 如果你想将更新应用于较旧的 *ActionId*. {% endhint %} #### 原因代码 每次修改或撤销动作数据时，你都必须提供一个原因。请使用下面相关的原因代码说明为何要更新该动作。 {% hint style="warning" %} **警告：** 传入不被接受的值将导致该条目不被处理，而是返回错误。如果你需要自定义原因代码，请联系你的 CSM 或 [**联系支持团队**](https://app.impact.com/support/portal.ihtml?createTicket=true&) **讨论处置代码**. {% endhint %}
代码说明
消费者欺诈消费者欺诈
消费者错误消费者错误
商品已退回商品已退回
已批准

操作已批准

注意： 如果您正在尝试批准操作， 批准 需要设置为 自定义处置代码.

订单错误订单错误
ORDER_UPDATE订单已更新
合作伙伴活动争议合作伙伴活动争议
品牌活动争议品牌活动争议
不符合条款不符合条款
商品缺货商品缺货
测试操作测试操作
合作伙伴账户已停用合作伙伴账户已停用
已记入其他合作伙伴已记入另一合作伙伴
OTHER其他原因
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.