# 批量修改与撤销参考

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

**参见以下参考以：**

* 了解在 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" %}
**注意：** 注意：如果您预计会有重复的 *Oid / OrderIds* 并选择使用 *Oid / OrderId + ActionTrackerId*，impact.com 默认会将您的更新应用于最新的 *ActionId* 。如果您想将更新应用于较旧的 *ActionId* ，请使用旧的 *ActionId*.
{% endhint %}

要查看包含字段说明的完整详细参数参考，请参阅 [impact.com 操作和转化数据参考](https://integrations.impact.com/impact-brand/docs/impactcom-action-conversion-data-references).

#### 原因代码

每次修改或撤销操作数据时，您都必须提供原因。请使用下面的相关原因代码来说明为何正在更新该操作。

{% hint style="warning" %}
**警告：** 传入非接受的值将导致该条目不被处理并返回错误。如果您需要自定义原因代码，请联系您的客户成功经理或 **联系支持以讨论处置代码**.
{% endhint %}

| 代码                      | 说明                                                                                                                                                         |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| CONS\_FRAUD             | 消费者欺诈                                                                                                                                                      |
| CONS\_ERROR             | 消费者错误                                                                                                                                                      |
| ITEM\_RETURNED          | 商品已退回                                                                                                                                                      |
| APPROVED                | <p>操作已批准</p><p><strong>注意：</strong> 如果您正在尝试批准操作， <code>批准</code> 需要被设置为 <a href="../../tracking/set-up-tracking/manage-disposition-codes">自定义处置代码</a>.</p> |
| 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 | 记入了另一个合作伙伴                                                                                                                                                 |
| 其他                      | 其他原因                                                                                                                                                       |
