> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-process-reversals-via-api-web-services-overview.md).

# Modificar ou reverter em lote 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 em relação a 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 da ação.

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

| If you want to...                             | Use this method...                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Submit a manual, one-time file with no coding | ​[Email](/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.md#step-2-submit-your-data-file) batch processing or [upload file via FTP](/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.md#step-2-submit-your-data-file)​                                                                                                                                                                                        |
| Set up automated conversion reporting         | ​[Conversions](https://integrations.impact.com/brand-api-reference/reference/conversions/conversions) / [Actions](https://integrations.impact.com/brand-api-reference/reference/actions) API, [push file via FTP](/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.md#step-2-submit-your-data-file), or [pull file via FTP​](/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.md#step-2-submit-your-data-file) |

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

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

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

Para modificar os dados de uma ação via API, você precisará do seu `ActionId` valor. Você pode então 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 mostrará por padrão os últimos 30 dias de ações.
* [Limites de taxa](https://integrations.impact.com/brand-api-reference/readme/rate-limits) se aplicam.
* Veja o [Listar todas as ações](https://integrations.impact.com/brand-api-reference/reference/actions/actions) documentação do endpoint da API 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 por meio do `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](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/manage-disposition-codes.md).

Códigos de motivo compatíveis:

<table><thead><tr><th width="239.2734375">Code</th><th>Description</th></tr></thead><tbody><tr><td><code>CONS_FRAUD</code></td><td>Consumer fraud</td></tr><tr><td><code>CONS_ERROR</code></td><td>Consumer error</td></tr><tr><td><code>ITEM_RETURNED</code></td><td>Item was returned</td></tr><tr><td><code>APPROVED</code></td><td><p>Action is approved</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Note:</strong> If you’re trying to approve actions, <code>Approve</code> needs to be set up as a <a href="/brand/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/manage-disposition-codes.md">custom disposition code</a>.</p></div></td></tr><tr><td><code>ORDER_ERROR</code></td><td>Order error</td></tr><tr><td><code>ORDER_UPDATE</code></td><td>Order was updated</td></tr><tr><td><code>PUB_ACT_DISPUTE</code></td><td>Partner activity dispute</td></tr><tr><td><code>ADV_ACT_DISPUTE</code></td><td>Brand activity dispute</td></tr><tr><td><code>NOT_COMPLIANCE_TERMS</code></td><td>Not in compliance with terms</td></tr><tr><td><code>ITEM_OUT_OF_STOCK</code></td><td>Item is out of stock</td></tr><tr><td><code>TEST_ACTION</code></td><td>Test action</td></tr><tr><td><code>PARTNER_NOT_ACTIVE</code></td><td>Partner account deactivated</td></tr><tr><td><code>CREDITED_DIFFERENT_MP</code></td><td>Credited to another partner</td></tr><tr><td><code>OTHER</code></td><td>Other reason</td></tr></tbody></table>

</details>

<details>

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

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

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

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-process-reversals-via-api-web-services-overview.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.