Skip to main content
Após configurar o arquivo e selecionar os datasets, o enriquecimento é colocado em fila para processamento em segundo plano. Durante a execução, a Lazy Data atualiza o progresso do enriquecimento e permite acompanhar o status, registros processados, falhas, valor consumido e arquivos gerados.

Processamento em segundo plano

O enriquecimento não depende da tela permanecer aberta. Depois de iniciado, o processamento continua em segundo plano e o usuário pode acompanhar a evolução pelo painel. Caso o servidor seja reiniciado, a execução pode ser retomada com base no progresso salvo.

Fila de processamento

Os enriquecimentos são processados em fila para evitar sobrecarga do sistema. Cada enriquecimento é dividido em lotes de registros. Dentro de cada lote, os datasets selecionados são consultados respeitando os limites de processamento configurados para cada dataset.

Progresso exibido

Durante a execução, o painel exibe informações como:
CampoDescrição
ProcessadosQuantidade de registros já processados.
EncontradosQuantidade de registros com dados retornados.
InválidosQuantidade de registros com CPF ou CNPJ inválido.
Não localizadosQuantidade de registros válidos sem retorno nos datasets selecionados.
FalhasQuantidade de registros que falharam por erro técnico.
Valor consumidoValor efetivamente consumido até o momento.

Status do enriquecimento

StatusDescrição
queuedEnriquecimento aguardando processamento.
processingEnriquecimento em execução.
completedEnriquecimento concluído com sucesso.
completed_with_errorsEnriquecimento concluído com falhas parciais.
failedEnriquecimento falhou.
cancelledEnriquecimento cancelado.

Retomada após interrupção

O progresso do enriquecimento é salvo durante o processamento. Se houver reinício do servidor ou interrupção temporária, a Lazy Data pode continuar a execução a partir do ponto salvo, evitando reprocessar toda a base.

Cobrança

Antes de iniciar o enriquecimento, a plataforma calcula uma estimativa com base em:
  • quantidade de registros;
  • datasets selecionados;
  • preço de cada dataset;
  • descontos aplicáveis ao plano.
Durante a execução, o valor consumido é atualizado conforme os registros são processados. Quando aplicável, registros ou datasets com falha podem gerar estorno.

Datasets com cobrança condicionada

Alguns datasets podem possuir cobrança condicionada ao retorno de dados. Nesses casos, registros sem resultado podem não consumir saldo, conforme a regra configurada para o dataset.

Falhas parciais

Uma falha em um dataset ou registro não interrompe necessariamente todo o enriquecimento. Quando possível, a Lazy Data continua processando os demais registros e datasets, registrando as falhas para análise posterior.

Arquivos finais

Ao final do processamento, os arquivos gerados ficam disponíveis para download.
ArquivoQuando aparece
SucessosQuando existem registros enriquecidos.
Não encontradosQuando existem registros válidos sem retorno.
FalhasQuando existem registros com erro de processamento.
Arquivos vazios não são gerados.

Valor consumido

O campo de valor consumido representa o custo efetivo do enriquecimento até o momento. Esse valor pode ser menor que a estimativa inicial quando:
  • registros são inválidos;
  • datasets falham e geram estorno;
  • datasets configurados para cobrar apenas com retorno não encontram dados;
  • parte da base não é processada.

Conclusão do enriquecimento

Quando o enriquecimento termina, o status passa para completed ou completed_with_errors. A partir desse momento, os arquivos finais disponíveis podem ser baixados pelo painel.

Boas práticas

  • Revise a coluna de CPF ou CNPJ antes de iniciar.
  • Selecione apenas datasets necessários para o objetivo da base.
  • Confira a estimativa antes de confirmar o processamento.
  • Para bases grandes, acompanhe o progresso periodicamente.
  • Baixe os arquivos finais após a conclusão.

Próximos passos

Arquivos de entrada e saída

Consulte a estrutura dos arquivos aceitos e dos resultados gerados.