💡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:

  1. O token deve ser enviado como parâmetro na URL da requisição.
  2. O token é obrigatório para realizar consultas.
  3. 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

NomeTipoObrigatórioDescrição
CNPJstringSimCNPJ da empresa a ser consultada. Pode ser enviado com ou sem formatação.
TOKENstringSimToken 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ódigoDescrição
201Sucesso: a requisição async foi criada com sucesso e está em processamento.
202Em Processamento: a requisição async ainda está em processamento.
400Requisição Inválida: a requisição está incorreta ou os parâmetros são inválidos.
401Não Autenticado: o usuário não forneceu as credenciais corretas para acessar o recurso.
403Não Autorizado: o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível.
404Não Encontrado: o servidor não encontrou uma representação atual do recurso solicitado.
408Tempo Esgotado: o servidor não conseguiu retornar a requisição no prazo estabelecido.
500Falha ao Realizar Consulta: o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte.
503Consulta 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