Skip to main content
O upload para enriquecimento é usado para enviar bases de CPF ou CNPJ que serão analisadas e enriquecidas pelos datasets selecionados. Após o upload, a Lazy Data valida o arquivo, identifica a estrutura da planilha, detecta a coluna de documento e prepara o enriquecimento para configuração.

​
Endpoint

POST https://upload.lazydata.com.br/enrichment
Em ambientes locais ou sandbox, o domínio pode variar conforme a configuração da integração.

​
Header obrigatório

A requisição deve enviar a assinatura temporária de upload no header. 
x-upload-signature: assinatura_temporaria

​
Como obter a assinatura

A assinatura é gerada no fluxo de criação do enriquecimento. Antes do upload, a aplicação cria ou reutiliza o enriquecimento em andamento e solicita uma assinatura temporária para envio do arquivo. A assinatura não deve ser persistida pelo cliente e deve ser usada apenas para o upload atual.

​
Formatos aceitos

O upload de enriquecimento aceita:
  • CSV
  • XLS
  • XLSX

​
Limite por arquivo

Cada arquivo pode ter até 1 GB. Arquivos acima desse limite são recusados.

​
Envio do arquivo

O arquivo deve ser enviado como multipart/form-data. Exemplo conceitual: 
POST /enrichment HTTP/1.1
Host: upload.lazydata.com.br
x-upload-signature: assinatura_temporaria
Content-Type: multipart/form-data
Campo do arquivo: 
file

​
Validações realizadas

Durante o upload, a Lazy Data valida:
  • assinatura temporária;
  • enriquecimento relacionado;
  • se o arquivo já foi enviado;
  • se o enriquecimento ainda aceita upload;
  • tamanho do arquivo;
  • extensão;
  • tipo de conteúdo;
  • integridade;
  • estrutura inicial do arquivo.

​
Análise do arquivo

Após o upload, a Lazy Data inicia a análise do arquivo. A análise pode identificar:
  • total de linhas;
  • presença de cabeçalho;
  • delimitador, no caso de CSV;
  • colunas disponíveis;
  • possível coluna de CPF ou CNPJ;
  • amostra das primeiras linhas;
  • formato de dados das colunas.
Essa etapa pode continuar em segundo plano após a resposta inicial do upload.

​
Resposta de upload recebido

Quando o arquivo é aceito para processamento, a API retorna: 
{
  "code": 200,
  "message": "Arquivo recebido e enviado para processamento.",
  "result": {
    "id": "8a1f7229-7cf0-48f8-912f-97ff6a4b1111",
    "status": "processing"
  }
}

​
Status após upload

O enriquecimento pode passar por estados como:
StatusDescrição
uploadingArquivo em envio.
analyzingArquivo sendo analisado.
ready_to_configureArquivo analisado e pronto para configurar coluna e datasets.
failedArquivo recusado ou análise falhou.

​
Arquivo sem cabeçalho

Quando a Lazy Data não identifica cabeçalho válido, as colunas podem ser exibidas com nomes genéricos. Exemplo: 
Coluna 1
Coluna 2
Coluna 3
Nesse caso, o usuário deve revisar a amostra e selecionar manualmente a coluna de CPF ou CNPJ.

​
Coluna de documento

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

​
Falhas comuns

Possíveis falhas no upload de enriquecimento:
  • assinatura inválida ou expirada;
  • enriquecimento não encontrado;
  • arquivo já enviado;
  • enriquecimento em status incompatível com upload;
  • arquivo acima de 1 GB;
  • formato não permitido;
  • arquivo vazio;
  • falha ao ler a planilha;
  • coluna de documento não identificada.
Consulte os códigos de erro de upload:

Códigos de erro de upload

Veja os erros possíveis durante o envio de arquivos.

​
Boas práticas

  • Use arquivos CSV para bases muito grandes.
  • Use cabeçalhos claros.
  • Evite colunas duplicadas.
  • Remova linhas vazias.
  • Não misture CPF e CNPJ no mesmo arquivo.
  • Revise a coluna detectada antes de iniciar o enriquecimento.
  • Solicite uma nova assinatura caso o upload demore ou falhe.

​
Próximos passos

Criar enriquecimento

Veja o fluxo completo para criar e configurar um enriquecimento.