Invia modifiche e storni in batch

Quando un partner genera una conversione—come una vendita—e il periodo di blocco per quell'azione non è ancora scaduto, puoi correggere eventuali dati azione errati inviando una modifica o uno storno. In questo modo si garantisce che il partner venga pagato correttamente alla scadenza del periodo di blocco.

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

Puoi inviare modifiche e storni in blocco tramite API, oppure tramite FTP/email come descritto in questo articolo. Il modello di cui hai bisogno per gli invii via 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.

Quale metodo di invio è giusto per te?

Se vuoi...	Usa questo metodo...
Invia un file manuale, una tantum, senza codice	​Email elaborazione batch o carica il file tramite FTP
Configura report automatici delle conversioni	​Conversioni / Azioni API, invia il file tramite FTP, o preleva il file tramite FTP

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, ma solo aggiornare quelli esistenti.
• Comprendi la gestione della deduplicazione — Quando più azioni condividono lo stesso Oid/OrderId, impact.com applica gli aggiornamenti al più recente ActionId. Per sovrascrivere questo, specifica il desiderato ActionId.
• Usa Importo correttamente per gli storni — Per stornare un'azione, puoi impostare Amount = 0. Tuttavia, se l'originale Amount = 0, lasciandolo a 0 verrà registrato come una modifica e l'azione non verrà stornata.

1

Passaggio 1: prepara il tuo file di dati

1. Identifica il file modello pertinente al tuo caso d'uso.

   • Vedi Riferimento per modifiche e storni in batch per 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 azione modificati.

   • Se stai usando un editor di testo, usa le virgole per separare ogni punto dati.
   • Se stai usando un editor per fogli di calcolo, aggiungi ogni punto dati in una cella separata.

   Nota: Assicurati di modificare le celle del foglio di calcolo in formato "testo semplice" o "Testo" in modo che i valori non vengano omessi accidentalmente.
4. Salva il file con un nome identificabile, ad esempio: Batch_Mods/Reversals_2025_02_12.csv

   • Per un elenco dei campi comunemente usati nell'elaborazione batch via FTP/email, vedi Riferimento per modifiche e storni in batch. In alternativa, consulta le nostre Riferimenti dei campi di azione e conversione per l'elenco completo dei campi supportati.

2

impact.com consente un massimo di 1.000 modifiche per azione. Se dopo hai bisogno di apportare ulteriori modifiche, contatta l'assistenza.

1. Dalla barra di navigazione superiore, seleziona [Profilo utente] → Impostazioni.
2. Nella colonna di destra, sotto Tracciamento, seleziona Tipi di evento.
3. Seleziona il nome del tipo di evento per cui desideri inviare modifiche in blocco.
4. Accanto a Elaborazione dei resi, seleziona [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:

Carica il file sul server FTP del sistema

Consigliamo di suddividere i file FTP/SFTP per mantenere il numero massimo di voci per file sotto 10.000.

1. Seleziona Carica il file sul server FTP del sistema.
2. Seleziona Invia per email nome utente e password FTP e Salva.
3. Una volta ricevute via email le tue credenziali FTP, 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 di impact.com, con distinzione tra maiuscole e minuscole.)	(Il tuo nome utente SFTP di impact.com, con distinzione tra maiuscole e minuscole.)
   Password	(La tua password FTP di impact.com, con distinzione tra maiuscole e minuscole.)	(La tua password SFTP di impact.com, con distinzione tra 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.

Recupera il file dal tuo server FTP

Consigliamo di suddividere i file FTP/SFTP per mantenere il numero massimo di voci per file sotto 10.000.

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 nella 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.

Invia il file per email al server SMTP del sistema

1. Seleziona Invia il file per email al server SMTP del 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 altri, includili nel CC: campo.
4. Puoi lasciare vuoti il campo oggetto e il corpo del messaggio.

   • Vedi di seguito un esempio dell'indirizzo email (il tuo sarà leggermente diverso):

3

Passaggio 3: controlla l'invio del tuo file

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

1. Dalla barra di navigazione superiore, seleziona [Profilo utente] → Impostazioni.
2. Nella colonna a sinistra, scorri fino a Tecnico sezione e seleziona Invio file.
3. Usa la tabella per rivedere i recenti invii 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 generali dei report possono richiedere più di 2 ore.
   • Di seguito sono riportati vari problemi che potresti incontrare durante la revisione degli invii dei file e le azioni che puoi intraprendere per risolverli.

Riferimento per la risoluzione dei problemi dell'invio

Problema	Azione da intraprendere
La colonna dei record 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 Importo colonna (ad es., inserisci 0 se desideri annullare le azioni).
BAD_DISPOSITION	Il codice motivo che hai fornito non è valido. Utilizza uno dei codici standard codici di motivo. In alternativa, puoi configurare un codice di disposizione personalizzato.
ALREADY_LOCKED	Il periodo di blocco dell'azione è già scaduto. L'azione non può più essere modificata o annullata.
Il valore ActionTrackerld:ActionTrackerld non è valido	Questo dovrebbe corrispondere a ID tipo evento 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.