Layouts de enriquecimento: como escolher o layout correto para envio de dados

🔍 O que são layouts de enriquecimento?

Os layouts de enriquecimento definem:

• quais dados precisam ser enviados;

• quais informações serão retornadas;

• como o arquivo deve estar estruturado.

Cada layout possui:

• um identificador obrigatório de entrada;

• uma estrutura específica de retorno;

• regras próprias de processamento.

Os layouts determinam exatamente:

• o formato esperado da planilha enviada;

• as colunas disponíveis no arquivo processado;

• os tipos de dados enriquecidos.

Escolher o layout correto evita falhas no processamento e garante que o retorno contenha os dados esperados.

⚠ O que pode causar erro no enriquecimento?

Os erros mais comuns acontecem quando:

• o identificador obrigatório não é enviado;

• o layout selecionado não corresponde ao tipo de dado enviado;

• o arquivo possui formatação inválida;

• o usuário espera informações que não fazem parte daquele layout.

Exemplo:

• enviar CPF em um layout que exige CNPJ;

• utilizar layout de telefone esperando retorno de e-mails.

✅ Como funcionam os layouts disponíveis

👤 Layouts para Pessoa Física (PF)

📍 Padrão - Completo localização PF

Objetivo

Enriquecer dados completos de localização e contato de pessoas físicas.

Dados obrigatórios para envio

• CPF.

Dados retornados

• Documento;

• Nome;

• Tipo;

• Endereço completo;

• Telefones fixos e celulares;

• E-mails.

Indicado para

• localização de clientes;

• atualização cadastral;

• enriquecimento completo de contatos PF.

👤 Padrão - Completo PF

Objetivo

Enriquecer dados completos de pessoas físicas.

Dados obrigatórios para envio

• CPF.

Dados retornados

• Documento;

• Nome;

• Tipo;

• Endereço completo;

• Telefones;

• E-mails.

Indicado para

• enriquecimento completo de base PF.

⭐ Padrão - Completo plus PF

Objetivo

Enriquecer dados avançados de pessoas físicas.

Dados obrigatórios para envio

• CPF.

Dados retornados

Inclui:

• dados pessoais;

• renda;

• função;

• RG;

• data de nascimento;

• status PEP;

• WhatsApp ativo;

• telefones;

• e-mails;

• endereço completo.

Esse layout retorna informações mais completas e pode gerar arquivos maiores.

📧 Padrão - Email PF

Objetivo

Retornar e-mails vinculados a pessoas físicas.

Dados obrigatórios para envio

• CPF.

Dados retornados

• Documento;

• E-mail;

• Prioridade.

É possível configurar a quantidade de e-mails retornados por CPF.

🏠 Padrão - Endereço PF

Objetivo

Retornar endereços vinculados a pessoas físicas.

Dados obrigatórios para envio

• CPF.

Dados retornados

• Endereço completo;

• Tipo;

• Prioridade.

É possível configurar quantos endereços serão retornados para cada CPF.

📱 Padrão — Telefone PF

Objetivo

Retornar telefones vinculados a pessoas físicas.

Dados obrigatórios para envio

• CPF.

Dados retornados

• DDD;

• Telefone;

• Tipo de telefone.

📱 Padrão — Telefone + PF

Objetivo

Retornar telefones com informações adicionais.

Dados obrigatórios para envio

• CPF.

Dados retornados

• DDD;

• Telefone;

• Prioridade;

• Tipo de telefone;

• WhatsApp ativo;

• Quantidade de dispositivos conectados.

📊 Padrão — Telefone + PF em colunas

Objetivo

Retornar telefones organizados em colunas.

Dados obrigatórios para envio

• CPF.

Dados retornados

• celulares separados por colunas;

• status de WhatsApp;

• telefones fixos.

Indicado para

• exportação para CRM;

• campanhas;

• automações.

👤 Padrão — Telefone PF e nome

Objetivo

Retornar nome e telefones de pessoas físicas.

Dados obrigatórios para envio

• CPF.

Dados retornados

• Nome;

• Telefones;

• Cidade;

🔎 Padrão — Pesquisa por nome PF

