Riferimento per modifiche e annullamenti in blocco

Quando si modificano o si annullano dati di azione in blocco, inizia scaricando uno dei file modello forniti da impact.com e sostituendo i dati di esempio con i tuoi. Quando aggiungi i tuoi dati, assicurati di seguire le linee guida della tabella di riferimento pertinente per garantire che l’invio del file sia formattato correttamente. Una volta che il file di invio è pronto, puoi riprendere da invio delle modifiche / annullamenti del tuo batch file.

Questo articolo di riferimento include i campi più comunemente utilizzati per modifiche e annullamenti in batch. Per vedere un riferimento completo e dettagliato, incluse le descrizioni dei campi, fai riferimento a Riferimenti ai campi di Azione e Conversione.

Consulta i riferimenti qui sotto per:

• Scoprire quali campi utilizzare in una modifica o annullamento batch via FTP/SMTP

• Scaricare file modello con dati di esempio segnaposto

• Capire quali codici motivo applicare e quando

Modifiche a livello di ordine

Questo serve quando vuoi aggiornare i dati dell’azione in blocco a livello di ordine anziché a livello di articolo, ad esempio modificare l’importo dell’ordine per più ordini.

Parametri accettati

Campo	Obbligatorio?	Modificabile?	Nota
ActionID	Obbligatorio condizionalmente*	Non modificabile	Fornire questo identificatore è consigliato quando la finestra di deduplicazione è breve.
Oid / OrderId	Obbligatorio condizionalmente*	Non modificabile	Fornire questo identificatore è richiesto quando si utilizza ActionTrackerId.
ActionTrackerID	Obbligatorio condizionalmente*	Non modificabile	Fornire questo identificatore è richiesto quando si utilizza OrderId/Oid.
Importo	Opzionale	Modificabile	Imposta il nuovo importo totale dell’ordine.
currencyCode	Opzionale	Modificabile	Imposta la valuta dei ricavi dell’azione. Per impostazione predefinita, se non fornita, viene utilizzata la valuta del tuo account impact.com.
CustomerStatus	Opzionale	Modificabile	Imposta lo stato del cliente al momento della conversione, ad esempio NEW / EXISTING.
Motivo	Obbligatorio	Modificabile	Fornisci un codice motivo valido per la modifica.

*Deve essere fornito almeno un percorso identificativo, ossia sia ActionId o (*OrderId/Oid *+ ActionTrackerId)

File modello

• Modello per modifiche a livello di ordine

• Modello per approvazioni a livello di ordine

Annullamenti a livello di ordine

Questo serve quando vuoi annullare in blocco azioni generate dal partner a livello di ordine anziché a livello di articolo, ad esempio annullare più ordini.

Parametri accettati

Campo	Obbligatorio?	Modificabile?	Nota
ActionID	Obbligatorio condizionalmente*	Non modificabile	Fornire questo identificatore è consigliato quando la finestra di deduplicazione è breve.
Oid / OrderId	Obbligatorio condizionalmente*	Non modificabile	Fornire questo identificatore è richiesto quando si utilizza ActionTrackerId.
ActionTrackerID	Obbligatorio condizionalmente*	Non modificabile	Fornire questo identificatore è richiesto quando si utilizza OrderId/Oid.
Importo	Obbligatorio condizionalmente**	Modificabile	Imposta su 0 per annullare l’ordine, a meno che l’importo originale = 0**
Motivo	Obbligatorio	Modificabile	Fornisci un codice motivo valido per l’annullamento.

*Deve essere fornito almeno un percorso identificativo, ossia sia ActionId o (OrderId/Oid + ActionTrackerId)

**Se l’originale Importo = 0, lascia Importo invariato per evitare di classificarlo erroneamente come una modifica.

File modello

• Modello per annullamenti a livello di ordine

Modifiche a livello di articolo

Questo serve quando vuoi aggiornare i dati dell’azione in blocco a livello di articolo anziché a livello di ordine, ad esempio modificare l’importo per più articoli in un ordine.

