# 一括修正と逆転処理の参照

アクションデータを一括で修正または取り消す場合は、まず impact.com が提供するテンプレートファイルのいずれかをダウンロードし、サンプルデータを自分のデータに置き換えてください。独自のデータを追加する際は、ファイル提出が正しい形式になるよう、該当する参照表のガイドラインに従ってください。提出ファイルが準備できたら、次に進んでください： [バッチ修正／取り消しを提出する](https://help.impact.com/brand/ja/platform-features/submit-and-modify-conversion-data/submit-batch-modifications-and-reversals#submit-your-data-file-0-1) ファイル。

**以下の参照を参照してください：**

* FTP/SMTP バッチ修正または取り消しで使用するフィールドを確認する
* プレースホルダのサンプルデータが入ったテンプレートファイルをダウンロードする
* 適用すべき理由コードおよび適用時期を理解する

#### 注文レベルの修正

これは、アイテムレベルではなく注文レベルでアクションデータを一括更新したい場合（例：複数の注文の注文合計金額を変更する）に使用します。

<details>

<summary>受け入れられるパラメータ</summary>

| 項目                | 必須？       | 編集可能？ | 注意                                                     |
| ----------------- | --------- | ----- | ------------------------------------------------------ |
| `ActionID`        | 条件付きで必須\* | 編集不可  | デデュプリケーションの窓が短い場合、この識別子の提供を推奨します。                      |
| `Oid / OrderId`   | 条件付きで必須\* | 編集不可  | これらの識別子を使用する場合、提供が必要です： *ActionTrackerId*.             |
| `ActionTrackerID` | 条件付きで必須\* | 編集不可  | これらの識別子を使用する場合、提供が必要です： *OrderId/Oid*.                 |
| `金額`              | 任意        | 編集可能  | 注文の新しい合計金額を設定します。                                      |
| `currencyCode`    | 任意        | 編集可能  | アクションの収益通貨を設定します。指定しない場合は impact.com アカウント通貨が既定値になります。 |
| `CustomerStatus`  | 任意        | 編集可能  | コンバージョン時の顧客ステータスを設定します（例：NEW / EXISTING）。              |
| `理由`              | 必須        | 編集可能  | 修正のための有効な理由コードを指定してください。                               |

\*少なくとも1つの識別子パスを提供する必要があります。つまり、いずれかを提供してください： *ActionId* **または** (\*OrderId/Oid \*+ *ActionTrackerId*)

</details>

<details>

<summary>テンプレートファイル</summary>

* [注文レベルの修正テンプレート](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)

</details>

#### 注文レベルの取り消し

これは、アイテムレベルではなく注文レベルでパートナー主導のアクションを一括で取り消したい場合に使用します（例：複数の注文を取り消す）。

<details>

<summary>受け入れられるパラメータ</summary>

| 項目                | 必須？         | 編集可能？ | 注意                                          |
| ----------------- | ----------- | ----- | ------------------------------------------- |
| `ActionID`        | 条件付きで必須\*   | 編集不可  | デデュプリケーションの窓が短い場合、この識別子の提供を推奨します。           |
| `Oid / OrderId`   | 条件付きで必須\*   | 編集不可  | これらの識別子を使用する場合、提供が必要です： *ActionTrackerId*.  |
| `ActionTrackerID` | 条件付きで必須\*   | 編集不可  | これらの識別子を使用する場合、提供が必要です： *OrderId/Oid*.      |
| `金額`              | 条件付きで必須\*\* | 編集可能  | に設定 **0** 注文を取り消すには、元の金額が 0 でない限りに設定します\*\* |
| `理由`              | 必須          | 編集可能  | 取り消しのための有効な理由コードを指定してください。                  |

\*少なくとも1つの識別子パスを提供する必要があります。つまり、いずれかを提供してください： *ActionId* **または** (*OrderId/Oid* + *ActionTrackerId*)

\*\*元の *Amount = 0*が *金額* のままにしておくと、修正として誤分類されるのを避けられます。

</details>

<details>

<summary>テンプレートファイル</summary>

* [注文レベル取り消しテンプレート](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_reversals_template.csv)

</details>

#### アイテムレベルの修正

これは、注文レベルではなくアイテムレベルでアクションデータを一括更新したい場合に使用します（例：注文内の複数アイテムの金額を変更する）。

<details>

<summary>受け入れられるパラメータ</summary>

| 項目                | 必須？       | 編集可能？ | 注意                                                    |
| ----------------- | --------- | ----- | ----------------------------------------------------- |
| `ActionID`        | 条件付きで必須\* | 編集不可  | デデュプリケーションの窓が短い場合、この識別子の提供を推奨します。                     |
| `Oid / OrderId`   | 条件付きで必須\* | 編集不可  | これらの識別子を使用する場合、提供が必要です： *ActionTrackerId*.            |
| `ActionTrackerID` | 条件付きで必須\* | 編集不可  | これらの識別子を使用する場合、提供が必要です： *OrderId/Oid*.                |
| `SKU`\*\*         | 必須        | 編集不可  | 修正したいアイテムの SKU 値を指定してください。                            |
| `金額`\*\*          | 条件付きで必須   | 編集可能  | 新しいアイテム金額（価格×数量）を設定します。数量を変更する場合、このフィールドも変更する必要があります。 |
| `数量`\*\*          | 任意        | 編集可能  | 注文内のアイテムの新しい数量を設定します。                                 |
| `カテゴリ`\*\*        | 任意        | 編集可能  | アイテムのカテゴリを設定します。                                      |
| `理由`\*\*          | 必須        | 編集可能  | 取り消しのための有効な理由コードを指定してください。                            |

\*少なくとも1つの識別子パスを提供する必要があります。つまり、いずれかを提供してください： *ActionId* **または** (*OrderId/Oid* + *ActionTrackerId*)

\*\*これらのフィールドは修正する各アイテムについて含める必要があります。識別子フィールドは注文ごとに一度のみ含めます。

</details>

<details>

<summary>テンプレートファイル</summary>

* [アイテムレベルの修正テンプレート](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)

</details>

#### アイテムレベルの取り消し

これは、注文レベルではなくアイテムレベルでアクションデータを一括で取り消したい場合に使用します（例：注文内の複数アイテムを取り消す）。

<details>

<summary>受け入れられるパラメータ</summary>

| 項目                | 必須？       | 編集可能？ | 注意                                                    |
| ----------------- | --------- | ----- | ----------------------------------------------------- |
| `ActionID`        | 条件付きで必須\* | 編集不可  | デデュプリケーションの窓が短い場合、この識別子の提供を推奨します。                     |
| `Oid / OrderId`   | 条件付きで必須\* | 編集不可  | これらの識別子を使用する場合、提供が必要です： *ActionTrackerId*.            |
| `ActionTrackerID` | 条件付きで必須\* | 編集不可  | これらの識別子を使用する場合、提供が必要です： *OrderId/Oid*.                |
| `SKU`\*\*         | 必須        | 編集不可  | 修正したいアイテムの SKU 値を指定してください。                            |
| `金額`\*\*          | 条件付きで必須   | 編集可能  | 新しいアイテム金額（価格×数量）を設定します。数量を変更する場合、このフィールドも変更する必要があります。 |
| `数量`\*\*          | 任意        | 編集可能  | 注文内のアイテムの新しい数量を設定します。                                 |
| `理由`\*\*          | 必須        | 編集可能  | 修正のための有効な理由コードを指定してください。                              |

\*少なくとも1つの識別子パスを提供する必要があります。つまり、いずれかを提供してください： *ActionId* **または** (*OrderId/Oid* + *ActionTrackerId*)

\*\*これらのフィールドは修正する各アイテムについて含める必要があります。識別子フィールドは注文ごとに一度のみ含めます。

</details>

<details>

<summary>テンプレートファイル</summary>

* [アイテムレベル取り消しテンプレート](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）を示しているためです。

</details>

{% hint style="info" %}
**注：** 注：重複することが予想される場合、 *Oid / OrderIds* の組み合わせを使用することを選択した場合、 *Oid / OrderId + ActionTrackerId*impact.com は既定であなたの更新を最新の *ActionId* に適用します。更新を古い *ActionId* に適用したい場合は、古い *ActionId*.
{% endhint %}

フィールド説明を含む完全な詳細パラメータ参照については、次を参照してください： [impact.com アクション＆コンバージョンデータ参照](https://integrations.impact.com/impact-brand/docs/impactcom-action-conversion-data-references).

#### 理由コード

アクションデータを修正または取り消すたびに、理由を提供する必要があります。アクションが更新される理由を説明するために、以下の該当する理由コードを使用してください。

{% hint style="warning" %}
**警告:** 受け入れられない値を渡すと、そのエントリは処理されずエラーが返されます。カスタム理由コードが必要な場合は、CSM に連絡するか、 **処分コードについて話し合うためにサポートに連絡してください**.
{% endhint %}

| コード                     | 説明                                                                                                                                                                                  |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| CONS\_FRAUD             | 消費者詐欺                                                                                                                                                                               |
| CONS\_ERROR             | 消費者の誤り                                                                                                                                                                              |
| ITEM\_RETURNED          | アイテムが返品された                                                                                                                                                                          |
| APPROVED                | <p>アクションは承認済み</p><p><strong>注：</strong> アクションを承認しようとしている場合、 <code>承認</code> はとして設定されている必要があります <a href="../../tracking/set-up-tracking/manage-disposition-codes">カスタム処分コード</a>.</p> |
| 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                   | その他の理由                                                                                                                                                                              |
