> 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 提供的模板文件之一，并将示例数据替换为你自己的数据。在添加你自己的数据时，请务必遵循相关参考表中的指南，以确保你提交的文件格式正确。提交文件准备就绪后，即可继续提交你的批量修改/冲销文件。 {% hint style="info" %} 本文参考文章包含批量修改和冲销中最常用的字段。要查看包含字段说明的完整详细参考，请参阅 [Action & Conversion 字段参考](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。 | | `备注` | 可选 | 可编辑 | 用于事件级报告的通用字段。如果原始转化中为空，提交值后会进行插入。每个操作仅接受一次——请在同一请求中提交任何其他字段更改。 | | `LocationId` | 可选 | 可编辑 | 主要用于住宿场景，这是此转化中指定地点的唯一标识符。如果原始转化中为空，提交值后会进行插入。 | | `LocationName` | 可选 | 可编辑 | 主要用于住宿场景，这是此转化中指定地点的名称。如果原始转化中为空，提交值后会进行插入。 | | `GiftPurchase` | 可选 | 可编辑 | 设为 true 可将订单标记为礼品购买，设为 false 可取消标记。如果原始转化中为空，提交值后会进行插入。 | | `Text1–Text50` | 可选 | 可编辑 | 通用文本字段，可接受你希望发送的任意文本数据字符串（Text1 到 Text50）。如果原始转化中为空，提交值后会进行插入。每个操作仅接受一次——请在同一请求中提交任何其他字段更改。 | | `原因` | 必填 | 可编辑 | 请为此次修改提供有效的原因代码。 | \*至少必须提供一条标识符路径，即以下任一项 *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" %} **备注：** 如果你预期会有重复的 *OrderIds* 并选择使用以下组合： *OrderId + ActionTrackerId*，impact.com 会默认将更新应用到最新的 *ActionId* 。如果你希望将更新应用到较旧的 *ActionId* ，请使用旧的 *ActionId*. {% endhint %} #### 原因代码 每次修改或冲销操作数据时，你都必须提供原因。请使用下方相关的原因代码来说明该操作为什么需要更新。 {% hint style="warning" %} **警告：** 传入不被接受的值将导致该条目不会被处理，并返回错误。如果你需要自定义原因代码，请联系你的 CSM 或 [**联系支持**](https://app.impact.com/support/portal.ihtml?createTicket=true&) **以讨论处置代码**. {% endhint %}
代码说明
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已记入另一位合作伙伴
其他其他原因
--- # 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.