> 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 reversals in batch

Quando un partner genera una conversione — come una vendita — e il periodo di blocco per quell'azione non è ancora trascorso, puoi correggere eventuali dati dell'azione errati inviando una modifica o una revoca. Questo garantisce che il partner venga pagato correttamente quando il periodo di blocco termina.

Le azioni vengono in genere modificate o revocate quando i clienti restituiscono gli ordini, commettono errori durante il checkout o quando gli articoli sono esauriti.

Puoi inviare modifiche e revoche in blocco tramite API, oppure tramite FTP/email come descritto in questo articolo. Il modello di cui hai bisogno per gli invii FTP/email dipende dal fatto che tu stia tracciando a livello di ordine o di articolo, poiché ciascuno richiede campi diversi. Se non sei sicuro di quale file usare, chiedi al tuo CSM o [contatta il supporto](https://app.impact.com/support/portal.ihtml).

### Quale metodo di invio è più adatto a 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), o [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) |

### Cose da tenere a mente:

* **Usa formati di file supportati** — Il file inviato deve essere in formato .CSV o .XML.
* **Non aggiungere nuovi punti dati** — Non puoi aggiungere nuovi campi a una transazione, puoi solo aggiornare quelli esistenti.
* **Comprendi la gestione della deduplicazione** — Quando più azioni condividono lo stesso *Oid/OrderId*, impact.com applica gli aggiornamenti all' *ActionId*. Per ignorare questo comportamento, specifica l' *ActionId*.
* **Usa&#x20;*****Importo*****&#x20;correttamente per le revoche** — Per revocare un'azione, puoi impostare *Importo = 0*. Tuttavia, se l'originale *Importo = 0*, mantenerlo a 0 verrà registrato come una modifica e l'azione non verrà revocata.

{% stepper %}
{% step %}

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

1. Identifica il file modello pertinente al tuo caso d'uso.
   * Vedi [Riferimento per modifiche e revoche in batch](/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 i file modello con dati di esempio.
2. Incolla il contenuto del modello in un'applicazione per fogli di calcolo (ad es. Microsoft Excel) o in un editor di testo (ad es. Notepad).
3. Sotto la riga di intestazione, inizia ad aggiungere i dati dell'azione modificata.

   * Se utilizzi un editor di testo, usa le virgole per separare ogni punto dati.
   * Se utilizzi un editor di fogli di calcolo, aggiungi ogni punto dati 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 normale" o "Testo" in modo che i valori non vengano omessi accidentalmente.</p></div>
4. Salva il file con un nome identificabile, ad esempio: `Batch_Mods/Reversals_2025_02_12.csv`
   * Per un elenco dei campi comunemente utilizzati nell'elaborazione in batch tramite FTP/email, vedi [Riferimento per modifiche e revoche in batch](/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 i nostri [Riferimenti ai campi di azioni e conversioni](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references) per un elenco completo dei campi supportati.
     {% endstep %}

{% step %}
impact.com consente un massimo di 1.000 modifiche per azione. Se dopo devi apportare ulteriori modifiche, [contatta l'assistenza](https://app.impact.com/support/portal.ihtml).

1. Dalla barra di navigazione superiore, seleziona ![](/files/9cd266a8f48956f16b756268ec5df533881606b9) **\[Profilo utente] → Impostazioni**.
2. Nella colonna di destra, sotto *Tracciamento*, 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 desideri inviare modifiche in blocco.
4. Accanto a *Elaborazione dei resi*, seleziona ![](/files/06805c880643774310ff3dae44fb97e4b59a7553) **\[Modifica]**.
5. Seleziona **Automatizza l'elaborazione dei resi (avanzato)**.
6. Scegli uno dei seguenti metodi relativi a FTP o email per inviare il tuo file:

<details>

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

{% hint style="info" %}
Consigliamo di suddividere i file FTP/SFTP per mantenere il numero massimo di voci per file al di sotto di 10.000.
{% endhint %}

1. Seleziona **Carica il file sul server FTP di sistema.**
2. Seleziona **Invia per email nome utente e password FTP** e **Salva**.
3. Una volta ricevute via email le credenziali FTP, utilizza 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 tuo nome utente FTP di impact.com sensibile alle maiuscole e minuscole.) | (Il tuo nome utente SFTP di impact.com sensibile alle maiuscole e minuscole.) |
   | **Password**    | (La tua password FTP di impact.com sensibile alle maiuscole e minuscole.)    | (La tua password SFTP di impact.com sensibile alle maiuscole e minuscole.)    |
4. Una volta connesso, carica il tuo 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" %}
Consigliamo di suddividere i file FTP/SFTP per mantenere il numero massimo di voci per file al di sotto di 10.000.
{% endhint %}

1. Seleziona **Recupera il file dal tuo server FTP**.
2. Inserisci il **URL del server**, **Porta**, e **Directory** percorso del file delle modifiche in blocco sul tuo server FTP. Inserisci il **Nome utente** e **Password** che impact.com utilizzerà per connettersi al tuo server FTP.
3. Seleziona **Salva** e continua.
4. Carica il tuo file nel *Directory* che hai specificato sopra.
   * impact.com tenta di connettersi e scaricare i file dal tuo server FTP ogni 24 ore, quindi il tuo file potrebbe impiegare fino a 24 ore per essere elaborato dopo il caricamento.

</details>

<details>

<summary>Invia il file via email al server SMTP di sistema</summary>

1. Seleziona **Invia il file via email al server SMTP di sistema.**
2. Ti verrà fornito un indirizzo email univoco subito sotto il metodo selezionato. Copia questo indirizzo email.
3. Utilizzando qualsiasi client email, invia un'email all'indirizzo univoco con il tuo file delle modifiche in blocco come allegato.
   * Includi solo l'indirizzo email univoco per il tipo di evento nel *A:* campo. Se devi inviare questo file ad altre persone, includile nel *CC:* campo.
4. Puoi lasciare vuoti il campo oggetto e il corpo del messaggio.
   * Vedi un esempio dell'indirizzo email qui sotto (il tuo sarà leggermente diverso):

<div data-with-frame="true"><figure><img src="/files/c81361965d23bde2d310533504879ef757dfdb28" alt="" width="446"><figcaption></figcaption></figure></div>

</details>
{% endstep %}

{% step %}

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

Una volta inviato il file .CSV o .XML a impact.com, puoi controllarne lo stato per vedere se è stato elaborato.

1. Dalla barra di navigazione superiore, seleziona ![](/files/9cd266a8f48956f16b756268ec5df533881606b9) **\[Profilo utente] → Impostazioni**.
2. Nella colonna di sinistra, scorri fino a *Tecnico* sezione e seleziona [**Invio file**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/ftp-file-submissions-flow.ihtml).
3. Usa la tabella per esaminare i recenti invii di file ricevuti da impact.com, incluso lo stato attuale dell'elaborazione.
   * 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 vari problemi che potresti incontrare durante la verifica degli invii dei 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 nel *Importo* colonna (ad esempio, inserisci 0 se desideri annullare le azioni).                                                                                                                                         |
| `BAD_DISPOSITION`                                        | <p>Il codice motivo che hai fornito non è valido. Utilizza uno dei codici standard <a href="/pages/89d8d8c97d0fe3c931bdfd202ba1883e459f78f2">codici motivo</a>.</p><p>In alternativa, puoi configurare un <a href="/pages/1cab1d9f83202eca82ed7b5563e9edf9ec4e1f17">codice di disposizione personalizzato</a>.</p> |
| `ALREADY_LOCKED`                                         | Il periodo di blocco dell'azione è già trascorso. L'azione non può più essere modificata o annullata.                                                                                                                                                                                                              |
| `Il valore ActionTrackerld:ActionTrackerld non è valido` | Questo dovrebbe corrispondere all' [ID del tipo di evento](/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`                                       | La `OID` che hai fornito non è corretto. Fornisci 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 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/submit-batch-modifications-and-reversals.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.
