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

アクションデータを一括で修正または取り消す場合は、まず impact.com が提供するテンプレートファイルのいずれかをダウンロードし、サンプルデータを自分のデータに置き換えてください。独自のデータを追加する際は、ファイル送信が正しくフォーマットされるよう、関連する参照表のガイドラインに従ってください。送信ファイルの準備ができたら、次の手順を再開できます。 [バッチ修正 / 取り消しの送信](/brand/ja/nitsuitebitaidesuka/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.md#submit-your-data-file-0-1) ファイル。

{% hint style="info" %}
この参照記事には、バッチ修正および取り消しで最も一般的に使用されるフィールドが含まれています。フィールドの説明を含む完全で詳細な参照については、次を参照してください。 [アクション & コンバージョンのフィールド参照](https://integrations.impact.com/impact-brand/reference/action-conversion-field-references).
{% endhint %}

**以下の参照を確認して、**

* FTP/SMTP バッチ修正または取り消しで使用するフィールドを確認する
* プレースホルダーのサンプルデータ付きテンプレートファイルをダウンロードする
* どの理由コードをいつ適用するかを理解する

#### 注文レベルの修正

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

<details>

<summary>受け入れ可能なパラメーター</summary>

| 項目                | 必須？       | 編集可能？ | 注                                                           |
| ----------------- | --------- | ----- | ----------------------------------------------------------- |
| `ActionID`        | 条件付きで必須\* | 編集不可  | 重複排除ウィンドウが短い場合は、この識別子を提供することを推奨します。                         |
| `Oid / OrderId`   | 条件付きで必須\* | 編集不可  | この識別子の提供は、次を使用する場合に必須です。 *ActionTrackerId*.                 |
| `ActionTrackerID` | 条件付きで必須\* | 編集不可  | この識別子の提供は、次を使用する場合に必須です。 *OrderId/Oid*.                     |
| `金額`              | 任意        | 編集可能  | 注文の新しい合計金額を設定します。                                           |
| `currencyCode`    | 任意        | 編集可能  | アクションの収益通貨を設定します。指定がない場合、デフォルトで impact.com アカウントの通貨が使用されます。 |
| `CustomerStatus`  | 任意        | 編集可能  | コンバージョン時点の顧客ステータスを設定します。例: NEW / EXISTING。                  |
| `理由`              | 必須        | 編集可能  | 修正の有効な理由コードを指定します。                                          |

\*少なくとも 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*.         |
| `金額`              | 条件付きで必須\*\* | 編集可能  | 次に設定します。 **0** 注文を取り消すには、ただし元の金額 = 0\*\* の場合を除く |
| `理由`              | 必須          | 編集可能  | 取り消しの有効な理由コードを指定します。                            |

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

\*\*もし元の *Amount = 0*、次のままにしておきます。 *金額* 修正として誤分類されないように、変更しないでください。

</details>

<details>

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

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

</details>

#### アイテムレベルの修正

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

<details>

<summary>受け入れ可能なパラメーター</summary>

| 項目                | 必須？       | 編集可能？ | 注                                                    |
| ----------------- | --------- | ----- | ---------------------------------------------------- |
| `ActionID`        | 条件付きで必須\* | 編集不可  | 重複排除ウィンドウが短い場合は、この識別子を提供することを推奨します。                  |
| `Oid / OrderId`   | 条件付きで必須\* | 編集不可  | この識別子の提供は、次を使用する場合に必須です。 *ActionTrackerId*.          |
| `ActionTrackerID` | 条件付きで必須\* | 編集不可  | この識別子の提供は、次を使用する場合に必須です。 *OrderId/Oid*.              |
| `SKU`\*\*         | 必須        | 編集不可  | 修正したいアイテムの SKU 値を指定します。                              |
| `金額`\*\*          | 条件付きで必須   | 編集可能  | 新しいアイテム金額、つまり価格\*数量を設定します。数量を変更する場合、このフィールドも修正が必要です。 |
| `数量`\*\*          | 任意        | 編集可能  | 注文内のアイテムの新しい数量を設定します。                                |
| `カテゴリ`\*\*        | 任意        | 編集可能  | アイテムのカテゴリを設定します。                                     |
| `理由`\*\*          | 必須        | 編集可能  | 取り消しの有効な理由コードを指定します。                                 |

\*少なくとも 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 値を指定します。                              |
| `金額`\*\*          | 条件付きで必須   | 編集可能  | 新しいアイテム金額、つまり価格\*数量を設定します。数量を変更する場合、このフィールドも修正が必要です。 |
| `数量`\*\*          | 任意        | 編集可能  | 注文内のアイテムの新しい数量を設定します。                                |
| `理由`\*\*          | 必須        | 編集可能  | 修正の有効な理由コードを指定します。                                   |

\*少なくとも 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 回表示されているのは、1 行は取り消し（Amount=0）、もう 1 行は修正（Amount=15）だからです。

</details>

{% hint style="info" %}
**注:** 重複する *OrderId* を使用することを選択する場合、 *OrderId + ActionTrackerId*、impact.com はデフォルトで更新を最新の *ActionId* に適用します。古い *ActionId* に更新を適用したい場合は、古い方を使用してください。 *ActionId*.
{% endhint %}

#### 理由コード

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

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


---

# Agent Instructions: 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:

```
GET https://help.impact.com/brand/ja/nitsuitebitaidesuka/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.