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

Upload para enriquecimento

Veja como enviar o arquivo pelo serviço upload.lazydata.com.br.

​
Formatos aceitos

O arquivo deve conter ao menos uma coluna com CPF ou CNPJ, conforme o tipo de enriquecimento escolhido.

​
Limite de tamanho

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

​
Arquivo de entrada

O arquivo de entrada contém os registros que serão enriquecidos. Exemplo com cabeçalho:
Exemplo sem cabeçalho:
Quando o arquivo não possui cabeçalho, a análise pode exibir colunas por índice ou nomes genéricos. Use as amostras retornadas em analysis.columns[] para escolher a coluna correta.

​
Detecção automática

Durante a análise do arquivo, a Lazy Data tenta identificar:
  • 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;
  • amostras das primeiras linhas.
Mesmo quando a coluna do documento for detectada automaticamente, revise a sugestão antes de iniciar o processamento.

​
Coluna do documento

A coluna do documento é a chave principal usada no enriquecimento. Se a coluna selecionada possuir documentos inválidos, esses registros serão contabilizados em invalid_documents e podem gerar o arquivo de saída invalid.

​
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.
Evite misturar CPF e CNPJ no mesmo arquivo. O tipo do enriquecimento define a validação aplicada a todos os registros.

​
Arquivos de saída

Ao final do enriquecimento, a Lazy Data pode gerar arquivos separados por resultado. Arquivos sem registros não são gerados.

​
Arquivo de sucessos

O arquivo success contém registros que tiveram retorno útil nos datasets selecionados. A estrutura mantém os dados originais do arquivo de entrada e adiciona colunas com dados retornados pelos datasets. Exemplo simplificado:

​
Arquivo de não encontrados

O arquivo not_found contém registros válidos, mas sem retorno útil nos datasets selecionados. Exemplo simplificado:

​
Arquivo de falhas

O arquivo failed contém registros que não puderam ser processados por erro técnico. Exemplo simplificado:

​
Arquivo de inválidos

O arquivo invalid contém registros ignorados porque o documento da coluna selecionada não é válido para o tipo do enriquecimento. Exemplo simplificado:

​
Download dos arquivos

Os arquivos finais ficam disponíveis quando o enriquecimento chega em completed ou completed_with_errors. Consulte outputs no status para saber quais arquivos foram gerados:

Arquivos de saída

Gere links temporários para baixar cada saída disponí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 CSV para bases muito grandes.
  • Valide a coluna sugerida em analysis.document_column antes de iniciar o processamento.
  • Consulte outputs antes de tentar baixar um arquivo.

​
Próximos passos

Criar enriquecimento

Crie o registro inicial e gere a assinatura de upload.

Consultar status

Acompanhe análise, progresso e arquivos gerados.

Upload para enriquecimento

Envie o arquivo de entrada.

Configurar e executar

Selecione coluna e datasets para iniciar.