💡A API Cadastro - Pessoa Jurídica - Plus retorna dados cadastrais completos de empresas, incluindo informações oficiais, estimativas de faturamento e dados relacionados. É amplamente utilizada para análise de crédito, onboarding e compliance.
Introdução
A API Cadastro - Pessoa Jurídica - Plus fornece dados detalhados sobre empresas brasileiras, incluindo informações cadastrais, estimativas de faturamento, dados societários e muito mais. Esta API é especialmente útil para instituições financeiras, empresas de análise de crédito e processos de due diligence.
URL Base
A API está hospedada no seguinte endereço:
https://apiv3.directd.com.br
Endpoint
Cadastro - Pessoa Jurídica - Plus
GET /api/CadastroPessoaJuridicaPlus
Descrição: Endpoint para realizar a consulta Cadastro - Pessoa Jurídica - Plus. Obs: esta consulta não possui comprovante.
Autenticação
Para acessar esta API, é necessário fornecer um token de autenticação.
Regras de Autenticação:
- O token deve ser enviado como parâmetro na URL da requisição.
- O token é obrigatório para realizar consultas.
- Em caso de dúvidas sobre o token, entre em contato com: suporte@directd.com.br
Campos da API
Dados Cadastrais
- CNPJ: Número de inscrição da empresa
- Razão Social: Nome oficial da empresa
- Nome Fantasia: Nome comercial da empresa
- Data de Fundação: Data de abertura da empresa
- Situação Cadastral: Status atual do CNPJ
- Natureza Jurídica:
- Código
- Descrição
- Tipo
- Porte: Classificação do porte da empresa
- CNAE:
- Código Principal
- Descrição Principal
- Códigos Secundários
- Descrições Secundárias
Dados Operacionais
- Quantidade de Funcionários
- Faixa de Funcionários
- Quantidade de Filiais
- Flag Matriz
- Órgão Público
- Tipo da Empresa
- Tributação
- Opção MEI
- Opção Simples
Dados Financeiros
- Faixa de Faturamento
- Faturamento Médio do CNAE
- Faturamento Presumido
Dados de Contato
-
Endereços:
- Logradouro
- Número
- Complemento
- Bairro
- Cidade
- UF
- CEP
-
Telefones:
- Número com DDD
- Flag Telemarketing Bloqueado
- Operadora
- Tipo de Telefone
- Flag WhatsApp
-
E-mails:
- Endereço de E-mail
Dados Societários
- Lista de Sócios:
- Documento
- Nome
- Percentual de Participação
- Data de Entrada
- Cargo
Parâmetros
Nome | Tipo | Obrigatório | Descrição |
---|---|---|---|
CNPJ | string | Sim | CNPJ da empresa a ser consultada. Pode ser enviado com ou sem formatação. |
TOKEN | string | Sim | Token de autenticação necessário para a consulta. Em caso de dúvidas, entre em contato com: suporte@directd.com.br |
Exemplos de Requisição
Usando cURL
curl 'https://apiv3.directd.com.br/api/CadastroPessoaJuridicaPlus?CNPJ=12345678000190&TOKEN=seu_token_aqui'
Respostas
Sucesso (200)
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "string",
"consultaUid": "string",
"chave": "string",
"usuario": "string",
"mensagem": "string",
"ip": "string",
"resultadoId": 0,
"resultado": "string",
"apiVersao": "v3",
"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"
}
],
"situacaoCadastral": "string",
"naturezaJuridicaCodigo": 0,
"naturezaJuridicaDescricao": "string",
"naturezaJuridicaTipo": "string",
"porte": "string",
"faixaFuncionarios": "string",
"quantidadeFuncionarios": 0,
"faixaFaturamento": "string",
"faturamentoMedioCNAE": "string",
"faturamentoPresumido": "string",
"matriz": true,
"orgaoPublico": "string",
"ramo": "string",
"tipoEmpresa": "string",
"tributacao": "string",
"opcaoMEI": "string",
"opcaoSimples": "string",
"quantidadeFiliais": "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"
}
]
}
}
Outros Códigos de Resposta
Código | Descrição |
---|---|
201 | Sucesso: a requisição async foi criada com sucesso e está em processamento. |
202 | Em Processamento: a requisição async ainda está em processamento. |
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. |
Aplicações
- Onboarding de Clientes e Fornecedores
- Análise de Risco/Crédito
- Due Diligence
- Compliance e KYC
- Prospecção de Clientes
Notas Importantes
- O valor da consulta é de R$ 0,36
- A API está na versão v3
- Esta consulta não gera comprovantes
- Para suporte técnico, entre em contato com suporte@directd.com.br