> 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). # 批量修改和撤销参考 当批量修改或反向处理 action 数据时，先下载 impact.com 提供的模板文件之一，并用你自己的数据替换示例数据。添加你自己的数据时，请务必遵循相关参考表中的指南，以确保你提交的文件格式正确。提交文件准备就绪后，即可继续提交批量修改 / 反向处理文件。 {% hint style="info" %} 本参考文章包含批量修改和反向处理最常用的字段。要查看包含字段说明的完整详细参考资料，请参阅 [Action & Conversion 字段参考](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references). {% endhint %} **请参阅以下参考资料，以：** * 了解在 FTP/SMTP 批量修改或反向处理中应使用哪些字段 * 下载带有占位示例数据的模板文件 * 了解应应用哪些原因代码以及何时应用 #### 订单级修改 当你希望在订单级而非商品级批量更新 action 数据时使用，例如，更改多个订单的订单金额。
接受的参数 | 字段 | 必填？ | 可编辑？ | 注意 | | ----------------- | ------ | ---- | ----------------------------------------------------------------------------------------- | | `ActionID` | 条件必填\* | 不可编辑 | 当去重窗口较短时，建议提供此标识符。 | | `Oid / OrderId` | 条件必填\* | 不可编辑 | 在使用时必须提供此标识符 *ActionTrackerId*. | | `ActionTrackerID` | 条件必填\* | 不可编辑 | 在使用时必须提供此标识符 *OrderId/Oid*. | | `Amount` | 可选 | 可编辑 | 将订单的新总金额设置为。 | | `currencyCode` | 可选 | 可编辑 | 设置 action 的收入币种。若未提供，默认为你的 impact.com 账户币种。 | | `CustomerStatus` | 可选 | 可编辑 | 设置转化时客户的状态，例如 NEW / EXISTING。 | | `注意` | 可选 | 可编辑 | 用于事件级报告的通用字段。如果原始转化为空，提交值会将其插入。每个 action 仅接受一次——请在同一请求中提交任何其他字段更改。 | | `LocationId` | 可选 | 可编辑 | 主要用于住宿，这是本次转化中所指定地点的唯一标识符。如果原始转化为空，提交值会将其插入。 | | `LocationName` | 可选 | 可编辑 | 主要用于住宿，这是本次转化中所指定地点的名称。如果原始转化为空，提交值会将其插入。 | | `GiftPurchase` | 可选 | 可编辑 | 设为 true 表示将订单标记为礼品购买，设为 false 则取消标记。如果原始转化为空，提交值会将其插入。 | | `Text1–Text50` | 可选 | 可编辑 | 可接收任意文本数据字符串的通用文本字段（Text1 到 Text50）。如果原始转化为空，提交值会将其插入。每个 action 仅接受一次——请在同一请求中提交任何其他字段更改。 | | `原因` | 必填 | 可编辑 | 为此次修改提供有效的原因代码。 | \*必须至少提供一个标识符路径，即，以下任一项 *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)
#### 订单级反向处理 当你希望在订单级而非商品级批量反向处理合作伙伴驱动的 action 时使用，例如，反向处理多个订单。
接受的参数 | 字段 | 必填？ | 可编辑？ | 注意 | | ----------------- | -------- | ---- | ------------------------------- | | `ActionID` | 条件必填\* | 不可编辑 | 当去重窗口较短时，建议提供此标识符。 | | `Oid / OrderId` | 条件必填\* | 不可编辑 | 在使用时必须提供此标识符 *ActionTrackerId*. | | `ActionTrackerID` | 条件必填\* | 不可编辑 | 在使用时必须提供此标识符 *OrderId/Oid*. | | `Amount` | 条件必填\*\* | 可编辑 | 设为 **0** 以反向处理订单，除非原始金额 = 0\*\* | | `原因` | 必填 | 可编辑 | 为此次反向处理提供有效的原因代码。 | \*必须至少提供一个标识符路径，即，以下任一项 *ActionId* **或** (*OrderId/Oid* + *ActionTrackerId*) \*\*如果原始 *Amount = 0*，请保持 *Amount* 不变，以免被误判为修改。
模板文件 * [订单级反向处理模板](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_reversals_template.csv)
#### 商品级修改 当你希望在商品级而非订单级批量更新 action 数据时使用，例如，更改订单中多个商品的金额。
接受的参数 | 字段 | 必填？ | 可编辑？ | 注意 | | ----------------- | ------ | ---- | ----------------------------------- | | `ActionID` | 条件必填\* | 不可编辑 | 当去重窗口较短时，建议提供此标识符。 | | `Oid / OrderId` | 条件必填\* | 不可编辑 | 在使用时必须提供此标识符 *ActionTrackerId*. | | `ActionTrackerID` | 条件必填\* | 不可编辑 | 在使用时必须提供此标识符 *OrderId/Oid*. | | `SKU`\*\* | 必填 | 不可编辑 | 提供你想修改的商品的 SKU 值。 | | `Amount`\*\* | 条件必填 | 可编辑 | 设置新的商品金额，即价格\*数量。如果你修改了数量，此字段也需要修改。 | | `数量`\*\* | 可选 | 可编辑 | 设置订单中的新商品数量。 | | `类别`\*\* | 可选 | 可编辑 | 设置商品的类别。 | | `原因`\*\* | 必填 | 可编辑 | 为此次反向处理提供有效的原因代码。 | \*必须至少提供一个标识符路径，即，以下任一项 *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)
#### 商品级反向处理 当你希望在商品级而非订单级批量反向处理 action 数据时使用，例如，反向处理订单中的多个商品。
接受的参数 | 字段 | 必填？ | 可编辑？ | 注意 | | ----------------- | ------ | ---- | ----------------------------------- | | `ActionID` | 条件必填\* | 不可编辑 | 当去重窗口较短时，建议提供此标识符。 | | `Oid / OrderId` | 条件必填\* | 不可编辑 | 在使用时必须提供此标识符 *ActionTrackerId*. | | `ActionTrackerID` | 条件必填\* | 不可编辑 | 在使用时必须提供此标识符 *OrderId/Oid*. | | `SKU`\*\* | 必填 | 不可编辑 | 提供你想修改的商品的 SKU 值。 | | `Amount`\*\* | 条件必填 | 可编辑 | 设置新的商品金额，即价格\*数量。如果你修改了数量，此字段也需要修改。 | | `数量`\*\* | 可选 | 可编辑 | 设置订单中的新商品数量。 | | `原因`\*\* | 必填 | 可编辑 | 为此次修改提供有效的原因代码。 | \*必须至少提供一个标识符路径，即，以下任一项 *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" %} **注意：** 如果你预计会有重复的 *OrderIds* 并选择使用 *OrderId + ActionTrackerId*，impact.com 默认将你的更新应用于最新的 *ActionId* 默认情况下。使用旧的 *ActionId* 如果你想将更新应用于较旧的 *ActionId*. {% endhint %} #### 原因代码 每次修改或反向处理 action 数据时，你都必须提供一个原因。请使用下面相关的原因代码来说明为何要更新该 action。 {% hint style="warning" %} **警告：** 如果提交未被接受的值，条目将不会被处理，而是返回错误。如果你需要自定义原因代码，请联系你的 CSM 或 [**联系支持团队**](https://app.impact.com/support/portal.ihtml?createTicket=true&) **以讨论处置代码**. {% endhint %}
CodeDescription
CONS_FRAUDConsumer fraud
CONS_ERRORConsumer error
ITEM_RETURNEDItem was returned
APPROVED

Action is approved

Note: If you’re trying to approve actions, Approve needs to be set up as a custom disposition code.

ORDER_ERROROrder error
ORDER_UPDATEOrder was updated
PUB_ACT_DISPUTEPartner activity dispute
ADV_ACT_DISPUTEBrand activity dispute
NOT_COMPLIANCE_TERMSNot in compliance with terms
ITEM_OUT_OF_STOCKItem is out of stock
TEST_ACTIONTest action
PARTNER_NOT_ACTIVEPartner account deactivated
CREDITED_DIFFERENT_MPCredited to another partner
OTHEROther reason
--- # 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` 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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.