> 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 stornieren, laden Sie zunächst eine der von impact.com bereitgestellten Vorlagendateien herunter und ersetzen Sie die Beispieldaten durch Ihre eigenen. Wenn Sie Ihre eigenen Daten hinzufügen, beachten Sie die Richtlinien in der entsprechenden Referenztabelle, damit Ihre Dateieinreichung korrekt formatiert ist. Sobald Ihre Einreichungsdatei bereit ist, können Sie mit dem Einreichen Ihrer Datei für Stapeländerungen/-stornierungen fortfahren. {% hint style="info" %} Dieser Referenzartikel enthält die am häufigsten verwendeten Felder für Stapeländerungen und -stornierungen. Eine vollständige, ausführliche Referenz mit Feldbeschreibungen finden Sie unter [Aktions- & Conversion-Feldreferenzen](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references). {% endhint %} **Siehe unten stehende Referenzen zu:** * Erfahren Sie, welche Felder für eine FTP/SMTP-Stapeländerung oder -stornierung verwendet werden sollen * Vorlagendateien mit Platzhalter-Beispieldaten herunterladen * Verstehen, welche Reason Codes anzuwenden sind und wann #### Änderungen auf Auftragsebene Dies ist für den Fall, dass Sie Aktionsdaten in großen Mengen auf Auftragsebene statt auf Positionsebene aktualisieren möchten, z. B. den Auftragsbetrag für mehrere Aufträge ändern.
Akzeptierte Parameter | Feld | Erforderlich? | Bearbeitbar? | Hinweis | | ----------------- | ---------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ActionID` | Bedingt erforderlich\* | Nicht bearbeitbar | Es wird empfohlen, diesen Bezeichner anzugeben, 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*. | | `Betrag` | Optional | Bearbeitbar | Setzen Sie den neuen Gesamtbetrag für den Auftrag. | | `Währungscode` | Optional | Bearbeitbar | Legen Sie die Umsatzwährung der Aktion fest. Standardmäßig wird Ihre impact.com-Kontowährung verwendet, wenn keine angegeben wird. | | `CustomerStatus` | Optional | Bearbeitbar | Legen Sie den Status des Kunden zum Zeitpunkt der Conversion fest, z. B. NEW / EXISTING. | | `Hinweis` | Optional | Bearbeitbar | Allgemeines Feld für Berichtszwecke auf Ereignisebene. Wenn es bei der ursprünglichen Conversion leer ist, wird durch das Übermitteln eines Werts ein Wert eingefügt. Nur einmal pro Aktion zulässig — übermitteln Sie alle anderen Feldänderungen in derselben Anfrage. | | `LocationId` | Optional | Bearbeitbar | Wird hauptsächlich für Unterkünfte verwendet; dies ist der eindeutige Bezeichner für den in dieser Conversion angegebenen Standort. Wenn er bei der ursprünglichen Conversion leer ist, wird durch das Übermitteln eines Werts ein Wert eingefügt. | | `LocationName` | Optional | Bearbeitbar | Wird hauptsächlich für Unterkünfte verwendet; dies ist der Name des in dieser Conversion angegebenen Standorts. Wenn er bei der ursprünglichen Conversion leer ist, wird durch das Übermitteln eines Werts ein Wert eingefügt. | | `GiftPurchase` | Optional | Bearbeitbar | Setzen Sie den Wert auf true, um die Bestellung als Geschenkkauf zu markieren, oder auf false, um die Markierung zu entfernen. Wenn es bei der ursprünglichen Conversion leer ist, wird durch das Übermitteln eines Werts ein Wert eingefügt. | | `Text1–Text50` | Optional | Bearbeitbar | Allgemeine Textfelder, die Zeichenfolgen mit beliebigen Textdaten akzeptieren, die Sie senden möchten (Text1 bis Text50). Wenn es bei der ursprünglichen Conversion leer ist, wird durch das Übermitteln eines Werts ein Wert eingefügt. Nur einmal pro Aktion zulässig — übermitteln Sie alle anderen Feldänderungen in derselben Anfrage. | | `Grund` | Erforderlich | Bearbeitbar | Geben Sie einen gültigen Reason Code für die Änderung an. | \*Mindestens ein Identifikationspfad muss angegeben werden, d. h. entweder *ActionId* **oder** (\*OrderId/Oid \*+ *ActionTrackerId*)
Vorlagendateien * [Vorlage für Änderungen auf Auftragsebene](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_modifications_template.csv) * [Vorlage für Genehmigungen auf Auftragsebene](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_approvals_template.csv)
#### Stornierungen auf Auftragsebene Dies ist für den Fall, dass Sie partnergesteuerte Aktionen in großen Mengen auf Auftragsebene statt auf Positionsebene stornieren möchten, z. B. mehrere Aufträge stornieren.
Akzeptierte Parameter | Feld | Erforderlich? | Bearbeitbar? | Hinweis | | ----------------- | ------------------------ | ----------------- | --------------------------------------------------------------------------------------------- | | `ActionID` | Bedingt erforderlich\* | Nicht bearbeitbar | Es wird empfohlen, diesen Bezeichner anzugeben, 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*. | | `Betrag` | Bedingt erforderlich\*\* | Bearbeitbar | Auf **0** setzen, um den Auftrag zu stornieren, es sei denn, der ursprüngliche Betrag = 0\*\* | | `Grund` | Erforderlich | Bearbeitbar | Geben Sie einen gültigen Reason Code für die Stornierung an. | \*Mindestens ein Identifikationspfad muss angegeben werden, d. h. entweder *ActionId* **oder** (*OrderId/Oid* + *ActionTrackerId*) \*\*Wenn der ursprüngliche *Betrag = 0*, lassen Sie *Betrag* unverändert, um nicht fälschlicherweise als Änderung klassifiziert zu werden.
Vorlagendateien * [Vorlage für Stornierungen auf Auftragsebene](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_reversals_template.csv)
#### Änderungen auf Positionsebene Dies ist für den Fall, dass Sie Aktionsdaten in großen Mengen auf Positionsebene statt auf Auftragsebene aktualisieren möchten, z. B. den Betrag für mehrere Positionen in einem Auftrag ändern.
Akzeptierte Parameter | Feld | Erforderlich? | Bearbeitbar? | Hinweis | | ----------------- | ---------------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------- | | `ActionID` | Bedingt erforderlich\* | Nicht bearbeitbar | Es wird empfohlen, diesen Bezeichner anzugeben, 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 der Position an, die Sie ändern möchten. | | `Betrag`\*\* | Bedingt erforderlich | Bearbeitbar | Setzen Sie den neuen Positionsbetrag, d. h. Preis\*Anzahl. Wenn Sie die Menge ändern, muss auch dieses Feld geändert werden. | | `Menge`\*\* | Optional | Bearbeitbar | Setzen Sie die neue Menge der Positionen im Auftrag. | | `Kategorie`\*\* | Optional | Bearbeitbar | Setzen Sie die Kategorie der Position. | | `Grund`\*\* | Erforderlich | Bearbeitbar | Geben Sie einen gültigen Reason Code für die Stornierung an. | \*Mindestens ein Identifikationspfad muss angegeben werden, d. h. entweder *ActionId* **oder** (*OrderId/Oid* + *ActionTrackerId*) \*\*Diese Felder müssen für jede von Ihnen geänderte Position enthalten sein. Die Bezeichnerfelder werden pro Auftrag nur einmal enthalten.
Vorlagendateien * [Vorlage für Änderungen auf Positionsebene](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_modifications_template.csv) * [Vorlage für Genehmigungen auf Positionsebene](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_approvals_template.csv)
#### Stornierungen auf Positionsebene Dies ist für den Fall, dass Sie Aktionsdaten in großen Mengen auf Positionsebene statt auf Auftragsebene stornieren möchten, z. B. mehrere Positionen in einem Auftrag stornieren.
Akzeptierte Parameter | Feld | Erforderlich? | Bearbeitbar? | Hinweis | | ----------------- | ---------------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------- | | `ActionID` | Bedingt erforderlich\* | Nicht bearbeitbar | Es wird empfohlen, diesen Bezeichner anzugeben, 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 der Position an, die Sie ändern möchten. | | `Betrag`\*\* | Bedingt erforderlich | Bearbeitbar | Setzen Sie den neuen Positionsbetrag, d. h. Preis\*Anzahl. Wenn Sie die Menge ändern, muss auch dieses Feld geändert werden. | | `Menge`\*\* | Optional | Bearbeitbar | Setzen Sie die neue Menge der Positionen im Auftrag. | | `Grund`\*\* | Erforderlich | Bearbeitbar | Geben Sie einen gültigen Reason Code für die Änderung an. | \*Mindestens ein Identifikationspfad muss angegeben werden, d. h. entweder *ActionId* **oder** (*OrderId/Oid* + *ActionTrackerId*) \*\*Diese Felder müssen für jede von Ihnen geänderte Position enthalten sein. Die Bezeichnerfelder werden pro Auftrag nur einmal enthalten.
Vorlagendateien * [Vorlage für Stornierungen auf Positionsebene](https://res.cloudinary.com/product-enablement/raw/upload/v1768298926/CSVs/Batch%20Action%20Processing/Item-level_reversals_template.csv) SKU O7427540 erscheint in diesem Beispiel zweimal, weil eine Zeile storniert wird (Betrag=0) und eine geändert wird (Betrag=15).
{% hint style="info" %} **Hinweis:** Wenn Sie erwarten, doppelte *OrderIds* zu haben und sich dafür entscheiden, die Kombination aus *OrderId + ActionTrackerId*, 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 %} #### Begründungscodes Jedes Mal, wenn Sie Aktionsdaten ändern oder stornieren, müssen Sie einen Grund angeben. Verwenden Sie den entsprechenden Begründungscode unten, um zu erläutern, warum die Aktion aktualisiert wird. {% hint style="warning" %} **Warnung:** Die Übergabe eines nicht akzeptierten Werts führt dazu, dass der Eintrag nicht verarbeitet wird und stattdessen ein Fehler zurückgegeben wird. Wenn Sie benutzerdefinierte Begründungscodes benötigen, wenden Sie sich an Ihren CSM oder [**den Support kontaktieren**](https://app.impact.com/support/portal.ihtml?createTicket=true&) **um Disposition Codes zu besprechen**. {% 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/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=&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.