# Riferimento per modifiche e revoche in batch

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](https://help.impact.com/brand/it/cosa-vorresti-imparare/platform-features/submit-and-modify-conversion-data/submit-batch-modifications-and-reversals#submit-your-data-file-0-1) file.

{% hint style="info" %}
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](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 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.

<details>

<summary>Parametri accettati</summary>

| 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*)

</details>

<details>

<summary>File modello</summary>

* [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)

</details>

#### 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.

<details>

<summary>Parametri accettati</summary>

| 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.

</details>

<details>

<summary>File modello</summary>

* [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)

</details>

#### 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.

<details>

<summary>Parametri accettati</summary>

| 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.

</details>

<details>

<summary>File modello</summary>

* [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)

</details>

#### 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.

<details>

<summary>Parametri accettati</summary>

| 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.

</details>

<details>

<summary>File modello</summary>

* [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 (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 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 di 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 che venga invece restituito un errore. Se hai bisogno di codici motivo personalizzati, contatta il tuo CSM oppure [**contatta l'assistenza**](https://app.impact.com/support/portal.ihtml?createTicket=true&) **per discutere i Codici di Disposizione**.
{% endhint %}