Orientações e respostas da equipe da Direct Data

/api/CadastroPessoaJuridica

💡 O endpoint /api/CadastroPessoaJuridica permite consultar dados detalhados sobre Pessoas Jurídicas registradas, incluindo informações cadastrais, atividades econômicas e dados societários.

Introdução

A API Cadastro - Pessoa Jurídica oferece dados detalhados sobre empresas, incluindo:

• Informações cadastrais básicas;
• Atividades econômicas principais e secundárias;
• Situação cadastral e motivo;
• Relações societárias (sócios, administradores).

Essa API é ideal para análise de crédito, compliance, e enriquecimento de dados empresariais.

URL Base

https://apiv3.directd.com.br

Endpoint

GET /api/CadastroPessoaJuridica

Autenticação

A autenticação é feita utilizando um TOKEN. Sem um token válido, o acesso será negado (401).

Regras de Autenticação

1. O TOKEN deve ser incluído como parâmetro obrigatório.
2. Caso o token seja inválido ou expirado, entre em contato pelo e-mail: suporte@directd.com.br.

Campos da API

Dados Retornados

• CNPJ: Número do Cadastro Nacional de Pessoa Jurídica.
• Razão Social: Nome oficial da empresa.
• Nome Fantasia: Nome comercial da empresa.
• Atividade Principal: Código e descrição da atividade econômica principal.
• Atividades Secundárias: Lista de atividades econômicas secundárias.
• Situação Cadastral: Status atual do registro (ex.: Ativa, Inativa, Baixada).
• Data da Situação Cadastral: Data da última atualização da situação cadastral.
• Motivo da Situação Cadastral: Razão para a situação cadastral atual.
• Endereço Completo: Logradouro, número, complemento, bairro, município, UF e CEP.
• Contato: Telefones e e-mail cadastrados.
• Capital Social: Valor do capital social da empresa.
• Nome do Sócio/Administrador;
• CPF ou CNPJ do Sócio/Administrador;
• Cargo: Cargo ocupado na empresa.

Parâmetros

Exemplo de Requisição

Usando cURL

curl -X 'GET' \
  'https://apiv3.directd.com.br/api/CadastroPessoaJuridica?CNPJ=12345678000123&TOKEN=68ADA2C3-8016-47DA-ADE6-13AE239308FE' \
  -H 'accept: application/json'

Respostas

Sucesso (200)

A consulta foi realizada com sucesso e retorna os dados da Pessoa Jurídica.

{
  "metaDados": {
    "consultaNome": "Cadastro - Pessoa Jurídica",
    "consultaUid": "direct-123456",
    "mensagem": "Consulta realizada com sucesso.",
    "resultado": "Sucesso",
    "apiVersao": "v3",
    "tempoExecucaoMs": 200
  },
  "retorno": {
    "cnpj": "12345678000123",
    "razaoSocial": "Empresa Exemplo Ltda.",
    "nomeFantasia": "Exemplo",
    "atividadePrincipal": {
      "codigo": "6201-5/00",
      "descricao": "Desenvolvimento de software sob encomenda."
    },
    "atividadesSecundarias": [
      {
        "codigo": "6204-0/00",
        "descricao": "Consultoria em tecnologia da informação."
      }
    ],
    "situacaoCadastral": "Ativa",
    "dataSituacaoCadastral": "01/01/2024",
    "motivoSituacaoCadastral": "Nenhum",
    "endereco": {
      "logradouro": "Rua Exemplo",
      "numero": "123",
      "complemento": "Sala 10",
      "bairro": "Centro",
      "municipio": "São Paulo",
      "uf": "SP",
      "cep": "01000-000"
    },
    "contato": {
      "telefone": ["(11) 99999-9999"],
      "email": "contato@empresaexemplo.com"
    },
    "capitalSocial": "500000.00",
    "quadroSocietario": [
      {
        "nome": "João da Silva",
        "documento": "12345678901",
        "cargo": "Administrador"
      }
    ]
  }
}

Códigos de Resposta

Notas Importantes

• Apenas um CNPJ deve ser enviado por consulta.
• Este endpoint não gera comprovantes.
• Para dúvidas ou suporte, entre em contato pelo e-mail: suporte@directd.com.br.