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, dados societários e estimativas de faturamento.

Introdução

A API Cadastro - Pessoa Jurídica - Básica 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);
• Estimativas de faturamento;
• Dados de contato e localização;
• Informações sobre porte e estrutura.

Essa API é ideal para:

• Onboarding de Clientes e Fornecedores
• Análise de Risco/Crédito
• Compliance e Due Diligence
• 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

Informações Básicas

• CNPJ: Número do Cadastro Nacional de Pessoa Jurídica
• 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 registro
• Última Atualização: Data da última atualização dos dados

Classificação e Estrutura

• CNAE Principal: Código e descrição da atividade econômica principal
• CNAEs Secundários: Lista de atividades econômicas secundárias
• Natureza Jurídica: Código, descrição e tipo
• Porte: Classificação do porte da empresa
• Tipo da Empresa: Classificação do tipo empresarial
• Flag Matriz: Indicador se é matriz ou filial
• Órgão Público: Indicador se é órgão público
• Ramo: Setor de atuação

Dados Quantitativos

• Quantidade de Funcionários: Número total de colaboradores
• Faixa de Funcionários: Classificação por faixa de colaboradores
• Faixa de Faturamento: Estimativa de faturamento
• Capital Social: Valor do capital social da empresa

Localização e Contato

• Endereço Completo:
  • Logradouro
  • Número
  • Complemento
  • Bairro
  • Cidade
  • UF
  • CEP
• Telefones:
  • Número com DDD
  • Tipo de telefone
  • Operadora
  • Flag WhatsApp
  • Flag Telemarketing Bloqueado
• E-mails: Lista de endereços de e-mail

Quadro Societário

• Lista de Sócios:
  • Nome
  • Documento (CPF/CNPJ)
  • Percentual de Participação
  • Data de Entrada
  • Cargo

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",
    "dataFundacao": "01/01/2020",
    "cnaeCodigo": "6201-5/00",
    "cnaeDescricao": "Desenvolvimento de software sob encomenda",
    "cnaEsSecundarios": [
      {
        "cnaeCodigoSecundario": "6204-0/00",
        "cnaeDescricaoSecundario": "Consultoria em tecnologia da informação"
      }
    ],
    "quantidadeFuncionarios": 50,
    "situacaoCadastral": "Ativa",
    "naturezaJuridicaCodigo": 206-2,
    "naturezaJuridicaDescricao": "Sociedade Empresária Limitada",
    "naturezaJuridicaTipo": "Empresarial",
    "porte": "Médio Porte",
    "faixaFuncionarios": "De 50 a 99",
    "faixaFaturamento": "De R$ 1.000.000,00 a R$ 5.000.000,00",
    "matriz": true,
    "orgaoPublico": false,
    "ramo": "Tecnologia",
    "tipoEmpresa": "Limitada",
    "telefones": [
      {
        "telefoneComDDD": "(11) 99999-9999",
        "telemarketingBloqueado": false,
        "operadora": "Vivo",
        "tipoTelefone": "Celular",
        "whatsApp": true
      }
    ],
    "enderecos": [
      {
        "logradouro": "Rua Exemplo",
        "numero": "123",
        "complemento": "Sala 10",
        "bairro": "Centro",
        "cidade": "São Paulo",
        "uf": "SP",
        "cep": "01000-000"
      }
    ],
    "emails": [
      {
        "enderecoEmail": "contato@empresaexemplo.com"
      }
    ],
    "ultimaAtualizacaoPJ": "01/03/2024",
    "socios": [
      {
        "documento": "12345678901",
        "nome": "João da Silva",
        "percentualParticipacao": "50.00",
        "dataEntrada": "01/01/2020",
        "cargo": "Administrador"
      }
    ]
  }
}

Códigos de Resposta

Notas Importantes

• Apenas um CNPJ deve ser enviado por consulta.
• Este endpoint não gera comprovantes.
• O valor da consulta é de R$ 0,16 por requisição.
• Para dúvidas ou suporte, entre em contato pelo e-mail: suporte@directd.com.br.