Riferimento a modifiche e annullamenti in batch

Quando modifichi o annulli in blocco i dati delle azioni, 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 nella tabella di riferimento pertinente per garantire che l’invio del file sia formattato correttamente. Una volta che il file da inviare è pronto, puoi riprendere con l’invio del file delle tue modifiche / annullamenti in batch.

Questo articolo di riferimento include i campi più comunemente usati per le modifiche e gli annullamenti in batch. Per vedere un riferimento completo e dettagliato, inclusi i descrittori dei campi, fai riferimento a Riferimenti dei campi di Azioni e Conversioni.

Consulta i riferimenti qui sotto per:

• Scoprire quali campi usare in una modifica o annullamento in batch via FTP/SMTP
• Scaricare file modello con dati di esempio segnaposto
• Capire quali codici motivo applicare e quando

Modifiche a livello ordine

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

Parametri accettati

Campo	Obbligatorio?	Modificabile?	Nota
ActionID	Obbligatorio in modo condizionale*	Non modificabile	Fornire questo identificativo è consigliato quando la finestra di deduplicazione è breve.
Oid / OrderId	Obbligatorio in modo condizionale*	Non modificabile	Fornire questo identificativo è obbligatorio quando si utilizza ActionTrackerId.
ActionTrackerID	Obbligatorio in modo condizionale*	Non modificabile	Fornire questo identificativo è obbligatorio quando si utilizza OrderId/Oid.
Importo	Facoltativo	Modificabile	Imposta il nuovo importo totale dell’ordine.
currencyCode	Facoltativo	Modificabile	Imposta la valuta del ricavo dell’azione. Per impostazione predefinita, se non specificata, viene utilizzata la valuta del tuo account impact.com.
CustomerStatus	Facoltativo	Modificabile	Imposta lo stato del cliente al momento della conversione, ad esempio NEW / EXISTING.
Nota	Facoltativo	Modificabile	Campo generico per finalità di reporting a livello di evento. Se è vuoto nella conversione originale, l’invio di un valore lo inserisce. Accettato solo una volta per azione — invia eventuali altre modifiche ai campi nella stessa richiesta.
LocationId	Facoltativo	Modificabile	Usato principalmente per le strutture ricettive, è l’identificativo univoco della località specificata in questa conversione. Se è vuoto nella conversione originale, l’invio di un valore lo inserisce.
LocationName	Facoltativo	Modificabile	Usato principalmente per le strutture ricettive, è il nome della località specificata in questa conversione. Se è vuoto nella conversione originale, l’invio di un valore lo inserisce.
GiftPurchase	Facoltativo	Modificabile	Imposta su true per contrassegnare l’ordine come acquisto regalo, oppure su false per rimuovere il contrassegno. Se è vuoto nella conversione originale, l’invio di un valore lo inserisce.
Text1–Text50	Facoltativo	Modificabile	Campi di testo generali che accettano stringhe di qualsiasi dato testuale desideri inviare (Text1 fino a Text50). Se è vuoto nella conversione originale, l’invio di un valore lo inserisce. Accettato solo una volta per azione — invia eventuali altre modifiche ai campi nella stessa richiesta.
Motivo	Obbligatorio	Modificabile	Fornisci un codice motivo valido per la modifica.

*Deve essere fornito almeno un percorso identificativo, cioè, ad esempio ActionId oppure (*OrderId/Oid *+ ActionTrackerId)

File modello

• Modello per modifiche a livello ordine
• Modello per approvazioni a livello ordine

Annullamenti a livello ordine

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

Parametri accettati

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

*Deve essere fornito almeno un percorso identificativo, cioè, ad esempio ActionId oppure (OrderId/Oid + ActionTrackerId)

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

File modello

• Modello per annullamenti a livello ordine

Modifiche a livello articolo

Questo serve quando vuoi aggiornare in blocco i dati delle azioni a livello di singolo 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 in modo condizionale*	Non modificabile	Fornire questo identificativo è consigliato quando la finestra di deduplicazione è breve.
Oid / OrderId	Obbligatorio in modo condizionale*	Non modificabile	Fornire questo identificativo è obbligatorio quando si utilizza ActionTrackerId.
ActionTrackerID	Obbligatorio in modo condizionale*	Non modificabile	Fornire questo identificativo è obbligatorio quando si utilizza OrderId/Oid.
SKU**	Obbligatorio	Non modificabile	Fornisci il valore SKU dell’articolo che vuoi modificare.
Importo**	Obbligatorio in modo condizionale	Modificabile	Imposta il nuovo importo dell’articolo, cioè prezzo*quantità. Se modifichi la quantità, anche questo campo deve essere modificato.
Quantità**	Facoltativo	Modificabile	Imposta la nuova quantità di articoli nell’ordine.
Categoria**	Facoltativo	Modificabile	Imposta la categoria dell’articolo.
Motivo**	Obbligatorio	Modificabile	Fornisci un codice motivo valido per l’annullamento.

*Deve essere fornito almeno un percorso identificativo, cioè, ad esempio ActionId oppure (OrderId/Oid + ActionTrackerId)

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

File modello

• Modello per modifiche a livello articolo
• Modello per approvazioni a livello articolo

Annullamenti a livello articolo

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

Parametri accettati

Campo	Obbligatorio?	Modificabile?	Nota
ActionID	Obbligatorio in modo condizionale*	Non modificabile	Fornire questo identificativo è consigliato quando la finestra di deduplicazione è breve.
Oid / OrderId	Obbligatorio in modo condizionale*	Non modificabile	Fornire questo identificativo è obbligatorio quando si utilizza ActionTrackerId.
ActionTrackerID	Obbligatorio in modo condizionale*	Non modificabile	Fornire questo identificativo è obbligatorio quando si utilizza OrderId/Oid.
SKU**	Obbligatorio	Non modificabile	Fornisci il valore SKU dell’articolo che vuoi modificare.
Importo**	Obbligatorio in modo condizionale	Modificabile	Imposta il nuovo importo dell’articolo, cioè prezzo*quantità. Se modifichi la quantità, anche questo campo deve essere modificato.
Quantità**	Facoltativo	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, cioè, ad esempio ActionId oppure (OrderId/Oid + ActionTrackerId)

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

File modello

• Modello per annullamenti a livello articolo

L’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 utilizzare 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 i dati di un’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 restituisca invece un errore. Se hai bisogno di codici motivo personalizzati, contatta il tuo CSM oppure contatta il supporto per discutere i codici di disposizione.

Codice	Descrizione
CONS_FRAUD	Frode del consumatore
CONS_ERROR	Errore del consumatore
ITEM_RETURNED	L'articolo è stato restituito
APPROVED	L'azione è approvata Nota: Se stai cercando di approvare le azioni, Approva deve essere impostato come un codice di disposizione personalizzato.
ORDER_ERROR	Errore dell'ordine
ORDER_UPDATE	L'ordine è stato aggiornato
PUB_ACT_DISPUTE	Controversia sull'attività del partner
ADV_ACT_DISPUTE	Controversia sull'attività del brand
NOT_COMPLIANCE_TERMS	Non conforme ai termini
ITEM_OUT_OF_STOCK	L'articolo è esaurito
TEST_ACTION	Azione di prova
PARTNER_NOT_ACTIVE	Account partner disattivato
CREDITED_DIFFERENT_MP	Accreditato a un altro partner
ALTRO	Altro motivo