> 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 のバッチ修正または差し戻しで使用するフィールドを確認する * プレースホルダーのサンプルデータ付きテンプレートファイルをダウンロードする * どの理由コードをいつ適用するかを理解する #### 注文レベルの修正 これは、項目レベルではなく注文レベルでアクションデータを一括更新したい場合、たとえば複数の注文の注文金額を変更したい場合に使用します。
受け入れ可能なパラメータ | フィールド | 必須？ | 編集可能？ | 注 | | ----------------- | --------- | ----- | -------------------------------------------------------- | | `ActionID` | 条件付きで必須\* | 編集不可 | 重複排除ウィンドウが短い場合は、この識別子を提供することを推奨します。 | | `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)
#### 注文レベルの差し戻し これは、項目レベルではなく注文レベルでパートナー起因のアクションを一括で差し戻したい場合、たとえば複数の注文を差し戻したい場合に使用します。
受け入れ可能なパラメータ | フィールド | 必須？ | 編集可能？ | 注 | | ----------------- | ----------- | ----- | --------------------------------------------- | | `ActionID` | 条件付きで必須\* | 編集不可 | 重複排除ウィンドウが短い場合は、この識別子を提供することを推奨します。 | | `Oid / OrderId` | 条件付きで必須\* | 編集不可 | 使用時には、この識別子の提供が必要です。 *ActionTrackerId*. | | `ActionTrackerID` | 条件付きで必須\* | 編集不可 | 使用時には、この識別子の提供が必要です。 *OrderId/Oid*. | | `金額` | 条件付きで必須\*\* | 編集可能 | に設定する **0** 注文を差し戻すために、ただし元の金額 = 0 の場合を除く\*\* | | `理由` | 必須 | 編集可能 | 差し戻しに対する有効な理由コードを指定してください。 | \*少なくとも 1 つの識別子パスを提供する必要があります。つまり、以下のいずれかです。 *ActionId* **または** (*OrderId/Oid* + *ActionTrackerId*) \*\*元の *金額 = 0*の場合は、 *金額* 変更しないでください。修正として誤分類されるのを避けるためです。
テンプレートファイル * [注文レベル差し戻しテンプレート](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_reversals_template.csv)
#### 項目レベルの修正 これは、注文レベルではなく項目レベルでアクションデータを一括更新したい場合、たとえば注文内の複数項目の金額を変更したい場合に使用します。
受け入れ可能なパラメータ | フィールド | 必須？ | 編集可能？ | 注 | | ----------------- | --------- | ----- | ------------------------------------------------------------- | | `ActionID` | 条件付きで必須\* | 編集不可 | 重複排除ウィンドウが短い場合は、この識別子を提供することを推奨します。 | | `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)
#### 項目レベルの差し戻し これは、注文レベルではなく項目レベルでアクションデータを一括で差し戻したい場合、たとえば注文内の複数項目を差し戻したい場合に使用します。
受け入れ可能なパラメータ | フィールド | 必須？ | 編集可能？ | 注 | | ----------------- | --------- | ----- | ------------------------------------------------------------- | | `ActionID` | 条件付きで必須\* | 編集不可 | 重複排除ウィンドウが短い場合は、この識別子を提供することを推奨します。 | | `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 %}
コード説明
CONS_FRAUD消費者詐欺
CONS_ERROR消費者エラー
ITEM_RETURNED商品は返品されました
APPROVED

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

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

ORDER_ERROR注文エラー
ORDER_UPDATE注文が更新されました
PUB_ACT_DISPUTEパートナーの活動に関する異議申し立て
ADV_ACT_DISPUTEブランドの活動に関する異議申し立て
NOT_COMPLIANCE_TERMS利用規約に準拠していません
ITEM_OUT_OF_STOCK商品は在庫切れです
TEST_ACTIONテストアクション
PARTNER_NOT_ACTIVEパートナーアカウントは無効化されました
CREDITED_DIFFERENT_MP別のパートナーにクレジットされました
OTHERその他の理由
--- # 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.