> 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*. | | `金額` | 任意 | 編集可能 | 注文の新しい合計金額を設定します。 | | `通貨コード` | 任意 | 編集可能 | アクションの収益通貨を設定します。指定がない場合、impact.com アカウントの通貨が既定値になります。 | | `CustomerStatus` | 任意 | 編集可能 | コンバージョン時点での顧客ステータスを設定します。例：NEW / EXISTING。 | | `注` | 任意 | 編集可能 | イベントレベルのレポート目的の一般フィールドです。元のコンバージョンで空の場合、値を送信すると挿入されます。アクションごとに1回のみ受け付けられます。ほかのフィールド変更は同じリクエストで送信してください。 | | `LocationId` | 任意 | 編集可能 | 主に宿泊施設で使用され、このコンバージョンで指定された場所の一意の識別子です。元のコンバージョンで空の場合、値を送信すると挿入されます。 | | `LocationName` | 任意 | 編集可能 | 主に宿泊施設で使用され、このコンバージョンで指定された場所の名前です。元のコンバージョンで空の場合、値を送信すると挿入されます。 | | `GiftPurchase` | 任意 | 編集可能 | 注文をギフト購入としてマークするには true に、マークを外すには false に設定します。元のコンバージョンで空の場合、値を送信すると挿入されます。 | | `Text1～Text50` | 任意 | 編集可能 | 送信したい任意のテキストデータ文字列を受け付ける一般テキストフィールドです（Text1 から Text50）。元のコンバージョンで空の場合、値を送信すると挿入されます。アクションごとに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*. | | `金額` | 条件付きで必須\*\* | 編集可能 | に設定 **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)
#### アイテムレベルの修正 これは、アイテムレベルではなく注文レベルでアクションデータを一括更新したい場合、たとえば1つの注文内の複数アイテムの金額を変更する場合に使用します。
受け入れ可能なパラメータ | フィールド | 必須？ | 編集可能？ | 注 | | ----------------- | --------- | ----- | ---------------------------------------------------- | | `ActionID` | 条件付きで必須\* | 編集不可 | 重複排除ウィンドウが短い場合、この識別子の提供を推奨します。 | | `Oid / OrderId` | 条件付きで必須\* | 編集不可 | 使用時にはこの識別子の提供が必須です *ActionTrackerId*. | | `ActionTrackerID` | 条件付きで必須\* | 編集不可 | 使用時にはこの識別子の提供が必須です *OrderId/Oid*. | | `SKU`\*\* | 必須 | 編集不可 | 修正したいアイテムのSKU値を指定してください。 | | `金額`\*\* | 条件付きで必須 | 編集可能 | 新しいアイテム金額、つまり価格\*数量を設定します。数量を修正する場合、このフィールドも修正が必要です。 | | `数量`\*\* | 任意 | 編集可能 | 注文内のアイテムの新しい数量を設定します。 | | `カテゴリ`\*\* | 任意 | 編集可能 | アイテムのカテゴリを設定します。 | | `理由`\*\* | 必須 | 編集可能 | 取り消しに有効な理由コードを指定してください。 | \*少なくとも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値を指定してください。 | | `金額`\*\* | 条件付きで必須 | 編集可能 | 新しいアイテム金額、つまり価格\*数量を設定します。数量を修正する場合、このフィールドも修正が必要です。 | | `数量`\*\* | 任意 | 編集可能 | 注文内のアイテムの新しい数量を設定します。 | | `理由`\*\* | 必須 | 編集可能 | 修正に有効な理由コードを指定してください。 | \*少なくとも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.