Documentação > CNPJ Enriquecido

API › CNPJ › Enriquecido

CNPJ Enriquecido

Dado cadastral e geográfico de empresas brasileiras a partir do CNPJ, para KYB, prevenção a fraude, enriquecimento de crédito PJ e expansão.

Categoria CNPJ
Atualização Mensal (Receita Federal)
Fontes Receita Federal · PrismaData
Enriquecimentos 8 famílias geográficas
Para que serve

Aplicações

A partir de um CNPJ, a API entrega o cadastro consolidado da Receita Federal já normalizado e geocodificado, e ainda permite ligar enriquecimentos geográficos calculados na coordenada do endereço da empresa. É a base para decisões de KYB, prevenção a fraude, análise de risco de crédito PJ e planejamento de expansão.

KYB e Onboarding de PJ

Valide cadastro, situação e endereço de empresas no cadastro. Confirme se a razão social, CNAE e endereço declarados batem com a Receita Federal.

Prevenção a Fraude

Detecte endereço divergente entre RFB e geocoder, geocodificação de baixa qualidade, e proximidade a presídio ou favela do endereço declarado.

Crédito e Risco PJ

Use porte, capital social, regime tributário, tempo de operação e renda do entorno como features em modelos de concessão e precificação.

Expansão e Inteligência Territorial

Cruze a atividade da empresa (CNAE) com tipologia do endereço, aglomeração comercial e renda do ponto para decisões de expansão e cobertura.

Entendendo o dado

Conceito

A API recebe um CNPJ e devolve o cadastro consolidado da Receita Federal — os campos do grupo pessoa_juridica — já normalizado e geocodificado. Aceita CNPJ de 14 caracteres com ou sem máscara e o novo formato alfanumérico da RFB.

Opcionalmente, cada família de enriquecimento geográfico habilitada acrescenta um grupo de campos calculado a partir da coordenada do endereço da empresa. Quando o CNPJ não tem coordenada geocodificável, apenas os campos de pessoa_juridica são retornados; nenhum enriquecimento é executado e nenhuma cota adicional é consumida.

Interpretação

Convenção de Sinais

Três campos de pessoa_juridica concentram os sinais de qualidade do endereço e são a linha de defesa contra fraude documental em PJ. Sem coordenada, os grupos de enriquecimento não vêm.

●
endereco_existe: false O endereço declarado não foi encontrado na base de logradouros. É um sinal forte de endereço fictício ou mal preenchido — atenção redobrada em onboarding.
●
divergencia_endereco_rfb_geocoder: true O endereço da Receita Federal diverge do que a geocodificação resolveu. Pode indicar erro cadastral, endereço genérico (ex.: "sala X" sem número), ou uso de endereço de terceiros.
○
qualidade_geocodificacao_classificacao ∈ {MUITO_ALTA, ALTA} A coordenada é confiável e os enriquecimentos geográficos podem ser usados diretamente em decisão. Em MEDIA/BAIXA, considere-os com ressalva; em MUITO_BAIXA/FALHA, evite.
●
latitude: null / longitude: null O CNPJ não tem coordenada geocodificável. Nenhum grupo de enriquecimento geográfico será retornado, mesmo com as flags ligadas.
Request

Parâmetros de Entrada

Um único parâmetro obrigatório no path — o CNPJ — e oito flags booleanas opcionais em query que ligam grupos de enriquecimento geográfico. Cada flag ligada conta como uma consulta adicional; flags puladas por falta de coordenada não contam.

cnpj path · string

CNPJ de 14 caracteres, com ou sem máscara. Aceita o novo formato alfanumérico da Receita Federal.

Flags de enriquecimento

slum boolean · default false

Proximidade e classificação de favelas no endereço da empresa.

prison boolean · default false

Proximidade e detalhes do presídio mais próximo do endereço.

border boolean · default false

Situação em relação a fronteiras internacionais (faixa de fronteira).

personal_income_static boolean · default false

