# Modificar ou Reverter Itens em uma Ação via API

Além de modificar e reverter ações, a impact.com permite que você modifique e reverta os detalhes de itens em nível de item de uma ação.

{% hint style="info" %}
**Observação:** A impact.com permite no máximo 1000 modificações por ação. Se você precisar fazer mais modificações depois disso, [entre em contato com o suporte](https://app.impact.com/support/portal.ihtml).
{% endhint %}

#### Modificar itens em uma ação via API

Se você estiver rastreando no nível de item (ou seja, enviando dados dos itens ao reportar conversões), pode usar a API para modificar a quantidade ou o valor de receita reportado dos itens dentro de uma ação.

Para modificar itens em uma ação, você precisará:

* O `ActionId` da ação.
* O `Motivo` para atualizar a ação (ao modificar itens em uma ação, sempre envie `ORDER_UPDATE`).
* O `Sku` do(s) item(ns) a ser(em) modificado(s) (pode ser encontrado ao recuperar uma ação via API).
* O novo `Quantity` valor para o item.
* O novo valor de `Amount` para o item — inclua isso na chamada somente se esse valor estiver mudando (por exemplo, o valor de receita reportado do item foi informado incorretamente).

Depois de ter todos esses valores, veja os exemplos de chamadas abaixo para aprender como modificar um item dentro de uma ação.

<details>

<summary>Chamadas de exemplo e resposta</summary>

**Nova quantidade do item**

```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' \
```

**Novo valor de receita do item**

```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>Resposta de exemplo</summary>

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

</details>

<details>

<summary>Referência de parâmetros</summary>

| `AccountId` | O valor do ID da conta de API da sua conta impact.com. [Saiba como encontrar esse valor](https://help.impact.com/brand/pt-br/account-administration/account-settings/api-tokens/manage-api-access-tokens-as-a-brand).          |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `AuthToken` | O valor do token de autorização da API da sua conta impact.com. [Saiba como encontrar esse valor](https://help.impact.com/brand/pt-br/account-administration/account-settings/api-tokens/manage-api-access-tokens-as-a-brand). |
| `ActionId`  | O valor de ID da ação a ser modificada.                                                                                                                                                                                        |
| `Sku`       | O valor do código de identificação do produto (SKU) do item — isso pode ser encontrado ao recuperar uma ação via API.                                                                                                          |
| `Quantity`  | O novo valor de quantidade para o item.                                                                                                                                                                                        |
| `Motivo`    | Ao reverter ou modificar um item, sempre envie `ORDER_UPDATE` como motivo.                                                                                                                                                     |
| `Amount`    | O novo valor do valor de receita para o item.                                                                                                                                                                                  |

</details>

#### Reverter itens em uma ação via API

Se você estiver rastreando no nível de item (ou seja, enviando dados dos itens ao reportar conversões), pode usar a API para reverter um ou mais itens definindo `Quantity` para `0`.

Para reverter itens em uma ação, você precisará:

* O `ActionId` da ação.
* O `Motivo` para atualizar a ação (ao reverter itens em uma ação, sempre envie `ORDER_UPDATE`).
* O `Sku` do(s) item(ns) a ser(em) revertido(s) (pode ser encontrado ao recuperar uma ação via API).
* O novo `Quantity` valor para o item — neste caso, `0`

Depois de ter todos esses valores, veja a chamada de exemplo abaixo para aprender como reverter itens em uma ação.

<details>

<summary>Chamada de exemplo e resposta</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>Resposta de exemplo</summary>

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

</details>

<details>

<summary>Referência de parâmetros</summary>

| `AccountId` | O valor do ID da conta de API da sua conta impact.com. [Saiba como encontrar esse valor](https://help.impact.com/brand/pt-br/account-administration/account-settings/api-tokens/manage-api-access-tokens-as-a-brand).          |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `AuthToken` | O valor do token de autorização da API da sua conta impact.com. [Saiba como encontrar esse valor](https://help.impact.com/brand/pt-br/account-administration/account-settings/api-tokens/manage-api-access-tokens-as-a-brand). |
| `ActionId`  | O valor de ID da ação a ser modificada.                                                                                                                                                                                        |
| `Sku`       | O valor do código de identificação do produto (SKU) do item — isso pode ser encontrado ao recuperar uma ação via API.                                                                                                          |
| `Quantity`  | O novo valor de quantidade para o item.                                                                                                                                                                                        |
| `Motivo`    | Ao reverter ou modificar um item, sempre envie `ORDER_UPDATE` como motivo.                                                                                                                                                     |

</details>
