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 passou, 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, seja via API, ou por meio de um servidor FTP/SMTP, conforme descrito abaixo. O modelo de que você precisa para envios via FTP/SMTP depende de você estar rastreando no nível do pedido ou do item, pois cada um requer campos diferentes. Se você não tiver certeza de qual arquivo usar, pergunte ao seu CSM ou entre em contato com o suporte.

Pontos a serem lembrados

• 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 desduplicação — Quando várias ações compartilham o mesmo Oid/OrderId, a impact.com aplica as atualizações à mais recente ActionId. Para substituir isso, especifique o ActionId.

• Use Amount corretamente para reversões — Para reverter uma ação, você pode definir Amount = 0. No entanto, se o valor original Amount = 0, 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 ver uma lista de campos comumente usados no processamento em lote via FTP/SMTP, consulte Referência de Modificações e Reversões em Lote. Como alternativa, veja Referências de Dados de Ações e Conversões da impact.com para uma lista completa dos campos compatíveis.

1. Identifique o arquivo de modelo relevante para o 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 estiver usando um editor de texto, use vírgulas para separar cada ponto de dados.

   • Se estiver usando um editor de planilha, adicione cada ponto de dados em uma célula separada.

   Importante: Certifique-se de estar editando as células da planilha no formato "Texto sem formatação" ou "Texto" para que os 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 modificações adicionais depois disso, entre em contato com 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 métodos a seguir 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. Depois de receber suas credenciais de FTP por e-mail, use um cliente FTP para se conectar à impact.com com as seguintes informações:

   
4. Após a conexão, 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 na impact.com. Como alternativa, entre em contato com o suporte.

Buscar arquivo do seu próprio servidor FTP

1. Selecione Buscar arquivo do seu próprio servidor FTP.

2. Insira o URL do servidor, Portae 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 se conectar ao seu servidor FTP.

3. Selecione Salvar e continue.

4. Envie seu arquivo de modificações em lote para o diretório especificado acima.

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

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

1. Selecione Enviar arquivo por e-mail para o servidor SMTP do sistema, depois copie seu endereço de e-mail exclusivo.

2. Usando qualquer cliente de e-mail, envie uma mensagem para o endereço exclusivo com seu arquivo de modificações em lote como anexo.

   • Inclua apenas o endereço de e-mail exclusivo do tipo de evento no campo Para: . Se você precisar enviar este arquivo para outras pessoas, inclua-as no campo CC: .

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écnico e selecione Envios de arquivo.

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 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 arquivo e as ações que pode tomar para corrigi-los.

   Problema	Ação a tomar
   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 quiser reverter as ações).
   BAD_DISPOSITION	O código de motivo fornecido não é válido. Use um dos códigos de motivo. padrão. Como alternativa, 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 passar por modificações ou reversões.
   ActionTrackerId: o valor de ActionTrackerId é inválido	Isso deve corresponder ao ID do tipo de evento informado.
   ACTION_NOT_FOUND	O OID que você forneceu está incorreto. Forneça um OID.
   ALREADY_REVERSED	A ação já foi revertida.
   ALREADY_APPROVED	A ação já foi aprovada.