Renda média estimada no ponto do endereço, com percentis BR/UF/município.

personal_income_pdf boolean · default false

Distribuição de renda no ponto (média, mediana, z-score).

commercial_cluster boolean · default false

Se o endereço está em aglomeração comercial e detalhes dela (vocação, porte, PDVs).

infosc boolean · default false

Informações do setor censitário IBGE do endereço.

tipologia boolean · default false

Tipologia CNEFE do endereço (finalidade, espécie, tipo de moradia).

sandbox boolean · default false

Quando true, retorna dados sintéticos para testes. Consultas em modo sandbox não contam para efeito de cota.

Observação: as flags só produzem efeito quando o CNPJ tem coordenadas. Se latitude/longitude vierem null, nenhum grupo de enriquecimento é retornado.

Na prática

Exemplos

Dois cenários ilustrativos: empresa com endereço bem geocodificado (retorna cadastro + enriquecimentos), e CNPJ sem coordenada (retorna apenas cadastro).

Consulta enriquecida com bom endereço GET /v1/cnpj/58150174000110/enriched?tipologia=true&personal_income_static=true 
{
  "prismadata__pessoa_juridica__cnpj": "58150174000110",
  "prismadata__pessoa_juridica__razao_social": "PRISMADATA TECNOLOGIA E INTELIGENCIA DE DADOS LTDA",
  "prismadata__pessoa_juridica__nome_fantasia": "PRISMADATA",
  "prismadata__pessoa_juridica__matriz_filial": "MATRIZ",
  "prismadata__pessoa_juridica__situacao_cadastral": "ATIVA",
  "prismadata__pessoa_juridica__porte": "PEQUENA",
  "prismadata__pessoa_juridica__natureza_juridica_descricao": "Sociedade Empresária Limitada",
  "prismadata__pessoa_juridica__cnae_principal_codigo": "6209100",
  "prismadata__pessoa_juridica__latitude": "-23.561414",
  "prismadata__pessoa_juridica__longitude": "-46.655881",
  "prismadata__pessoa_juridica__qualidade_geocodificacao_classificacao": "MUITO_ALTA",
  "prismadata__pessoa_juridica__qualidade_geocodificacao_score": 96,
  "prismadata__pessoa_juridica__endereco_existe": true,
  "prismadata__pessoa_juridica__divergencia_endereco_rfb_geocoder": false,

  "prismadata__tipologia__finalidade": "COMERCIAL",
  "prismadata__tipologia__especie": "EDIFICIO_ESCRITORIOS",
  "prismadata__tipologia__tipo_moradia": null,
  "prismadata__tipologia__confianca": "ALTA",
  "prismadata__tipologia__cobertura": true,

  "prismadata__personal_income_static__faixa_sm_min": 15.0,
  "prismadata__personal_income_static__faixa_sm_max": 20.0,
  "prismadata__personal_income_static__percentil_br": 96,
  "prismadata__personal_income_static__percentil_uf": 94,
  "prismadata__personal_income_static__percentil_mun": 91
}

Empresa ATIVA, com geocodificação MUITO_ALTA (score 96) e sem divergência entre RFB e geocoder. Os enriquecimentos habilitados vêm preenchidos: tipologia CNEFE identifica o endereço como edifício comercial de escritórios, e a renda estática coloca o ponto no percentil 96 do país. Os enriquecimentos não pedidos (favela, presídio, fronteira, etc.) simplesmente não aparecem.

