O endpoint /api/CadastroPessoaJuridica permite consultar dados detalhados sobre Pessoas Jurídicas registradas, incluindo informações cadastrais, atividades econômicas, dados societários e estimativas de faturamento.
Cadastro - Pessoa Jurídica - Básica
Consulta responsável por retornar dados de cadastro de um CNPJ recuperadas de fontes oficiais e combinadas com inferências e outros dados relacionados.
Estimativa de Faturamento Presumido das Empresas no Brasil
Este estudo tem como objetivo estimar o faturamento presumido das empresas brasileiras com base em múltiplas variáveis estruturais e operacionais. A metodologia utilizada permite uma análise abrangente considerando fatores determinantes para a geração de receita empresarial.
Metodologia e Variáveis Utilizadas
Para a estimativa do faturamento, foram consideradas as seguintes variáveis:
CNAE: Classificação Nacional das Atividades Econômicas, indicando o setor de atuação;
Natureza Jurídica: Tipo de constituição legal da empresa;
Porte: Classificação como MEI, ME, EPP, médio ou grande porte;
Quantidade de Funcionários: Indicador da capacidade produtiva e operacional;
Quantidade de Sócios (Pessoa Física e Jurídica): Estrutura societária e seu impacto na governança corporativa;
Quantidade de Filiais: Reflexo da expansão territorial e volume de negócios;
Capital Social: Indicador da robustez financeira da empresa;
Antiguidade (anos de existência): Relacionado à estabilidade e experiência de mercado.
Modelo de Estimação
A modelagem estatística empregada cruzou os dados dessas variáveis para criar uma estimativa confiável do faturamento presumido. Foram utilizadas técnicas de regressão e aprendizado de máquina para identificar padrões e correlações entre os fatores analisados.
Resultados e Aplicações
Os resultados obtidos permitem segmentar empresas por faixas de faturamento, fornecendo insights relevantes para:
Planejamento tributário e enquadramento fiscal adequado;
Análises de crédito e risco financeiro;
Formulação de políticas públicas e estratégicas setoriais;
Benchmarking empresarial e estudos de mercado.
Conclusão
A estimativa do faturamento presumido, baseada em variáveis estruturais e operacionais, possibilita um diagnóstico preciso do ambiente empresarial brasileiro. Este estudo contribui para a tomada de decisões estratégicas e facilita a análise econômica de diferentes setores e portes empresariais.
Casos de Uso
- Onboarding e qualificação de fornecedores (KYS/KYB)
- Análise de crédito e risco de empresas
- Compliance e due diligence de parceiros
- Enriquecimento de leads B2B
Aplicações
- Onboarding de Clientes e Fornecedores
- Análise de Risco/Crédito
Benefícios
- Reduz inadimplência com checagens confiáveis
- Aumenta a eficiência do cadastro com menos retrabalho
- Facilita auditorias e conformidade regulatória
- Integração rápida com respostas padronizadas
URL Base
A API está hospedada no seguinte endereço:
https://apiv3.directd.com.br/api/CadastroPessoaJuridicaEndpoint
GET https://apiv3.directd.com.br/api/CadastroPessoaJuridica?CNPJ={0}&Token=Seu_TokenDescrição: Endpoint para realizar consultas Cadastro - Pessoa Jurídica - Básica.
Nota: Esta consulta não gera comprovantes.
Campos Retornados
- Bairro: Bairro do endereço
- Cargo: Cargo ou função do indivíduo
- CEP: Número CEP do endereço
- Cidade: Cidade do registro em questão
- CNAE - Código: Código do CNAE principal da empresa relacionada.
- CNAE - Código Secundário: Código do CNAE secundário da empresa
- CNAE - Descrição: Descrição do CNAE principal da empresa relacionada.
- CNAE Secundário - Descrição: Descrição do CNAE secundário da empresa
- CNPJ: CNPJ da empresa
- Código da Natureza Jurídica: Código da natureza jurídica da empresa
- Complemento: Complemento do endereço do registro em questão
- Data de Entrada: Data da entrada do sócio na empresa
- Data de Fundação: Data de fundação da empresa
- Descrição da Natureza Jurídica: Descrição da natureza jurídica da empresa
- Documento: Documento referente ao CPF/CNPJ
- Endereço: Informa o endereço do indivíduo
- Endereço de E-mail: Endereço de e-mail da entidade
- Faixa de faturamento: Faturamento estimado da empresa
- Faixa de Funcionários: Número de funcionários estimado da empresa
- Flag Matriz: Informa se a empresa é matriz. True(verdadeiro) ou false(falso)
- Flag Telemarketing Bloqueado: Informa se o telefone é bloqueado para telemarketing. True(verdadeiro) ou false(falso)
- Flag WhatsApp: Informa se o telefone está vinculado ao WhatsApp. True(verdadeiro) ou false(falso)
- Lista de CNAE Secundários: Retorna uma lista de CNAE secundários da empresa
- Lista de E-mail: E-mails vinculados à entidade
- Lista de Endereço: Lista os endereços do indivíduo
- Lista de Sócios: Lista de sócios da empresa
- Lista de Telefones: Telefones vinculados ao indivíduo
- Logradouro: Nome da rua, avenida, travessa, alameda ou outros onde está localizado o endereço.
- Nome: Nome do indivíduo/registro
- Nome Fantasia: Nome fantasia da empresa
- Número: Número do registro em questão
- Operadora: Operadora do telefone
- Órgão Público: Informa se a empresa tem relação com algum órgão público
- Percentual de Participação: Percentual de participação do sócio na empresa
- Porte: Porte da empresa, referindo-se ao tamanho da mesma
- Quantidade de Funcionários: Informa a quantidade de funcionários que a entidade consultada possui
- Ramo: Informa o ramo da empresa
- Razão Social: Razão social da empresa
- Situação Cadastral: Situação cadastral do indivíduo
- Telefone com DDD: Número de telefone incluindo DDD
- Tipo da Empresa: Tipo referente da empresa
- Tipo da Natureza Jurídica: Código da natureza jurídica da empresa
- Tipo de Telefone: Informa o tipo de telefone, como por exemplo, se ele é fixo ou celular
- UF: Unidade Federativa (estado) referente ao registro
- Última Atualização da Pessoa Jurídica: Data da última atualização da pessoa jurídica
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
CNPJ | string | Sim | O parâmetro CNPJ pode ser enviado com ou sem formatação. |
TOKEN | string | Sim | O parâmetro TOKEN é essencial para efetuar esta consulta. Em caso de dúvidas, por favor, entre em contato com: suporte@directd.com.br |
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "string",
"consultaUid": "string",
"chave": "string",
"usuario": "string",
"mensagem": "string",
"ip": "string",
"resultadoId": 0,
"resultado": "string",
"apiVersao": "v3",
"enviarCallback": false,
"gerarComprovante": false,
"urlComprovante": "string",
"assincrono": true,
"data": "dd/MM/yyyy HH:mm:ss",
"tempoExecucaoMs": 0
},
"retorno": {
"cnpj": "string",
"razaoSocial": "string",
"nomeFantasia": "string",
"dataFundacao": "string",
"cnaeCodigo": 0,
"cnaeDescricao": "string",
"cnaEsSecundarios": [
{
"cnaeCodigoSecundario": 0,
"cnaeDescricaoSecundario": "string"
}
],
"quantidadeFuncionarios": 0,
"situacaoCadastral": "string",
"naturezaJuridicaCodigo": 0,
"naturezaJuridicaDescricao": "string",
"naturezaJuridicaTipo": "string",
"porte": "string",
"faixaFuncionarios": "string",
"faixaFaturamento": "string",
"matriz": true,
"orgaoPublico": "string",
"ramo": "string",
"tipoEmpresa": "string",
"telefones": [
{
"telefoneComDDD": "string",
"telemarketingBloqueado": true,
"operadora": "string",
"tipoTelefone": "string",
"whatsApp": true
}
],
"enderecos": [
{
"logradouro": "string",
"numero": "string",
"complemento": "string",
"bairro": "string",
"cidade": "string",
"uf": "string",
"cep": "string"
}
],
"emails": [
{
"enderecoEmail": "string"
}
],
"ultimaAtualizacaoPJ": "string",
"socios": [
{
"documento": "string",
"nome": "string",
"percentualParticipacao": "string",
"dataEntrada": "string",
"cargo": "string"
}
]
}
}Erros Comuns
| Código | Descrição |
|---|---|
400 | Requisição Inválida: a requisição está incorreta ou os parâmetros são inválidos. |
401 | Não Autenticado: o usuário não forneceu as credenciais corretas para acessar o recurso. |
403 | Não Autorizado: o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
404 | Não Encontrado: o servidor não encontrou uma representação atual do recurso solicitado. |
408 | Tempo Esgotado: o servidor não conseguiu retornar a requisição no prazo estabelecido. |
500 | Falha ao Realizar Consulta: o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte. |
503 | Consulta em Manutenção: a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. |
Notas Importantes
- Para utilizar a consulta de forma assíncrona, utiliza-se: '&async=habilitar' na URL
- Em caso de dúvidas/suporte, entre em contato pelo e-mail: suporte@directd.com.br ou pelo nosso WhatsApp: (11) 93906-9228