Skip to main content
A criação de um enriquecimento é feita em etapas para reduzir erros de configuração e garantir que a base enviada esteja pronta para processamento. O fluxo começa com a escolha do tipo de base, passa pelo envio e análise do arquivo, seleção dos datasets e finaliza com o início do processamento.

​
Etapa 1: Tipo de enriquecimento

Ao criar um novo enriquecimento, selecione o tipo da base:
TipoQuando usar
Pessoa físicaQuando o arquivo contém CPFs.
Pessoa jurídicaQuando o arquivo contém CNPJs.
Essa escolha define como a Lazy Data validará os documentos e quais datasets estarão disponíveis nas próximas etapas.

​
Etapa 2: Nome e arquivo

Informe um nome para identificar o enriquecimento no painel. Em seguida, selecione o arquivo que será processado. Formatos aceitos:
  • CSV
  • XLS
  • XLSX
O arquivo deve conter ao menos uma coluna com CPF ou CNPJ, conforme o tipo escolhido.

​
Etapa 3: Upload e análise do arquivo

Após selecionar o arquivo, a Lazy Data solicita uma assinatura temporária de upload e envia o arquivo para processamento. Durante a análise, a plataforma identifica:
  • formato do arquivo;
  • tamanho;
  • quantidade de linhas;
  • presença de cabeçalho;
  • delimitador, quando aplicável;
  • colunas disponíveis;
  • possível coluna de CPF ou CNPJ;
  • amostra das primeiras linhas.
Essa etapa ocorre em segundo plano. O painel acompanha o progresso até que o arquivo esteja pronto para revisão.

​
Etapa 4: Revisão da coluna do documento

Depois que o arquivo for analisado, revise a coluna identificada como CPF ou CNPJ. Se a coluna detectada automaticamente não for a correta, selecione manualmente a coluna adequada. Quando o arquivo não possuir cabeçalho, as colunas podem aparecer com nomes genéricos, como: 
Coluna 1
Coluna 2
Coluna 3
Nesse caso, use a amostra exibida no painel para escolher a coluna correta.

​
Etapa 5: Seleção dos datasets

Após confirmar a coluna do documento, selecione os datasets que serão usados no enriquecimento. Nenhum dataset vem selecionado por padrão. A estimativa de custo é atualizada conforme:
  • quantidade de registros identificados;
  • datasets selecionados;
  • preço de cada dataset;
  • descontos aplicáveis ao plano.

​
Etapa 6: Início do processamento

Ao iniciar o enriquecimento, a Lazy Data reserva o valor estimado quando aplicável e coloca o processamento em fila. O processamento ocorre em segundo plano, permitindo que o usuário saia da tela e acompanhe depois pelo histórico de enriquecimentos.

​
Etapa 7: Acompanhamento

Durante a execução, o painel exibe:
  • total de registros;
  • registros processados;
  • registros encontrados;
  • registros inválidos;
  • registros não localizados;
  • falhas;
  • valor consumido;
  • status atual do enriquecimento.
O processamento pode ser retomado se houver interrupção, desde que o arquivo e o progresso ainda estejam disponíveis.

​
Status do enriquecimento

StatusDescrição
awaiting_uploadEnriquecimento criado e aguardando envio do arquivo.
uploadingArquivo em envio.
analyzingArquivo sendo analisado.
ready_to_configureArquivo analisado e pronto para configuração.
ready_to_startDatasets selecionados e enriquecimento pronto para iniciar.
queuedEnriquecimento aguardando processamento.
processingEnriquecimento em execução.
completedEnriquecimento concluído.
completed_with_errorsEnriquecimento concluído com falhas parciais.
failedEnriquecimento falhou.
cancelledEnriquecimento cancelado.

​
Regras importantes

  • O arquivo deve conter documentos válidos para o tipo escolhido.
  • CPFs e CNPJs inválidos são contabilizados como registros inválidos.
  • Registros válidos, mas sem retorno nos datasets selecionados, podem ser classificados como não localizados.
  • Datasets com falha podem gerar estorno conforme a regra de cobrança aplicável.
  • Arquivos sem registros em uma categoria de saída não são gerados.

​
Continuação de enriquecimentos

Se o usuário sair da tela antes de concluir o fluxo, o enriquecimento permanece salvo. Ao abrir novamente o item no painel, o modal retorna para a etapa correspondente ao status atual, permitindo continuar de onde parou.

​
Próximos passos

Arquivos de entrada e saída

Entenda os formatos aceitos, regras do arquivo e arquivos gerados ao final do enriquecimento.