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 Nesta página Aplicações Conceito Convenção de sinais Entradas Exemplos Atributos retornados Detalhes técnicos Limitações 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, CENTROIDE_MUNICIPIO ou NAO_GEOCODIFICADO, 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": "NAO_GEOCODIFICADO", "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 `NAO_GEOCODIFICADO`. 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, derivada do score em faixas: * `MUITO_ALTA` — score ≥ 90 (endereço exato ou correção leve). * `ALTA` — 70 ≤ score < 90 (endereço bom, correções pequenas ou interpolação leve). * `MEDIA` — 50 ≤ score < 70 (correção de bairro ou interpolação de rua). * `BAIXA` — 30 ≤ score < 50 (endereço reconstruído). * `MUITO_BAIXA` — 1 ≤ score < 30 (match pobre). * `NAO_GEOCODIFICADO` — score 0 ou ausente (não foi possível resolver o endereço). * `CENTROIDE_MUNICIPIO` — fallback municipal (score fixo em 5). Coordenada é a sede oficial do município — usar apenas como fallback, não como endereço. 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](). O campo `cd_setor` (código IBGE do setor) requer role específica: cliente comercial padrão recebe `null` neste campo enquanto o restante do bloco vem preenchido. 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](). Quando o ponto cai fora de setor censitário (águas continentais, offshore, fora do BR), os campos retornam a string `"SEM_INFORMACAO"` — atenção ao teste truthy no cliente. prismadata__personal_income_pdf__* Distribuição de renda no ponto (média, mediana, z-score). Mesmo comportamento `"SEM_INFORMACAO"` do `personal_income_static` quando o ponto cai fora de setor censitário. prismadata__commercial_cluster__* Aglomerações comerciais próximas (nome, vocação, porte, PDVs, faixa de renda). Fonte: cadastro CNPJ da Receita Federal intersectado com a malha viária OpenStreetMap — aproximadamente onze mil aglomerações mapeadas nacionalmente. 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 ](<../api-playground/cnpj/>) [ Solicitar acesso ]()