📂 Estrutura de Dados — Pessoa Jurídica
Esta página descreve todos os campos possíveis na resposta do endpoint Dossiê Cadastral por CNPJ.Campos sem valor são omitidos da resposta. Trate sempre com null-safety.
Identificação
| Campo | Tipo | Descrição |
|---|---|---|
cnpj | string | CNPJ consultado (14 dígitos) |
documento | string | Mesmo valor que cnpj |
razaoSocial | string | Razão social registrada na Receita Federal |
nomeFantasia | string | Nome fantasia (quando cadastrado) |
naturezaJuridica | string | Natureza jurídica (ex: SOCIEDADE EMPRESARIA LIMITADA) |
porte | string | Porte da empresa: ME, EPP, MEDIO, GRANDE, DEMAIS |
segmento | string | Segmento de atuação (ex: COMERCIO, SERVICOS, INDUSTRIA) |
matriz | boolean | true se é a matriz; false se é filial |
idade | integer | Idade da empresa em anos desde a abertura |
dataAbertura | string | Data de abertura no formato YYYY-MM-DD |
website | string | Site da empresa (quando disponível) |
Situação Cadastral
| Campo | Tipo | Descrição |
|---|---|---|
situacaoCadastral | string | Status na Receita Federal: ATIVA, SUSPENSA, INAPTA, BAIXADA, NULA |
dataSituacaoCadastral | string | Data da última alteração de situação no formato YYYY-MM-DD |
Atividade Econômica
| Campo | Tipo | Descrição |
|---|---|---|
cnaePrincipal | string | Código do CNAE principal (7 dígitos) |
descricaoCnaePrincipal | string | Código + descrição completa do CNAE principal |
cnaesSecundarios | array | Lista de CNAEs secundários |
cnaesSecundarios[].codigo | string | Código do CNAE (7 dígitos) |
cnaesSecundarios[].descricao | string | Código + descrição completa do CNAE |
Dados Financeiros
| Campo | Tipo | Descrição |
|---|---|---|
capitalSocial | number | Capital social registrado em reais |
faturamentoEstimado | number | Faturamento anual estimado em reais |
quantidadeColaboradores | integer | Número estimado de colaboradores ativos |
Contato
| Campo | Tipo | Descrição |
|---|---|---|
telefones | array | Lista de telefones associados |
telefones[].tipo | string | Tipo do telefone: MOVEL, FIXO ou COMERCIAL |
telefones[].ddd | string | DDD (2 dígitos) |
telefones[].numero | string | Número do telefone (sem DDD) |
emails | array<string> | Lista de e-mails associados |
website | string | Site da empresa |
urlLinkedin | string | Perfil no LinkedIn (quando disponível) |
urlInstagram | string | Perfil no Instagram (quando disponível) |
urlFacebook | string | Perfil no Facebook (quando disponível) |
Endereços
| Campo | Tipo | Descrição |
|---|---|---|
enderecos | array | Endereços registrados |
enderecos[].tipoLogradouro | string | Tipo do logradouro (ex: RUA, AVENIDA, TRAVESSA) |
enderecos[].logradouro | string | Nome do logradouro |
enderecos[].numero | string | Número |
enderecos[].complemento | string | Complemento (quando disponível) |
enderecos[].bairro | string | Bairro |
enderecos[].cidade | string | Cidade |
enderecos[].uf | string | UF (sigla do estado) |
enderecos[].cep | string | CEP (8 dígitos, sem formatação) |
Quadro Societário
| Campo | Tipo | Descrição |
|---|---|---|
socios | array | Sócios e administradores atuais |
socios[].documento | string | CPF (11 dígitos) ou CNPJ (14 dígitos) do sócio |
socios[].nome | string | Nome completo ou razão social do sócio |
socios[].dataEntrada | string | Data de entrada na sociedade no formato YYYY-MM-DD |
antigosSocios | array | Ex-sócios que já saíram do quadro societário |
antigosSocios[].nome | string | Nome completo ou razão social do ex-sócio |
antigosSocios[].dataSaida | string | Data de saída da sociedade no formato YYYY-MM-DD |
Histórico de Funcionários
| Campo | Tipo | Descrição |
|---|---|---|
historicoFuncionarios | array | Quantidade de funcionários registrados por ano |
historicoFuncionarios[].ano | integer | Ano de referência |
historicoFuncionarios[].qtdeFuncionarios | integer | Quantidade de funcionários naquele ano |
Dívidas
| Campo | Tipo | Descrição |
|---|---|---|
dividas | object | Resumo de débitos federais |
dividas.total | number | Total de dívidas em reais |
dividas.totalPrevidenciaria | number | Débitos previdenciários (INSS) em reais |
dividas.totalFgts | number | Débitos de FGTS em reais |
dividas.totalNaoPrevidenciaria | number | Débitos não previdenciários em reais |