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

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

| もし〜したい場合...                 | この方法を使います...                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| コーディングなしで、手動の1回限りのファイルを送信する | ​[メール](/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="/brand/ja/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/manage-disposition-codes.md">カスタム処理コード</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.