# 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 il file inviato sia formattato correttamente. Una volta che il file di invio è pronto, puoi continuare con [l'invio delle tue modifiche / annullamenti batch](https://help.impact.com/brand/it/su-cosa-vorresti-saperne-di-piu/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 usati per modifiche e annullamenti batch. Per vedere un riferimento completo e dettagliato incluse le descrizioni dei campi, fai riferimento a [Riferimenti ai campi di Azione & Conversione](https://integrations.impact.com/impact-brand/reference/action-conversion-field-references).
{% endhint %}

**Consulta i riferimenti seguenti per:**

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

#### Modifiche a livello di ordine

Questo è per quando vuoi aggiornare i dati delle azioni 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 in modo condizionale\* | Non modificabile | Fornire questo identificatore è consigliato quando la finestra di deduplicazione è breve.                                          |
| `Oid / OrderId`   | Obbligatorio in modo condizionale\* | Non modificabile | Fornire questo identificatore è richiesto quando si utilizza *ActionTrackerId*.                                                    |
| `ActionTrackerID` | Obbligatorio in modo condizionale\* | 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 assume la valuta del tuo account impact.com se non fornita. |
| `CustomerStatus`  | Opzionale                           | Modificabile     | Imposta lo stato del cliente al momento della conversione, ad es., NEW / EXISTING.                                                 |
| `Reason`          | 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 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 è per quando vuoi annullare in blocco azioni guidate dal partner a livello di ordine anziché a livello di articolo, ad es., annullare più ordini.

<details>

<summary>Parametri accettati</summary>

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

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

\*\*Se l' *Importo = 0*, lascia *Importo* invariato per evitare di classificare erroneamente come 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 è per quando vuoi aggiornare i dati delle azioni in blocco a livello di articolo anziché a livello di ordine, ad es., modificare l'importo per più articoli in un ordine.

<details>

<summary>Parametri accettati</summary>

| Campo             | Obbligatorio?                       | Modificabile?    | Nota                                                                                                                              |
| ----------------- | ----------------------------------- | ---------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `ActionID`        | Obbligatorio in modo condizionale\* | Non modificabile | Fornire questo identificatore è consigliato quando la finestra di deduplicazione è breve.                                         |
| `Oid / OrderId`   | Obbligatorio in modo condizionale\* | Non modificabile | Fornire questo identificatore è richiesto quando si utilizza *ActionTrackerId*.                                                   |
| `ActionTrackerID` | Obbligatorio in modo condizionale\* | 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 in modo condizionale   | Modificabile     | Imposta il nuovo importo dell'articolo, cioè prezzo\*quantità. Se modifichi la quantità, anche questo campo richiede la modifica. |
| `Quantità`\*\*    | Opzionale                           | Modificabile     | Imposta la nuova quantità di articoli nell'ordine.                                                                                |
| `Categoria`\*\*   | Opzionale                           | Modificabile     | Imposta la categoria dell'articolo.                                                                                               |
| `Reason`\*\*      | Obbligatorio                        | Modificabile     | Fornisci un codice motivo valido per l'annullamento.                                                                              |

\*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 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 è per quando vuoi annullare i dati delle azioni in blocco a livello di articolo anziché a livello di ordine, ad es., annullare più articoli in un ordine.

<details>

<summary>Parametri accettati</summary>

| Campo             | Obbligatorio?                       | Modificabile?    | Nota                                                                                                                              |
| ----------------- | ----------------------------------- | ---------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `ActionID`        | Obbligatorio in modo condizionale\* | Non modificabile | Fornire questo identificatore è consigliato quando la finestra di deduplicazione è breve.                                         |
| `Oid / OrderId`   | Obbligatorio in modo condizionale\* | Non modificabile | Fornire questo identificatore è richiesto quando si utilizza *ActionTrackerId*.                                                   |
| `ActionTrackerID` | Obbligatorio in modo condizionale\* | 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 in modo condizionale   | Modificabile     | Imposta il nuovo importo dell'articolo, cioè prezzo\*quantità. Se modifichi la quantità, anche questo campo richiede la modifica. |
| `Quantità`\*\*    | Opzionale                           | Modificabile     | Imposta la nuova quantità di articoli nell'ordine.                                                                                |
| `Reason`\*\*      | 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 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).

</details>

{% hint style="info" %}
**Nota:** Nota: Se prevedi di avere OrderId duplicati *OrderIds* 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:** Passare un valore non accettato comporterà che la voce non venga elaborata e che venga restituito 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 %}
