Enviar Modificações & 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 são tipicamente 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 seja via API, ou através de um servidor FTP/SMTP conforme descrito abaixo. O modelo que você precisa para envios FTP/SMTP depende se você está rastreando no nível do pedido ou do item, já que cada um exige campos diferentes. Se você não tiver certeza de qual arquivo usar, pergunte ao seu CSM ou contate o suporte.

Coisas a ter em mente

• Use formatos de arquivo suportados — Seu arquivo de envio deve estar em 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 novo ActionId. Para sobrescrever isso, especifique o ActionId.

• Use Amount corretamente para reversões — Para reverter uma ação, você pode definir Amount = 0. No entanto, se o Amount = 0original permanecer com o mesmo valor, mantê-lo como 0 será registrado como uma modificação, e a ação não será revertida.

Passo 1: Prepare seu arquivo de dados

Para uma lista de campos comumente usados no processamento em lote via FTP/SMTP, veja Referência de Modificações e Reversões em Lote. Alternativamente, veja Referências de Dados de Ações e Conversões da impact.com para uma lista completa de campos suportados.

1. Identifique o arquivo de modelo relevante para seu caso de uso.

   • Veja Referência de Modificações e Reversões em Lote 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 de ação alterados.

   • 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.

   Importante: Certifique-se de que está editando as células da planilha no formato "Texto simples" ou "Texto" para que valores não sejam omitidos acidentalmente.

4. Salve o arquivo com um nome identificável, como: Batch_Mods/Reversals_2025_02_12.csv

Passo 2: Envie seu arquivo de dados

A impact.com permite um máximo de 1.000 modificações por ação. Se você precisar fazer mais modificações depois disso, contate o suporte.

1. Na barra de navegação superior, selecione [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 [Editar].

5. Selecione Automatizar processamento de devoluções (avançado).

   • Escolha um dos seguintes métodos relacionados a FTP ou SMTP para enviar seu arquivo:

Enviar arquivo para o servidor FTP do sistema

1. Selecione Enviar arquivo para o servidor FTP do sistema.

2. Selecione Salvar.

3. Uma vez que você tenha recebido suas credenciais FTP por e-mail, use um cliente FTP para conectar-se à impact.com com as seguintes informações:

   
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, contate a pessoa que criou sua conta na impact.com. Alternativamente, contate o suporte.

Puxe o arquivo do seu próprio servidor FTP

1. Selecione Puxe o 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. Envie seu arquivo de modificações em lote para o diretório que você especificou acima.

   • A impact.com tenta conectar-se 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.

Enviar arquivo por e-mail para o servidor SMTP do sistema

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 do tipo de evento no Para: campo. Se você precisar enviar este arquivo para outras pessoas, inclua-as no CC: campo.

3. Você pode deixar o campo de assunto e o corpo da mensagem em branco.

Passo 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 [Perfil do usuário] → Configurações.

2. Na coluna da esquerda, role até a seção Técnica e selecione Envios de Arquivos.

3. Use a tabela para revisar envios de arquivos recentes que a impact.com recebeu, incluindo o status atual de processamento.

   • Os arquivos enviados aparecerão dentro de 10–15 minutos após o envio, enquanto atualizações gerais de relatórios podem levar 2+ horas.

   • Abaixo estão várias questões que você pode encontrar ao revisar envios de arquivos e ações que você pode tomar para corrigi-las.

   Problema	Ação a ser tomada
   A coluna Registros mostra 0	Verifique se a extensão do arquivo é .CSV ou .XML.
   NO_CHANGE	Nenhuma alteração foi feita na ação. Por favor, assegure-se de inserir o valor final na Amount coluna (por exemplo, insira 0 se você quiser reverter ações).
   BAD_DISPOSITION	O código de motivo que você forneceu não é válido. Por favor, use um dos códigos de motivo. Alternativamente, você pode configurar um código de disposição personalizado.
   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.
   ActionTrackerId:ActionTrackerId valor é inválido	Isto deve corresponder ao ID do Tipo de Evento 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.