> 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/de/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md).

# Referenz für stapelweise Änderungen und Stornierungen

Wenn Sie Aktionsdaten in großen Mengen ändern oder rückgängig machen möchten, laden Sie zunächst eine der von impact.com bereitgestellten Vorlagendateien herunter und ersetzen Sie die Beispieldaten durch Ihre eigenen. Achten Sie beim Hinzufügen eigener Daten darauf, die Richtlinien in der entsprechenden Referenztabelle einzuhalten, damit Ihre Datei korrekt formatiert ist. Sobald Ihre Einreichungsdatei fertig ist, können Sie mit dem Einreichen Ihrer Datei für Stapeländerungen bzw. -rücknahmen fortfahren.

{% hint style="info" %}
Dieser Referenzartikel enthält die am häufigsten verwendeten Felder für Stapeländerungen und -rücknahmen. Eine vollständige, detaillierte Referenz mit Feldbeschreibungen finden Sie unter [Referenzen zu Aktions- und Conversion-Feldern](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references).
{% endhint %}

**In den folgenden Referenzen erfahren Sie:**

* Welche Felder Sie für eine FTP-/SMTP-Stapeländerung oder -rücknahme verwenden sollten
* Vorlagendateien mit Platzhalter-Beispieldaten herunterladen
* Welche Ursachencodes wann anzuwenden sind

#### Änderungen auf Bestellebene

Diese Option ist geeignet, wenn Sie Aktionsdaten für mehrere Bestellungen auf Bestellebene statt auf Artikelebene ändern möchten, z. B. den Bestellbetrag für mehrere Bestellungen.

<details>

<summary>Akzeptierte Parameter</summary>

