> 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">Suivez la formation PXA</a>

Si quoi que ce soit concernant une action change (par exemple, une commande a été annulée, un article a été retourné, etc.), vous pouvez utiliser l'API pour la modifier (ou l'annuler), ce qui modifie le montant de la commission pour 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](/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](/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](/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​](/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 *ActionId* valeur

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

* Vous pouvez spécifier une plage de dates dans votre appel — 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 le [Lister toutes les actions](https://integrations.impact.com/brand-api-reference/reference/actions/actions) Documentation du point de terminaison de l'API pour en savoir plus.

### FAQ

<details>

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

Si une action a été modifiée ou annulée avant sa date de verrouillage, vous pouvez soumettre `RESET` comme motif 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 réinitialisées via le `RESET` code peuvent ne pas s'afficher correctement dans les rapports (par exemple, les valeurs de revenus peuvent être calculées incorrectement).

</details>

<details>

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

Tous deux *Codes de disposition* et *Motifs* sont utilisés dans le même contexte — *Motifs* sont des codes prédéfinis que l'API acceptera par défaut, tandis que *Codes de disposition* sont des motifs personnalisés que vous pouvez configurer. [En savoir plus sur les codes de disposition](/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="/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 puis-je voir quand des modifications / annulations sont appliquées à une action ?</summary>

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

{% hint style="info" %}
**Remarque :** Une `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>


---

# 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.