> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-process-reversals-via-api-web-services-overview.md).

# Modifier ou annuler par lot via l’API

<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 un élément lié à une action change (par exemple, une commande est annulée, un article est retourné, etc.), vous pouvez utiliser l’API pour la modifier (ou l’annuler), ce qui change le montant de la commission associée à l’action.

### Quelle méthode de soumission vous convient le mieux ?

| If you want to...                             | Use this method...                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Submit a manual, one-time file with no coding | ​[Email](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.md#step-2-submit-your-data-file) batch processing or [upload file via FTP](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.md#step-2-submit-your-data-file)​                                                                                                                                                                                        |
| Set up automated conversion reporting         | ​[Conversions](https://integrations.impact.com/brand-api-reference/reference/conversions/conversions) / [Actions](https://integrations.impact.com/brand-api-reference/reference/actions) API, [push file via FTP](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.md#step-2-submit-your-data-file), or [pull file via FTP​](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.md#step-2-submit-your-data-file) |

### Options d’annulation via l’API :

* [Modifier ou annuler un ou plusieurs éléments d’une action via l’API](https://integrations.impact.com/brand-api-reference/reference/actions/actions)
* [Annuler une action entière via l’API](https://integrations.impact.com/brand-api-reference/reference/actions/actions)

### Prérequis : récupérer la valeur *ActionId* &#x20;

Pour modifier les données d’une action via l’API, vous aurez besoin de sa valeur `ActionId` Vous pourrez ensuite l’utiliser pour trouver l’action à modifier via l’API.

* Vous pouvez spécifier une plage de dates dans votre requête ; sinon, le point de terminaison affiche par défaut les actions des 30 derniers jours.
* [Les limites de débit](https://integrations.impact.com/brand-api-reference/readme/rate-limits) s’appliquent.
* Consultez la documentation du [List all actions](https://integrations.impact.com/brand-api-reference/reference/actions/actions) point de terminaison de l’API pour en savoir plus.

### FAQ

<details>

<summary>Comment réinitialiser une modification ou une annulation apportée à une action (ou à ses éléments) ?</summary>

Si une action a été modifiée ou annulée avant sa date de verrouillage, vous pouvez soumettre `RESET` comme motif pour rétablir l’état par défaut de l’action :

```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 réinitialisées à l’aide du code `RESET` peuvent ne pas apparaître correctement dans les rapports (par exemple, les valeurs de revenu peuvent être calculées de manière incorrecte).

</details>

<details>

<summary>Quelle est la différence entre un code de statut et un motif ?</summary>

Les *codes de statut* et les *motifs* s’utilisent dans le même contexte : les *motifs* sont des codes prédéfinis que l’API accepte par défaut, tandis que les *codes de statut* sont des motifs personnalisés que vous pouvez configurer. [En savoir plus sur les codes de statut](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/manage-disposition-codes.md).

Codes de motif pris en charge :

<table><thead><tr><th width="239.2734375">Code</th><th>Description</th></tr></thead><tbody><tr><td><code>CONS_FRAUD</code></td><td>Consumer fraud</td></tr><tr><td><code>CONS_ERROR</code></td><td>Consumer error</td></tr><tr><td><code>ITEM_RETURNED</code></td><td>Item was returned</td></tr><tr><td><code>APPROVED</code></td><td><p>Action is approved</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Note:</strong> If you’re trying to approve actions, <code>Approve</code> needs to be set up as a <a href="https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/manage-disposition-codes.md">custom disposition code</a>.</p></div></td></tr><tr><td><code>ORDER_ERROR</code></td><td>Order error</td></tr><tr><td><code>ORDER_UPDATE</code></td><td>Order was updated</td></tr><tr><td><code>PUB_ACT_DISPUTE</code></td><td>Partner activity dispute</td></tr><tr><td><code>ADV_ACT_DISPUTE</code></td><td>Brand activity dispute</td></tr><tr><td><code>NOT_COMPLIANCE_TERMS</code></td><td>Not in compliance with terms</td></tr><tr><td><code>ITEM_OUT_OF_STOCK</code></td><td>Item is out of stock</td></tr><tr><td><code>TEST_ACTION</code></td><td>Test action</td></tr><tr><td><code>PARTNER_NOT_ACTIVE</code></td><td>Partner account deactivated</td></tr><tr><td><code>CREDITED_DIFFERENT_MP</code></td><td>Credited to another partner</td></tr><tr><td><code>OTHER</code></td><td>Other reason</td></tr></tbody></table>

</details>

<details>

<summary>Comment savoir quand des modifications ou des annulations sont appliquées à une action ?</summary>

Vous pouvez utiliser le point de terminaison [action updates](https://integrations.impact.com/brand-api-reference/reference/actions/models) pour connaître la date de la dernière mise à jour d’une action et son état actuel.

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

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-process-reversals-via-api-web-services-overview.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
