> 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 が提供するテンプレートファイルのいずれかをダウンロードし、サンプルデータを自分のデータに置き換えてください。独自のデータを追加する際は、ファイルの送信形式が正しくなるよう、該当する参照表のガイドラインに従ってください。送信ファイルの準備ができたら、次に進めます [バッチ修正／取消の送信](/brand/ja/what-would-you-like-to-learn-about/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/brand-api-reference/reference/action-and-conversion-field-references). {% endhint %} **以下の参照先をご覧ください：** * FTP/SMTP バッチ修正または取消で使用するフィールドを確認する * プレースホルダーのサンプルデータ付きテンプレートファイルをダウンロードする * どの理由コードをいつ適用するかを理解する #### 注文レベルの修正 これは、アイテムレベルではなく注文レベルでアクションデータを一括更新したい場合、たとえば複数の注文の注文金額を変更したい場合に使用します。
使用可能なパラメータ | 項目 | 必須？ | 編集可能？ | メモ | | ----------------- | --------- | ----- | --------------------------------------------------------- | | `アクションID` | 条件付きで必須\* | 編集不可 | 重複排除ウィンドウが短い場合は、この識別子を指定することを推奨します。 | | `Oid / OrderId` | 条件付きで必須\* | 編集不可 | 次を使用する場合は、この識別子の指定が必要です *ActionTrackerId*. | | `ActionTrackerID` | 条件付きで必須\* | 編集不可 | 次を使用する場合は、この識別子の指定が必要です *OrderId/Oid*. | | `金額` | 任意 | 編集可能 | 注文の新しい合計金額を設定します。 | | `currencyCode` | 任意 | 編集可能 | アクションの収益通貨を設定します。指定がない場合、既定では impact.com アカウントの通貨が使用されます。 | | `CustomerStatus` | 任意 | 編集可能 | コンバージョン時点での顧客ステータスを設定します。例：NEW / EXISTING。 | | `理由` | 必須 | 編集可能 | 修正のための有効な理由コードを指定してください。 | \*少なくとも 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)
#### 注文レベルの取消 これは、アイテムレベルではなく注文レベルでパートナー主導のアクションを一括で取り消したい場合、たとえば複数の注文を取り消したい場合に使用します。
使用可能なパラメータ | 項目 | 必須？ | 編集可能？ | メモ | | ----------------- | ----------- | ----- | ------------------------------------------ | | `アクションID` | 条件付きで必須\* | 編集不可 | 重複排除ウィンドウが短い場合は、この識別子を指定することを推奨します。 | | `Oid / OrderId` | 条件付きで必須\* | 編集不可 | 次を使用する場合は、この識別子の指定が必要です *ActionTrackerId*. | | `ActionTrackerID` | 条件付きで必須\* | 編集不可 | 次を使用する場合は、この識別子の指定が必要です *OrderId/Oid*. | | `金額` | 条件付きで必須\*\* | 編集可能 | 次に設定： **0** 注文を取り消すために、ただし元の金額 = 0\*\* を除く | | `理由` | 必須 | 編集可能 | 取消のための有効な理由コードを指定してください。 | \*少なくとも 1 つの識別子パスを指定する必要があります。つまり、次のいずれか *ActionId* **または** (*OrderId/Oid* + *ActionTrackerId*) \*\*元の *Amount = 0*の場合は、 *金額* 修正として誤分類されないよう、変更しないでください。
テンプレートファイル * [注文レベルの取消テンプレート](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_reversals_template.csv)
#### アイテムレベルの修正 これは、注文レベルではなくアイテムレベルでアクションデータを一括更新したい場合、たとえば注文内の複数アイテムの金額を変更したい場合に使用します。
使用可能なパラメータ | 項目 | 必須？ | 編集可能？ | メモ | | ----------------- | --------- | ----- | ---------------------------------------------------------------- | | `アクションID` | 条件付きで必須\* | 編集不可 | 重複排除ウィンドウが短い場合は、この識別子を指定することを推奨します。 | | `Oid / OrderId` | 条件付きで必須\* | 編集不可 | 次を使用する場合は、この識別子の指定が必要です *ActionTrackerId*. | | `ActionTrackerID` | 条件付きで必須\* | 編集不可 | 次を使用する場合は、この識別子の指定が必要です *OrderId/Oid*. | | `SKU`\*\* | 必須 | 編集不可 | 修正したいアイテムの SKU 値を指定してください。 | | `金額`\*\* | 条件付きで必須 | 編集可能 | 新しいアイテム金額、つまり price\*quantity を設定します。数量を変更する場合は、このフィールドも変更が必要です。 | | `数量`\*\* | 任意 | 編集可能 | 注文内のアイテムの新しい数量を設定します。 | | `カテゴリ`\*\* | 任意 | 編集可能 | アイテムのカテゴリを設定します。 | | `理由`\*\* | 必須 | 編集可能 | 取消のための有効な理由コードを指定してください。 | \*少なくとも 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)
#### アイテムレベルの取消 これは、注文レベルではなくアイテムレベルでアクションデータを一括で取り消したい場合、たとえば注文内の複数アイテムを取り消したい場合に使用します。
使用可能なパラメータ | 項目 | 必須？ | 編集可能？ | メモ | | ----------------- | --------- | ----- | ---------------------------------------------------------------- | | `アクションID` | 条件付きで必須\* | 編集不可 | 重複排除ウィンドウが短い場合は、この識別子を指定することを推奨します。 | | `Oid / OrderId` | 条件付きで必須\* | 編集不可 | 次を使用する場合は、この識別子の指定が必要です *ActionTrackerId*. | | `ActionTrackerID` | 条件付きで必須\* | 編集不可 | 次を使用する場合は、この識別子の指定が必要です *OrderId/Oid*. | | `SKU`\*\* | 必須 | 編集不可 | 修正したいアイテムの SKU 値を指定してください。 | | `金額`\*\* | 条件付きで必須 | 編集可能 | 新しいアイテム金額、つまり price\*quantity を設定します。数量を変更する場合は、このフィールドも変更が必要です。 | | `数量`\*\* | 任意 | 編集可能 | 注文内のアイテムの新しい数量を設定します。 | | `理由`\*\* | 必須 | 編集可能 | 修正のための有効な理由コードを指定してください。 | \*少なくとも 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&) **または Disposition Codes について相談してください**. {% endhint %}
コード説明
消費者不正消費者不正
消費者エラー消費者エラー
商品返品商品は返品されました
承認済み

アクションは承認されています

注: アクションを承認しようとしている場合、 承認 として設定する必要があります カスタムディスポジションコード.

注文エラー注文エラー
ORDER_UPDATE注文が更新されました
パートナーアクティビティの異議申し立てパートナーアクティビティの異議申し立て
ブランドアクティビティの異議申し立てブランドアクティビティの異議申し立て
利用規約に準拠していません利用規約に準拠していません
在庫切れ商品は在庫切れです
テストアクションテストアクション
パートナーがアクティブではありませんパートナーアカウントが無効化されました
別のパートナーに付与されました別のパートナーに付与されました
その他その他の理由
--- # 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-modifications-and-reversals-reference.md?ask=&goal= ``` `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.