> 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/it/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).

# Modifica o annulla in batch tramite 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">Segui il corso PXA</a>

Se qualcosa relativo a un'azione cambia (ad es. un ordine è stato annullato, un articolo è stato restituito, ecc.), puoi usare l'API per modificarla (o annullarla), modificando l'importo della commissione per l'azione.

### Quale metodo di invio è giusto per te?

| 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) |

### Opzioni di annullamento tramite API:

* [Modifica o annulla uno o più articoli in un'azione tramite API](https://integrations.impact.com/brand-api-reference/reference/actions/actions)
* [Annulla un'intera azione tramite API](https://integrations.impact.com/brand-api-reference/reference/actions/actions)

### Prerequisito: recupera il *ActionId* valore

Per modificare i dati dell'azione tramite API, avrai bisogno del suo `ActionId` valore. Potrai quindi usarlo per trovare l'azione che desideri modificare tramite API.

* Puoi specificare un intervallo di date nella tua chiamata — altrimenti, l'endpoint mostra per impostazione predefinita gli ultimi 30 giorni di azioni.
* [I limiti di frequenza](https://integrations.impact.com/brand-api-reference/readme/rate-limits) si applicano.
* Visualizza il [Elenca tutte le azioni](https://integrations.impact.com/brand-api-reference/reference/actions/actions) Documentazione dell'endpoint API per saperne di più.

### Domande frequenti

<details>

<summary>Come posso reimpostare una modifica / annullamento apportata a un'azione (o agli elementi dell'azione)?</summary>

Se un'azione è stata modificata o annullata prima della data di blocco, puoi inviare `RESET` come motivo per riportare l'azione al suo stato predefinito:

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

Le azioni che sono state reimpostate tramite il `RESET` codice potrebbero non apparire correttamente nei report (ad es., i valori delle entrate potrebbero essere calcolati in modo errato).

</details>

<details>

<summary>Qual è la differenza tra un codice di disposizione e un motivo?</summary>

Entrambi *Codici di disposizione* e *Motivi* sono usati nello stesso contesto — *Motivi* sono codici predefiniti che l'API accetterà per impostazione predefinita, mentre *Codici di disposizione* sono motivi personalizzati che puoi configurare. [Scopri di più sui codici di disposizione](/brand/it/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/manage-disposition-codes.md).

Codici motivo supportati:

<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>Come posso vedere quando le modifiche / gli annullamenti vengono applicati a un'azione?</summary>

Puoi usare i [aggiornamenti dell'azione](https://integrations.impact.com/brand-api-reference/reference/actions/models) endpoint per vedere quando un'azione è stata aggiornata l'ultima volta e qual è il suo stato attuale.

{% hint style="info" %}
**Nota:** Un `ActionUpdatesID` valore è diverso da un `ActionId` valore — devi usare il `ActionUpdatesID` valore per recuperare gli aggiornamenti di un'azione.
{% 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/it/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.