> 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 Batch-Änderungen und -Rücknahmen Wenn Sie Aktionsdaten in großen Mengen ändern oder rückgängig machen, 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 Ihrer eigenen Daten darauf, die Richtlinien in der entsprechenden Referenztabelle zu befolgen, damit Ihre Dateieinreichung korrekt formatiert ist. Sobald Ihre Einreichungsdatei fertig ist, können Sie mit dem Einreichen Ihrer Datei für Batch-Änderungen/-Rücknahmen fortfahren. {% hint style="info" %} Dieser Referenzartikel enthält die am häufigsten verwendeten Felder für Batch-Änderungen und -Rücknahmen. Eine vollständige, detaillierte Referenz mit Feldbeschreibungen finden Sie unter [Referenzen für Aktions- und Conversion-Felder](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references). {% endhint %} **Siehe die folgenden Referenzen, um:** * zu erfahren, welche Felder für eine FTP/SMTP-Batch-Änderung oder -Rücknahme verwendet werden * Vorlagendateien mit Platzhalter-Beispieldaten herunterladen * zu verstehen, welche Fehlercodes wann anzuwenden sind #### Änderungen auf Bestell-Ebene Dies ist für den Fall, dass Sie Aktionsdaten in großen Mengen auf Bestell-Ebene statt auf Artikel-Ebene aktualisieren möchten, z. B. den Bestellbetrag für mehrere Bestellungen ändern.
Akzeptierte Parameter | Feld | Erforderlich? | Bearbeitbar? | Hinweis | | ----------------- | ---------------------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ActionID` | Bedingt erforderlich\* | Nicht bearbeitbar | Die Angabe dieses Kennzeichners wird empfohlen, wenn das Deduplizierungsfenster kurz ist. | | `Oid / OrderId` | Bedingt erforderlich\* | Nicht bearbeitbar | Die Angabe dieses Kennzeichners ist erforderlich bei der Verwendung von *ActionTrackerId*. | | `ActionTrackerID` | Bedingt erforderlich\* | Nicht bearbeitbar | Die Angabe dieses Kennzeichners ist erforderlich bei der Verwendung von *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. Wird standardmäßig als Währung Ihres impact.com-Kontos verwendet, wenn keine angegeben wird. | | `CustomerStatus` | Optional | Bearbeitbar | Legen Sie den Kundenstatus zum Zeitpunkt der Conversion fest, z. B. NEW / EXISTING. | | `Hinweis` | Optional | Bearbeitbar | Allgemeines Feld für Berichterstattungszwecke auf Ereignisebene. Wenn es bei der ursprünglichen Conversion leer ist, wird durch das Übermitteln eines Werts ein Eintrag hinzugefügt. Nur einmal pro Aktion akzeptiert — senden Sie alle anderen Feldänderungen in derselben Anfrage. | | `LocationId` | Optional | Bearbeitbar | Wird hauptsächlich für Unterkünfte verwendet und ist die eindeutige Kennung für den in dieser Conversion angegebenen Ort. Wenn es bei der ursprünglichen Conversion leer ist, wird durch das Übermitteln eines Werts ein Eintrag hinzugefügt. | | `LocationName` | Optional | Bearbeitbar | Wird hauptsächlich für Unterkünfte verwendet und ist der Name für den in dieser Conversion angegebenen Ort. Wenn es bei der ursprünglichen Conversion leer ist, wird durch das Übermitteln eines Werts ein Eintrag hinzugefügt. | | `GiftPurchase` | Optional | Bearbeitbar | Auf true setzen, um die Bestellung als Geschenk-Kauf 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 Eintrag hinzugefügt. | | `Text1–Text50` | Optional | Bearbeitbar | Allgemeine Textfelder, die Zeichenfolgen mit beliebigen Textdaten akzeptieren, die Sie senden möchten (Text1 bis Text50). Wenn sie bei der ursprünglichen Conversion leer sind, wird durch das Übermitteln eines Werts ein Eintrag hinzugefügt. Nur einmal pro Aktion akzeptiert — senden Sie alle anderen Feldänderungen in derselben Anfrage. | | `Grund` | Erforderlich | Bearbeitbar | Geben Sie einen gültigen Fehlercode für die Änderung an. | \*Es muss mindestens ein Kennzeichnerpfad angegeben werden, d. h. entweder *ActionId* **oder** (\*OrderId/Oid \*+ *ActionTrackerId*)
Vorlagendateien * [Vorlage für Änderungen auf Bestell-Ebene](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_modifications_template.csv) * [Vorlage für Genehmigungen auf Bestell-Ebene](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_approvals_template.csv)
#### Rücknahmen auf Bestell-Ebene Dies ist für den Fall, dass Sie partnergetriebene Aktionen in großen Mengen auf Bestell-Ebene statt auf Artikel-Ebene rückgängig machen möchten, z. B. mehrere Bestellungen rückgängig machen.
Akzeptierte Parameter | Feld | Erforderlich? | Bearbeitbar? | Hinweis | | ----------------- | ------------------------ | ----------------- | ---------------------------------------------------------------------------------------------------- | | `ActionID` | Bedingt erforderlich\* | Nicht bearbeitbar | Die Angabe dieses Kennzeichners wird empfohlen, wenn das Deduplizierungsfenster kurz ist. | | `Oid / OrderId` | Bedingt erforderlich\* | Nicht bearbeitbar | Die Angabe dieses Kennzeichners ist erforderlich bei der Verwendung von *ActionTrackerId*. | | `ActionTrackerID` | Bedingt erforderlich\* | Nicht bearbeitbar | Die Angabe dieses Kennzeichners ist erforderlich bei der Verwendung von *OrderId/Oid*. | | `Amount` | Bedingt erforderlich\*\* | Bearbeitbar | Setzen auf **0** um die Bestellung rückgängig zu machen, sofern der ursprüngliche Betrag = 0 ist\*\* | | `Grund` | Erforderlich | Bearbeitbar | Geben Sie einen gültigen Fehlercode für die Rücknahme an. | \*Es muss mindestens ein Kennzeichnerpfad angegeben werden, d. h. entweder *ActionId* **oder** (*OrderId/Oid* + *ActionTrackerId*) \*\*Wenn ursprünglich *Betrag = 0*, lassen Sie *Amount* unverändert, um eine falsche Einstufung als Änderung zu vermeiden.
Vorlagendateien * [Vorlage für Rücknahmen auf Bestell-Ebene](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_reversals_template.csv)
#### Änderungen auf Artikel-Ebene Dies ist für den Fall, dass Sie Aktionsdaten in großen Mengen auf Artikel-Ebene statt auf Bestell-Ebene aktualisieren möchten, z. B. den Betrag für mehrere Artikel in einer Bestellung ändern.
Akzeptierte Parameter | Feld | Erforderlich? | Bearbeitbar? | Hinweis | | ----------------- | ---------------------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------- | | `ActionID` | Bedingt erforderlich\* | Nicht bearbeitbar | Die Angabe dieses Kennzeichners wird empfohlen, wenn das Deduplizierungsfenster kurz ist. | | `Oid / OrderId` | Bedingt erforderlich\* | Nicht bearbeitbar | Die Angabe dieses Kennzeichners ist erforderlich bei der Verwendung von *ActionTrackerId*. | | `ActionTrackerID` | Bedingt erforderlich\* | Nicht bearbeitbar | Die Angabe dieses Kennzeichners ist erforderlich bei der Verwendung von *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 Menge ändern, muss dieses Feld ebenfalls geändert werden. | | `Menge`\*\* | Optional | Bearbeitbar | Legen Sie die neue Anzahl der Artikel in der Bestellung fest. | | `Kategorie`\*\* | Optional | Bearbeitbar | Legen Sie die Kategorie des Artikels fest. | | `Grund`\*\* | Erforderlich | Bearbeitbar | Geben Sie einen gültigen Fehlercode für die Rücknahme an. | \*Es muss mindestens ein Kennzeichnerpfad angegeben werden, d. h. entweder *ActionId* **oder** (*OrderId/Oid* + *ActionTrackerId*) \*\*Diese Felder müssen für jeden von Ihnen geänderten Artikel enthalten sein. Die Kennzeichnerfelder werden nur einmal pro Bestellung angegeben.
Vorlagendateien * [Vorlage für Änderungen auf Artikel-Ebene](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_modifications_template.csv) * [Vorlage für Genehmigungen auf Artikel-Ebene](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_approvals_template.csv)
#### Rücknahmen auf Artikel-Ebene Dies ist für den Fall, dass Sie Aktionsdaten in großen Mengen auf Artikel-Ebene statt auf Bestell-Ebene rückgängig machen möchten, z. B. mehrere Artikel in einer Bestellung rückgängig machen.
Akzeptierte Parameter | Feld | Erforderlich? | Bearbeitbar? | Hinweis | | ----------------- | ---------------------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------- | | `ActionID` | Bedingt erforderlich\* | Nicht bearbeitbar | Die Angabe dieses Kennzeichners wird empfohlen, wenn das Deduplizierungsfenster kurz ist. | | `Oid / OrderId` | Bedingt erforderlich\* | Nicht bearbeitbar | Die Angabe dieses Kennzeichners ist erforderlich bei der Verwendung von *ActionTrackerId*. | | `ActionTrackerID` | Bedingt erforderlich\* | Nicht bearbeitbar | Die Angabe dieses Kennzeichners ist erforderlich bei der Verwendung von *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 Menge ändern, muss dieses Feld ebenfalls geändert werden. | | `Menge`\*\* | Optional | Bearbeitbar | Legen Sie die neue Anzahl der Artikel in der Bestellung fest. | | `Grund`\*\* | Erforderlich | Bearbeitbar | Geben Sie einen gültigen Fehlercode für die Änderung an. | \*Es muss mindestens ein Kennzeichnerpfad angegeben werden, d. h. entweder *ActionId* **oder** (*OrderId/Oid* + *ActionTrackerId*) \*\*Diese Felder müssen für jeden von Ihnen geänderten Artikel enthalten sein. Die Kennzeichnerfelder werden nur einmal pro Bestellung angegeben.
Vorlagendateien * [Vorlage für Rücknahmen auf Artikel-Ebene](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 eine Rücknahme (Betrag=0) und eine eine Änderung (Betrag=15) ist.
{% 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 %} #### Fehlercodes Jedes Mal, wenn Sie Aktionsdaten ändern oder rückgängig machen, müssen Sie einen Grund angeben. Verwenden Sie den untenstehenden relevanten Fehlercode, um zu erläutern, warum die Aktion aktualisiert wird. {% hint style="warning" %} **Warnung:** Wenn ein nicht akzeptierter Wert übergeben wird, wird der Eintrag nicht verarbeitet und stattdessen ein Fehler zurückgegeben. Wenn Sie benutzerdefinierte Fehlercodes benötigen, wenden Sie sich an Ihren CSM oder [**den Support kontaktieren**](https://app.impact.com/support/portal.ihtml?createTicket=true&) **um Dispositionscodes zu besprechen**. {% endhint %}
CodeBeschreibung
CONS_FRAUDVerbraucherbetrug
CONS_ERRORVerbraucherfehler
ITEM_RETURNEDArtikel wurde zurückgegeben
APPROVED

Aktion ist genehmigt

Hinweis: Wenn Sie Aktionen genehmigen möchten, Genehmigen muss als ein benutzerdefinierter Dispositionscode.

ORDER_ERRORBestellfehler
ORDER_UPDATEBestellung wurde aktualisiert
PUB_ACT_DISPUTEStreitfall zur Partneraktivität
ADV_ACT_DISPUTEStreitfall zur Markenaktivität
NOT_COMPLIANCE_TERMSNicht konform mit den Bedingungen
ITEM_OUT_OF_STOCKArtikel ist nicht auf Lager
TEST_ACTIONTestaktion
PARTNER_NOT_ACTIVEPartnerkonto deaktiviert
CREDITED_DIFFERENT_MPEinem anderen Partner gutgeschrieben
ANDEREAnderer Grund
--- # 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/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 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.