Orientações e respostas da equipe da Direct Data

/api/BeneficiarioFinal

💡 O endpoint /api/BeneficiarioFinal permite consultar dados detalhados de pessoas físicas e jurídicas, incluindo identificação de Politicamente Expostas (PEP), sócios e histórico de sociedades. A análise alcança até 10 graus de relacionamento societário para identificar o beneficiário final em uma rede complexa de ligações.

Introdução

A API Beneficiário Final oferece informações essenciais sobre beneficiários finais, incluindo:

• Dados de Pessoa Física e Jurídica;
• Identificação de PEP e sócios;
• Histórico de sociedades e conexões em até 10 níveis.

Essa API é ideal para prevenção de lavagem de dinheiro, análise de risco/crédito e compliance/ESG.

URL Base

https://apiv3.directd.com.br

Endpoint

GET /api/BeneficiarioFinal

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

• Documento Consultado: CPF ou CNPJ do beneficiário final consultado.
• Nome/Razão Social: Nome completo ou razão social.
• Data de Cadastro: Data de inclusão no sistema.
• Data de Atualização: Última atualização dos dados.
• Flag isPEP: Indica se é uma Pessoa Politicamente Exposta (PEP).
• Documento: CPF ou CNPJ da sociedade.
• Nome/Razão Social: Nome ou razão social da sociedade.
• Flag isPEP: Indica se a sociedade é politicamente exposta.
• Status: Status da sociedade (ativa/inativa).
• Nível: Grau de relacionamento da sociedade com o beneficiário final.
• Lista de Sócios: Nome dos sócios vinculados.
• Data de Início: Data de início da relação societária.
• Data de Fim: Data de término da relação societária (se aplicável).
• Status: Status da relação (ativa/inativa).
• Cargo: Cargo ocupado na sociedade.

Parâmetros

Exemplo de Requisição

Usando cURL

curl -X 'GET' \
  'https://apiv3.directd.com.br/api/BeneficiarioFinal?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 do beneficiário final.

{
  "metaDados": {
    "consultaNome": "Beneficiário Final",
    "consultaUid": "direct-123456",
    "mensagem": "Consulta realizada com sucesso.",
    "resultado": "Sucesso",
    "apiVersao": "v3",
    "tempoExecucaoMs": 200
  },
  "retorno": {
    "documentoConsultado": "12345678000123",
    "nomeRazaoSocial": "Empresa Exemplo Ltda.",
    "dataCadastro": "01/01/2020",
    "dataUpdate": "01/01/2024",
    "pepMatriz": true,
    "sociedades": [
      {
        "documento": "98765432000111",
        "nomeRazaoSocial": "Sociedade Exemplo S.A.",
        "pepMatriz": false,
        "status": true,
        "nivel": 1,
        "socios": [
          "Maria Silva",
          "João Santos"
        ],
        "historicoSociedades": [
          {
            "dataInicio": "01/01/2018",
            "dataFim": null,
            "status": true,
            "cargo": "Diretor"
          }
        ]
      }
    ]
  }
}

Códigos de Resposta

Notas Importantes

• Apenas um documento (CPF ou 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.