> 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 对其进行修改（或逆转），从而更改该动作的佣金金额。

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

| If you want to...                             | Use this method...                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Submit a manual, one-time file with no coding | ​[Email](/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.md#step-2-submit-your-data-file) batch processing or [upload file via FTP](/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.md#step-2-submit-your-data-file)​                                                                                                                                                                                        |
| Set up automated conversion reporting         | ​[Conversions](https://integrations.impact.com/brand-api-reference/reference/conversions/conversions) / [Actions](https://integrations.impact.com/brand-api-reference/reference/actions) API, [push file via FTP](/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.md#step-2-submit-your-data-file), or [pull file via FTP​](/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.md#step-2-submit-your-data-file) |

### 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="239.2734375">Code</th><th>Description</th></tr></thead><tbody><tr><td><code>CONS_FRAUD</code></td><td>Consumer fraud</td></tr><tr><td><code>CONS_ERROR</code></td><td>Consumer error</td></tr><tr><td><code>ITEM_RETURNED</code></td><td>Item was returned</td></tr><tr><td><code>APPROVED</code></td><td><p>Action is approved</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Note:</strong> If you’re trying to approve actions, <code>Approve</code> needs to be set up as a <a href="/brand/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/manage-disposition-codes.md">custom disposition code</a>.</p></div></td></tr><tr><td><code>ORDER_ERROR</code></td><td>Order error</td></tr><tr><td><code>ORDER_UPDATE</code></td><td>Order was updated</td></tr><tr><td><code>PUB_ACT_DISPUTE</code></td><td>Partner activity dispute</td></tr><tr><td><code>ADV_ACT_DISPUTE</code></td><td>Brand activity dispute</td></tr><tr><td><code>NOT_COMPLIANCE_TERMS</code></td><td>Not in compliance with terms</td></tr><tr><td><code>ITEM_OUT_OF_STOCK</code></td><td>Item is out of stock</td></tr><tr><td><code>TEST_ACTION</code></td><td>Test action</td></tr><tr><td><code>PARTNER_NOT_ACTIVE</code></td><td>Partner account deactivated</td></tr><tr><td><code>CREDITED_DIFFERENT_MP</code></td><td>Credited to another partner</td></tr><tr><td><code>OTHER</code></td><td>Other reason</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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.