> 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 バッチ修正または取り消しで使用するフィールドを確認する * プレースホルダーのサンプルデータ付きテンプレートファイルをダウンロードする * どの理由コードをいつ適用するかを理解する #### 注文レベルの修正 これは、アイテムレベルではなく注文レベルでアクションデータを一括更新したい場合に使用します。例: 複数の注文の注文金額を変更する。
使用可能なパラメータ | 項目 | 必須？ | 編集可能？ | 注 | | ----------------- | -------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------- | | `ActionID` | 条件付き必須\* | 編集不可 | 重複排除ウィンドウが短い場合は、この識別子の提供を推奨します。 | | `Oid / OrderId` | 条件付き必須\* | 編集不可 | この識別子の提供が必要なのは、次を使用する場合です *ActionTrackerId*. | | `ActionTrackerID` | 条件付き必須\* | 編集不可 | この識別子の提供が必要なのは、次を使用する場合です *OrderId/Oid*. | | `Amount` | 任意 | 編集可能 | 注文の新しい合計金額を設定します。 | | `currencyCode` | 任意 | 編集可能 | アクションの売上通貨を設定します。指定しない場合は、impact.com アカウントの通貨が既定値になります。 | | `CustomerStatus` | 任意 | 編集可能 | コンバージョン時点での顧客ステータスを設定します。例: NEW / EXISTING。 | | `注` | 任意 | 編集可能 | イベントレベルのレポート目的の一般フィールド。元のコンバージョンで空欄の場合、値を送信すると挿入されます。1つのアクションにつき1回のみ受け付けられます。その他のフィールド変更は同じリクエストで送信してください。 | | `LocationId` | 任意 | 編集可能 | 主に宿泊施設で使用されます。これは、このコンバージョンで指定された場所の一意の識別子です。元のコンバージョンで空欄の場合、値を送信すると挿入されます。 | | `LocationName` | 任意 | 編集可能 | 主に宿泊施設で使用されます。これは、このコンバージョンで指定された場所の名前です。元のコンバージョンで空欄の場合、値を送信すると挿入されます。 | | `GiftPurchase` | 任意 | 編集可能 | true に設定すると注文をギフト購入としてマークし、false に設定するとマークを解除します。元のコンバージョンで空欄の場合、値を送信すると挿入されます。 | | `Text1～Text50` | 任意 | 編集可能 | 送信したい任意のテキストデータ文字列を受け付ける汎用テキストフィールドです（Text1～Text50）。元のコンバージョンで空欄の場合、値を送信すると挿入されます。1つのアクションにつき1回のみ受け付けられます。その他のフィールド変更は同じリクエストで送信してください。 | | `理由` | 必須 | 編集可能 | 修正の有効な理由コードを指定してください。 | \*少なくとも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\*\* の場合を除きます | | `理由` | 必須 | 編集可能 | 取り消しの有効な理由コードを指定してください。 | \*少なくとも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)
#### アイテムレベルの修正 これは、注文レベルではなくアイテムレベルでアクションデータを一括更新したい場合に使用します。例: 1つの注文内の複数アイテムの金額を変更する。
使用可能なパラメータ | 項目 | 必須？ | 編集可能？ | 注 | | ----------------- | -------- | ----- | --------------------------------------------------------------- | | `ActionID` | 条件付き必須\* | 編集不可 | 重複排除ウィンドウが短い場合は、この識別子の提供を推奨します。 | | `Oid / OrderId` | 条件付き必須\* | 編集不可 | この識別子の提供が必要なのは、次を使用する場合です *ActionTrackerId*. | | `ActionTrackerID` | 条件付き必須\* | 編集不可 | この識別子の提供が必要なのは、次を使用する場合です *OrderId/Oid*. | | `SKU`\*\* | 必須 | 編集不可 | 修正したいアイテムのSKU値を指定してください。 | | `Amount`\*\* | 条件付き必須 | 編集可能 | 新しいアイテム金額、つまり 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)
#### アイテムレベルの取り消し これは、注文レベルではなくアイテムレベルでアクションデータを一括で取り消したい場合に使用します。例: 1つの注文内の複数アイテムを取り消す。
使用可能なパラメータ | 項目 | 必須？ | 編集可能？ | 注 | | ----------------- | -------- | ----- | --------------------------------------------------------------- | | `ActionID` | 条件付き必須\* | 編集不可 | 重複排除ウィンドウが短い場合は、この識別子の提供を推奨します。 | | `Oid / OrderId` | 条件付き必須\* | 編集不可 | この識別子の提供が必要なのは、次を使用する場合です *ActionTrackerId*. | | `ActionTrackerID` | 条件付き必須\* | 編集不可 | この識別子の提供が必要なのは、次を使用する場合です *OrderId/Oid*. | | `SKU`\*\* | 必須 | 編集不可 | 修正したいアイテムのSKU値を指定してください。 | | `Amount`\*\* | 条件付き必須 | 編集可能 | 新しいアイテム金額、つまり 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 %}
CodeDescription
CONS_FRAUDConsumer fraud
CONS_ERRORConsumer error
ITEM_RETURNEDItem was returned
APPROVED

Action is approved

Note: If you’re trying to approve actions, Approve needs to be set up as a custom disposition code.

ORDER_ERROROrder error
ORDER_UPDATEOrder was updated
PUB_ACT_DISPUTEPartner activity dispute
ADV_ACT_DISPUTEBrand activity dispute
NOT_COMPLIANCE_TERMSNot in compliance with terms
ITEM_OUT_OF_STOCKItem is out of stock
TEST_ACTIONTest action
PARTNER_NOT_ACTIVEPartner account deactivated
CREDITED_DIFFERENT_MPCredited to another partner
OTHEROther reason
--- # 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=&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.