# Modifica o annulla voci in un'azione tramite API

Oltre a modificare e annullare le azioni, impact.com ti consente di modificare e annullare i dettagli a livello di articolo di un'azione.

{% hint style="info" %}
**Nota:** impact.com consente un massimo di 1000 modifiche per azione. Se hai bisogno di effettuare ulteriori modifiche successivamente, [contatta il supporto](https://app.impact.com/support/portal.ihtml).
{% endhint %}

#### Modificare gli articoli in un'azione tramite API

Se stai monitorando a livello di articolo (cioè passando i dati degli articoli quando segnali le conversioni), puoi utilizzare l'API per modificare la quantità o l'importo di ricavo riportato degli articoli all'interno di un'azione.

Per modificare gli articoli in un'azione, ti serviranno:

* L' `ActionId` dell'azione.
* L' `Motivo` dell'aggiornamento dell'azione (quando si modificano gli articoli in un'azione, invia sempre `ORDER_UPDATE`).
* L' `Sku` degli articolo/i da modificare (può essere trovato recuperando un'azione tramite API).
* Il nuovo `Quantity` valore per l'articolo.
* Il nuovo ricavo `Amount` valore per l'articolo — includi questo campo nella chiamata solo se questo valore cambia (ad es. l'importo di ricavo dell'articolo è stato segnalato in modo errato).

Una volta che avrai tutti questi valori, vedi gli esempi di chiamate qui sotto per imparare come modificare un articolo all'interno di un'azione.

<details>

<summary>Esempi di chiamate e risposta</summary>

**Nuova quantità dell'articolo**

```bash
curl 'https://api.impact.com/Advertisers/{AccountSID}/Actions' \
  -X PUT \
  -u '{AccountSID}:{AuthToken}' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'ActionId={ActionId}' \
  -d 'Sku={Sku}' \
  -d 'Quantity={Quantity}' \
  -d 'Reason=ORDER_UPDATE' \
```

**Nuovo importo di ricavo dell'articolo**

```bash
  curl 'https://api.impact.com/Advertisers/{AccountSID}/Actions' \
    -X PUT \
    -u '{AccountSID}:{AuthToken}' \
    -H 'Accept: application/json' \
    -H 'Content-Type: application/x-www-form-urlencoded' \
    -d 'ActionId={ActionId}' \
    -d 'Sku={Sku}' \
    -d 'Amount={Amount}' \
    -d 'Reason=ORDER_UPDATE' \
```

</details>

<details>

<summary>Esempio di risposta</summary>

```json
{
  "Status": "QUEUED",
  "QueuedUri": "/Advertisers/{AccountSID}/APISubmissions/A-86b9-56992f50eefe"
}
```

</details>

<details>

<summary>Riferimento parametri</summary>

| `AccountId` | Il valore ID dell'account API del tuo account impact.com. [Scopri come trovare questo valore](https://help.impact.com/brand/it/account-administration/account-settings/api-tokens/manage-api-access-tokens-as-a-brand).             |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `AuthToken` | Il valore del token di autorizzazione API del tuo account impact.com. [Scopri come trovare questo valore](https://help.impact.com/brand/it/account-administration/account-settings/api-tokens/manage-api-access-tokens-as-a-brand). |
| `ActionId`  | Il valore ID dell'azione da modificare.                                                                                                                                                                                             |
| `Sku`       | Il valore SKU (unità di gestione del magazzino) dell'articolo — questo può essere trovato recuperando un'azione tramite API.                                                                                                        |
| `Quantity`  | Il nuovo valore di quantità per l'articolo.                                                                                                                                                                                         |
| `Motivo`    | Quando annulli o modifichi un articolo, invia sempre `ORDER_UPDATE` come motivo.                                                                                                                                                    |
| `Amount`    | Il nuovo valore dell'importo di ricavo per l'articolo.                                                                                                                                                                              |

</details>

#### Annullare gli articoli in un'azione tramite API

Se stai monitorando a livello di articolo (cioè passando i dati degli articoli quando segnali le conversioni), puoi utilizzare l'API per annullare uno o più articoli impostando `Quantity` a `0`.

Per annullare gli articoli in un'azione, ti serviranno:

* L' `ActionId` dell'azione.
* L' `Motivo` per l'aggiornamento dell'azione (quando si annullano articoli in un'azione, invia sempre `ORDER_UPDATE`).
* L' `Sku` degli articolo/i da annullare (può essere trovato recuperando un'azione tramite API).
* Il nuovo `Quantity` valore per l'articolo — in questo caso, `0`

Una volta che avrai tutti questi valori, vedi l'esempio di chiamata qui sotto per imparare come annullare gli articoli in un'azione.

<details>

<summary>Esempio di chiamata e risposta</summary>

```bash
curl 'https://api.impact.com/Advertisers/{AccountSID}/Actions' \
  -X PUT \
  -u '{AccountSID}:{AuthToken}' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'ActionId={ActionId}' \
  -d 'Sku={Sku}' \
  -d 'Quantity=0' \
  -d 'Reason=ORDER_UPDATE'
```

</details>

<details>

<summary>Esempio di risposta</summary>

```json
{
  "Status": "QUEUED",
  "QueuedUri": "/Advertisers/{AccountSID}/APISubmissions/A-86b9-56992f50eefe"
}  
```

</details>

<details>

<summary>Riferimento parametri</summary>

| `AccountId` | Il valore ID dell'account API del tuo account impact.com. [Scopri come trovare questo valore](https://help.impact.com/brand/it/account-administration/account-settings/api-tokens/manage-api-access-tokens-as-a-brand).             |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `AuthToken` | Il valore del token di autorizzazione API del tuo account impact.com. [Scopri come trovare questo valore](https://help.impact.com/brand/it/account-administration/account-settings/api-tokens/manage-api-access-tokens-as-a-brand). |
| `ActionId`  | Il valore ID dell'azione da modificare.                                                                                                                                                                                             |
| `Sku`       | Il valore SKU (unità di gestione del magazzino) dell'articolo — questo può essere trovato recuperando un'azione tramite API.                                                                                                        |
| `Quantity`  | Il nuovo valore di quantità per l'articolo.                                                                                                                                                                                         |
| `Motivo`    | Quando annulli o modifichi un articolo, invia sempre `ORDER_UPDATE` come motivo.                                                                                                                                                    |

</details>