CNPJ sem coordenada geocodificável GET /v1/cnpj/{cnpj}/enriched?slum=true&prison=true&infosc=true 
{
  "prismadata__pessoa_juridica__cnpj": "12345678000199",
  "prismadata__pessoa_juridica__razao_social": "EXEMPLO INDUSTRIA E COMERCIO LTDA",
  "prismadata__pessoa_juridica__nome_fantasia": null,
  "prismadata__pessoa_juridica__matriz_filial": "MATRIZ",
  "prismadata__pessoa_juridica__situacao_cadastral": "ATIVA",
  "prismadata__pessoa_juridica__porte": "MICRO",
  "prismadata__pessoa_juridica__cnae_principal_codigo": "4520001",
  "prismadata__pessoa_juridica__logradouro": "ESTRADA VELHA S/N",
  "prismadata__pessoa_juridica__numero": "SN",
  "prismadata__pessoa_juridica__municipio_nome": "MUNICIPIO INTERIOR",
  "prismadata__pessoa_juridica__uf": "MG",

  "prismadata__pessoa_juridica__latitude": null,
  "prismadata__pessoa_juridica__longitude": null,
  "prismadata__pessoa_juridica__endereco_normalizado": null,
  "prismadata__pessoa_juridica__qualidade_geocodificacao_classificacao": "FALHA",
  "prismadata__pessoa_juridica__qualidade_geocodificacao_score": null,
  "prismadata__pessoa_juridica__endereco_existe": false,
  "prismadata__pessoa_juridica__divergencia_endereco_rfb_geocoder": null
}

Endereço genérico ("Estrada Velha S/N") não foi geocodificado: endereco_existe: false, coordenadas nulas, classificação FALHA. Mesmo com slum, prison e infosc habilitadas, nenhum grupo de enriquecimento vem — e a cota não é consumida por eles.

Os JSONs acima são ilustrativos e resumem os campos mais relevantes de cada cenário. Consulte a lista completa na seção seguinte.

Response

Atributos Retornados

Todos os campos de pessoa_juridica vêm sempre; os grupos de enriquecimento só aparecem quando a flag está ligada e o CNPJ tem coordenada. Os nomes abaixo são exibidos sem o prefixo prismadata__pessoa_juridica__.

