---
title: "Layouts de enriquecimento: como escolher o layout correto para envio de dados"
description: "Entenda como funcionam os layouts de enriquecimento, quais dados devem ser enviados em cada modelo e quais informações serão retornadas após o processamento."
url: https://suporte.datastone.com.br/pt-br/articles/11385775-layouts-de-enriquecimento-como-escolher-o-layout-correto-para-envio-de-dados
collection: "Enriquecimento"
updated: 2026-11-17
language: pt-br
---

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

Entenda como funcionam os layouts de enriquecimento, quais dados devem ser enviados em cada modelo e quais informações serão retornadas após o processamento.

## 🔍 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.
    

> **Success:** 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.
    

> **Info:** 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.
    

> **Success:** É 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.
    

> **Success:** É 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.
    

> **Success:** É 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.
    

> **Success:** É 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

<table data-id="dd6e8fa8-6d35-4f13-9dd8-261d058e2487" style="min-width: 25px;"><colgroup><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p data-id="f98eb2c0-ae51-4371-b88c-206b0701ef71">12345678900</p></td></tr></tbody></table>

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.
    

> **Warning:** 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.
