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 tiver passado, você pode corrigir quaisquer dados incorretos da ação 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 por meio da 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ê estar acompanhando no nível do pedido ou do item, já que cada um requer campos diferentes. Se não tiver certeza de qual arquivo usar, pergunte ao seu CSM ou entre em contato com o suporte.

Qual método de envio é o ideal para você?

Se você quiser...	Use este método...
Envie um arquivo manual e único, sem programação	​E-mail processamento em lote ou enviar arquivo via FTP
Configurar relatórios automatizados de conversões	​Conversões / Ações API, enviar arquivo via FTP, ou baixar arquivo via FTP

Coisas 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 à mais recente ActionId. Para substituir isso, especifique o desejado ActionId.
• Use Amount corretamente para reversões — Para reverter uma ação, você pode definir Valor = 0. No entanto, se o original Valor = 0, mantê-lo como 0 será registrado como uma modificação, e a ação não será revertida.

1

Etapa 1: Prepare seu arquivo de dados

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

   Observação: Certifique-se de editar as células da planilha no formato "Texto simples" 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

   • Para obter uma lista dos campos comumente usados no processamento em massa por FTP/e-mail, consulte Referência de Modificações e Reversões em Lote. Como alternativa, consulte nossos Referências de Campos de Ação e Conversão para obter uma lista completa dos campos compatíveis.

2

impact.com permite um máximo de 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 [Perfil do usuário] → Configurações.
2. Na coluna da 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 o processamento de devoluções (avançado).
6. Escolha um dos seguintes métodos relacionados a FTP ou e-mail para enviar seu arquivo:

Enviar arquivo para o servidor FTP do sistema

Recomendamos dividir arquivos FTP/SFTP para manter o número máximo de entradas por arquivo abaixo de 10.000.

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 informações a seguir:

   	FTP	SFTP
   Servidor	batch.impact.com	sftp://batch.impact.com
   Porta	21	22
   Nome de usuário	(Seu nome de usuário de FTP do impact.com, com diferenciação entre maiúsculas e minúsculas.)	(Seu nome de usuário de SFTP do impact.com, com diferenciação entre maiúsculas e minúsculas.)
   Senha	(Sua senha de FTP do impact.com, com diferenciação entre maiúsculas e minúsculas.)	(Sua senha de 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 recebeu o e-mail com as credenciais de FTP, entre em contato com a pessoa que criou sua conta no impact.com. Como alternativa, entre em contato com o suporte.

Buscar arquivo do seu próprio servidor FTP

Recomendamos dividir arquivos FTP/SFTP para manter o número máximo de entradas por arquivo abaixo de 10.000.

1. Selecione Buscar arquivo do seu próprio servidor FTP.
2. Digite o URL do servidor, Porta, e Diretório caminho para o arquivo de modificações em lote no seu servidor FTP. Digite 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, 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.
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 uma mensagem para o endereço exclusivo com seu arquivo de modificações em lote como anexo.

   • Inclua somente o endereço de e-mail exclusivo do tipo de evento no Para: campo. Se você precisar enviar este arquivo para outras pessoas, inclua-as no Cc: campo.
4. Você pode deixar o campo de assunto e o corpo da mensagem em branco.

   • Veja um exemplo do endereço de e-mail abaixo (o seu será um pouco diferente):

3

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 dele para ver se foi processado.

1. Na barra de navegação superior, selecione [Perfil do usuário] → Configurações.
2. Na coluna da esquerda, role até o Técnico seção e selecione Envios de arquivos.
3. Use a tabela para revisar os envios de arquivos recentes que o impact.com recebeu, incluindo o status atual de 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 arquivos e as ações que você pode tomar para solucioná-los.

Referência de solução de problemas de envio

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	Não há nenhuma alteração feita na ação. Certifique-se de inserir o valor final na Valor coluna (por exemplo, insira 0 se quiser reverter ações).
BAD_DISPOSITION	O código de motivo que você forneceu não é válido. Use um dos códigos padrão códigos de motivo. 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 sofrer modificações ou reversões.
ActionTrackerld:ActionTrackerld é inválido	Isso deve corresponder ao ID do Tipo de Evento inserido.
ACTION_NOT_FOUND	O OID que você forneceu está incorreto. Forneça um valor correto OID.
ALREADY_REVERSED	A ação já foi revertida.
ALREADY_APPROVED	A ação já foi aprovada.