Dados retornados pela API: JSON com empresa, sócios e contatos

Estrutura JSON completa: dados cadastrais, endereço, telefones, email, CNAEs, sócios com qualificação, faixa etária e contatos extras.

A API retorna dados em formato JSON estruturado em três seções principais:

1. company: Dados cadastrais completos da empresa
2. socios: Lista de sócios e administradores
3. contatos_extras: Emails e websites adicionais

Seção: Company (Dados Cadastrais)

Esta seção contém todas as informações cadastrais da empresa.

Identificação:

• cnpj: Número do CNPJ (14 dígitos)
• razao_social: Razão social da empresa
• nome_fantasia: Nome fantasia
• raiz_cnpj: Raiz do CNPJ (8 primeiros dígitos)
• matriz_filial: Indica se é MATRIZ ou FILIAL

Atividade Econômica:

• cnae_fiscal: CNAE principal (formato: código/subclasse)
• cnaes_secundarios: Array com CNAEs secundários
• natureza_juridica: Descrição da natureza jurídica
• cod_nat_juridica: Código da natureza jurídica

Situação Cadastral:

• situacao_cadastral: Status da empresa (ATIVA, SUSPENSA, BAIXADA, etc.)
• data_situacao: Data da situação cadastral
• motivo_situacao: Motivo da situação cadastral
• data_inicio_atividade: Data de início das atividades

Informações Financeiras:

• capital_social: Capital social da empresa (número decimal)
• porte: Código do porte da empresa (01=Micro, 03=Pequena, 05=Demais)
• opc_simples: Se optante do Simples Nacional (SIM/NÃO)
• data_opc_simples: Data da opção pelo Simples
• opc_mei: Se é MEI (SIM/NÃO)

Endereço:

• tipo_logradouro: Tipo do logradouro (RUA, AVENIDA, etc.)
• logradouro: Nome do logradouro
• numero: Número do endereço
• complemento: Complemento do endereço
• bairro: Bairro
• cep: CEP (formato: 00000-000)
• uf: Sigla do estado
• municipio: Nome do município
• cod_municipio: Código do município

Contatos:

• ddd_1: DDD do telefone principal
• telefone_1: Telefone principal
• email: Email principal cadastrado
• has_email: Boolean indicando se possui email
• has_website: Boolean indicando se possui website

Exemplo Completo de Dados de Company

"company": {
"cnpj": 12345678000190,
"razao_social": "EMPRESA EXEMPLO LTDA",
"nome_fantasia": "Empresa Exemplo",
"cnae_fiscal": "6201-5/00",
"cnaes_secundarios": ["6202-3/00", "6203-1/00"],
"data_inicio_atividade": "2020-01-15",
"situacao_cadastral": "ATIVA",
"data_situacao": "2020-01-15",
"motivo_situacao": "SEM MOTIVO",
"natureza_juridica": "Sociedade Empresária Limitada",
"cod_nat_juridica": "206-2",
"capital_social": 100000.0,
"porte": "03",
"opc_simples": "SIM",
"data_opc_simples": "2020-01-15",
"opc_mei": "NÃO",
"matriz_filial": "MATRIZ",
"tipo_logradouro": "RUA",
"logradouro": "DAS FLORES",
"numero": "100",
"complemento": "SALA 1",
"bairro": "CENTRO",
"cep": "01310-100",
"uf": "SP",
"cod_municipio": "7107",
"municipio": "São Paulo",
"ddd_1": "11",
"telefone_1": "99999-9999",
"email": "[email protected]",
"has_email": true,
"has_website": false,
"raiz_cnpj": 12345678
}

Seção: Sócios

Array contendo informações de todos os sócios e administradores da empresa.

Dados de Cada Sócio:

• nome_socio: Nome completo do sócio
• cnpj_cpf_socio: CPF ou CNPJ do sócio (sem formatação)
• cod_qualificacao: Código da qualificação do sócio
• qualificacao_socio: Descrição da qualificação (ex: "Sócio-Administrador")
• tipo_socio: Código do tipo (1=Pessoa Jurídica, 2=Pessoa Física, 3=Estrangeiro)
• tipo_socio_descricao: Descrição do tipo de sócio
• data_entrada: Data de entrada na sociedade
• faixa_etaria: Faixa etária do sócio (apenas para pessoas físicas)

Exemplo de Dados de Sócios

"socios": [
{
"nome_socio": "JOAO SILVA",
"cnpj_cpf_socio": "12345678900",
"cod_qualificacao": "49",
"qualificacao_socio": "Sócio-Administrador",
"tipo_socio": "2",
"tipo_socio_descricao": "Pessoa Física",
"data_entrada": "2020-01-15",
"faixa_etaria": "41 a 50 anos"
}
]

Seção: Contatos Extras

Array contendo emails e websites adicionais da empresa.

Dados de Cada Contato:

• cnpj: CNPJ da empresa
• tipo_contato: Tipo do contato ("email" ou "website")
• tipo_website: Subtipo do website (quando aplicável: "social", "institucional", etc.)
• contato: O email ou URL do website

Exemplo de Contatos Extras

"contatos_extras": [
{
"cnpj": "12345678000190",
"tipo_contato": "email",
"tipo_website": null,
"contato": "[email protected]"
},
{
"cnpj": "12345678000190",
"tipo_contato": "website",
"tipo_website": "social",
"contato": "https://facebook.com/empresa"
}
]

Interpretando os Códigos

Códigos de Porte:

• 01: Microempresa
• 03: Empresa de Pequeno Porte
• 05: Demais (Média ou Grande)

Situações Cadastrais Comuns:

• ATIVA: Empresa em funcionamento regular
• SUSPENSA: Atividades temporariamente suspensas
• INAPTA: Empresa inapta perante a Receita Federal
• BAIXADA: Empresa encerrou suas atividades
• NULA: Cadastro anulado

Tipo de Sócio:

• 1: Pessoa Jurídica
• 2: Pessoa Física
• 3: Estrangeiro

Processando as Respostas

1. Sempre verifique o código de status HTTP antes de processar o JSON
2. Valide se as seções esperadas estão presentes na resposta
3. Os arrays (socios e contatos_extras) podem estar vazios
4. Campos de texto podem conter valores null
5. Valores numéricos como capital_social são retornados como float
6. Datas seguem o formato ISO (YYYY-MM-DD)
7. CNPJs são retornados como números inteiros (sem formatação)