> 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-process-reversals-via-api-web-services-overview.md).

# 通过 API 批量修改或撤销

<a href="https://pxa.impact.com/student/activity/2268418?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=&#x26;utm_campaign=help-center" class="button primary">参加 PXA 课程</a>

如果某个转化的任何信息发生变化（例如，订单被取消、商品被退回等），您可以使用 API 对其进行修改（或撤销），从而更改该转化的佣金金额。

### 哪种提交方式适合您？

| 如果你想……          | 使用此方法……                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 无需编程，提交一次性的手动文件 | ​[电子邮件](/brand/zh/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/submit-conversion-data-via-ftp-or-email.md#before-you-start) 批量处理，或 [通过 FTP 上传文件](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals#upload-file-to-system-ftp-server)                                                                                                                                                                                                                            |
| 设置自动化转换报告       | ​[转化](https://integrations.impact.com/brand-api-reference/reference/conversions/conversions) / [操作](https://integrations.impact.com/brand-api-reference/reference/actions) API， [通过 FTP 推送文件](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals#upload-file-to-system-ftp-server)，或 [通过 FTP 拉取文件](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals#pull-file-from-your-own-ftp-server) |

### API 撤销选项：

* [通过 API 修改或撤销一个转化中的一个或多个条目](https://integrations.impact.com/brand-api-reference/reference/actions/actions)
* [通过 API 撤销整个转化](https://integrations.impact.com/brand-api-reference/reference/actions/actions)

### 前提：获取 *ActionId* 值

要通过 API 修改转化数据，您需要其 `ActionId` 值。然后，您可以使用它通过 API 找到要修改的转化。

* 您可以在调用中指定日期范围——否则，该端点默认显示最近 30 天的转化。
* [速率限制](https://integrations.impact.com/brand-api-reference/readme/rate-limits) 适用。
* 查看 [列出所有转化](https://integrations.impact.com/brand-api-reference/reference/actions/actions) 请参阅 API 端点文档以了解更多信息。

### 常见问题

<details>

<summary>如何重置对某个转化（或转化条目）所做的修改/撤销？</summary>

如果某个转化在其锁定日期之前已被修改或撤销，您可以提交 `RESET` 作为原因，将该转化恢复为默认状态：

```programlisting
curl 'https://api.impact.com/Advertisers/{AccountSID}/Actions' \\
  -X PUT \\
  -u '{AccountSID}:{AuthToken}' \\
  -H 'Accept: application/json' \\
  -H 'Content-Type: application/x-www-form-urlencoded' \\
  -d 'ActionId={ActionId}' \\
  -d 'Reason=RESET'
```

通过以下方式重置的转化 `RESET` 代码在报告中可能不会正确显示（例如，收入值可能计算错误）。

</details>

<details>

<summary>处置代码和原因有什么区别？</summary>

两者 *处置代码* 和 *原因* 都用于相同的上下文—— *原因* 是 API 默认会接受的预定义代码，而 *处置代码* 是您可以配置的自定义原因。 [了解更多有关处置代码的信息](/brand/zh/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/manage-disposition-codes.md).

支持的原因代码：

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

</details>

<details>

<summary>如何查看某个转化何时应用了修改/撤销？</summary>

您可以使用 [转化更新](https://integrations.impact.com/brand-api-reference/reference/actions/models) 端点，以查看某个转化最后一次更新的时间以及其当前状态。

{% hint style="info" %}
**注意：** 一个 `ActionUpdatesID` 值不同于一个 `ActionId` 值——您必须使用 `ActionUpdatesID` 值来检索某个转化的更新。
{% endhint %}

</details>


---

# 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-process-reversals-via-api-web-services-overview.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.