# Modificar em lote ou reverter via API

<a href="https://pxa.impact.com/student/activity/2268418?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=&#x26;utm_campaign=help-center" class="button primary">Faça o curso PXA</a>

Se algo sobre uma ação mudar (por exemplo, um pedido foi cancelado, um item foi devolvido etc.), você pode usar a API para modificá-la (ou revertê-la), alterando o valor da comissão para a ação.&#x20;

### Qual método de envio é o certo para você?

### Opções de reversão da API:

* [Modificar ou reverter um ou mais itens em uma ação via API](https://integrations.impact.com/impact-brand/reference/update-an-action-item)
* [Reverter uma ação inteira via API](https://integrations.impact.com/impact-brand/reference/reverse-an-action)

### Pré-requisito: Recupere o *ActionId* valor

Para modificar os dados da ação via API, você precisará do seu `ActionId` valor. Em seguida, você pode usar isso para encontrar a ação que deseja modificar via API.

* Você pode especificar um intervalo de datas na sua chamada — caso contrário, o endpoint exibirá por padrão as ações dos últimos 30 dias.
* [Limites de taxa](https://integrations.impact.com/impact-brand/reference/rate-limits) se aplicam.
* Consulte a documentação do endpoint da API [Listar todas as ações](https://integrations.impact.com/impact-brand/reference/list-all-actions) para saber mais.

### Perguntas frequentes

<details>

<summary>Como faço para redefinir uma modificação / reversão feita em uma ação (ou itens da ação)?</summary>

Se uma ação tiver sido modificada ou revertida antes da data de bloqueio, você pode enviar `RESET` como motivo para atualizar a ação de volta ao seu estado padrão:

```programlisting
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 'Reason=RESET'
```

Ações que foram redefinidas via `RESET` código podem não aparecer corretamente nos relatórios (por exemplo, os valores de receita podem ser calculados incorretamente).

</details>

<details>

<summary>Qual é a diferença entre um código de disposição e um motivo?</summary>

Ambos *Códigos de disposição* e *Motivos* são usados no mesmo contexto — *Motivos* são códigos predefinidos que a API aceitará por padrão, enquanto *Códigos de disposição* são motivos personalizados que você pode configurar. [Saiba mais sobre Códigos de Disposição](https://help.impact.com/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/platform-features/tracking/set-up-tracking/manage-disposition-codes).

Códigos de motivo compatíveis:

</details>

<details>

<summary>Como posso ver quando modificações / reversões são aplicadas a uma ação?</summary>

Você pode usar o [endpoint de atualizações da ação](https://integrations.impact.com/impact-brand/reference/the-action-update-object) para ver quando uma ação foi atualizada pela última vez e qual é seu estado atual.

{% hint style="info" %}
**Observação:** Uma `ActionUpdatesID` valor é diferente de um `ActionId` valor — você deve usar o `ActionUpdatesID` valor para recuperar as atualizações de uma ação.
{% endhint %}

</details>