> 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を使ってそれを変更（または取り消し）し、そのアクションのコミッション額を変更できます。

### どの送信方法が適していますか？

| 〜したい場合は...                  | この方法を使って...                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| コーディングなしで、手動の一回限りのファイルを送信する | ​[メール](/brand/ja/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を介してアクション内の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="234">コード</th><th>説明</th></tr></thead><tbody><tr><td><code>CONS_FRAUD</code></td><td>消費者詐欺</td></tr><tr><td><code>CONS_ERROR</code></td><td>消費者エラー</td></tr><tr><td><code>ITEM_RETURNED</code></td><td>商品は返品されました</td></tr><tr><td><code>APPROVED</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/efc7faa21a9d1684e520e450ad311e576c03224c">カスタム処理コード</a>.</p></div></td></tr><tr><td><code>ORDER_ERROR</code></td><td>注文エラー</td></tr><tr><td><code>ORDER_UPDATE</code></td><td>注文が更新されました</td></tr><tr><td><code>PUB_ACT_DISPUTE</code></td><td>パートナーの活動に関する異議申し立て</td></tr><tr><td><code>ADV_ACT_DISPUTE</code></td><td>ブランドの活動に関する異議申し立て</td></tr><tr><td><code>NOT_COMPLIANCE_TERMS</code></td><td>利用規約に準拠していません</td></tr><tr><td><code>ITEM_OUT_OF_STOCK</code></td><td>商品は在庫切れです</td></tr><tr><td><code>TEST_ACTION</code></td><td>テストアクション</td></tr><tr><td><code>PARTNER_NOT_ACTIVE</code></td><td>パートナーアカウントは無効化されました</td></tr><tr><td><code>CREDITED_DIFFERENT_MP</code></td><td>別のパートナーにクレジットされました</td></tr><tr><td><code>OTHER</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/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=<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.