> 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/batch-modifications-and-reversals-reference.md). # Riferimento per modifiche e annullamenti in batch Quando si modificano o si annullano 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 di invio è pronto, puoi riprendere con [l'invio delle tue modifiche/reversioni in batch](/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#submit-your-data-file-0-1) file. {% hint style="info" %} Questo articolo di riferimento include i campi più comunemente usati per modifiche e reversioni in batch. Per vedere un riferimento completo e dettagliato, inclusi i descrizioni dei campi, fai riferimento a [Riferimenti ai campi di azioni e conversioni](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references). {% endhint %} **Consulta i riferimenti qui sotto per:** * Scoprire quali campi utilizzare in una modifica o reversione in batch FTP/SMTP * Scaricare file modello con dati di esempio segnaposto * Comprendere quali codici motivo applicare e quando #### Modifiche a livello di ordine Questo serve quando vuoi aggiornare i dati delle azioni in blocco a livello di ordine anziché a livello di elemento, 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 è obbligatorio quando si usa *ActionTrackerId*. | | `ActionTrackerID` | Obbligatorio condizionalmente\* | Non modificabile | Fornire questo identificatore è obbligatorio quando si usa *OrderId/Oid*. | | `Importo` | Opzionale | Modificabile | Imposta il nuovo importo totale dell'ordine. | | `currencyCode` | Opzionale | Modificabile | Imposta la valuta del ricavo dell'azione. Se non specificato, l'impostazione predefinita è 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, cioè oppure *ActionId* **o** (\*OrderId/Oid \*+ *ActionTrackerId*)
File modello * [Modello per modifiche a livello di ordine](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_modifications_template.csv) * [Modello per approvazioni a livello di ordine](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_approvals_template.csv)
#### Reversioni a livello di ordine Questo serve quando vuoi annullare in blocco le azioni guidate dal partner a livello di ordine anziché a livello di elemento, 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 è obbligatorio quando si usa *ActionTrackerId*. | | `ActionTrackerID` | Obbligatorio condizionalmente\* | Non modificabile | Fornire questo identificatore è obbligatorio quando si usa *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 la reversione. | \*Deve essere fornito almeno un percorso identificativo, cioè oppure *ActionId* **o** (*OrderId/Oid* + *ActionTrackerId*) \*\*Se l'originale *Importo = 0*, lascia *Importo* invariato per evitare di essere classificato erroneamente come una modifica.
File modello * [Modello per reversioni a livello di ordine](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_reversals_template.csv)
#### Modifiche a livello di elemento Questo serve quando vuoi aggiornare i dati delle azioni in blocco a livello di elemento anziché a livello di ordine, ad esempio modificare l'importo per più elementi 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 è obbligatorio quando si usa *ActionTrackerId*. | | `ActionTrackerID` | Obbligatorio condizionalmente\* | Non modificabile | Fornire questo identificatore è obbligatorio quando si usa *OrderId/Oid*. | | `SKU`\*\* | Obbligatorio | Non modificabile | Fornisci il valore SKU dell'elemento che vuoi modificare. | | `Importo`\*\* | Obbligatorio condizionalmente | Modificabile | Imposta il nuovo importo dell'elemento, cioè prezzo\*quantità. Se modifichi la quantità, anche questo campo richiede una modifica. | | `Quantità`\*\* | Opzionale | Modificabile | Imposta la nuova quantità di elementi nell'ordine. | | `Categoria`\*\* | Opzionale | Modificabile | Imposta la categoria dell'elemento. | | `Motivo`\*\* | Obbligatorio | Modificabile | Fornisci un codice motivo valido per la reversione. | \*Deve essere fornito almeno un percorso identificativo, cioè oppure *ActionId* **o** (*OrderId/Oid* + *ActionTrackerId*) \*\*Questi campi devono essere inclusi per ogni elemento che modifichi. I campi identificativi sono inclusi una sola volta per ordine.
File modello * [Modello per modifiche a livello di elemento](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_modifications_template.csv) * [Modello per approvazioni a livello di elemento](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_approvals_template.csv)
#### Reversioni a livello di elemento Questo serve quando vuoi annullare in blocco i dati delle azioni a livello di elemento anziché a livello di ordine, ad esempio annullare più elementi 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 è obbligatorio quando si usa *ActionTrackerId*. | | `ActionTrackerID` | Obbligatorio condizionalmente\* | Non modificabile | Fornire questo identificatore è obbligatorio quando si usa *OrderId/Oid*. | | `SKU`\*\* | Obbligatorio | Non modificabile | Fornisci il valore SKU dell'elemento che vuoi modificare. | | `Importo`\*\* | Obbligatorio condizionalmente | Modificabile | Imposta il nuovo importo dell'elemento, cioè prezzo\*quantità. Se modifichi la quantità, anche questo campo richiede una modifica. | | `Quantità`\*\* | Opzionale | Modificabile | Imposta la nuova quantità di elementi nell'ordine. | | `Motivo`\*\* | Obbligatorio | Modificabile | Fornisci un codice motivo valido per la modifica. | \*Deve essere fornito almeno un percorso identificativo, cioè oppure *ActionId* **o** (*OrderId/Oid* + *ActionTrackerId*) \*\*Questi campi devono essere inclusi per ogni elemento che modifichi. I campi identificativi sono inclusi una sola volta per ordine.
File modello * [Modello per reversioni a livello di elemento](https://res.cloudinary.com/product-enablement/raw/upload/v1768298926/CSVs/Batch%20Action%20Processing/Item-level_reversals_template.csv) Lo SKU O7427540 appare due volte in questo esempio perché una riga sta eseguendo la reversione (Importo=0) e una sta eseguendo la modifica (Importo=15).
{% hint style="info" %} **Nota:** Se prevedi di avere *OrderIds* duplicati e scegli di usare la combinazione di *OrderId + ActionTrackerId*, impact.com applica il tuo aggiornamento al più recente *ActionId* per impostazione predefinita. Usa il vecchio *ActionId* se vuoi applicare l'aggiornamento al più vecchio *ActionId*. {% endhint %} #### 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. {% hint style="warning" %} **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 o [**contatta il supporto**](https://app.impact.com/support/portal.ihtml?createTicket=true&) **per discutere i codici di disposizione**. {% endhint %}
CodiceDescrizione
CONS_FRAUDFrode del consumatore
CONS_ERRORErrore del consumatore
ITEM_RETURNEDL'articolo è stato restituito
APPROVED

L'azione è approvata

Nota: Se stai cercando di approvare le azioni, approvarla deve essere impostato come un codice di disposizione personalizzato.

ORDER_ERRORErrore dell'ordine
ORDER_UPDATEL'ordine è stato aggiornato
PUB_ACT_DISPUTEControversia sull'attività del partner
ADV_ACT_DISPUTEControversia sull'attività del marchio
NOT_COMPLIANCE_TERMSNon conforme ai termini
ITEM_OUT_OF_STOCKL'articolo è esaurito
TEST_ACTIONAzione di test
PARTNER_NOT_ACTIVEAccount partner disattivato
CREDITED_DIFFERENT_MPAccreditato a un altro partner
ALTROAltro motivo
--- # 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/batch-modifications-and-reversals-reference.md?ask=&goal= ``` `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.