> 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" %}
本文参考文章包含批量修改和撤销最常用的字段。要查看包含字段说明的完整详细参考，请参阅 [Action & Conversion Field References](https://integrations.impact.com/impact-brand/reference/action-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 值。                  |
| `金额`\*\*          | 有条件必需   | 可编辑  | 设置新的商品金额，即价格\*数量。如果你修改数量，此字段也需要修改。 |
| `数量`\*\*          | 可选      | 可编辑  | 设置订单中商品的新数量。                       |
| `类别`\*\*          | 可选      | 可编辑  | 设置商品类别。                            |
| `原因`\*\*          | 必填      | 可编辑  | 为该撤销提供有效的原因代码。                     |

\*必须提供至少一条标识符路径，即，以下任一项 *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 值。                  |
| `金额`\*\*          | 有条件必需   | 可编辑  | 设置新的商品金额，即价格\*数量。如果你修改数量，此字段也需要修改。 |
| `数量`\*\*          | 可选      | 可编辑  | 设置订单中商品的新数量。                       |
| `原因`\*\*          | 必填      | 可编辑  | 为该修改提供有效的原因代码。                     |

\*必须提供至少一条标识符路径，即，以下任一项 *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 %}


---

# 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:

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

The question should be specific, self-contained, and written in natural language.
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.