# Riferimento per modifiche e annullamenti in blocco

Quando modifichi o reversi 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 modifiche / revoche in batch](/brand/it/che-cosa-vorresti-imparare/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.md#submit-your-data-file-0-1) del file.

{% hint style="info" %}
Questo articolo di riferimento include i campi più comunemente usati per le modifiche e le revoche in batch. Per vedere un riferimento completo e dettagliato, incluse le descrizioni dei campi, fai riferimento a [Riferimenti dei campi Azione & Conversione](https://integrations.impact.com/impact-brand/reference/action-conversion-field-references).
{% endhint %}

**Consulta i riferimenti qui sotto per:**

* Scoprire quali campi utilizzare in una modifica o revoca batch 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 in blocco i dati dell'azione a livello di ordine anziché a livello di articolo, ad es. modificare l'importo dell'ordine per più ordini.

<details>

<summary>Parametri accettati</summary>

| 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 dei ricavi dell'azione. Per impostazione predefinita viene usata la valuta del tuo account impact.com se non viene fornita. |
| `CustomerStatus`  | Facoltativo                         | Modificabile     | Imposta lo stato del cliente al momento della conversione, ad es. NUOVO / ESISTENTE.                                                          |
| `Motivo`          | Obbligatorio                        | Modificabile     | Fornisci un codice motivo valido per la modifica.                                                                                             |

\*Deve essere fornito almeno un percorso identificativo, cioè o *ActionId* **o** (\*OrderId/Oid \*+ *ActionTrackerId*)

</details>

<details>

<summary>File modello</summary>

* [Modello di modifiche a livello di ordine](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_modifications_template.csv)
* [Modello di approvazioni a livello di ordine](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_approvals_template.csv)

</details>

#### Revoche a livello di ordine

Questo serve quando vuoi revocare in blocco le azioni generate dai partner a livello di ordine anziché a livello di articolo, ad es. revocare più ordini.

<details>

<summary>Parametri accettati</summary>

| 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 revocare l'ordine, a meno che importo originale = 0\*\*              |
| `Motivo`          | Obbligatorio                          | Modificabile     | Fornisci un codice motivo valido per la revoca.                                           |

\*Deve essere fornito almeno un percorso identificativo, cioè o *ActionId* **o** (*OrderId/Oid* + *ActionTrackerId*)

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

</details>

<details>

<summary>File modello</summary>

* [Modello di revoche a livello di ordine](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_reversals_template.csv)

</details>

#### Modifiche a livello di articolo

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

<details>

<summary>Parametri accettati</summary>

| 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 richiede una modifica. |
| `Quantità`\*\*    | Facoltativo                         | Modificabile     | Imposta la nuova quantità di articoli nell'ordine.                                                                                 |
| `filtro`\*\*      | Facoltativo                         | Modificabile     | Imposta la categoria dell'articolo.                                                                                                |
| `Motivo`\*\*      | Obbligatorio                        | Modificabile     | Fornisci un codice motivo valido per la revoca.                                                                                    |

\*Deve essere fornito almeno un percorso identificativo, cioè o *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.

</details>

<details>

<summary>File modello</summary>

* [Modello di modifiche a livello di articolo](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_modifications_template.csv)
* [Modello di approvazioni a livello di articolo](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_approvals_template.csv)

</details>

#### Revoche a livello di articolo

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

<details>

<summary>Parametri accettati</summary>

| 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 richiede una modifica. |
| `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è o *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.

</details>

<details>

<summary>File modello</summary>

* [Modello di revoche a livello di articolo](https://res.cloudinary.com/product-enablement/raw/upload/v1768298926/CSVs/Batch%20Action%20Processing/Item-level_reversals_template.csv)

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

</details>

{% hint style="info" %}
**Nota:** Se prevedi di avere *OrderId 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 revochi 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" %}
**Avviso:** 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 il supporto**](https://app.impact.com/support/portal.ihtml?createTicket=true&) **per discutere dei codici di disposizione**.
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://help.impact.com/brand/it/che-cosa-vorresti-imparare/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.