> 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/submit-batch-modifications-and-reversals.md).

# Enviar modificações e reversões em lote

Quando um parceiro gera uma conversão — como uma venda — e o período de bloqueio dessa ação ainda não expirou, você pode corrigir quaisquer dados de ação incorretos enviando uma modificação ou reversão. Isso garante que o parceiro seja pago corretamente quando o período de bloqueio terminar.

As ações normalmente são modificadas ou revertidas quando os clientes devolvem pedidos, cometem erros durante o checkout ou quando os itens estão fora de estoque.

Você pode enviar modificações e reversões em massa via API ou por FTP/e-mail, conforme descrito neste artigo. O modelo de que você precisa para envios por FTP/e-mail depende de você acompanhar no nível do pedido ou do item, pois cada um requer campos diferentes. Se não tiver certeza de qual arquivo usar, pergunte ao seu CSM ou [entrar em contato com o suporte](https://app.impact.com/support/portal.ihtml).

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

| Se você quiser...                               | Use este método...                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Enviar um arquivo manual único, sem código      | ​[E-mail](/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 automáticos 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) |

### Pontos a ter em mente:

* **Use formatos de arquivo compatíveis** — Seu arquivo de envio deve estar no formato .CSV ou .XML.
* **Não adicione novos pontos de dados** — Você não pode adicionar novos campos a uma transação, apenas atualizar os existentes.
* **Entenda o tratamento de deduplicação** — Quando várias ações compartilham o mesmo *Oid/OrderId*, a impact.com aplica as atualizações ao *ActionId* mais recente. Para substituir isso, especifique o *ActionId*.
* **Use&#x20;*****Valor*****&#x20;corretamente para reversões** — Para reverter uma ação, você pode definir *Amount = 0*. No entanto, se o *Amount = 0*original, mantê-lo como 0 será registrado como uma modificação, e a ação não será revertida.

{% stepper %}
{% step %}

#### Etapa 1: Prepare seu arquivo de dados

1. Identifique o arquivo de modelo relevante para o seu caso de uso.
   * Consulte [Referência de Modificações e Reversões em Lote](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md) para arquivos de modelo com dados de exemplo.
2. Cole o conteúdo do modelo em um aplicativo de planilha (por exemplo, Microsoft Excel) ou editor de texto (por exemplo, Bloco de Notas).
3. Abaixo da linha de cabeçalho, comece a adicionar os dados da ação alterada.

   * Se você estiver usando um editor de texto, use vírgulas para separar cada ponto de dados.
   * Se você estiver usando um editor de planilhas, adicione cada ponto de dados em uma célula separada.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Observação:</strong> Certifique-se de editar as células da planilha no formato "Texto simples" ou "Texto" para que valores não sejam omitidos acidentalmente.</p></div>
4. Salve o arquivo com um nome identificável, como: `Batch_Mods/Reversals_2025_02_12.csv`
   * Para uma lista dos campos mais usados no processamento em lote por FTP/e-mail, consulte [Referência de Modificações e Reversões em Lote](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md). Como alternativa, veja nossas [Referências de Campos de Ação e Conversão](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references) para uma lista completa dos campos compatíveis.
     {% endstep %}

{% step %}
O impact.com permite no máximo 1.000 modificações por ação. Se você precisar fazer mais modificações depois disso, [contatar o suporte](https://app.impact.com/support/portal.ihtml).

1. Na barra de navegação superior, selecione ![](/files/cc510dcd14da0c528f14731f55068f027f9c731d) **\[Perfil do usuário] → Configurações**.
2. Na coluna da direita, em *Rastreamento*, selecione [**Tipos de evento**](https://app.impact.com/secure/advertiser/tracking-settings/actiontracker/view-actiontracker-flow.ihtml).
3. Selecione o **nome** do Tipo de evento para o qual você deseja enviar modificações em lote.
4. Ao lado de *Processamento de devoluções*, selecione ![](/files/f1c5fe94457426459cac3548436ce2a195dcde68) **\[Editar]**.
5. Selecione **Automatizar o processamento de devoluções (avançado)**.
6. Escolha um dos métodos a seguir relacionados a FTP ou e-mail para enviar seu arquivo:

<details>

<summary>Enviar arquivo para o servidor FTP do sistema</summary>

{% hint style="info" %}
Recomendamos dividir arquivos FTP/SFTP para manter o número máximo de entradas por arquivo abaixo de 10.000.
{% endhint %}

1. Selecione **Enviar arquivo para o servidor FTP do sistema.**
2. Selecione **Enviar nome de usuário e senha do FTP por e-mail** e **Salvar**.
3. Depois de receber suas credenciais de FTP por e-mail, use um cliente FTP para se conectar ao impact.com com as seguintes informações:

   |                     | FTP                                                                                       | SFTP                                                                                       |
   | ------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
   | **Servidor**        | batch.impact.com                                                                          | sftp\://batch.impact.com                                                                   |
   | **Porta**           | 21                                                                                        | 22                                                                                         |
   | **Nome de usuário** | (Seu nome de usuário FTP do impact.com, com diferenciação entre maiúsculas e minúsculas.) | (Seu nome de usuário SFTP do impact.com, com diferenciação entre maiúsculas e minúsculas.) |
   | **Senha**           | (Sua senha FTP do impact.com, com diferenciação entre maiúsculas e minúsculas.)           | (Sua senha SFTP do impact.com, com diferenciação entre maiúsculas e minúsculas.)           |
4. Depois de conectado, envie seu arquivo para o diretório principal do servidor.
   * Se você não tiver recebido o e-mail com as credenciais de FTP, entre em contato com a pessoa que criou sua conta no impact.com. Como alternativa, [contatar o suporte](https://app.impact.com/support/portal.ihtml).

</details>

<details>

<summary>Buscar arquivo do seu próprio servidor FTP</summary>

{% hint style="info" %}
Recomendamos dividir arquivos FTP/SFTP para manter o número máximo de entradas por arquivo abaixo de 10.000.
{% endhint %}

1. Selecione **Buscar arquivo do seu próprio servidor FTP**.
2. Insira o **URL do servidor**, **Porta**, e **Diretório** caminho para o arquivo de modificações em lote no seu servidor FTP. Insira o **Nome de usuário** e **Senha** que o impact.com usará para se conectar ao seu servidor FTP.
3. Selecione **Salvar** e continue.
4. Envie seu arquivo para o *Diretório* que você especificou acima.
   * O impact.com tenta se conectar e baixar arquivos do seu servidor FTP a cada 24 horas, portanto seu arquivo pode levar até 24 horas para ser processado após o envio.

</details>

<details>

<summary>Enviar arquivo por e-mail para o servidor SMTP do sistema</summary>

1. Selecione **Enviar arquivo por e-mail para o servidor SMTP do sistema.**
2. Um endereço de e-mail exclusivo será fornecido logo abaixo do método selecionado. Copie este endereço de e-mail.
3. Usando qualquer cliente de e-mail, envie um e-mail para o endereço exclusivo com seu arquivo de modificações em lote em anexo.
   * Inclua apenas o endereço de e-mail exclusivo *Para:* para o tipo de evento no *CC:* campo.
4. Você pode deixar o campo de assunto e o corpo da mensagem em branco.
   * Veja abaixo um exemplo do endereço de e-mail (o seu será um pouco diferente):

<div data-with-frame="true"><figure><img src="/files/739ae6191ed360ee90cfe7b3c0ec6d362fe72df5" alt="" width="446"><figcaption></figcaption></figure></div>

</details>
{% endstep %}

{% step %}

#### Etapa 3: Revise o envio do seu arquivo

Depois de enviar seu arquivo .CSV ou .XML para a impact.com, você pode verificar o status para ver se ele foi processado.

1. Na barra de navegação superior, selecione ![](/files/cc510dcd14da0c528f14731f55068f027f9c731d) **\[Perfil do usuário] → Configurações**.
2. Na coluna da esquerda, role até *Técnica* seção e selecione [**Envios de Arquivos**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/ftp-file-submissions-flow.ihtml).
3. Use a tabela para revisar os envios recentes de arquivos recebidos pela impact.com, incluindo o status atual do processamento.
   * Os arquivos enviados aparecerão dentro de 10 a 15 minutos após o envio, enquanto as atualizações gerais de relatórios podem levar mais de 2 horas.
   * Abaixo estão vários problemas que você pode encontrar ao revisar os envios de arquivos e as ações que pode tomar para solucioná-los.

<details>

<summary>Referência de solução de problemas de envio</summary>

| Problema                                                 | Ação a ser tomada                                                                                                                                                                                                                                                                                       |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| A coluna de registros mostra 0                           | Certifique-se de que a extensão do arquivo seja .CSV ou .XML.                                                                                                                                                                                                                                           |
| `NO_CHANGE`                                              | Nenhuma alteração foi feita na ação. Certifique-se de inserir o valor final no *Valor* coluna (por exemplo, insira 0 se quiser reverter as ações).                                                                                                                                                      |
| `BAD_DISPOSITION`                                        | <p>O código de motivo informado não é válido. Use um dos padrões <a href="/pages/885ac7827b6f6749367eced79f1a4f093f1cbb2c">códigos de motivo</a>.</p><p>Como alternativa, você pode configurar um <a href="/pages/f21e0b7b2e35e3213e9479b3eea72e53becc5208">código de disposição personalizado</a>.</p> |
| `ALREADY_LOCKED`                                         | O período de bloqueio da ação já passou. A ação não pode mais sofrer modificações ou reversões.                                                                                                                                                                                                         |
| `ActionTrackerld: o valor de ActionTrackerld é inválido` | Isso deve corresponder ao [ID do tipo de evento](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/event-types/how-do-i-find-my-event-type-ids.md) informado.                                                                                                                           |
| `ACTION_NOT_FOUND`                                       | O `OID` informado está incorreto. Forneça um correto `OID`.                                                                                                                                                                                                                                             |
| `ALREADY_REVERSED`                                       | A ação já foi revertida.                                                                                                                                                                                                                                                                                |
| `ALREADY_APPROVED`                                       | A ação já foi aprovada.                                                                                                                                                                                                                                                                                 |

</details>
{% endstep %}
{% endstepper %}


---

# 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/submit-batch-modifications-and-reversals.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.
