> 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-modifications-and-reversals-reference.md).

# 一括変更と取り消しのリファレンス

アクションデータを一括で変更または取り消す場合は、まずimpact.comが提供するテンプレートファイルをダウンロードし、サンプルデータを独自のデータに置き換えてください。データを追加する際は、ファイルが正しい形式で提出されるよう、該当するリファレンステーブルのガイドラインに従ってください。提出ファイルの準備ができたら、一括変更／取り消しファイルの提出に進みます。

{% hint style="info" %}
この記事では、一括変更と取り消しで最もよく使用されるフィールドを紹介します。フィールドの説明を含む詳細なリファレンスについては、 [アクションとコンバージョンのフィールドリファレンス](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references).
{% endhint %}

**以下のリファレンスでは、次の内容を確認できます。**

* FTP/SMTPによる一括変更または取り消しで使用するフィールド
* プレースホルダーのサンプルデータが入ったテンプレートファイルのダウンロード
* 適用する理由コードとその適用タイミング

#### 注文レベルの変更

これは、商品レベルではなく注文レベルでアクションデータを一括更新する場合に使用します。たとえば、複数の注文の金額を変更する場合です。

<details>

<summary>使用可能なパラメーター</summary>

| 項目                | 必須?       | 編集可能? | 注記                                                                                                                                               |
| ----------------- | --------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `ActionID`        | 条件付きで必須\* | 編集不可  | 重複排除期間が短い場合は、この識別子を指定することをおすすめします。                                                                                                               |
| `Oid / OrderId`   | 条件付きで必須\* | 編集不可  | 次を使用する場合は、この識別子の指定が必須です。 *ActionTrackerId*.                                                                                                      |
| `ActionTrackerID` | 条件付きで必須\* | 編集不可  | 次を使用する場合は、この識別子の指定が必須です。 *OrderId/Oid*.                                                                                                          |
| `Amount`          | 任意        | 編集可能  | 注文の新しい合計金額を設定します。                                                                                                                                |
| `currencyCode`    | 任意        | 編集可能  | アクションの売上通貨を設定します。指定しない場合は、impact.comアカウントの通貨が使用されます。                                                                                             |
| `CustomerStatus`  | 任意        | 編集可能  | コンバージョン時点での顧客ステータスを設定します（例: NEW / EXISTING）。                                                                                                     |
| `Note`            | 任意        | 編集可能  | イベントレベルのレポート用の汎用フィールドです。元のコンバージョンで空欄の場合、値を送信するとその値が挿入されます。アクションごとに一度だけ受け付けられます。他のフィールドも変更する場合は、同じリクエストで送信してください。                                 |
| `LocationId`      | 任意        | 編集可能  | 主に宿泊施設向けに使用される、このコンバージョンで指定された場所の一意の識別子です。元のコンバージョンで空欄の場合、値を送信するとその値が挿入されます。                                                                     |
| `LocationName`    | 任意        | 編集可能  | 主に宿泊施設向けに使用される、このコンバージョンで指定された場所の名称です。元のコンバージョンで空欄の場合、値を送信するとその値が挿入されます。                                                                         |
| `GiftPurchase`    | 任意        | 編集可能  | 注文をギフト購入としてマークするにはtrue、マークを解除するにはfalseに設定します。元のコンバージョンで空欄の場合、値を送信するとその値が挿入されます。                                                                  |
| `Text1–Text50`    | 任意        | 編集可能  | 送信したい任意のテキストデータを文字列として受け付ける汎用テキストフィールドです（Text1からText50）。元のコンバージョンで空欄の場合、値を送信するとその値が挿入されます。アクションごとに一度だけ受け付けられます。他のフィールドも変更する場合は、同じリクエストで送信してください。 |
| `Reason`          | 必須        | 編集可能  | 変更の有効な理由コードを指定します。                                                                                                                               |

\*識別子の指定方法を少なくとも1つ指定する必要があります。つまり、 *ActionId* **または** （\*OrderId/Oid \*+ *ActionTrackerId*)

</details>

<details>

<summary>テンプレートファイル</summary>

* [注文レベルの変更用テンプレート](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_modifications_template.csv)
* [注文レベルの承認用テンプレート](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_approvals_template.csv)

</details>

#### 注文レベルの取り消し

これは、アイテム単位ではなく注文単位で、パートナー主導のアクションを一括で取り消す場合に使用します（例：複数の注文を取り消す場合）。

<details>

<summary>使用可能なパラメーター</summary>

| 項目                | 必須?         | 編集可能? | 注記                                          |
| ----------------- | ----------- | ----- | ------------------------------------------- |
| `ActionID`        | 条件付きで必須\*   | 編集不可  | 重複排除期間が短い場合は、この識別子を指定することをおすすめします。          |
| `Oid / OrderId`   | 条件付きで必須\*   | 編集不可  | 次を使用する場合は、この識別子の指定が必須です。 *ActionTrackerId*. |
| `ActionTrackerID` | 条件付きで必須\*   | 編集不可  | 次を使用する場合は、この識別子の指定が必須です。 *OrderId/Oid*.     |
| `Amount`          | 条件付きで必須\*\* | 編集可能  | 次の値を設定します： **0** 元の金額が0でない限り、注文を取り消すには      |
| `Reason`          | 必須          | 編集可能  | 取り消しの有効な理由コードを指定してください。                     |

\*少なくとも1つの識別子パスを指定する必要があります。つまり、 *ActionId* **または** (*OrderId/Oid* + *ActionTrackerId*)