| Feld              | Erforderlich?          | Bearbeitbar?      | Hinweis                                                                                                                                                                                                                                                                                                                                                  |
| ----------------- | ---------------------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ActionID`        | Bedingt erforderlich\* | Nicht bearbeitbar | Die Angabe dieses Bezeichners wird empfohlen, wenn das Deduplizierungsfenster kurz ist.                                                                                                                                                                                                                                                                  |
| `Oid / OrderId`   | Bedingt erforderlich\* | Nicht bearbeitbar | Die Angabe dieses Bezeichners ist erforderlich, wenn Sie *ActionTrackerId*.                                                                                                                                                                                                                                                                              |
| `ActionTrackerID` | Bedingt erforderlich\* | Nicht bearbeitbar | Die Angabe dieses Bezeichners ist erforderlich, wenn Sie *OrderId/Oid*.                                                                                                                                                                                                                                                                                  |
| `Amount`          | Optional               | Bearbeitbar       | Legen Sie den neuen Gesamtbetrag für die Bestellung fest.                                                                                                                                                                                                                                                                                                |
| `currencyCode`    | Optional               | Bearbeitbar       | Legen Sie die Umsatzwährung der Aktion fest. Wenn keine Währung angegeben wird, gilt standardmäßig die Währung Ihres impact.com-Kontos.                                                                                                                                                                                                                  |
| `CustomerStatus`  | Optional               | Bearbeitbar       | Legen Sie den Kundenstatus zum Zeitpunkt der Conversion fest, z. B. NEW / EXISTING.                                                                                                                                                                                                                                                                      |
| `Note`            | Optional               | Bearbeitbar       | Allgemeines Feld für die Berichterstattung auf Ereignisebene. Wenn das Feld bei der ursprünglichen Conversion leer ist, wird durch die Übermittlung eines Werts dieser eingetragen. Pro Aktion nur einmal zulässig — übermitteln Sie alle weiteren Feldänderungen in derselben Anfrage.                                                                  |
| `LocationId`      | Optional               | Bearbeitbar       | Dieser eindeutige Bezeichner für den in dieser Conversion angegebenen Standort wird hauptsächlich für Unterkünfte verwendet. Wenn das Feld bei der ursprünglichen Conversion leer ist, wird durch die Übermittlung eines Werts dieser eingetragen.                                                                                                       |
| `LocationName`    | Optional               | Bearbeitbar       | Dieser Name des in dieser Conversion angegebenen Standorts wird hauptsächlich für Unterkünfte verwendet. Wenn das Feld bei der ursprünglichen Conversion leer ist, wird durch die Übermittlung eines Werts dieser eingetragen.                                                                                                                           |
| `GiftPurchase`    | Optional               | Bearbeitbar       | Legen Sie den Wert auf true fest, um die Bestellung als Geschenk zu kennzeichnen, oder auf false, um die Kennzeichnung aufzuheben. Wenn das Feld bei der ursprünglichen Conversion leer ist, wird durch die Übermittlung eines Werts dieser eingetragen.                                                                                                 |
| `Text1–Text50`    | Optional               | Bearbeitbar       | Allgemeine Textfelder, die Zeichenfolgen mit beliebigen Textdaten akzeptieren, die Sie übermitteln möchten (Text1 bis Text50). Wenn das Feld bei der ursprünglichen Conversion leer ist, wird durch die Übermittlung eines Werts dieser eingetragen. Pro Aktion nur einmal zulässig — übermitteln Sie alle weiteren Feldänderungen in derselben Anfrage. |
| `Reason`          | Erforderlich           | Bearbeitbar       | Geben Sie einen gültigen Ursachencode für die Änderung an.                                                                                                                                                                                                                                                                                               |

\*Es muss mindestens ein Bezeichnerpfad angegeben werden, d. h. entweder *ActionId* **oder** (\*OrderId/Oid \*+ *ActionTrackerId*)

</details>

<details>

<summary>Vorlagendateien</summary>

* [Vorlage für Änderungen auf Bestellebene](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_modifications_template.csv)
* [Vorlage für Genehmigungen auf Bestellebene](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_approvals_template.csv)

</details>

#### Rücknahmen auf Bestellebene

Dies ist für Fälle gedacht, in denen Sie partnergesteuerte Aktionen gesammelt auf Auftragsebene statt auf Artikelebene rückgängig machen möchten, z. B. mehrere Aufträge rückgängig machen.

<details>

<summary>Akzeptierte Parameter</summary>

| Feld              | Erforderlich?            | Bearbeitbar?      | Hinweis                                                                                                   |
| ----------------- | ------------------------ | ----------------- | --------------------------------------------------------------------------------------------------------- |
| `ActionID`        | Bedingt erforderlich\*   | Nicht bearbeitbar | Die Angabe dieses Bezeichners wird empfohlen, wenn das Deduplizierungsfenster kurz ist.                   |
| `Oid / OrderId`   | Bedingt erforderlich\*   | Nicht bearbeitbar | Die Angabe dieses Bezeichners ist erforderlich, wenn Sie *ActionTrackerId*.                               |
| `ActionTrackerID` | Bedingt erforderlich\*   | Nicht bearbeitbar | Die Angabe dieses Bezeichners ist erforderlich, wenn Sie *OrderId/Oid*.                                   |
| `Amount`          | Bedingt erforderlich\*\* | Bearbeitbar       | Setzen Sie auf **0** , um den Auftrag rückgängig zu machen, es sei denn, der ursprüngliche Betrag = 0\*\* |
| `Reason`          | Erforderlich             | Bearbeitbar       | Geben Sie einen gültigen Grundcode für die Rückabwicklung an.                                             |

\*Mindestens ein Identifikatorpfad muss angegeben werden, d. h. entweder *ActionId* **oder** (*OrderId/Oid* + *ActionTrackerId*)

\*\*Wenn der ursprüngliche *Betrag = 0*, lassen Sie *Betrag* unverändert, um eine falsche Einstufung als Änderung zu vermeiden.

</details>

<details>

<summary>Vorlagendateien</summary>

* [Vorlage für Rückabwicklungen auf Auftragsebene](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_reversals_template.csv)

</details>

#### Änderungen auf Artikelebene

Dies ist für Fälle gedacht, in denen Sie Aktionsdaten gesammelt auf Artikelebene statt auf Auftragsebene aktualisieren möchten, z. B. den Betrag für mehrere Artikel eines Auftrags ändern.

<details>

<summary>Akzeptierte Parameter</summary>

| Feld              | Erforderlich?          | Bearbeitbar?      | Hinweis                                                                                                                          |
| ----------------- | ---------------------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `ActionID`        | Bedingt erforderlich\* | Nicht bearbeitbar | Die Angabe dieses Bezeichners wird empfohlen, wenn das Deduplizierungsfenster kurz ist.                                          |
| `Oid / OrderId`   | Bedingt erforderlich\* | Nicht bearbeitbar | Die Angabe dieses Bezeichners ist erforderlich, wenn Sie *ActionTrackerId*.                                                      |
| `ActionTrackerID` | Bedingt erforderlich\* | Nicht bearbeitbar | Die Angabe dieses Bezeichners ist erforderlich, wenn Sie *OrderId/Oid*.                                                          |
| `SKU`\*\*         | Erforderlich           | Nicht bearbeitbar | Geben Sie den SKU-Wert des Artikels an, den Sie ändern möchten.                                                                  |
| `Amount`\*\*      | Bedingt erforderlich   | Bearbeitbar       | Legen Sie den neuen Artikelbetrag fest, d. h. Preis\*Anzahl. Wenn Sie die Anzahl ändern, muss auch dieses Feld angepasst werden. |
| `Quantity`\*\*    | Optional               | Bearbeitbar       | Legen Sie die neue Anzahl der Artikel im Auftrag fest.                                                                           |
| `Category`\*\*    | Optional               | Bearbeitbar       | Legen Sie die Kategorie des Artikels fest.                                                                                       |
| `Reason`\*\*      | Erforderlich           | Bearbeitbar       | Geben Sie einen gültigen Grundcode für die Rückabwicklung an.                                                                    |

\*Mindestens ein Identifikatorpfad muss angegeben werden, d. h. entweder *ActionId* **oder** (*OrderId/Oid* + *ActionTrackerId*)

\*\*Diese Felder müssen für jeden geänderten Artikel angegeben werden. Die Identifikatorfelder werden nur einmal pro Auftrag angegeben.

</details>

<details>

<summary>Vorlagendateien</summary>

* [Vorlage für Änderungen auf Artikelebene](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_modifications_template.csv)
* [Vorlage für Genehmigungen auf Artikelebene](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_approvals_template.csv)

</details>

#### Rückabwicklungen auf Artikelebene

Dies ist für Fälle gedacht, in denen Sie Aktionsdaten gesammelt auf Artikelebene statt auf Auftragsebene rückgängig machen möchten, z. B. mehrere Artikel eines Auftrags rückgängig machen.

<details>

<summary>Akzeptierte Parameter</summary>

| Feld              | Erforderlich?          | Bearbeitbar?      | Hinweis                                                                                                                          |
| ----------------- | ---------------------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `ActionID`        | Bedingt erforderlich\* | Nicht bearbeitbar | Die Angabe dieses Bezeichners wird empfohlen, wenn das Deduplizierungsfenster kurz ist.                                          |
| `Oid / OrderId`   | Bedingt erforderlich\* | Nicht bearbeitbar | Die Angabe dieses Bezeichners ist erforderlich, wenn Sie *ActionTrackerId*.                                                      |
| `ActionTrackerID` | Bedingt erforderlich\* | Nicht bearbeitbar | Die Angabe dieses Bezeichners ist erforderlich, wenn Sie *OrderId/Oid*.                                                          |
| `SKU`\*\*         | Erforderlich           | Nicht bearbeitbar | Geben Sie den SKU-Wert des Artikels an, den Sie ändern möchten.                                                                  |
| `Amount`\*\*      | Bedingt erforderlich   | Bearbeitbar       | Legen Sie den neuen Artikelbetrag fest, d. h. Preis\*Anzahl. Wenn Sie die Anzahl ändern, muss auch dieses Feld angepasst werden. |
| `Quantity`\*\*    | Optional               | Bearbeitbar       | Legen Sie die neue Anzahl der Artikel im Auftrag fest.                                                                           |
| `Reason`\*\*      | Erforderlich           | Bearbeitbar       | Geben Sie einen gültigen Ursachencode für die Änderung an.                                                                       |

\*Mindestens ein Identifikatorpfad muss angegeben werden, d. h. entweder *ActionId* **oder** (*OrderId/Oid* + *ActionTrackerId*)

\*\*Diese Felder müssen für jeden geänderten Artikel angegeben werden. Die Identifikatorfelder werden nur einmal pro Auftrag angegeben.

</details>

<details>

<summary>Vorlagendateien</summary>

* [Vorlage für Rückabwicklungen auf Artikelebene](https://res.cloudinary.com/product-enablement/raw/upload/v1768298926/CSVs/Batch%20Action%20Processing/Item-level_reversals_template.csv)

Die SKU O7427540 ist in diesem Beispiel zweimal aufgeführt, da eine Zeile eine Rückabwicklung (Amount=0) und die andere eine Änderung (Amount=15) darstellt.

</details>

{% hint style="info" %}
**Hinweis:** Wenn Sie mit doppelten *OrderIds* rechnen und die Kombination aus *OrderId + ActionTrackerId*verwenden, wendet impact.com Ihre Aktualisierung standardmäßig auf die neueste *ActionId* an. Verwenden Sie die alte *ActionId* , wenn Sie die Aktualisierung auf die ältere *ActionId*.
{% endhint %}

#### Grundcodes

Bei jeder Änderung oder Rückabwicklung von Aktionsdaten müssen Sie einen Grund angeben. Verwenden Sie den passenden Grundcode unten, um zu erläutern, warum die Aktion aktualisiert wird.

{% hint style="warning" %}
**Warnung:** Bei Angabe eines nicht akzeptierten Werts wird der Eintrag nicht verarbeitet und stattdessen ein Fehler zurückgegeben. Wenn Sie benutzerdefinierte Grundcodes benötigen, wenden Sie sich an Ihren CSM oder [**kontaktieren Sie den Support**](https://app.impact.com/support/portal.ihtml?createTicket=true&) **, um Disposition Codes zu besprechen**.
{% endhint %}

<table><thead><tr><th width="239.2734375">Code</th><th>Description</th></tr></thead><tbody><tr><td><code>CONS_FRAUD</code></td><td>Consumer fraud</td></tr><tr><td><code>CONS_ERROR</code></td><td>Consumer error</td></tr><tr><td><code>ITEM_RETURNED</code></td><td>Item was returned</td></tr><tr><td><code>APPROVED</code></td><td><p>Action is approved</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Note:</strong> If you’re trying to approve actions, <code>Approve</code> needs to be set up as a <a href="https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/manage-disposition-codes.md">custom disposition code</a>.</p></div></td></tr><tr><td><code>ORDER_ERROR</code></td><td>Order error</td></tr><tr><td><code>ORDER_UPDATE</code></td><td>Order was updated</td></tr><tr><td><code>PUB_ACT_DISPUTE</code></td><td>Partner activity dispute</td></tr><tr><td><code>ADV_ACT_DISPUTE</code></td><td>Brand activity dispute</td></tr><tr><td><code>NOT_COMPLIANCE_TERMS</code></td><td>Not in compliance with terms</td></tr><tr><td><code>ITEM_OUT_OF_STOCK</code></td><td>Item is out of stock</td></tr><tr><td><code>TEST_ACTION</code></td><td>Test action</td></tr><tr><td><code>PARTNER_NOT_ACTIVE</code></td><td>Partner account deactivated</td></tr><tr><td><code>CREDITED_DIFFERENT_MP</code></td><td>Credited to another partner</td></tr><tr><td><code>OTHER</code></td><td>Other reason</td></tr></tbody></table>


---

# 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/de/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=<question>&goal=<user_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.