Parametri accettati

Campo	Obbligatorio?	Modificabile?	Nota
ActionID	Obbligatorio condizionalmente*	Non modificabile	Fornire questo identificatore è consigliato quando la finestra di deduplicazione è breve.
Oid / OrderId	Obbligatorio condizionalmente*	Non modificabile	Fornire questo identificatore è richiesto quando si utilizza ActionTrackerId.
ActionTrackerID	Obbligatorio condizionalmente*	Non modificabile	Fornire questo identificatore è richiesto quando si utilizza OrderId/Oid.
SKU**	Obbligatorio	Non modificabile	Fornisci il valore SKU dell’articolo che vuoi modificare.
Importo**	Obbligatorio condizionalmente	Modificabile	Imposta il nuovo importo dell’articolo, cioè prezzo*quantità. Se modifichi la quantità, anche questo campo deve essere modificato.
Quantità**	Opzionale	Modificabile	Imposta la nuova quantità di articoli nell’ordine.
Categoria**	Opzionale	Modificabile	Imposta la categoria dell’articolo.
Motivo**	Obbligatorio	Modificabile	Fornisci un codice motivo valido per l’annullamento.

*Deve essere fornito almeno un percorso identificativo, ossia sia ActionId o (OrderId/Oid + ActionTrackerId)

**Questi campi devono essere inclusi per ogni articolo che modifichi. I campi identificativi sono inclusi una sola volta per ordine.

File modello

• Modello per modifiche a livello di articolo

• Modello per approvazioni a livello di articolo

Annullamenti a livello di articolo

Questo serve quando vuoi annullare i dati dell’azione in blocco a livello di articolo anziché a livello di ordine, ad esempio annullare più articoli in un ordine.

Parametri accettati

Campo	Obbligatorio?	Modificabile?	Nota
ActionID	Obbligatorio condizionalmente*	Non modificabile	Fornire questo identificatore è consigliato quando la finestra di deduplicazione è breve.
Oid / OrderId	Obbligatorio condizionalmente*	Non modificabile	Fornire questo identificatore è richiesto quando si utilizza ActionTrackerId.
ActionTrackerID	Obbligatorio condizionalmente*	Non modificabile	Fornire questo identificatore è richiesto quando si utilizza OrderId/Oid.
SKU**	Obbligatorio	Non modificabile	Fornisci il valore SKU dell’articolo che vuoi modificare.
Importo**	Obbligatorio condizionalmente	Modificabile	Imposta il nuovo importo dell’articolo, cioè prezzo*quantità. Se modifichi la quantità, anche questo campo deve essere modificato.
Quantità**	Opzionale	Modificabile	Imposta la nuova quantità di articoli nell’ordine.
Motivo**	Obbligatorio	Modificabile	Fornisci un codice motivo valido per la modifica.

*Deve essere fornito almeno un percorso identificativo, ossia sia ActionId o (OrderId/Oid + ActionTrackerId)

**Questi campi devono essere inclusi per ogni articolo che modifichi. I campi identificativi sono inclusi una sola volta per ordine.

File modello

• Modello per annullamenti a livello di articolo

Lo SKU O7427540 appare due volte in questo esempio perché una riga sta annullando (Importo=0) e una sta modificando (Importo=15).

Nota: Se prevedi di avere OrderId duplicati e scegli di usare la combinazione di OrderId + ActionTrackerId, impact.com applica l’aggiornamento al più recente ActionId per impostazione predefinita. Usa il vecchio ActionId se vuoi applicare l’aggiornamento al più vecchio ActionId.

Codici motivo

Ogni volta che modifichi o annulli dati di azione, devi fornire un motivo. Usa il codice motivo pertinente qui sotto per spiegare perché l’azione viene aggiornata.

Avvertenza: L’invio di un valore non accettato farà sì che la voce non venga elaborata e che venga invece restituito un errore. Se hai bisogno di codici motivo personalizzati, contatta il tuo CSM oppure contatta l'assistenza per discutere i Codici di Disposizione.