\*\*元の *Amount = 0*の場合は、 *Amount* を変更せず、変更として誤分類されないようにしてください。

</details>

<details>

<summary>テンプレートファイル</summary>

* [注文単位の取り消しテンプレート](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_reversals_template.csv)

</details>

#### アイテム単位の変更

これは、注文単位ではなくアイテム単位でアクションデータを一括更新する場合に使用します（例：注文内の複数アイテムのAmountを変更する場合）。

<details>

<summary>使用可能なパラメーター</summary>

| 項目                | 必須?       | 編集可能? | 注記                                                      |
| ----------------- | --------- | ----- | ------------------------------------------------------- |
| `ActionID`        | 条件付きで必須\* | 編集不可  | 重複排除期間が短い場合は、この識別子を指定することをおすすめします。                      |
| `Oid / OrderId`   | 条件付きで必須\* | 編集不可  | 次を使用する場合は、この識別子の指定が必須です。 *ActionTrackerId*.             |
| `ActionTrackerID` | 条件付きで必須\* | 編集不可  | 次を使用する場合は、この識別子の指定が必須です。 *OrderId/Oid*.                 |
| `SKU`\*\*         | 必須        | 編集不可  | 変更するアイテムのSKU値を指定してください。                                 |
| `Amount`\*\*      | 条件付きで必須   | 編集可能  | アイテムの新しい金額（価格×数量）を設定します。数量を変更する場合は、このフィールドも変更する必要があります。 |
| `Quantity`\*\*    | 任意        | 編集可能  | 注文内のアイテムの新しい数量を設定します。                                   |
| `Category`\*\*    | 任意        | 編集可能  | アイテムのカテゴリを設定します。                                        |
| `Reason`\*\*      | 必須        | 編集可能  | 取り消しの有効な理由コードを指定してください。                                 |

\*少なくとも1つの識別子パスを指定する必要があります。つまり、 *ActionId* **または** (*OrderId/Oid* + *ActionTrackerId*)

\*\*変更する各アイテムにこれらのフィールドを含める必要があります。識別子フィールドは注文ごとに1回だけ含めます。

</details>

<details>

<summary>テンプレートファイル</summary>

* [アイテム単位の変更テンプレート](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_modifications_template.csv)
* [アイテム単位の承認テンプレート](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_approvals_template.csv)

</details>

#### アイテム単位の取り消し

これは、注文単位ではなくアイテム単位でアクションデータを一括で取り消す場合に使用します（例：注文内の複数アイテムを取り消す場合）。

<details>

<summary>使用可能なパラメーター</summary>

| 項目                | 必須?       | 編集可能? | 注記                                                      |
| ----------------- | --------- | ----- | ------------------------------------------------------- |
| `ActionID`        | 条件付きで必須\* | 編集不可  | 重複排除期間が短い場合は、この識別子を指定することをおすすめします。                      |
| `Oid / OrderId`   | 条件付きで必須\* | 編集不可  | 次を使用する場合は、この識別子の指定が必須です。 *ActionTrackerId*.             |
| `ActionTrackerID` | 条件付きで必須\* | 編集不可  | 次を使用する場合は、この識別子の指定が必須です。 *OrderId/Oid*.                 |
| `SKU`\*\*         | 必須        | 編集不可  | 変更するアイテムのSKU値を指定してください。                                 |
| `Amount`\*\*      | 条件付きで必須   | 編集可能  | アイテムの新しい金額（価格×数量）を設定します。数量を変更する場合は、このフィールドも変更する必要があります。 |
| `Quantity`\*\*    | 任意        | 編集可能  | 注文内のアイテムの新しい数量を設定します。                                   |
| `Reason`\*\*      | 必須        | 編集可能  | 変更の有効な理由コードを指定します。                                      |

\*少なくとも1つの識別子パスを指定する必要があります。つまり、 *ActionId* **または** (*OrderId/Oid* + *ActionTrackerId*)

\*\*変更する各アイテムにこれらのフィールドを含める必要があります。識別子フィールドは注文ごとに1回だけ含めます。

</details>

<details>

<summary>テンプレートファイル</summary>

* [アイテム単位の取り消しテンプレート](https://res.cloudinary.com/product-enablement/raw/upload/v1768298926/CSVs/Batch%20Action%20Processing/Item-level_reversals_template.csv)

この例では、SKU O7427540が2回登場します。一方の行は取り消し（Amount=0）、もう一方の行は変更（Amount=15）を表しています。

</details>

{% hint style="info" %}
**注：** 重複する *OrderIds* が発生する可能性があり、 *OrderId + ActionTrackerId*の組み合わせを使用する場合、impact.comはデフォルトで最新の *ActionId* に更新を適用します。古いものに更新を適用する場合は、古い *ActionId* を使用してください。 *ActionId*.
{% endhint %}

#### 理由コード

アクションデータを変更または取り消すたびに、理由を指定する必要があります。以下の該当する理由コードを使用して、アクションを更新する理由を説明してください。

{% hint style="warning" %}
**警告：** 受け付けられない値を渡すと、エントリは処理されず、代わりにエラーが返されます。カスタム理由コードが必要な場合は、CSMに問い合わせるか、 [**サポートに連絡**](https://app.impact.com/support/portal.ihtml?createTicket=true&) **して、Disposition Codeについてご相談ください。**.
{% endhint %}

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


---

# 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-modifications-and-reversals-reference.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.
