# Einträge in einer Aktion über API ändern oder rückgängig machen

Zusätzlich zum Ändern und Rückgängigmachen von Aktionen ermöglicht impact.com Ihnen, die positionsbezogenen Angaben einer Aktion zu ändern und rückgängig zu machen.

{% hint style="info" %}
**Hinweis:** impact.com erlaubt maximal 1000 Änderungen pro Aktion. Wenn Sie danach weitere Änderungen vornehmen müssen, [kontaktieren Sie den Support](https://app.impact.com/support/portal.ihtml).
{% endhint %}

#### Positionen in einer Aktion über die API ändern

Wenn Sie auf Positionsebene verfolgen (d. h. Positionsdaten beim Melden von Conversions übergeben), können Sie die API verwenden, um die Menge oder den gemeldeten Umsatzbetrag von Positionen innerhalb einer Aktion zu ändern.

Um Positionen in einer Aktion zu ändern, benötigen Sie:

* Die `ActionId` der Aktion.
* Die `Grund` für die Aktualisierung der Aktion (bei der Änderung von Positionen in einer Aktion immer `ORDER_UPDATE`).
* Die `Sku` der zu ändernden Position(en) (kann beim Abrufen einer Aktion über die API gefunden werden).
* Die neue `Quantity` Wert für die Position.
* Der neue Umsatz `Amount` Wert für die Position – schließen Sie diesen nur im Aufruf ein, wenn sich dieser Wert ändert (z. B. wenn der gemeldete Umsatzbetrag der Position falsch gemeldet wurde).

Sobald Sie all diese Werte haben, sehen Sie sich die Beispielaufrufe unten an, um zu erfahren, wie Sie eine Position innerhalb einer Aktion ändern.

<details>

<summary>Beispielaufrufe &#x26; Antwort</summary>

**Neue Positionsmenge**

```bash
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 'Sku={Sku}' \
  -d 'Quantity={Quantity}' \
  -d 'Reason=ORDER_UPDATE' \
```

**Neuer Positionsumsatzbetrag**

```bash
  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 'Sku={Sku}' \
    -d 'Amount={Amount}' \
    -d 'Reason=ORDER_UPDATE' \
```

</details>

<details>

<summary>Beispielantwort</summary>

```json
{
  "Status": "QUEUED",
  "QueuedUri": "/Advertisers/{AccountSID}/APISubmissions/A-86b9-56992f50eefe"
}
```

</details>

<details>

<summary>Parameterreferenz</summary>

| `AccountId` | Der API-Konto-ID-Wert Ihres impact.com-Kontos. [Erfahren Sie, wie Sie diesen Wert finden](https://help.impact.com/brand/de/was-mochten-sie-lernen/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/was-mochten-sie-lernen/account-administration/account-settings/api-tokens/manage-api-access-tokens-as-a-brand). |
| `ActionId`  | Der ID-Wert der zu ändernden Aktion.                                                                                                                                                                                                                  |
| `Sku`       | Der Stock-Keeping-Unit-Wert (SKU) der Position – diesen finden Sie beim Abrufen einer Aktion über die API.                                                                                                                                            |
| `Quantity`  | Der neue Mengenwert für die Position.                                                                                                                                                                                                                 |
| `Grund`     | Beim Rückgängigmachen oder Ändern einer Position geben Sie immer `ORDER_UPDATE` als Grund an.                                                                                                                                                         |
| `Amount`    | Der neue Umsatzbetragwert für die Position.                                                                                                                                                                                                           |

</details>

#### Positionen in einer Aktion über die API rückgängig machen

Wenn Sie auf Positionsebene verfolgen (d. h. Positionsdaten beim Melden von Conversions übergeben), können Sie die API verwenden, um eine oder mehrere Positionen rückgängig zu machen, indem Sie `Quantity` auf `0`.

Um Positionen in einer Aktion rückgängig zu machen, benötigen Sie:

* Die `ActionId` der Aktion.
* Die `Grund` für die Aktualisierung der Aktion (bei Rückgängigmachung von Positionen in einer Aktion immer `ORDER_UPDATE`).
* Die `Sku` der zu rückgängig machenden Position(en) (kann beim Abrufen einer Aktion über die API gefunden werden).
* Die neue `Quantity` Wert für die Position – in diesem Fall `0`

Sobald Sie all diese Werte haben, sehen Sie sich den Beispielaufruf unten an, um zu erfahren, wie Sie Positionen in einer Aktion rückgängig machen.

<details>

<summary>Beispielaufruf &#x26; Antwort</summary>

```bash
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 'Sku={Sku}' \
  -d 'Quantity=0' \
  -d 'Reason=ORDER_UPDATE'
```

</details>

<details>

<summary>Beispielantwort</summary>

```json
{
  "Status": "QUEUED",
  "QueuedUri": "/Advertisers/{AccountSID}/APISubmissions/A-86b9-56992f50eefe"
}  
```

</details>

<details>

<summary>Parameterreferenz</summary>

| `AccountId` | Der API-Konto-ID-Wert Ihres impact.com-Kontos. [Erfahren Sie, wie Sie diesen Wert finden](https://help.impact.com/brand/de/was-mochten-sie-lernen/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/was-mochten-sie-lernen/account-administration/account-settings/api-tokens/manage-api-access-tokens-as-a-brand). |
| `ActionId`  | Der ID-Wert der zu ändernden Aktion.                                                                                                                                                                                                                  |
| `Sku`       | Der Stock-Keeping-Unit-Wert (SKU) der Position – diesen finden Sie beim Abrufen einer Aktion über die API.                                                                                                                                            |
| `Quantity`  | Der neue Mengenwert für die Position.                                                                                                                                                                                                                 |
| `Grund`     | Beim Rückgängigmachen oder Ändern einer Position geben Sie immer `ORDER_UPDATE` als Grund an.                                                                                                                                                         |

</details>
