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.

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.

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

• Vorlage für Genehmigungen auf Auftragsebene

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

Ä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

• Vorlage für Genehmigungen auf Positionsebene

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

SKU O7427540 erscheint in diesem Beispiel zweimal, weil eine Zeile storniert wird (Betrag=0) und eine geändert wird (Betrag=15).

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.

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.

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 um Disposition Codes zu besprechen.

Code	Description
CONS_FRAUD	Consumer fraud
CONS_ERROR	Consumer error
ITEM_RETURNED	Item 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_ERROR	Order error
ORDER_UPDATE	Order was updated
PUB_ACT_DISPUTE	Partner activity dispute
ADV_ACT_DISPUTE	Brand activity dispute
NOT_COMPLIANCE_TERMS	Not in compliance with terms
ITEM_OUT_OF_STOCK	Item is out of stock
TEST_ACTION	Test action
PARTNER_NOT_ACTIVE	Partner account deactivated
CREDITED_DIFFERENT_MP	Credited to another partner
OTHER	Other reason