> 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/submit-batch-modifications-and-reversals.md).

# Invia modifiche e annullamenti in batch

Quando un partner genera una conversione, ad esempio una vendita, e il periodo di blocco per quell’azione non è ancora trascorso, puoi correggere eventuali dati errati dell’azione inviando una modifica o uno storno. In questo modo, al termine del periodo di blocco, il partner riceverà il pagamento corretto.

In genere, le azioni vengono modificate o stornate quando i clienti restituiscono gli ordini, commettono errori durante il pagamento o quando gli articoli sono esauriti.

Puoi inviare modifiche e storni in blocco tramite API oppure via FTP/email, come descritto in questo articolo. Il modello da usare per gli invii via FTP/email dipende dal fatto che il monitoraggio avvenga a livello di ordine o di articolo, poiché i campi richiesti sono diversi. Se non sai quale file usare, chiedi al tuo CSM oppure [contatta l’assistenza](https://app.impact.com/support/portal.ihtml).

### Qual è il metodo di invio più adatto a te?

| Se vuoi…                                                          | Usa questo metodo…                                                                                                                                                                                                                                                                                                       |
| ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Inviare un file manuale una tantum senza scrivere codice          | ​[Email](#step-2-submit-your-data-file) elaborazione in batch oppure [caricamento del file via FTP](#step-2-submit-your-data-file)​                                                                                                                                                                                      |
| Configurare la generazione automatica di report sulle conversioni | ​[Conversioni](https://integrations.impact.com/brand-api-reference/reference/conversions/conversions) / [Azioni](https://integrations.impact.com/brand-api-reference/reference/actions) API, [invio del file via FTP](#step-2-submit-your-data-file), oppure [recupero del file via FTP​](#step-2-submit-your-data-file) |

### Aspetti da tenere presenti:

* **Usa i formati di file supportati** — Il file da inviare deve essere in formato .CSV o .XML.
* **Non aggiungere nuovi dati** — Non puoi aggiungere nuovi campi a una transazione, puoi solo aggiornare quelli esistenti.
* **Comprendi come viene gestita la deduplicazione** — Quando più azioni condividono lo stesso *Oid/OrderId*, impact.com applica gli aggiornamenti all’azione più recente *ActionId*. Per applicarli a un’altra azione, specifica il valore desiderato *ActionId*.
* **Usa&#x20;*****Amount*****&#x20;correttamente per gli storni** — Per stornare un’azione, puoi impostare *Amount = 0*. Tuttavia, se il valore originale *Amount = 0*, mantenerlo a 0 verrà considerato una modifica e l’azione non verrà stornata.

{% stepper %}
{% step %}

#### Passaggio 1: prepara il file di dati

1. Individua il file modello adatto al tuo caso d’uso.
   * Consulta [Riferimento per modifiche e storni in batch](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-modifications-and-reversals-reference.md) per trovare i file modello con dati di esempio.
2. Incolla il contenuto del modello in un foglio di calcolo (ad esempio Microsoft Excel) o in un editor di testo (ad esempio Blocco note).
3. Sotto la riga d’intestazione, inizia ad aggiungere i dati aggiornati dell’azione.

   * Se usi un editor di testo, separa i dati con le virgole.
   * Se usi un foglio di calcolo, inserisci ogni dato in una cella separata.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Nota:</strong> Assicurati di modificare le celle del foglio di calcolo nel formato «Testo semplice» o «Testo», in modo che i valori non vengano omessi accidentalmente.</p></div>
4. Salva il file con un nome riconoscibile, ad esempio: `Batch_Mods/Reversals_2025_02_12.csv`
   * Per un elenco dei campi comunemente usati nell’elaborazione in batch via FTP/email, consulta [Riferimento per modifiche e storni in batch](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-modifications-and-reversals-reference.md). In alternativa, consulta il nostro [Riferimenti ai campi di azione e conversione](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references) per l’elenco completo dei campi supportati.
     {% endstep %}

{% step %}

#### Passaggio 2: invia il file di dati

impact.com consente un massimo di 1.000 modifiche per azione. Se in seguito hai bisogno di apportare altre modifiche, [contatta l'assistenza](https://app.impact.com/support/portal.ihtml).

1. Nella barra di navigazione superiore, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Profilo utente] → Impostazioni**.
2. Nella colonna a destra, sotto *Monitoraggio*, seleziona [**Tipi di evento**](https://app.impact.com/secure/advertiser/tracking-settings/actiontracker/view-actiontracker-flow.ihtml).
3. Seleziona il **nome** del tipo di evento per cui vuoi inviare modifiche in batch.
4. Accanto a *Elaborazione dei resi*, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fkka3dqJOx8ZhiX82RDLt%2FEdit_light.svg?alt=media\&token=f454405c-ebd8-49af-90db-22efc27476bf) **\[Modifica]**.
5. Seleziona **Automatizza l’elaborazione dei resi (avanzato)**, quindi seleziona **Caricamento in batch**.
6. Scegli uno dei seguenti metodi basati su FTP o email per inviare il file:

<details>

<summary>Carica il file sul server FTP del sistema</summary>

{% hint style="info" %}
Ti consigliamo di suddividere i file FTP/SFTP in modo che ciascun file contenga meno di 10.000 voci.
{% endhint %}

1. Seleziona **Carica il file sul server FTP del sistema.**
2. Seleziona **Invia via email nome utente e password FTP** e **Salva**.
3. Dopo aver ricevuto le credenziali FTP via email, usa un client FTP per connetterti a impact.com con le seguenti informazioni:

   |                 | FTP                                                                            | SFTP                                                                            |
   | --------------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------- |
   | **Server**      | batch.impact.com                                                               | sftp\://batch.impact.com                                                        |
   | **Porta**       | 21                                                                             | 22                                                                              |
   | **Nome utente** | (Il nome utente FTP di impact.com, con distinzione tra maiuscole e minuscole.) | (Il nome utente SFTP di impact.com, con distinzione tra maiuscole e minuscole.) |
   | **Password**    | (La password FTP di impact.com, con distinzione tra maiuscole e minuscole.)    | (La password SFTP di impact.com, con distinzione tra maiuscole e minuscole.)    |
4. Una volta connesso, carica il file nella directory principale del server.
   * Se non hai ricevuto l'email con le credenziali FTP, contatta la persona che ha creato il tuo account impact.com. In alternativa, [contatta l'assistenza](https://app.impact.com/support/portal.ihtml).

</details>

<details>

<summary>Recupera il file dal tuo server FTP</summary>

{% hint style="info" %}
Ti consigliamo di suddividere i file FTP/SFTP in modo che ciascun file contenga meno di 10.000 voci.
{% endhint %}

1. Seleziona **Recupera il file dal tuo server FTP**.
2. Inserisci l' **URL del server**, **Porta**, e il **Directory** percorso del file delle modifiche in batch sul tuo server FTP. Inserisci il **Nome utente** e la **Password** che impact.com userà per connettersi al tuo server FTP.
3. Seleziona **Salva** e continua.
4. Carica il file nella *Directory* specificata sopra.
   * impact.com tenta di connettersi al tuo server FTP e scaricare i file ogni 24 ore, quindi il file potrebbe richiedere fino a 24 ore per essere elaborato dopo il caricamento.

</details>

<details>

<summary>Invia il file al server SMTP del sistema tramite email</summary>

1. Seleziona **Invia il file al server SMTP del sistema tramite email.**
2. Subito sotto il metodo selezionato verrà fornito un indirizzo email univoco. Copia questo indirizzo email.
3. Usando un qualsiasi client di posta, invia un'email all'indirizzo univoco allegando il file delle modifiche in batch.
   * Inserisci solo l'indirizzo email univoco per il tipo di evento nel campo *A:* . Se devi inviare il file ad altri, aggiungili nel campo *CC:* .
4. Puoi lasciare vuoti il campo dell'oggetto e il corpo del messaggio.
   * Di seguito è riportato un esempio dell'indirizzo email (il tuo sarà leggermente diverso):

<div data-with-frame="true"><figure><img src="https://1651675991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpVKEIcehMut8QKRmaUZu%2Fuploads%2F4KrGuAmvXvwqwYUxauT0%2FScreenshot%202026-10-07%20at%2023.37.54.png?alt=media&amp;token=5835d762-9ad4-41c3-9715-d79be84c5af9" alt="" width="563"><figcaption></figcaption></figure></div>

</details>
{% endstep %}

{% step %}

#### Passaggio 3: controlla l’invio del file

Dopo aver inviato il file .CSV o .XML a impact.com, puoi controllarne lo stato per verificare se è stato elaborato.

1. Nella barra di navigazione superiore, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b527686787b925f477dff4feb9be3a63f51250a7%2Fdcf31aa89710c2f91d880b79ce8d8c18489cd8cad334e5cd91dd7ee0372a44fd.svg?alt=media) **\[Profilo utente] → Impostazioni**.
2. Nella colonna a sinistra, scorri fino alla sezione *Tecnico* e seleziona [**Invii di file**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/ftp-file-submissions-flow.ihtml).
3. Usa la tabella per esaminare gli invii di file recenti ricevuti da impact.com, incluso lo stato di elaborazione corrente.
   * I file inviati compariranno entro 10-15 minuti dall’invio, mentre gli aggiornamenti generali dei report possono richiedere più di 2 ore.
   * Di seguito sono riportati alcuni problemi che potresti riscontrare durante la revisione degli invii di file e le azioni che puoi intraprendere per risolverli.

<details>

<summary>Riferimento per la risoluzione dei problemi di invio</summary>

| Problema                                           | Azione da intraprendere                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| La colonna Records mostra 0                        | Assicurati che l’estensione del file sia .CSV o .XML.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `NO_CHANGE`                                        | Non è stata apportata alcuna modifica all’azione. Assicurati di inserire l’importo finale nella colonna *Importo* (ad esempio, inserisci 0 se vuoi annullare le azioni).                                                                                                                                                                                                                                                                                                                                                                   |
| `BAD_DISPOSITION`                                  | <p>Il codice motivo fornito non è valido. Usa uno dei <a href="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-modifications-and-reversals-reference.md">codici motivo standard</a>.</p><p>In alternativa, puoi configurare un <a href="https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/manage-disposition-codes.md">codice disposizione personalizzato</a>.</p> |
| `ALREADY_LOCKED`                                   | Il periodo di blocco dell’azione è già scaduto. Non è più possibile modificare o annullare l’azione.                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `ActionTrackerld:ActionTrackerld value is invalid` | Questo valore dovrebbe corrispondere all’ [ID del tipo di evento](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/event-types/how-do-i-find-my-event-type-ids.md) inserito.                                                                                                                                                                                                                                                                                                                          |
| `ACTION_NOT_FOUND`                                 | L’ `OID` fornito non è corretto. Inserisci un `OID`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `ALREADY_REVERSED`                                 | L’azione è già stata annullata.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `ALREADY_APPROVED`                                 | L’azione è già stata approvata.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |

</details>
{% endstep %}
{% endstepper %}


---

# 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/submit-batch-modifications-and-reversals.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.