Objetivo

Localizar dados de pessoas físicas a partir do nome.

Dados obrigatórios para envio

• Nome.

Dados retornados

• Documento;

• Endereço;

• Telefones;

• E-mails.

📧 Padrão — Pesquisa por e-mail PF

Objetivo

Localizar dados de pessoas físicas a partir do e-mail.

Dados obrigatórios para envio

• E-mail.

Dados retornados

• CPF;

• Nome;

• Outros e-mails;

• Telefones;

• Endereço completo.

📞 Padrão — Pesquisa por telefone

Objetivo

Localizar dados de pessoa física a partir de um telefone.

Dados obrigatórios para envio

• Telefone.

Dados retornados

• CPF;

• Nome.

🏢 Layouts para Pessoa Jurídica (PJ)

📍 Padrão — Completo localização PJ

Objetivo

Enriquecer dados completos de empresas, incluindo localização e contatos.

Dados obrigatórios para envio

• CNPJ.

Dados retornados

Inclui:

• razão social;

• nome fantasia;

• CNAE;

• situação cadastral;

• endereço;

• telefones;

• e-mails;

• dados empresariais.

📧 Padrão — Email PJ

Objetivo

Retornar e-mails vinculados a empresas.

Dados obrigatórios para envio

• CNPJ.

Dados retornados

• Documento;

• E-mail;

• Prioridade.

É possível definir quantos e-mails serão retornados.

👥 Padrão — Email PJ Sócios

Objetivo

Retornar e-mails de sócios vinculados à empresa.

Dados obrigatórios para envio

• CNPJ.

Dados retornados

• Nome do sócio;

• E-mail do sócio;

• Prioridade.

📱 Padrão — Telefone PJ

Objetivo

Retornar telefones de empresas.

Dados obrigatórios para envio

• CNPJ.

Dados retornados

• DDD;

• Telefone;

• Tipo de telefone.

👥 Padrão — Telefone PJ sócios

Objetivo

Retornar telefones de sócios vinculados à empresa.

Dados obrigatórios para envio

• CNPJ.

Dados retornados

• Nome do sócio;

• Telefone;

• WhatsApp;

• CPF do sócio.

📲 Padrão — Telefone + e-mail sócio PJ

Objetivo

Retornar telefones e e-mails de sócios vinculados à empresa.

Dados obrigatórios para envio

• CNPJ.

Dados retornados

• Nome do sócio;

• Telefone;

• E-mail;

• Tipo de telefone;

• WhatsApp;

• CPF do sócio.

É possível configurar a quantidade de sócios, telefones e e-mails devem retornar caso haja mais de um.

🔎 Padrão — Pesquisa por razão social PJ

Objetivo

Localizar empresas e sócios a partir da razão social.

Dados obrigatórios para envio

• Razão social.

Dados retornados

• Documento;

• Razão social;

• Nome dos sócios;

• Telefones;

• E-mails.

📲 Layout para validação de WhatsApp

✅ Padrão — Filtro WhatsApp

Objetivo

Validar se um telefone possui WhatsApp ativo.

Dados obrigatórios para envio

• Telefone.

Dados retornados

• Telefone;

• Flag de WhatsApp;

• Descrição.

Indicado para

• higienização de base;

• campanhas;

• validação de contatos.

💡 Exemplo prático de funcionamento

Exemplo de envio

Arquivo enviado:

CPF

Layout selecionado:

• Padrão — Email PF

Resultado esperado:

• retorno de e-mails vinculados ao CPF informado.

📄 Como visualizar o modelo correto de arquivo

Antes de enviar a base, o sistema disponibiliza:

• exemplo de envio;

• exemplo de retorno;

• estrutura esperada do arquivo;

• colunas obrigatórias.

Sempre valide o exemplo de envio antes de iniciar o processamento.

🚨 O que verificar antes de tentar novamente

Confira os seguintes pontos:

• o layout selecionado está correto;

• a coluna obrigatória existe;

• CPF, CNPJ, telefone ou e-mail estão válidos;

• o arquivo está no formato aceito pela plataforma.