# 一括修正と取り消しのリファレンス
アクションデータを一括で修正または取り消す場合は、まず impact.com が提供するテンプレートファイルのいずれかをダウンロードし、サンプルデータを自分のデータに置き換えてください。独自のデータを追加する際は、ファイル送信が正しくフォーマットされるよう、関連する参照表のガイドラインに必ず従ってください。送信ファイルの準備ができたら、以下を使って再開できます [一括修正／取り消しの送信](https://help.impact.com/brand/ja/nitsuitebitaidesuka/platform-features/submit-and-modify-conversion-data/submit-batch-modifications-and-reversals#submit-your-data-file-0-1) ファイル。
{% hint style="info" %}
この参考記事には、一括修正および取り消しで最もよく使用されるフィールドが含まれています。フィールドの説明を含む完全で詳細な参照を確認するには、以下を参照してください [アクション & コンバージョン フィールド参照](https://integrations.impact.com/impact-brand/reference/action-conversion-field-references).
{% endhint %}
**以下の参照を使用して、次のことを行ってください。**
* FTP/SMTP の一括修正または取り消しで使用するフィールドを確認する
* プレースホルダーのサンプルデータ付きテンプレートファイルをダウンロードする
* どの理由コードをいつ適用するかを理解する
#### 注文レベルの修正
これは、商品レベルではなく注文レベルでアクションデータを一括更新したい場合に使用します。例: 複数の注文の注文金額を変更する。
受け入れられるパラメータ
| フィールド | 必須？ | 編集可能？ | 注記 |
| ----------------- | -------- | ----- | ------------------------------------------------------ |
| `ActionID` | 条件付き必須\* | 編集不可 | 重複排除ウィンドウが短い場合、この識別子の提供を推奨します。 |
| `Oid / OrderId` | 条件付き必須\* | 編集不可 | この識別子の提供が必要になるのは、以下を使用する場合です *ActionTrackerId*. |
| `ActionTrackerID` | 条件付き必須\* | 編集不可 | この識別子の提供が必要になるのは、以下を使用する場合です *OrderId/Oid*. |
| `Amount` | 任意 | 編集可能 | 注文の新しい合計金額を設定します。 |
| `currencyCode` | 任意 | 編集可能 | アクションの収益通貨を設定します。指定しない場合、デフォルトは impact.com アカウントの通貨です。 |
| `CustomerStatus` | 任意 | 編集可能 | コンバージョン時点での顧客のステータスを設定します。例: NEW / EXISTING。 |
| `Reason` | 必須 | 編集可能 | 修正のための有効な理由コードを指定してください。 |
\*少なくとも 1 つの識別子パスを指定する必要があります。つまり、以下のいずれかです *ActionId* **または** (\*OrderId/Oid \*+ *ActionTrackerId*)
テンプレートファイル
* [注文レベル修正テンプレート](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)
#### 注文レベルの取り消し
これは、商品レベルではなく注文レベルで、パートナー起点のアクションを一括で取り消したい場合に使用します。例: 複数の注文を取り消す。
受け入れられるパラメータ
| フィールド | 必須？ | 編集可能？ | 注記 |
| ----------------- | ---------- | ----- | ----------------------------------------------- |
| `ActionID` | 条件付き必須\* | 編集不可 | 重複排除ウィンドウが短い場合、この識別子の提供を推奨します。 |
| `Oid / OrderId` | 条件付き必須\* | 編集不可 | この識別子の提供が必要になるのは、以下を使用する場合です *ActionTrackerId*. |
| `ActionTrackerID` | 条件付き必須\* | 編集不可 | この識別子の提供が必要になるのは、以下を使用する場合です *OrderId/Oid*. |
| `Amount` | 条件付き必須\*\* | 編集可能 | 次のように設定 **0** 注文を取り消します。ただし、元の金額 = 0 の場合は除く\*\* |
| `Reason` | 必須 | 編集可能 | 取り消しのための有効な理由コードを指定してください。 |
\*少なくとも 1 つの識別子パスを指定する必要があります。つまり、以下のいずれかです *ActionId* **または** (*OrderId/Oid* + *ActionTrackerId*)
\*\*元の *Amount = 0*の場合は、 *Amount* 変更しないままにして、修正として誤分類されるのを避けてください。
テンプレートファイル
* [注文レベルの取り消しテンプレート](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_reversals_template.csv)
#### 商品レベルの修正
これは、注文レベルではなく商品レベルでアクションデータを一括更新したい場合に使用します。例: 注文内の複数商品の Amount を変更する。
受け入れられるパラメータ
| フィールド | 必須？ | 編集可能？ | 注記 |
| ----------------- | -------- | ----- | ------------------------------------------------------------- |
| `ActionID` | 条件付き必須\* | 編集不可 | 重複排除ウィンドウが短い場合、この識別子の提供を推奨します。 |
| `Oid / OrderId` | 条件付き必須\* | 編集不可 | この識別子の提供が必要になるのは、以下を使用する場合です *ActionTrackerId*. |
| `ActionTrackerID` | 条件付き必須\* | 編集不可 | この識別子の提供が必要になるのは、以下を使用する場合です *OrderId/Oid*. |
| `SKU`\*\* | 必須 | 編集不可 | 修正したい商品の SKU 値を指定してください。 |
| `Amount`\*\* | 条件付き必須 | 編集可能 | 新しい商品金額、つまり price\*quantity を設定します。数量を変更する場合、このフィールドも変更が必要です。 |
| `Quantity`\*\* | 任意 | 編集可能 | 注文内の商品の新しい数量を設定します。 |
| `Category`\*\* | 任意 | 編集可能 | 商品のカテゴリを設定します。 |
| `Reason`\*\* | 必須 | 編集可能 | 取り消しのための有効な理由コードを指定してください。 |
\*少なくとも 1 つの識別子パスを指定する必要があります。つまり、以下のいずれかです *ActionId* **または** (*OrderId/Oid* + *ActionTrackerId*)
\*\*これらのフィールドは、修正する各商品に含める必要があります。識別子フィールドは注文ごとに 1 回のみ含めます。
テンプレートファイル
* [商品レベル修正テンプレート](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)
#### 商品レベルの取り消し
これは、注文レベルではなく商品レベルでアクションデータを一括で取り消したい場合に使用します。例: 注文内の複数商品を取り消す。
受け入れられるパラメータ
| フィールド | 必須？ | 編集可能？ | 注記 |
| ----------------- | -------- | ----- | ------------------------------------------------------------- |
| `ActionID` | 条件付き必須\* | 編集不可 | 重複排除ウィンドウが短い場合、この識別子の提供を推奨します。 |
| `Oid / OrderId` | 条件付き必須\* | 編集不可 | この識別子の提供が必要になるのは、以下を使用する場合です *ActionTrackerId*. |
| `ActionTrackerID` | 条件付き必須\* | 編集不可 | この識別子の提供が必要になるのは、以下を使用する場合です *OrderId/Oid*. |
| `SKU`\*\* | 必須 | 編集不可 | 修正したい商品の SKU 値を指定してください。 |
| `Amount`\*\* | 条件付き必須 | 編集可能 | 新しい商品金額、つまり price\*quantity を設定します。数量を変更する場合、このフィールドも変更が必要です。 |
| `Quantity`\*\* | 任意 | 編集可能 | 注文内の商品の新しい数量を設定します。 |
| `Reason`\*\* | 必須 | 編集可能 | 修正のための有効な理由コードを指定してください。 |
\*少なくとも 1 つの識別子パスを指定する必要があります。つまり、以下のいずれかです *ActionId* **または** (*OrderId/Oid* + *ActionTrackerId*)
\*\*これらのフィールドは、修正する各商品に含める必要があります。識別子フィールドは注文ごとに 1 回のみ含めます。
テンプレートファイル
* [商品レベルの取り消しテンプレート](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）だからです。
{% 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&) **に連絡して、処分コードについて相談してください**.
{% endhint %}