> 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 — come una vendita — e il periodo di blocco per quella azione non è ancora scaduto, puoi correggere eventuali dati d’azione errati inviando una modifica o un annullamento. In questo modo il partner viene pagato correttamente quando il periodo di blocco termina.
Le azioni vengono in genere modificate o annullate quando i clienti restituiscono gli ordini, commettono errori durante il checkout oppure quando gli articoli non sono disponibili.
Puoi inviare modifiche e annullamenti in blocco tramite API, oppure tramite FTP/email come descritto in questo articolo. Il modello necessario 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 l'assistenza](https://app.impact.com/support/portal.ihtml).
### Quale metodo di invio è adatto a te?
| Se vuoi... | Usa questo metodo... |
| --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Inviare un file manuale, una tantum, senza programmazione | [Email](#step-2-submit-your-data-file) elaborazione batch o [caricare il file tramite FTP](#step-2-submit-your-data-file) |
| Impostare il reporting automatico delle conversioni | [Conversioni](https://integrations.impact.com/brand-api-reference/reference/conversions/conversions) / [Azioni](https://integrations.impact.com/brand-api-reference/reference/actions) API, [inviare il file tramite FTP](#step-2-submit-your-data-file), oppure [prelevare il file tramite FTP](#step-2-submit-your-data-file) |
### Aspetti 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 sovrascriverlo, specifica il *ActionId*.
* **Usa *****Importo***** correttamente per gli annullamenti** — Per annullare un'azione, puoi impostare *Importo = 0*. Tuttavia, se l' *Importo = 0*, mantenerlo a 0 verrà registrato come una modifica e l'azione non verrà annullata.
{% 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 annullamenti in blocco](/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 di 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 delle azioni modificati.
* Se stai usando un editor di testo, usa le virgole per separare ogni punto dati.
* Se stai usando un editor di fogli di calcolo, aggiungi ogni punto dati in una cella separata.
Nota: Assicurati di modificare le celle del foglio di calcolo nel formato "Testo normale" o "Testo" in modo che i valori non vengano omessi accidentalmente.
Carica il file sul server FTP di sistema
{% hint style="info" %}
Consigliamo di suddividere i file FTP/SFTP per mantenere il numero massimo di voci per file sotto 10.000.
{% endhint %}
1. Seleziona **Carica il file sul server FTP di sistema.**
2. Seleziona **Invia via email nome utente e password FTP** e **Salva**.
3. Una volta ricevute 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 tuo nome utente FTP impact.com, sensibile alle maiuscole e minuscole.) | (Il tuo nome utente SFTP impact.com, sensibile alle maiuscole e minuscole.) |
| **Password** | (La tua password FTP impact.com, sensibile alle maiuscole e minuscole.) | (La tua password SFTP impact.com, sensibile alle 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).
Preleva il file dal tuo server FTP
{% hint style="info" %}
Consigliamo di suddividere i file FTP/SFTP per mantenere il numero massimo di voci per file sotto 10.000.
{% endhint %}
1. Seleziona **Preleva il file dal tuo server FTP**.
2. Inserisci l' **URL del server**, **Porta**, e **Directory** percorso del file delle modifiche batch sul tuo server FTP. Inserisci l' **Nome utente** e **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 e scaricare i file dal tuo server FTP ogni 24 ore, quindi potrebbero essere necessarie fino a 24 ore dopo il caricamento per l'elaborazione del file.
Invia il file via email al server SMTP di sistema
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 file delle modifiche batch come allegato.
* Includi solo l'indirizzo email univoco per il tipo di evento nel campo *A:* Se devi inviare questo file ad altri, includili nel campo *CC:* campo.
4. Puoi lasciare vuoti il campo oggetto e il corpo del messaggio.
* Vedi sotto un esempio dell'indirizzo email (il tuo sarà leggermente diverso):
{% endstep %}
{% step %}
#### Passaggio 3: rivedi l'invio del file
Dopo aver inviato il file .CSV o .XML a impact.com, puoi controllarne lo stato per vedere se è stato elaborato.
1. Dalla barra di navigazione in alto, seleziona  **\[Profilo utente] → Impostazioni**.
2. Nella colonna di sinistra, scorri fino alla *Tecnico* sezione e seleziona [**Invii file**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/ftp-file-submissions-flow.ihtml).
3. Usa la tabella per rivedere gli invii recenti di file ricevuti da impact.com, incluso lo stato di elaborazione attuale.
* I file inviati appariranno entro 10-15 minuti dall'invio, mentre gli aggiornamenti del reporting generale possono richiedere più di 2 ore.
* Di seguito sono riportati vari problemi che potresti incontrare durante la revisione degli invii di file e le azioni che puoi intraprendere per risolverli.
Riferimento per la risoluzione dei problemi di invio
| 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* campo (ad es. inserisci 0 se desideri annullare le azioni). |
| `BAD_DISPOSITION` | Il codice motivo fornito non è valido. Usa uno dei codici motivo.
standard. In alternativa, puoi impostare un codice di disposizione personalizzato.
|
| `ALREADY_LOCKED` | Il periodo di blocco dell'azione è già trascorso. L'azione non può più subire modifiche o annullamenti. |
| `Il valore ActionTrackerld:ActionTrackerld non è valido` | Questo dovrebbe corrispondere a [ID tipo 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` | Il `OID` che hai fornito non è corretto. Fornisci un `OID`. |
| `ALREADY_REVERSED` | L'azione è già stata annullata. |
| `ALREADY_APPROVED` | L'azione è già stata approvata. |
{% 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=&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.
