# 批量修改与撤销参考

当批量修改或冲正行动数据时，请先下载 impact.com 提供的模板文件之一，并用您自己的数据替换示例数据。添加您自己的数据时，请务必遵循相关参考表中的指南，以确保您提交的文件格式正确。提交文件准备就绪后，您可以继续进行 [提交批量修改/冲正](https://help.impact.com/brand/zh/nin-xiang-liao-jie-shen-me/platform-features/submit-and-modify-conversion-data/submit-batch-modifications-and-reversals#submit-your-data-file-0-1) 文件。

{% hint style="info" %}
本文参考文章包含批量修改和冲正中最常用的字段。若要查看包含字段说明的完整详细参考，请参阅 [行动与转化字段参考](https://integrations.impact.com/impact-brand/reference/action-conversion-field-references).
{% endhint %}

**请参阅下方参考以：**

* 了解在 FTP/SMTP 批量修改或冲正中应使用哪些字段
* 下载带有占位示例数据的模板文件
* 了解应应用哪些原因代码以及何时应用

#### 订单级修改

适用于您希望在订单级别而非商品级别批量更新行动数据的情况，例如，批量更改多个订单的订单金额。

<details>

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

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

\*必须提供至少一条标识符路径，即以下之一 *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*.              |
| `Amount`          | 有条件必填\*\* | 可编辑  | 设置为 **0** 以冲正订单，除非原始金额 = 0\*\* |
| `Reason`          | 必填        | 可编辑  | 提供有效的冲正原因代码。                   |

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

\*\*如果原始 *金额 = 0*，请保持 *Amount* 不变，以避免被误分类为修改。

</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 值。                   |
| `Amount`\*\*      | 有条件必填   | 可编辑  | 设置新的商品金额，即价格\*数量。如果您修改数量，则此字段也需要修改。 |
| `Quantity`\*\*    | 可选      | 可编辑  | 设置订单中商品的新数量。                        |
| `Category`\*\*    | 可选      | 可编辑  | 设置商品的类别。                            |
| `Reason`\*\*      | 必填      | 可编辑  | 提供有效的冲正原因代码。                        |

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

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