# Modifier ou annuler des éléments d'une action via l'API

En plus de modifier et d'annuler des actions, impact.com vous permet de modifier et d'annuler les détails au niveau des articles d'une action.

{% hint style="info" %}
**Remarque :** impact.com autorise un maximum de 1000 modifications par action. Si vous devez effectuer d'autres modifications par la suite, [contacter le support](https://app.impact.com/support/portal.ihtml).
{% endhint %}

#### Modifier les articles d'une action via l'API

Si vous suivez au niveau des articles (c.-à-d. en transmettant les données des articles lors du signalement des conversions), vous pouvez utiliser l'API pour modifier la quantité ou le montant de revenu déclaré des articles au sein d'une action.

Pour modifier les articles d'une action, vous aurez besoin de :

* Le `ActionId` de l'action.
* Le `Raison` de la mise à jour de l'action (lors de la modification des articles d'une action, soumettez toujours `ORDER_UPDATE`).
* Le `Sku` des articles à modifier (peut être trouvé lors de la récupération d'une action via l'API).
* La nouvelle `Quantity` valeur pour l'article.
* Le nouveau `Amount` valeur de revenu pour l'article — inclure ceci dans l'appel uniquement si cette valeur change (par ex., le montant de revenu d'article déclaré a été signalé de manière incorrecte).

Une fois que vous avez toutes ces valeurs, consultez les exemples d'appels ci-dessous pour apprendre comment modifier un article au sein d'une action.

<details>

<summary>Exemples d'appels et réponse</summary>

**Nouvelle quantité d'article**

```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' \
```

**Nouveau montant de revenu par article**

```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>Exemple de réponse</summary>

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

</details>

<details>

<summary>Référence des paramètres</summary>

| `AccountId` | La valeur de l'ID de compte API de votre compte impact.com. [Apprenez comment trouver cette valeur](https://help.impact.com/brand/fr/quaimeriez-vous-apprendre/account-administration/account-settings/api-tokens/manage-api-access-tokens-as-a-brand).       |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `AuthToken` | La valeur du jeton d'autorisation API de votre compte impact.com. [Apprenez comment trouver cette valeur](https://help.impact.com/brand/fr/quaimeriez-vous-apprendre/account-administration/account-settings/api-tokens/manage-api-access-tokens-as-a-brand). |
| `ActionId`  | La valeur ID de l'action à modifier.                                                                                                                                                                                                                          |
| `Sku`       | La valeur du stock-keeping unit (SKU) de l'article — elle peut être trouvée lors de la récupération d'une action via l'API.                                                                                                                                   |
| `Quantity`  | La nouvelle valeur de quantité pour l'article.                                                                                                                                                                                                                |
| `Raison`    | Lors de l'annulation ou de la modification d'un article, soumettez toujours `ORDER_UPDATE` comme raison.                                                                                                                                                      |
| `Amount`    | La nouvelle valeur du montant de revenu pour l'article.                                                                                                                                                                                                       |

</details>

#### Annuler des articles d'une action via l'API

Si vous suivez au niveau des articles (c.-à-d. en transmettant les données des articles lors du signalement des conversions), vous pouvez utiliser l'API pour annuler un ou plusieurs articles en définissant `Quantity` à `0`.

Pour annuler des articles d'une action, vous aurez besoin de :

* Le `ActionId` de l'action.
* Le `Raison` pour la mise à jour de l'action (lors de l'annulation d'articles d'une action, soumettez toujours `ORDER_UPDATE`).
* Le `Sku` des articles à annuler (peut être trouvé lors de la récupération d'une action via l'API).
* La nouvelle `Quantity` valeur pour l'article — dans ce cas, `0`

Une fois que vous avez toutes ces valeurs, consultez l'exemple d'appel ci-dessous pour apprendre comment annuler des articles d'une action.

<details>

<summary>Exemple d'appel et réponse</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>Exemple de réponse</summary>

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

</details>

<details>

<summary>Référence des paramètres</summary>

| `AccountId` | La valeur de l'ID de compte API de votre compte impact.com. [Apprenez comment trouver cette valeur](https://help.impact.com/brand/fr/quaimeriez-vous-apprendre/account-administration/account-settings/api-tokens/manage-api-access-tokens-as-a-brand).       |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `AuthToken` | La valeur du jeton d'autorisation API de votre compte impact.com. [Apprenez comment trouver cette valeur](https://help.impact.com/brand/fr/quaimeriez-vous-apprendre/account-administration/account-settings/api-tokens/manage-api-access-tokens-as-a-brand). |
| `ActionId`  | La valeur ID de l'action à modifier.                                                                                                                                                                                                                          |
| `Sku`       | La valeur du stock-keeping unit (SKU) de l'article — elle peut être trouvée lors de la récupération d'une action via l'API.                                                                                                                                   |
| `Quantity`  | La nouvelle valeur de quantité pour l'article.                                                                                                                                                                                                                |
| `Raison`    | Lors de l'annulation ou de la modification d'un article, soumettez toujours `ORDER_UPDATE` comme raison.                                                                                                                                                      |

</details>
