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

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

### API 撤销选项：

* [通过 API 修改或撤销一个行动中的一项或多项商品](https://integrations.impact.com/impact-brand/reference/update-an-action-item)
* [通过 API 撤销整个行动](https://integrations.impact.com/impact-brand/reference/reverse-an-action)

### 前提条件：检索 *ActionId* 值

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

* 您可以在调用中指定日期范围——否则，该端点默认显示最近 30 天的行动。
* [速率限制](https://integrations.impact.com/impact-brand/reference/rate-limits) 适用。
* 查看下方的 [列出所有行动](https://integrations.impact.com/impact-brand/reference/list-all-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).

支持的原因代码：

</details>

<details>

<summary>如何查看对行动应用修改/撤销的时间？</summary>

您可以使用 [行动更新](https://integrations.impact.com/impact-brand/reference/the-action-update-object) 端点以查看某个行动最后一次更新的时间以及其当前状态。

{% 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:

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

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.