> 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 批量修改或撤销中应使用哪些字段
* 下载包含占位示例数据的模板文件
* 了解应应用哪些原因代码以及何时应用

#### 订单级修改

这是用于在订单级批量更新行动数据，而不是在商品级，例如为多个订单更改订单金额。

<details>

<summary>可接受的参数</summary>

| 字段                | 必填？     | 可编辑？ | 注意                                      |
| ----------------- | ------- | ---- | --------------------------------------- |
| `ActionID`        | 有条件必填\* | 不可编辑 | 当去重窗口较短时，建议提供此标识符。                      |
| `Oid / OrderId`   | 有条件必填\* | 不可编辑 | 在使用时必须提供此标识符 *ActionTrackerId*.         |
| `ActionTrackerID` | 有条件必填\* | 不可编辑 | 在使用时必须提供此标识符 *OrderId/Oid*.             |
| `金额`              | 可选      | 可编辑  | 设置订单的新总金额。                              |
| `currencyCode`    | 可选      | 可编辑  | 设置该行动的收入货币。若未提供，则默认为你的 impact.com 账户货币。 |
| `CustomerStatus`  | 可选      | 可编辑  | 设置转化时客户的状态，例如 NEW / EXISTING。           |
| `原因`              | 必填      | 可编辑  | 为此次修改提供有效的原因代码。                         |

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

</details>

<details>

<summary>模板文件</summary>

* [订单级修改模板](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)

</details>

#### 订单级撤销

这是用于在订单级批量撤销由合作伙伴驱动的行动，而不是在商品级，例如撤销多个订单。

<details>

<summary>可接受的参数</summary>

| 字段                | 必填？       | 可编辑？ | 注意                              |
| ----------------- | --------- | ---- | ------------------------------- |
| `ActionID`        | 有条件必填\*   | 不可编辑 | 当去重窗口较短时，建议提供此标识符。              |
| `Oid / OrderId`   | 有条件必填\*   | 不可编辑 | 在使用时必须提供此标识符 *ActionTrackerId*. |
| `ActionTrackerID` | 有条件必填\*   | 不可编辑 | 在使用时必须提供此标识符 *OrderId/Oid*.     |
| `金额`              | 有条件必填\*\* | 可编辑  | 设置为 **0** 用于撤销订单，除非原始金额 = 0\*\* |
| `原因`              | 必填        | 可编辑  | 为此次撤销提供有效的原因代码。                 |

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

\*\*如果原始 *Amount = 0*，则保留 *金额* 不变，以避免被误判为修改。

</details>

<details>

<summary>模板文件</summary>

* [订单级撤销模板](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_reversals_template.csv)

</details>

#### 商品级修改

这是用于在商品级批量更新行动数据，而不是在订单级，例如为订单中的多个商品更改金额。

<details>

<summary>可接受的参数</summary>

| 字段                | 必填？     | 可编辑？ | 注意                                           |
| ----------------- | ------- | ---- | -------------------------------------------- |
| `ActionID`        | 有条件必填\* | 不可编辑 | 当去重窗口较短时，建议提供此标识符。                           |
| `Oid / OrderId`   | 有条件必填\* | 不可编辑 | 在使用时必须提供此标识符 *ActionTrackerId*.              |
| `ActionTrackerID` | 有条件必填\* | 不可编辑 | 在使用时必须提供此标识符 *OrderId/Oid*.                  |
| `SKU`\*\*         | 必填      | 不可编辑 | 提供你想修改的商品 SKU 值。                             |
| `金额`\*\*          | 有条件必填   | 可编辑  | 设置新的商品金额，即 price\*quantity。如果你修改数量，此字段也需要修改。 |
| `数量`\*\*          | 可选      | 可编辑  | 设置订单中商品的新数量。                                 |
| `类别`\*\*          | 可选      | 可编辑  | 设置商品类别。                                      |
| `原因`\*\*          | 必填      | 可编辑  | 为此次撤销提供有效的原因代码。                              |

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

\*\*这些字段必须包含在你修改的每个商品中。标识符字段在每个订单中只需包含一次。

</details>

<details>

<summary>模板文件</summary>

* [商品级修改模板](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)

</details>

#### 商品级撤销

这是用于在商品级批量撤销行动数据，而不是在订单级，例如撤销订单中的多个商品。

<details>

<summary>可接受的参数</summary>

| 字段                | 必填？     | 可编辑？ | 注意                                           |
| ----------------- | ------- | ---- | -------------------------------------------- |
| `ActionID`        | 有条件必填\* | 不可编辑 | 当去重窗口较短时，建议提供此标识符。                           |
| `Oid / OrderId`   | 有条件必填\* | 不可编辑 | 在使用时必须提供此标识符 *ActionTrackerId*.              |
| `ActionTrackerID` | 有条件必填\* | 不可编辑 | 在使用时必须提供此标识符 *OrderId/Oid*.                  |
| `SKU`\*\*         | 必填      | 不可编辑 | 提供你想修改的商品 SKU 值。                             |
| `金额`\*\*          | 有条件必填   | 可编辑  | 设置新的商品金额，即 price\*quantity。如果你修改数量，此字段也需要修改。 |
| `数量`\*\*          | 可选      | 可编辑  | 设置订单中商品的新数量。                                 |
| `原因`\*\*          | 必填      | 可编辑  | 为此次修改提供有效的原因代码。                              |

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

\*\*这些字段必须包含在你修改的每个商品中。标识符字段在每个订单中只需包含一次。

</details>

<details>

<summary>模板文件</summary>

* [商品级撤销模板](https://res.cloudinary.com/product-enablement/raw/upload/v1768298926/CSVs/Batch%20Action%20Processing/Item-level_reversals_template.csv)

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

</details>

{% 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 %}

<table><thead><tr><th width="234">代码</th><th>说明</th></tr></thead><tbody><tr><td><code>消费者欺诈</code></td><td>消费者欺诈</td></tr><tr><td><code>消费者错误</code></td><td>消费者错误</td></tr><tr><td><code>商品已退回</code></td><td>商品已退回</td></tr><tr><td><code>已批准</code></td><td><p>操作已批准</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>注意：</strong> 如果您正在尝试批准操作， <code>批准</code> 需要设置为 <a href="/pages/e3e08d2a70b519195027fa14e3f87e1da5adbaee">自定义处置代码</a>.</p></div></td></tr><tr><td><code>订单错误</code></td><td>订单错误</td></tr><tr><td><code>ORDER_UPDATE</code></td><td>订单已更新</td></tr><tr><td><code>合作伙伴活动争议</code></td><td>合作伙伴活动争议</td></tr><tr><td><code>品牌活动争议</code></td><td>品牌活动争议</td></tr><tr><td><code>不符合条款</code></td><td>不符合条款</td></tr><tr><td><code>商品缺货</code></td><td>商品缺货</td></tr><tr><td><code>测试操作</code></td><td>测试操作</td></tr><tr><td><code>合作伙伴未激活</code></td><td>合作伙伴账户已停用</td></tr><tr><td><code>记入其他合作伙伴</code></td><td>记入另一合作伙伴</td></tr><tr><td><code>其他</code></td><td>其他原因</td></tr></tbody></table>


---

# 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=<question>&goal=<endgoal>
```

`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.