Identificação
cnpj
CNPJ de 14 caracteres, sem máscara.
cnpj_basico
Primeiros 8 caracteres do CNPJ (identifica a matriz e todas as filiais).
cnpj_ordem
4 caracteres que identificam a filial (0001 é a matriz).
cnpj_dv
2 dígitos verificadores.
cnpj_alfanumerico
true quando o CNPJ contém letras (novo formato da Receita Federal).
matriz_filial
MATRIZ ou FILIAL.
Cadastro
razao_social
Razão social registrada na Receita Federal.
nome_fantasia
Nome fantasia declarado, se houver.
situacao_cadastral
Situação atual: NULA, ATIVA, SUSPENSA, INAPTA ou BAIXADA.
data_situacao_cadastral
Data (YYYY-MM-DD) da última mudança de situação.
motivo_situacao_cadastral
Motivo textual da situação atual.
data_abertura
Data (YYYY-MM-DD) de constituição da empresa.
natureza_juridica_codigo
Código IBGE da natureza jurídica.
natureza_juridica_descricao
Descrição textual da natureza jurídica.
porte
Porte: NAO_INFORMADO, MICRO, PEQUENA ou DEMAIS.
capital_social
Capital social declarado (valor decimal em texto).
Regime tributário
opcao_simples
Se é optante do Simples Nacional.
data_opcao_simples
Data de adesão ao Simples.
opcao_mei
Se é optante do MEI.
data_opcao_mei
Data de adesão ao MEI.
Atividade econômica
cnae_principal_codigo
Código CNAE da atividade principal (7 dígitos).
cnae_principal_descricao
Descrição da atividade principal.
cnae_secundario_1
Primeiro CNAE secundário (na ordem em que aparece no cadastro).
cnae_secundario_2
Segundo CNAE secundário.
cnae_secundario_3
Terceiro CNAE secundário.
total_cnaes_secundarios
Número total de CNAEs secundários registrados. Para ver a lista completa, use a consulta detalhada.
Endereço
logradouro
Nome do logradouro.
numero
Número do endereço.
complemento
Complemento do endereço.
bairro
Bairro.
municipio_codigo
Código IBGE do município.
municipio_nome
Nome do município.
uf
UF (2 caracteres).
cep
CEP sem máscara.
Geolocalização & qualidade
id_logradouro
Identificador estável do logradouro, útil para correlacionar com outros produtos de geolocalização da PrismaData.
id_loc
Identificador estável da localização, útil para correlacionar com outros produtos de geolocalização da PrismaData.
latitude
Latitude do endereço. null quando não foi possível geocodificar.
longitude
Longitude do endereço. null quando não foi possível geocodificar.
endereco_normalizado
Endereço reescrito no padrão usado pela geocodificação.
qualidade_geocodificacao_score
Score de qualidade da geocodificação (0-100).
qualidade_geocodificacao_classificacao
Classificação da qualidade da geocodificação: MUITO_ALTA, ALTA, MEDIA, BAIXA, MUITO_BAIXA ou FALHA.
endereco_existe
Se o endereço foi encontrado na base de referência da geocodificação.
divergencia_endereco_rfb_geocoder
Sinaliza divergência entre o endereço cadastrado na Receita Federal e o endereço geocodificado.
Sócios
total_socios
Número total de sócios cadastrados.
total_socios_pf
Número de sócios pessoa física.
total_socios_pj
Número de sócios pessoa jurídica.
total_socios_estrangeiro
Número de sócios estrangeiros.
Metadados
data_publicacao_rfb
Data da publicação dos dados pela Receita Federal (versão da base).
data_processamento
Data e hora em que os dados foram enriquecidos.
Enriquecimentos geográficos (opcionais)
prismadata__slum__*
Proximidade e classificação de favelas — ver favelas.html.
prismadata__prison__*
Proximidade a presídios — ver presidio.html.
prismadata__border__*
Situação em relação à faixa de fronteira — ver border.html.
prismadata__infosc__*
Setor censitário IBGE — ver infosc.html.
prismadata__tipologia__*
Tipologia CNEFE do endereço (finalidade, espécie, tipo de moradia, confiança, cobertura).
prismadata__personal_income_static__*
Renda média no ponto com percentis BR/UF/município — ver renda_estatica.html.
prismadata__personal_income_pdf__*
Distribuição de renda no ponto (média, mediana, z-score).
prismadata__commercial_cluster__*
Aglomerações comerciais próximas (nome, vocação, porte, PDVs, faixa de renda).
Referência

Detalhes Técnicos

Fontes

  • Cadastro Nacional da Pessoa Jurídica (dados abertos da Receita Federal)
  • Geocodificação e enriquecimento geográfico PrismaData

Metodologia

Ingestão dos dados abertos da RFB, normalização e geocodificação do endereço, e cálculo dos enriquecimentos a partir da coordenada resultante. Sinais de qualidade (score, classificação, divergência RFB × geocoder) acompanham cada registro.

Frequência de Atualização

Acompanha a publicação mensal dos dados abertos de CNPJ da RFB. Os campos data_publicacao_rfb e data_processamento identificam a versão.

Cobertura

Todas as empresas do país (matrizes e filiais, ativas e baixadas). Enriquecimentos geográficos dependem de geocodificação bem-sucedida — endereços mal preenchidos na RFB podem não geocodificar.

Atenção

Limitações

Considere ao utilizar

  • Enriquecimentos geográficos só são retornados quando o endereço tem coordenada geocodificável; parte da base não geocodifica.
  • A qualidade da coordenada varia. Use qualidade_geocodificacao_classificacao e divergencia_endereco_rfb_geocoder antes de confiar nos enriquecimentos em uma decisão automática.
  • Os dados cadastrais dependem da última publicação da RFB e podem estar defasados em relação à situação real da empresa.
  • Endereços mal preenchidos na RFB (complemento ausente ou ambíguo, "sem número", zona rural sem referência) reduzem a precisão da geocodificação.

Pronto para testar?

Explore o playground do CNPJ Enriquecido: cole um CNPJ, ligue as flags e veja o retorno em tempo real com mapa e resumo.

Abrir Playground