# Enviar Modificações e Reversões em Lote

Quando um parceiro gera uma conversão — como uma venda — e o período de bloqueio para essa 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 clientes devolvem pedidos, cometem erros no checkout ou quando itens estão fora de estoque.

Você pode enviar modificações e reversões em lote tanto [via API](https://integrations.impact.com/impact-brand/reference/actions-overview), quanto por meio de um servidor FTP/SMTP conforme descrito abaixo. O modelo que você precisa para envios por FTP/SMTP depende se você está rastreando no nível do pedido ou do item, pois cada um requer campos diferentes. Se não souber qual arquivo usar, pergunte ao seu CSM ou [contatar o suporte](https://app.impact.com/support/portal.ihtml).

#### Coisas a ter em mente

* **Use formatos de arquivo suportados** — 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 múltiplas ações compartilham o mesmo *Oid/OrderId*, a impact.com aplica atualizações ao mais recente *ActionId*. Para sobrescrever isso, especifique o *ActionId*.
* **Use corretamente o Amount para reversões** — Para reverter uma ação, você pode definir *Amount = 0*. No entanto, se o original *Amount = 0*, mantendo-o como 0 será registrado como uma modificação, e a ação não será revertida.

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

Para uma lista completa de campos que você pode usar no processamento em lote por FTP/SMTP, veja [Referência de Modificações & Reversões em Lote](https://help.impact.com/brand/pt-br/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference).

1. Identifique o arquivo de modelo relevante para seu caso de uso.
   * Veja [Referência de Modificações & Reversões em Lote](https://help.impact.com/brand/pt-br/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference) por exemplo arquivos de modelo.
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 de ação alterados.

   * Se estiver usando um editor de texto, use vírgulas para separar cada ponto de dados.
   * Se 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>Importante:</strong> Certifique-se de editar as células da planilha em formato "Texto simples" ou "Texto" para que os valores não sejam acidentalmente omitidos.</p></div>
4. Salve o arquivo com um nome identificável, como: `Batch_Mods_Reversals_2025_02_12.csv`

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

A impact.com permite no máximo 1.000 modificações por ação. Se você precisar fazer mais modificações depois disso, entre em contato com o suporte.

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. À direita, em *Rastreamento*, selecione **Tipos de Evento**.
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 ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6027673a720a6522269e1861ad0554c4a85baf29%2F9dcf248c757a094c6af27798e61091b8425a0afa1637ae0e5ba3448c5f85b1a1.svg?alt=media) **\[Editar]**.
5. Selecione **Automatize o processamento de devoluções (avançado)**.
   * Escolha um dos seguintes métodos relacionados a FTP ou SMTP para enviar seu arquivo:

<details>

<summary>Carregar arquivo no servidor FTP do sistema</summary>

1. Selecione **Faça upload do arquivo para o servidor FTP do sistema.**
2. Selecione **Salvar**.
3. Assim que receber suas credenciais FTP por e-mail, use um cliente FTP para conectar-se à impact.com com as seguintes informações:

   <div data-with-frame="true"><figure><img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-602f57b0b5ea7fdd8e0b57e60b8bfbb03682a471%2Fb97d7d89206c581acaa9d0ec8e5da972dd3cfa859e0e78d3b23845104b796417.png?alt=media" alt=""><figcaption></figcaption></figure></div>
4. Uma vez conectado, envie seu arquivo para o diretório principal do servidor.
   * Se você não recebeu o e-mail com as credenciais FTP, entre em contato com a pessoa que criou sua conta na impact.com. Alternativamente, [contatar o suporte](https://app.impact.com/support/portal.ihtml).

</details>

<details>

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

1. Selecione **Puxar 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 a impact.com usará para conectar-se ao seu servidor FTP.
3. Selecione **Salvar** e continue.
4. Faça upload do seu arquivo de modificações em lote para o diretório que você especificou acima.
   * A impact.com tenta conectar e baixar arquivos do seu servidor FTP a cada 24 horas, então 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**, então copie seu endereço de e-mail único.
2. Usando qualquer cliente de e-mail, envie um e-mail para o endereço único com seu arquivo de modificações em lote como anexo.
   * Inclua apenas o endereço de e-mail único para o tipo de evento no *Para:* campo. Se você precisar enviar este arquivo para outras pessoas, inclua-as em *CC:* campo.
3. Você pode deixar o campo de assunto e o corpo da mensagem em branco.

</details>

#### 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  ![](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é o *Técnico* seção e selecione **Submissões de Arquivos**.
3. Use a tabela para revisar envios recentes de arquivos que a impact.com recebeu, incluindo o status atual de processamento.

   * Arquivos enviados aparecerão dentro de 10–15 minutos após o envio, enquanto atualizações gerais de relatório podem levar 2+ horas.
   * Abaixo estão vários problemas que você pode encontrar ao revisar envios de arquivos e ações que você pode tomar para corrigi-los.

   | Problema                                           | Ação a ser tomada                                                                                                                                                                                                                                                                                                      |
   | -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | A coluna 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 na *Amount* coluna (por exemplo, insira 0 se você quiser reverter ações).                                                                                                                                                                  |
   | `BAD_DISPOSITION`                                  | <p>O código de motivo que você forneceu não é válido. Por favor, use um dos <a href="batch-modifications-and-reversals-reference">códigos de motivo</a>.</p><p>Alternativamente, você pode configurar um <a href="../../tracking/set-up-tracking/manage-disposition-codes">código de disposição personalizado</a>.</p> |
   | `ALREADY_LOCKED`                                   | O período de bloqueio da ação já expirou. A ação não pode mais sofrer modificações ou reversões.                                                                                                                                                                                                                       |
   | `ActionTrackerId:ActionTrackerId valor é inválido` | Isto deve corresponder ao [ID do Tipo de Evento](https://help.impact.com/brand/pt-br/platform-features/event-types/how-do-i-find-my-event-type-ids) inserido.                                                                                                                                                          |
   | `ACTION_NOT_FOUND`                                 | O `OID` que você forneceu está incorreto. Por favor, forneça um `OID`.                                                                                                                                                                                                                                                 |
   | `ALREADY_REVERSED`                                 | A ação já foi revertida.                                                                                                                                                                                                                                                                                               |
   | `ALREADY_APPROVED`                                 | A ação já foi aprovada.                                                                                                                                                                                                                                                                                                |
