> 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/ja/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](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.md#step-2-submit-your-data-file) batch processing or [upload file via 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.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](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.md#step-2-submit-your-data-file), or [pull file via 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.md#step-2-submit-your-data-file) |

### APIによる取り消しの方法：

* [APIを使って、アクション内の1つ以上の項目を変更または取り消す](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がデフォルトで受け付ける定義済みコードである一方、 *処理コード* は設定可能なカスタム理由です。 [処分コードについて詳しく見る](https://help.impact.com/brand/ja/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="https://help.impact.com/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" %}
**注:** 1つの `ActionUpdatesID` の値は、1つの `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/ja/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.
