# Aperçu du traitement en masse des revers via API (services Web)

<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">Suivre le cours PXA</a>

Si quelque chose concernant une action change (par ex., une commande a été annulée, un article a été retourné, etc.), vous pouvez utiliser l'API pour la modifier (ou l'annuler), en changeant le montant de la commission pour l'action. Dans cet article, nous montrons comment modifier et annuler une action avec des appels cURL à l'API Brand d'impact.com.

**Options de traitement par lot pour les annulations :**

* Modifier ou annuler un ou plusieurs articles d'une action via l'API
* Annuler une action entière via l'API

#### Prérequis : Récupérer la *ActionId* valeur

Pour annuler une action, vous aurez besoin de sa `ActionId` valeur. L'appel ci-dessous récupérera toutes les actions pour un *Programme* (c.-à-d., *Campagne*) — vous pouvez l'utiliser pour trouver l'action que vous voulez modifier.

* Vous pouvez spécifier une plage de dates dans votre appel — sinon, le point de terminaison affiche par défaut les 30 derniers jours d'actions.
* [Les limites de débit](https://integrations.impact.com/impact-brand/reference/rate-limits) s'appliquent.
* Voir la [Lister toutes les actions](https://integrations.impact.com/impact-brand/reference/list-all-actions) Documentation du point de terminaison API pour en savoir plus.

<details>

<summary>Référence du paramètre</summary>

| Paramètre    | Description                                                                                                                                                                                                                                                                                                                                                                           |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `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/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/account-administration/account-settings/api-tokens/manage-api-access-tokens-as-a-brand).                                                                                                                                                   |
| `CampaignId` | <p>La valeur ID du programme (campagne) sous lequel l'action a été suivie.</p><p><img src="https://57104473-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="Exemple d'appel" %}

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

{% endtab %}

{% tab title="Exemple de réponse" %}

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

{% endtab %}
{% endtabs %}

#### FAQ

<details>

<summary>Comment réinitialiser une modification / annulation effectuée sur une action (ou des articles d'action) ?</summary>

Si une action a été modifiée ou annulée avant sa date de verrouillage, vous pouvez soumettre `RESET` comme raison pour remettre l'action à son état par défaut :

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

Les actions qui ont été réinitialisées via le `RESET` code peuvent ne pas apparaître correctement dans les rapports (par ex., les valeurs de revenus peuvent être calculées incorrectement).

</details>

<details>

<summary>Quelle est la différence entre un code de disposition et une raison ?</summary>

Les codes de disposition et les raisons sont utilisés dans le même contexte — *Les raisons* sont des codes prédéfinis que l'API acceptera par défaut, tandis que *Les codes de disposition* sont des raisons personnalisées que vous pouvez configurer. [En savoir plus sur les codes de disposition](https://help.impact.com/brand/fr/platform-features/tracking/set-up-tracking/manage-disposition-codes).

Soumettre l'une de ces valeurs comme raison annulera l'article (ou l'action) :

| Code                    | Description                             |
| ----------------------- | --------------------------------------- |
| `CONS_FRAUD`            | Fraude consommateur                     |
| `CONS_ERROR`            | Erreur du consommateur                  |
| `ITEM_RETURNED`         | Article retourné                        |
| `ORDER_ERROR`           | Erreur de commande                      |
| `ORDER_UPDATE`          | La commande a été mise à jour           |
| `PUB_ACT_DISPUTE`       | Litige d'activité partenaire            |
| `ADV_ACT_DISPUTE`       | Contestation d'activité par l'annonceur |
| `NOT_COMPLIANCE_TERMS`  | Non conforme aux conditions             |
| `ITEM_OUT_OF_STOCK`     | L'article est en rupture de stock       |
| `TEST_ACTION`           | Action de test                          |
| `PARTNER_NOT_ACTIVE`    | Compte partenaire désactivé             |
| `CREDITED_DIFFERENT_MP` | Crédité à un autre partenaire           |
| `OTHER`                 | Autre raison                            |
| `ITEM_CANCELLED`        | Article dans la commande annulé         |

</details>

<details>

<summary>Comment puis-je voir quand des modifications / annulations sont appliquées à une action ?</summary>

Vous pouvez utiliser les [mises à jour d'action](https://integrations.impact.com/impact-brand/reference/the-action-update-object) point de terminaison pour voir quand une action a été mise à jour pour la dernière fois et quel est son état actuel.

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

{% hint style="info" %}
**Remarque :** Un `ActionUpdatesID` la valeur est différente d'une `ActionId` valeur — vous devez utiliser la `ActionUpdatesID` valeur pour récupérer les mises à jour d'une action.
{% endhint %}

</details>
