> 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 terminou, você pode corrigir dados incorretos da ação enviando uma modificação ou reversão. Assim, o parceiro receberá o pagamento correto quando o período de bloqueio terminar.

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

Você pode enviar modificações e reversões em lote pela API ou por FTP/e-mail, conforme descrito neste artigo. O modelo necessário para envios por FTP/e-mail depende de você fazer o rastreamento no nível do pedido ou do item, pois cada opção exige campos diferentes. Se não souber qual arquivo usar, fale com seu CSM ou [entre em contato com o suporte](https://app.impact.com/support/portal.ihtml).

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

| Se você quiser...                                       | Use este método...                                                                                                                                                                                                                                                                                                     |
| ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Envie um arquivo manual e único, sem precisar programar | ​[E-mail](#step-2-submit-your-data-file) processamento em lote ou [envio de arquivo por FTP](#step-2-submit-your-data-file)​                                                                                                                                                                                           |
| Configure 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, [envio de arquivo por FTP](#step-2-submit-your-data-file), ou [download de arquivo por FTP​](#step-2-submit-your-data-file) |

### Pontos importantes:

* **Use formatos de arquivo compatíveis** — O arquivo enviado deve estar no formato .CSV ou .XML.
* **Não adicione novos pontos de dados** — Não é possível adicionar novos campos a uma transação, apenas atualizar os existentes.
* **Entenda como funciona a deduplicação** — Quando várias ações compartilham o mesmo *Oid/OrderId*, o impact.com aplica as atualizações à *ActionId*mais recente. Para substituir esse comportamento, especifique o *ActionId*.
* **Use&#x20;*****Amount*****&#x20;corretamente nas 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 adequado ao seu caso de uso.
   * Consulte [Referência de modificações e reversões em lote](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-modifications-and-reversals-reference.md) para ver arquivos de modelo com dados de exemplo.
2. Cole o conteúdo do modelo em um aplicativo de planilhas (por exemplo, Microsoft Excel) ou em um editor de texto (por exemplo, Bloco de Notas).
3. Comece a adicionar os dados corrigidos da ação abaixo da linha de cabeçalho.

   * Se estiver usando um editor de texto, separe cada ponto de dados com vírgulas.
   * Se estiver usando um editor de planilhas, insira 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> Edite as células da planilha no formato "Texto simples" ou "Texto" para evitar que valores sejam omitidos acidentalmente.</p></div>
4. Salve o arquivo com um nome que permita identificá-lo, como: `Batch_Mods/Reversals_2025_02_12.csv`
   * Para ver uma lista dos campos usados com frequência no processamento em lote por FTP/e-mail, consulte [Referência de modificações e reversões em lote](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-modifications-and-reversals-reference.md). Como alternativa, consulte nosso [Referências dos campos de ação e conversão](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references) para ver a lista completa de campos compatíveis.
     {% endstep %}

{% step %}

#### Etapa 2: Envie seu arquivo de dados

O impact.com permite no máximo 1.000 modificações por ação. Se precisar fazer mais modificações depois disso, [entre em contato com o suporte](https://app.impact.com/support/portal.ihtml).

1. Na barra de navegação superior, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Perfil do usuário] → Configurações**.
2. Na coluna à 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ê quer enviar modificações em lote.
4. Ao lado de *Processamento de devoluções*, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fkka3dqJOx8ZhiX82RDLt%2FEdit_light.svg?alt=media\&token=f454405c-ebd8-49af-90db-22efc27476bf) **\[Editar]**.
5. Selecione **Automatizar o processamento de devoluções (avançado)**&#x65; selecione **Upload em lote**.
6. Escolha um dos métodos relacionados a FTP ou e-mail a seguir para enviar seu arquivo:

<details>

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

{% hint style="info" %}
Recomendamos dividir os arquivos FTP/SFTP para que cada arquivo tenha menos de 10.000 entradas.
{% endhint %}

1. Selecione **Enviar arquivo para o servidor FTP do sistema.**
2. Selecione **Enviar por e-mail o nome de usuário e a senha do FTP** 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 do FTP do impact.com, que diferencia maiúsculas de minúsculas.) | (Seu nome de usuário do SFTP do impact.com, que diferencia maiúsculas de minúsculas.) |
   | **Senha**           | (Sua senha do FTP do impact.com, que diferencia maiúsculas de minúsculas.)           | (Sua senha do SFTP do impact.com, que diferencia maiúsculas de minúsculas.)           |
4. Depois de se conectar, envie seu arquivo para o diretório principal do servidor.
   * Se você não recebeu o e-mail com as credenciais de FTP, entre em contato com a pessoa que criou sua conta do impact.com. Como alternativa, [entre em contato com o suporte](https://app.impact.com/support/portal.ihtml).

</details>

<details>

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

{% hint style="info" %}
Recomendamos dividir os arquivos FTP/SFTP para que cada arquivo tenha menos de 10.000 entradas.
{% endhint %}

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

</details>

<details>

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

1. Selecionar **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 esse endereço de e-mail.
3. Usando qualquer cliente de e-mail, envie uma mensagem para o endereço exclusivo e anexe o arquivo de modificações em lote.
   * Inclua somente o endereço de e-mail exclusivo para o tipo de evento no campo *Para:* . Se precisar enviar esse arquivo para outras pessoas, inclua os endereços no campo *CC:* .
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="https://1651675991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpVKEIcehMut8QKRmaUZu%2Fuploads%2F4KrGuAmvXvwqwYUxauT0%2FScreenshot%202026-10-07%20at%2023.37.54.png?alt=media&amp;token=5835d762-9ad4-41c3-9715-d79be84c5af9" alt="" width="563"><figcaption></figcaption></figure></div>

</details>
{% endstep %}

{% step %}

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

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

1. Na barra de navegação superior, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b527686787b925f477dff4feb9be3a63f51250a7%2Fdcf31aa89710c2f91d880b79ce8d8c18489cd8cad334e5cd91dd7ee0372a44fd.svg?alt=media) **\[Perfil do usuário] → Configurações**.
2. Na coluna à esquerda, role até a seção *Técnico* 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 em até 10 a 15 minutos após o envio, enquanto as atualizações gerais de relatórios podem levar mais de 2 horas.
   * Veja abaixo alguns problemas que você pode encontrar ao revisar os envios de arquivos e as ações que pode realizar para solucioná-los.

<details>

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

| Problema                                           | Ação a realizar                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| A coluna de registros mostra 0                     | Verifique se a extensão do arquivo é .CSV ou .XML.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `NO_CHANGE`                                        | Nenhuma alteração foi feita na ação. Certifique-se de inserir o valor final na coluna *Valor* (por exemplo, insira 0 se quiser reverter ações).                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `BAD_DISPOSITION`                                  | <p>O código de motivo fornecido não é válido. Use um dos códigos de motivo padrão <a href="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-modifications-and-reversals-reference.md">códigos de motivo</a>.</p><p>Como alternativa, você pode configurar um <a href="https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/manage-disposition-codes.md">código de disposição personalizado</a>.</p> |
| `ALREADY_LOCKED`                                   | O período de bloqueio da ação já terminou. A ação não pode mais ser modificada nem revertida.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `ActionTrackerld:ActionTrackerld value is invalid` | Isso deve corresponder ao [ID do tipo de evento](https://help.impact.com/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` fornecido está incorreto. Informe um `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 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/submit-batch-modifications-and-reversals.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.
