> 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](/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経由でアクション内の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がデフォルトで受け入れる事前定義コードであり、 *処理コード* は、設定できるカスタム理由です。 [処理コードについて詳しく学ぶ](/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="/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/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.