> 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 a modifiche e annullamenti in batch Quando modifichi o annulli dati delle azioni in blocco, inizia scaricando uno dei file modello forniti da impact.com e sostituisci 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 il tuo file inviato sia formattato correttamente. Una volta che il file di invio è pronto, puoi riprendere con l'invio del file delle modifiche/annullamenti in batch. {% hint style="info" %} 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 che includa le descrizioni dei campi, fai riferimento a [Riferimenti ai campi di azione e conversione](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references). {% endhint %} **Vedi i riferimenti qui sotto per:** * Scopri quali campi usare per una modifica o un annullamento in batch via FTP/SMTP * Scarica i file modello con dati di esempio segnaposto * Capisci 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 invece che a livello di articolo, ad es. modificare l'importo dell'ordine per più ordini.
Parametri accettati | Campo | Obbligatorio? | Modificabile? | Nota | | ----------------- | ---------------------------------------- | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ActionID` | Obbligatorio in determinate condizioni\* | Non modificabile | Fornire questo identificatore è consigliato quando la finestra di deduplicazione è breve. | | `Oid / OrderId` | Obbligatorio in determinate condizioni\* | Non modificabile | Fornire questo identificatore è richiesto quando si utilizza *ActionTrackerId*. | | `ActionTrackerID` | Obbligatorio in determinate condizioni\* | Non modificabile | Fornire questo identificatore è richiesto quando si utilizza *OrderId/Oid*. | | `Amount` | Facoltativo | Modificabile | Imposta il nuovo importo totale dell'ordine. | | `currencyCode` | Facoltativo | Modificabile | Imposta la valuta dei ricavi dell'azione. Se non specificata, il valore predefinito è la valuta del tuo account impact.com. | | `CustomerStatus` | Facoltativo | Modificabile | Imposta lo stato del cliente al momento della conversione, ad es. 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 strutture ricettive, è l'identificatore 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 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 generici che accettano stringhe di qualsiasi dato testuale che 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 di identificazione, ossia uno dei due: *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)
#### 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 es. annullare più ordini.
Parametri accettati | Campo | Obbligatorio? | Modificabile? | Nota | | ----------------- | ------------------------------------------ | ---------------- | ----------------------------------------------------------------------------------------- | | `ActionID` | Obbligatorio in determinate condizioni\* | Non modificabile | Fornire questo identificatore è consigliato quando la finestra di deduplicazione è breve. | | `Oid / OrderId` | Obbligatorio in determinate condizioni\* | Non modificabile | Fornire questo identificatore è richiesto quando si utilizza *ActionTrackerId*. | | `ActionTrackerID` | Obbligatorio in determinate condizioni\* | Non modificabile | Fornire questo identificatore è richiesto quando si utilizza *OrderId/Oid*. | | `Amount` | Obbligatorio in determinate condizioni\*\* | 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 di identificazione, ossia uno dei due: *ActionId* **o** (*OrderId/Oid* + *ActionTrackerId*) \*\*Se l'originale *Amount = 0*, lascia *Amount* invariato per evitare che venga classificato erroneamente come modifica.
File modello * [Modello per annullamenti 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 articolo Questo serve quando vuoi aggiornare i dati dell'azione in blocco a livello di articolo invece che a livello di ordine, ad es. modificare l'importo per più articoli in un ordine.
Parametri accettati | Campo | Obbligatorio? | Modificabile? | Nota | | ----------------- | ---------------------------------------- | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------- | | `ActionID` | Obbligatorio in determinate condizioni\* | Non modificabile | Fornire questo identificatore è consigliato quando la finestra di deduplicazione è breve. | | `Oid / OrderId` | Obbligatorio in determinate condizioni\* | Non modificabile | Fornire questo identificatore è richiesto quando si utilizza *ActionTrackerId*. | | `ActionTrackerID` | Obbligatorio in determinate condizioni\* | Non modificabile | Fornire questo identificatore è richiesto quando si utilizza *OrderId/Oid*. | | `SKU`\*\* | Obbligatorio | Non modificabile | Fornisci il valore SKU dell'articolo che desideri modificare. | | `Amount`\*\* | Obbligatorio in determinate condizioni | 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 di identificazione, ossia uno dei due: *ActionId* **o** (*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 di articolo](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_modifications_template.csv) * [Modello per approvazioni a livello di articolo](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_approvals_template.csv)
#### Annullamenti a livello di articolo Questo serve quando vuoi annullare in blocco i dati delle azioni a livello di articolo anziché a livello di ordine, ad es. annullare più articoli in un ordine.
Parametri accettati | Campo | Obbligatorio? | Modificabile? | Nota | | ----------------- | ---------------------------------------- | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------- | | `ActionID` | Obbligatorio in determinate condizioni\* | Non modificabile | Fornire questo identificatore è consigliato quando la finestra di deduplicazione è breve. | | `Oid / OrderId` | Obbligatorio in determinate condizioni\* | Non modificabile | Fornire questo identificatore è richiesto quando si utilizza *ActionTrackerId*. | | `ActionTrackerID` | Obbligatorio in determinate condizioni\* | Non modificabile | Fornire questo identificatore è richiesto quando si utilizza *OrderId/Oid*. | | `SKU`\*\* | Obbligatorio | Non modificabile | Fornisci il valore SKU dell'articolo che desideri modificare. | | `Amount`\*\* | Obbligatorio in determinate condizioni | 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 di identificazione, ossia uno dei due: *ActionId* **o** (*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 di articolo](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 annullando (Amount=0) e una sta modificando (Amount=15).
{% hint style="info" %} **Nota:** Se prevedi di avere duplicati *OrderIds* 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*. {% endhint %} #### Codici motivo Ogni volta che modifichi o annulli dati delle azioni, devi fornire un motivo. Usa il codice motivo pertinente qui sotto per spiegare perché l'azione viene aggiornata. {% hint style="warning" %} **Attenzione:** 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 l'assistenza**](https://app.impact.com/support/portal.ihtml?createTicket=true&) **per discutere i codici di disposizione**. {% endhint %}
CodeDescription
CONS_FRAUDConsumer fraud
CONS_ERRORConsumer error
ITEM_RETURNEDItem was returned
APPROVED

Action is approved

Note: If you’re trying to approve actions, Approve needs to be set up as a custom disposition code.

ORDER_ERROROrder error
ORDER_UPDATEOrder was updated
PUB_ACT_DISPUTEPartner activity dispute
ADV_ACT_DISPUTEBrand activity dispute
NOT_COMPLIANCE_TERMSNot in compliance with terms
ITEM_OUT_OF_STOCKItem is out of stock
TEST_ACTIONTest action
PARTNER_NOT_ACTIVEPartner account deactivated
CREDITED_DIFFERENT_MPCredited to another partner
OTHEROther reason
--- # 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/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 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.