> 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 in batch o annulla 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), cambiando l'importo della commissione per l'azione.

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

| Se vuoi...                                                | Usa questo metodo...                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Invia un file manuale, una tantum, senza codice           | ​[Email](/brand/it/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/submit-conversion-data-via-ftp-or-email.md#before-you-start) elaborazione in batch o [carica file tramite 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#upload-file-to-system-ftp-server)                                                                                                                                                                                                                                          |
| Configura la reportistica automatizzata delle conversioni | ​[Conversioni](https://integrations.impact.com/brand-api-reference/reference/conversions/conversions) / [Azioni](https://integrations.impact.com/brand-api-reference/reference/actions) API, [invia file tramite 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#upload-file-to-system-ftp-server), oppure [recupera file tramite 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#pull-file-from-your-own-ftp-server) |

### Opzioni di annullamento via 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, ti servirà il suo `ActionId` valore. Potrai quindi usarlo per trovare l'azione che desideri modificare tramite API.

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

### FAQ

<details>

<summary>Come posso reimpostare una modifica / un annullamento effettuato su un'azione (o sugli articoli dell'azione)?</summary>

Se un'azione è stata modificata o annullata prima della sua 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 dei ricavi 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 utilizzati 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="234">Codice</th><th>Descrizione</th></tr></thead><tbody><tr><td><code>CONS_FRAUD</code></td><td>Frode del consumatore</td></tr><tr><td><code>CONS_ERROR</code></td><td>Errore del consumatore</td></tr><tr><td><code>ITEM_RETURNED</code></td><td>L'articolo è stato restituito</td></tr><tr><td><code>APPROVED</code></td><td><p>L'azione è approvata</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Nota:</strong> Se stai cercando di approvare le azioni, <code>Approva</code> deve essere impostato come un <a href="/pages/1cab1d9f83202eca82ed7b5563e9edf9ec4e1f17">codice di disposizione personalizzato</a>.</p></div></td></tr><tr><td><code>ORDER_ERROR</code></td><td>Errore dell'ordine</td></tr><tr><td><code>ORDER_UPDATE</code></td><td>L'ordine è stato aggiornato</td></tr><tr><td><code>PUB_ACT_DISPUTE</code></td><td>Contestazione dell'attività del partner</td></tr><tr><td><code>ADV_ACT_DISPUTE</code></td><td>Contestazione dell'attività del brand</td></tr><tr><td><code>NOT_COMPLIANCE_TERMS</code></td><td>Non conforme ai termini</td></tr><tr><td><code>ITEM_OUT_OF_STOCK</code></td><td>L'articolo non è disponibile</td></tr><tr><td><code>TEST_ACTION</code></td><td>Azione di test</td></tr><tr><td><code>PARTNER_NOT_ACTIVE</code></td><td>Account del partner disattivato</td></tr><tr><td><code>CREDITED_DIFFERENT_MP</code></td><td>Accreditato a un altro partner</td></tr><tr><td><code>ALTRO</code></td><td>Altro motivo</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:** Una `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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
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=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.