# Übersicht: Stapelverarbeitung von Rückbuchungen via API (Web Services)

<a href="https://pxa.impact.com/student/activity/2268418?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=&#x26;utm_campaign=help-center" class="button primary">Nehmen Sie am PXA-Kurs teil</a>

Wenn sich an einer Aktion etwas ändert (z. B. eine Bestellung storniert wurde, ein Artikel zurückgegeben wurde usw.), können Sie die API verwenden, um sie zu ändern (oder rückgängig zu machen) und den Provisionsbetrag für die Aktion anzupassen. In diesem Artikel zeigen wir, wie man eine Aktion mit cURL-Aufrufen an die impact.com Brand API ändert und rückgängig macht.

**Optionen zur Stapelverarbeitung von Rückgängen:**

* Ein oder mehrere Artikel einer Aktion per API ändern oder rückgängig machen
* Eine gesamte Aktion per API rückgängig machen

#### Voraussetzung: Rufen Sie den *ActionId* Wert

Um eine Aktion rückgängig zu machen, benötigen Sie deren `ActionId` Wert. Der untenstehende Aufruf ruft alle Aktionen für eine bestimmte *Program* (d. h., *Kampagne*) ab — Sie können dies verwenden, um die Aktion zu finden, die Sie ändern möchten.

* Sie können in Ihrem Aufruf einen Datumsbereich angeben — andernfalls zeigt der Endpunkt standardmäßig die letzten 30 Tage an Aktionen an.
* [Rate-Limits](https://integrations.impact.com/impact-brand/reference/rate-limits) gelten.
* Siehe die [Alle Aktionen auflisten](https://integrations.impact.com/impact-brand/reference/list-all-actions) API-Endpunktdokumentation, um mehr zu erfahren.

<details>

<summary>Parameterreferenz</summary>

| Parameter    | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                   |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `AccountId`  | Der API-Konto-ID-Wert Ihres impact.com-Kontos. [Erfahren Sie, wie Sie diesen Wert finden](https://help.impact.com/brand/de/account-administration/account-settings/api-tokens/manage-api-access-tokens-as-a-brand).                                                                                                                                                                            |
| `AuthToken`  | Der API-Autorisierungstoken-Wert Ihres impact.com-Kontos. [Erfahren Sie, wie Sie diesen Wert finden](https://help.impact.com/brand/de/account-administration/account-settings/api-tokens/manage-api-access-tokens-as-a-brand).                                                                                                                                                                 |
| `CampaignId` | <p>Der ID-Wert des Programms (Kampagne), unter dem die Aktion nachverfolgt wurde.</p><p><img src="https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-31394f285a15896ee35415220c2ee33641e1e8db%2F6cdb04166abb32ded5995d58f18ef3e6462d01cddcf81cd387abb3cac22e3389.png?alt=media" alt="" data-size="original"></p> |

</details>

{% tabs %}
{% tab title="Beispielaufruf" %}

```programlisting
curl 'https://api.impact.com/Advertisers/{AccountSID}/Actions' \
  -X GET \
  -u '{AccountSID}:{AuthToken}' \
  -H 'Accept: application/json' \
  -d 'CampaignId={CampaignId}'
```

{% endtab %}

{% tab title="Beispielantwort" %}

```programlisting
{
  "@page": "1",
  ...,
  "Actions": [
    {
      "Id": "1000.4636.158133",
      ...,
    }
  ]
}
```

{% endtab %}
{% endtabs %}

#### FAQs

<details>

<summary>Wie setze ich eine Änderung / einen Rückgang, der an einer Aktion (oder Aktionsartikeln) vorgenommen wurde, zurück?</summary>

Wenn eine Aktion vor ihrem Sperrdatum geändert oder rückgängig gemacht wurde, können Sie `RESET` als Grund übermitteln, um die Aktion wieder in ihren Standardzustand zu versetzen:

```programlisting
curl 'https://api.impact.com/Advertisers/{AccountSID}/Actions' \
  -X PUT \
  -u '{AccountSID}:{AuthToken}' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'ActionId={ActionId}' \
  -d 'Reason=RESET'
```

Aktionen, die über den `RESET` Code zurückgesetzt wurden, werden in den Berichten möglicherweise nicht korrekt angezeigt (z. B. können Umsatzwerte falsch berechnet werden).

</details>

<details>

<summary>Was ist der Unterschied zwischen einem Disposition-Code und einem Grund?</summary>

Sowohl Disposition-Codes als auch Gründe werden im gleichen Kontext verwendet — *Gründe* sind vordefinierte Codes, die die API standardmäßig akzeptiert, während *Disposition-Codes* benutzerdefinierte Gründe sind, die Sie konfigurieren können. [Erfahren Sie mehr über Disposition-Codes](https://help.impact.com/brand/de/platform-features/tracking/set-up-tracking/manage-disposition-codes).

Das Übermitteln eines dieser Werte als Grund wird den Artikel (oder die Aktion) rückgängig machen:

| Code                    | Beschreibung                                |
| ----------------------- | ------------------------------------------- |
| `CONS_FRAUD`            | Betrug durch Verbraucher                    |
| `CONS_ERROR`            | Fehler des Verbrauchers                     |
| `ITEM_RETURNED`         | Artikel zurückgegeben                       |
| `ORDER_ERROR`           | Bestellfehler                               |
| `ORDER_UPDATE`          | Bestellung wurde aktualisiert               |
| `PUB_ACT_DISPUTE`       | Partneraktivitätsstreit                     |
| `ADV_ACT_DISPUTE`       | Streitigkeit über Werbetreibenden-Aktivität |
| `NOT_COMPLIANCE_TERMS`  | Nicht konform mit den Bedingungen           |
| `ITEM_OUT_OF_STOCK`     | Artikel ist nicht vorrätig                  |
| `TEST_ACTION`           | Testaktion                                  |
| `PARTNER_NOT_ACTIVE`    | Partnerkonto deaktiviert                    |
| `CREDITED_DIFFERENT_MP` | Gutschrift an einen anderen Partner         |
| `OTHER`                 | Anderer Grund                               |
| `ITEM_CANCELLED`        | Artikel in Bestellung wurde storniert       |

</details>

<details>

<summary>Wie kann ich sehen, wann Änderungen / Rückgänge auf eine Aktion angewendet wurden?</summary>

Sie können die [Action-Updates](https://integrations.impact.com/impact-brand/reference/the-action-update-object) Endpunkt, um zu sehen, wann eine Aktion zuletzt aktualisiert wurde und welchen aktuellen Status sie hat.

```programlisting
curl 'https://api.impact.com/Advertisers/{AccountSID}/ActionUpdates/{ActionUpdatesId}' \
  -X GET \
  -u '{AccountSID}:{AuthToken}' \
  -H 'Accept: application/json' \
```

{% hint style="info" %}
**Hinweis:** Eine `ActionUpdatesID` Wert unterscheidet sich von einem `ActionId` Wert — Sie müssen den `ActionUpdatesID` Wert verwenden, um Updates für eine Aktion abzurufen.
{% endhint %}

</details>
