> 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 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 da ação.

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

| Se você quiser...                                 | Use este método...                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Envie um arquivo manual, único, sem programação   | ​[Email](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/submit-conversion-data-via-ftp-or-email.md#before-you-start) processamento em lote ou [enviar arquivo via FTP](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals#upload-file-to-system-ftp-server)                                                                                                                                                                                                                              |
| Configurar relatórios automatizados de conversões | ​[Conversões](https://integrations.impact.com/brand-api-reference/reference/conversions/conversions) / [Ações](https://integrations.impact.com/brand-api-reference/reference/actions) API, [enviar arquivo via FTP](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals#upload-file-to-system-ftp-server), ou [baixar arquivo via FTP](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals#pull-file-from-your-own-ftp-server) |

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

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

### 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 usá-lo 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 os últimos 30 dias de ações.
* [Limites de taxa](https://integrations.impact.com/brand-api-reference/readme/rate-limits) se aplicam.
* Veja a tabela de referência de [Liste todas as ações](https://integrations.impact.com/brand-api-reference/reference/actions/actions) Consulte a 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 sua 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 suportados:

<table><thead><tr><th width="234">Código</th><th>Descrição</th></tr></thead><tbody><tr><td><code>CONS_FRAUD</code></td><td>Fraude do consumidor</td></tr><tr><td><code>CONS_ERROR</code></td><td>Erro do consumidor</td></tr><tr><td><code>ITEM_RETURNED</code></td><td>O item foi devolvido</td></tr><tr><td><code>APPROVED</code></td><td><p>A ação está aprovada</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Observação:</strong> Se você estiver tentando aprovar ações, <code>Aprovar</code> precisa ser configurado como um <a href="/pages/f21e0b7b2e35e3213e9479b3eea72e53becc5208">código de disposição personalizado</a>.</p></div></td></tr><tr><td><code>ORDER_ERROR</code></td><td>Erro do pedido</td></tr><tr><td><code>ORDER_UPDATE</code></td><td>O pedido foi atualizado</td></tr><tr><td><code>PUB_ACT_DISPUTE</code></td><td>Disputa de atividade do parceiro</td></tr><tr><td><code>ADV_ACT_DISPUTE</code></td><td>Disputa de atividade da marca</td></tr><tr><td><code>NOT_COMPLIANCE_TERMS</code></td><td>Não está em conformidade com os termos</td></tr><tr><td><code>ITEM_OUT_OF_STOCK</code></td><td>O item está fora de estoque</td></tr><tr><td><code>TEST_ACTION</code></td><td>Ação de teste</td></tr><tr><td><code>PARTNER_NOT_ACTIVE</code></td><td>Conta do parceiro desativada</td></tr><tr><td><code>CREDITED_DIFFERENT_MP</code></td><td>Creditado para outro parceiro</td></tr><tr><td><code>OUTRO</code></td><td>Outro motivo</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 é seu estado atual.

{% hint style="info" %}
**Observação:** Um `ActionUpdatesID` valor é diferente de um `ActionId` valor — você deve usar o `ActionUpdatesID` valor para recuperar as 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
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=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.