📂 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