O endpoint /api/VinculosSocietarios permite consultar vínculos societários de uma empresa (CNPJ) ou pessoa física (CPF), retornando suas participações, cargos e relações diretas e indiretas.
Esta documentação detalha como autenticar, enviar requisições, interpretar respostas e tratar erros durante a integração.
Vínculos Societários
Consulta responsável por obter e analisar os vínculos societários de uma empresa ou pessoa física, apresentando a participação em sociedades, cargos exercidos e relações entre sócios. O serviço permite mapear estruturas societárias de forma detalhada, contemplando empresas coligadas e controladas, facilitando a visualização da rede de relacionamentos corporativos e a identificação de possíveis conexões relevantes para análise de risco e conformidade.
Casos de Uso
- Integração com bases de dados societários.
- Identificação de vínculos e participações entre pessoas físicas e jurídicas.
- Mapeamento de estruturas empresariais (controladas, coligadas, administradores).
- Apoio a processos de due diligence, compliance e prevenção à lavagem de dinheiro.
- Suporte para análises de risco, crédito e integridade corporativa.
Aplicações
- Prevenção de Lavagem de Dinheiro
- Análise de Risco/Crédito
- Compliance/ESG
Benefícios
- Acesso automatizado e atualizado a vínculos societários.
- Reduz erros manuais e tempo de análise.
- Facilita a visualização de redes de relacionamento corporativo.
- Integração simples e escalável com sistemas internos de compliance e risco.
URL Base
A API está hospedada no seguinte endereço:
https://apiv3.directd.com.br/api/VinculoSocietarioEndpoint
GET https://apiv3.directd.com.br/api/VinculoSocietario?CPF={0}&CNPJ={1}&Token=Seu_TokenDescrição: Endpoint para realizar consultas Vínculos Societários.
Nota: Esta consulta não gera comprovantes.
Campos Retornados
- Cargo: Cargo ou função do indivíduo
- Data de Fim: Data do fim do registro
- Data de Início: Data de Início do registro
- Documento: Documento referente ao CPF/CNPJ
- Documento Consultado: Documento consultado referente ao CPF/CNPJ
- Flag PEP Matriz: Retorna se o indivíduo é PEP matriz. True(verdadeiro) ou false(falso)
- Grau: Grau do registro
- Lista de Históricos: LIsta o histórico de sociedades.
- Nível: Nível de sociedade com o indivíduo ou empresa consultado
- Nome Entidade: Nome da entidade ou Razão Social consultada
- Relacionamentos: Informa o grau de relacionamento da entidade.
- Status: Retorna detalhes sobre o status do registro em questão
- Tipo: Tipo do registro em questão
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
CNPJ | string | Sim | O parâmetro CNPJ pode ser enviado com ou sem formatação. |
CPF | string | Sim | O parâmetro CPF 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": {
"documentoConsultado": "string",
"nomeEntidade": "string",
"pepMatriz": true,
"relacionamentos": [
{
"documento": "string",
"nomeEntidade": "string",
"pepMatriz": true,
"nivel": 0,
"tipo": "string",
"grau": "string",
"status": true,
"historicos": [
{
"cargo": "string",
"status": true,
"dataInicio": "string",
"dataFim": "string"
}
],
"relacionamentos": [
"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
- Informe apenas um único documento por requisição
- 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