Skip to main content
O enriquecimento permite enviar uma base de dados em massa e adicionar informações estruturadas aos registros usando os datasets disponíveis na Lazy Data. Ele é indicado para fluxos em que você já possui uma lista de CPFs ou CNPJs e precisa complementar esses registros com dados cadastrais, indicadores, scores, informações financeiras, protestos, processos ou outros dados disponíveis nos datasets contratados.

Criar enriquecimento

Veja o fluxo completo para criar, enviar, configurar e executar um enriquecimento.

​
Como funciona

O fluxo de enriquecimento é dividido em etapas:
1

Escolha o tipo da base

Defina se o arquivo contém CPFs (pf) ou CNPJs (pj).
2

Crie o enriquecimento

Informe nome, tipo da base e metadados do arquivo para gerar a assinatura de upload.
3

Envie o arquivo

Envie CSV, XLS ou XLSX para https://upload.lazydata.com.br/enrichment.
4

Revise a análise

Confirme a coluna de CPF ou CNPJ detectada e revise amostras do arquivo.
5

Selecione datasets

Escolha os datasets que serão usados no processamento.
6

Inicie e acompanhe

Coloque o enriquecimento na fila, acompanhe progresso, custo e arquivos finais.

​
Tipos de base

Essa escolha define a validação aplicada aos documentos e quais datasets ficam disponíveis para configuração.

​
Arquivo de entrada

O arquivo enviado deve conter uma coluna com os documentos que serão usados no enriquecimento. Formatos aceitos:
  • csv
  • xls
  • xlsx
A Lazy Data analisa o arquivo para identificar separador, cabeçalho, colunas disponíveis e possível coluna de CPF ou CNPJ. Quando a coluna do documento for detectada automaticamente, o usuário ainda pode revisar e alterar antes de iniciar o enriquecimento.

Arquivos de entrada e saída

Entenda formatos aceitos, estrutura esperada e arquivos gerados.

​
Upload do arquivo

O upload de enriquecimento usa assinatura temporária. O arquivo binário não é enviado para a URL base da API principal. Ele deve ser enviado para:
O header usado no envio é:

Upload para enriquecimento

Consulte a rota técnica de envio do arquivo.

​
Datasets

Após o arquivo ser analisado, o usuário seleciona quais datasets serão usados no enriquecimento. A estimativa de custo é calculada com base em:
  • quantidade de registros válidos;
  • datasets selecionados;
  • preço de cada dataset;
  • descontos aplicáveis ao plano;
  • regras de cobrança condicionada, quando houver.
Nenhum dataset é selecionado automaticamente. A escolha deve ser feita pelo usuário.
Datasets disponíveis para consulta individual podem não estar habilitados para enriquecimento. Use a listagem específica de enriquecimento.

Datasets disponíveis

Liste datasets PF ou PJ disponíveis para processamento em massa.

​
Configuração

Depois que o arquivo chegar em waiting_configuration, configure:

Configurar e executar

Envie coluna, datasets e campos adicionais para iniciar o processamento.

​
Processamento

O enriquecimento é executado em segundo plano. Durante a execução, a plataforma atualiza o progresso com informações como:
  • registros processados;
  • registros enriquecidos;
  • registros inválidos;
  • registros não localizados;
  • falhas;
  • valor consumido;
  • valores estornados, quando houver.
Caso o servidor seja reiniciado, o processamento pode ser retomado a partir do progresso salvo.

Execução e acompanhamento

Saiba como acompanhar progresso, status, cobrança e download dos resultados.

​
Status principais

​
Arquivos gerados

Ao final do enriquecimento, a plataforma pode gerar arquivos separados conforme o resultado dos registros. Arquivos sem registros não são gerados.

Arquivos de saída

Gere links temporários para baixar os arquivos finais disponíveis.

​
Cobrança

Antes de iniciar o enriquecimento, o valor estimado pode ser reservado conforme os datasets selecionados e a quantidade de registros válidos. Durante o processamento, a cobrança considera os resultados efetivamente processados conforme as regras de cada dataset. Quando aplicável, valores de registros ou datasets com falha podem ser estornados.
O valor final pode ser menor que a estimativa inicial quando há documentos inválidos, datasets com cobrança condicionada ou estornos por falha.

​
Retomada e segurança

O enriquecimento mantém o progresso salvo para permitir continuidade em caso de interrupção. Ao abrir novamente o item, use status e resume_step para retomar a etapa correta, como upload, análise, configuração, progresso ou saída. Os arquivos temporários são usados apenas durante o processamento. Ao final, os arquivos finais são armazenados de forma segura e os temporários locais são removidos.

​
Boas práticas

  • Use uma coluna exclusiva para CPF ou CNPJ.
  • Não misture CPF e CNPJ no mesmo arquivo.
  • Use cabeçalhos claros e remova linhas vazias.
  • Revise a coluna detectada antes de iniciar.
  • Liste datasets disponíveis antes de configurar.
  • Selecione apenas datasets necessários para o objetivo da base.
  • Acompanhe failed_rows, invalid_documents e cost.consumed em bases grandes.
  • Baixe os arquivos finais após a conclusão, conforme sua política de retenção.

​
Próximos passos

Criar enriquecimento

Veja o passo a passo para criar um novo enriquecimento.

Arquivos de entrada e saída

Entenda os formatos aceitos e os arquivos gerados.

Execução e acompanhamento

Saiba como acompanhar progresso, status, cobrança e download dos resultados.

Datasets disponíveis

Liste datasets PF ou PJ habilitados para enriquecimento.