Skip to main content
O enriquecimento usa arquivos como base de entrada e gera arquivos de saída ao final do processamento. A Lazy Data analisa o arquivo enviado para identificar a estrutura, detectar a coluna de CPF ou CNPJ e preparar os registros que serão enriquecidos.

​
Formatos aceitos

Os formatos aceitos são:
  • CSV
  • XLS
  • XLSX
O arquivo deve conter ao menos uma coluna com CPF ou CNPJ, conforme o tipo de enriquecimento escolhido.

​
Limite de tamanho

O upload de arquivos de enriquecimento aceita arquivos de até 1 GB. Arquivos acima desse limite são recusados antes do processamento.

​
Arquivo de entrada

O arquivo de entrada deve conter os registros que serão enriquecidos. Exemplo com cabeçalho: 
cpf,nome,nascimento
60235209872,BENITO JUAREZ DE OLIVEIRA,1980-05-10
05491816876,ANTONIO SERGIO SILVESTRE,1978-09-22
36114391853,PEDRO ROCHA DE CARVALHO,1992-01-15
Exemplo sem cabeçalho: 
60235209872,BENITO JUAREZ DE OLIVEIRA,1980-05-10
05491816876,ANTONIO SERGIO SILVESTRE,1978-09-22
36114391853,PEDRO ROCHA DE CARVALHO,1992-01-15
Quando o arquivo não possui cabeçalho, a Lazy Data pode identificar as colunas com nomes genéricos, como: 
Coluna 1
Coluna 2
Coluna 3

​
Detecção automática

Durante a análise do arquivo, a Lazy Data tenta identificar automaticamente:
  • formato do arquivo;
  • delimitador, quando aplicável;
  • existência de cabeçalho;
  • total de linhas;
  • colunas disponíveis;
  • coluna provável de CPF ou CNPJ;
  • amostra das primeiras linhas.
Mesmo quando a coluna do documento for detectada automaticamente, o usuário pode revisar e alterar antes de iniciar o enriquecimento.

​
Coluna do documento

A coluna do documento é a coluna usada como chave principal do enriquecimento.
Tipo de enriquecimentoDocumento esperado
Pessoa físicaCPF
Pessoa jurídicaCNPJ
Se a coluna selecionada possuir documentos inválidos, esses registros serão contabilizados como inválidos.

​
Linhas e cabeçalhos

Quando o arquivo possui cabeçalho, a primeira linha é usada como nome das colunas e não entra na contagem de registros processáveis. Quando o arquivo não possui cabeçalho, todas as linhas são consideradas registros.

​
Arquivos de saída

Ao final do enriquecimento, a Lazy Data pode gerar arquivos separados por resultado.
ArquivoDescrição
SucessosRegistros enriquecidos com retorno dos datasets selecionados.
Não encontradosRegistros válidos que não tiveram dados localizados.
FalhasRegistros que não puderam ser processados por erro técnico ou falha de consulta.
Arquivos sem registros não são gerados.

​
Arquivo de sucessos

O arquivo de sucessos contém os registros que tiveram retorno nos datasets selecionados. A estrutura mantém os dados originais do arquivo de entrada e adiciona colunas com os dados retornados pelos datasets. Exemplo simplificado: 
cpf,nome,person_basic_data.name,person_basic_data.birthdate,person_basic_data.gender
60235209872,BENITO JUAREZ DE OLIVEIRA,BENITO JUAREZ DE OLIVEIRA,1980-05-10,MASCULINO
05491816876,ANTONIO SERGIO SILVESTRE,ANTONIO SERGIO SILVESTRE,1978-09-22,MASCULINO

​
Arquivo de não encontrados

O arquivo de não encontrados contém registros válidos, mas sem retorno nos datasets selecionados. Exemplo simplificado: 
cpf,nome,reason
36114391853,PEDRO ROCHA DE CARVALHO,not_found

​
Arquivo de falhas

O arquivo de falhas contém registros que não puderam ser processados por erro técnico. Exemplo simplificado: 
cpf,nome,error
74162721815,DULCINEA DE ALMEIDA,provider_request_failed

​
Registros inválidos

Registros com CPF ou CNPJ inválido são contabilizados no progresso do enriquecimento. Dependendo do processamento, eles podem aparecer no arquivo de falhas ou serem registrados como inválidos no resumo do enriquecimento.

​
Download dos arquivos

Os arquivos finais ficam disponíveis no painel quando o enriquecimento é concluído. O download é exibido apenas para arquivos gerados com registros. Se uma categoria não tiver registros, o arquivo correspondente não será criado e o botão de download ficará indisponível.

​
Boas práticas

  • Use uma coluna exclusiva para CPF ou CNPJ.
  • Evite misturar CPF e CNPJ no mesmo arquivo.
  • Remova linhas vazias antes do upload.
  • Use cabeçalhos claros sempre que possível.
  • Evite colunas duplicadas com o mesmo nome.
  • Prefira arquivos CSV para bases muito grandes.
  • Valide a amostra exibida antes de iniciar o processamento.

​
Próximos passos

Execução e acompanhamento

Saiba como acompanhar o progresso, cobrança e status do enriquecimento.