# Vínculos Societários - CPF

Mapeia os vínculos societários da pessoa física: participação em sociedades, cargos e empresas coligadas e controladas.

- **Identificador:** `pessoas/vinculos-societarios-cpf`
- **Categoria:** Dados cadastrais
- **Audiência:** PF
- **Endpoint:** `POST /api/v1/{tenant}/pessoas/vinculos-societarios-cpf`
- **Preço de tabela:** R$ 5,000 por consulta bem-sucedida
- **Página:** https://www.proteo.com.br/api/consultas/pessoas/vinculos-societarios-cpf

## Quando usar

Descrição

O serviço Vínculos Societários identifica as sociedades em que a pessoa física consultada participa, com o nível e o grau de cada vínculo, a situação (ativo ou inativo) e o histórico de cargos com as datas de início e fim.

Para cada pessoa ou empresa vinculada são apresentados a situação cadastral, a indicação de PEP e de óbito (pessoa física) ou a data de abertura, baixa e recuperação judicial (pessoa jurídica), além do endereço. Os vínculos de níveis seguintes são exibidos de forma aninhada.

Casos de uso

Due diligence de clientes e fornecedores, PLD/FT, mapeamento de grupo econômico e análise de crédito.

## Parâmetros (corpo JSON)

| Campo | Obrigatório | Descrição |
|---|---|---|
| `document` | sim | CPF da pessoa, com ou sem máscara. |

## Campos de retorno (`data`)

| Campo | Tipo |
|---|---|
| `documentoConsultado` | texto |
| `nomeEntidade` | texto |
| `detalhesPessoaFisica` | texto |
| `detalhesPessoaJuridica.matriz` | booleano |
| `detalhesPessoaJuridica.dataAbertura` | texto |
| `detalhesPessoaJuridica.baixada` | booleano |
| `detalhesPessoaJuridica.dataEncerramento` | texto |
| `detalhesPessoaJuridica.recuperacaoJudicial` | booleano |
| `detalhesPessoaJuridica.situacaoCadastral` | texto |
| `detalhesPessoaJuridica.endereco.logradouro` | texto |
| `detalhesPessoaJuridica.endereco.numero` | texto |
| `detalhesPessoaJuridica.endereco.complemento` | texto |
| `detalhesPessoaJuridica.endereco.bairro` | texto |
| `detalhesPessoaJuridica.endereco.cidade` | texto |
| `detalhesPessoaJuridica.endereco.uf` | texto |
| `detalhesPessoaJuridica.endereco.cep` | texto |
| `relacionamentos[].documento` | texto |
| `relacionamentos[].nomeEntidade` | texto |
| `relacionamentos[].detalhesPessoaFisica.pep` | booleano |
| `relacionamentos[].detalhesPessoaFisica.dataNascimento` | texto |
| `relacionamentos[].detalhesPessoaFisica.obito` | booleano |
| `relacionamentos[].detalhesPessoaFisica.situacaoCadastral` | texto |
| `relacionamentos[].detalhesPessoaJuridica` | texto |
| `relacionamentos[].nivel` | número |
| `relacionamentos[].tipo` | texto |
| `relacionamentos[].grau` | texto |
| `relacionamentos[].status` | booleano |
| `relacionamentos[].historicos[].cargo` | texto |
| `relacionamentos[].historicos[].status` | booleano |
| `relacionamentos[].historicos[].dataInicio` | texto |
| `relacionamentos[].historicos[].dataFim` | texto |
| `relacionamentos[].relacionamentos[].documento` | texto |
| `relacionamentos[].relacionamentos[].nomeEntidade` | texto |
| `relacionamentos[].relacionamentos[].detalhesPessoaFisica.pep` | booleano |
| `relacionamentos[].relacionamentos[].detalhesPessoaFisica.dataNascimento` | texto |
| `relacionamentos[].relacionamentos[].detalhesPessoaFisica.obito` | booleano |
| `relacionamentos[].relacionamentos[].detalhesPessoaFisica.situacaoCadastral` | texto |
| `relacionamentos[].relacionamentos[].detalhesPessoaJuridica` | texto |
| `relacionamentos[].relacionamentos[].nivel` | número |
| `relacionamentos[].relacionamentos[].tipo` | texto |
| `relacionamentos[].relacionamentos[].grau` | texto |
| `relacionamentos[].relacionamentos[].status` | booleano |
| `quantidade_vinculos` | número |
| `quantidade_vinculos_ativos` | número |
| `quantidade_total_vinculos` | número |
| `possui_pep_vinculado` | booleano |

## Exemplo de resposta (valores fictícios)

```json
{
  "execution_id": "00000000-0000-0000-0000-000000000000",
  "status": "success",
  "message": "Consulta realizada com sucesso",
  "query_name": "Vínculos Societários - CPF",
  "query_slug": "vinculos-societarios-cpf",
  "data": {
    "documentoConsultado": "texto",
    "nomeEntidade": "texto",
    "detalhesPessoaFisica": null,
    "detalhesPessoaJuridica": {
      "matriz": false,
      "dataAbertura": "texto",
      "baixada": false,
      "dataEncerramento": null,
      "recuperacaoJudicial": false,
      "situacaoCadastral": "texto",
      "endereco": {
        "logradouro": "texto",
        "numero": "texto",
        "complemento": "texto",
        "bairro": "texto",
        "cidade": "texto",
        "uf": "texto",
        "cep": "texto"
      }
    },
    "relacionamentos": [
      {
        "documento": "texto",
        "nomeEntidade": "texto",
        "detalhesPessoaFisica": {
          "pep": false,
          "dataNascimento": "texto",
          "obito": false,
          "situacaoCadastral": null
        },
        "detalhesPessoaJuridica": null,
        "nivel": 0,
        "tipo": "texto",
        "grau": "texto",
        "status": false,
        "historicos": [
          {
            "cargo": "texto",
            "status": false,
            "dataInicio": "texto",
            "dataFim": null
          }
        ],
        "relacionamentos": [
          {
            "documento": "texto",
            "nomeEntidade": "texto",
            "detalhesPessoaFisica": {
              "pep": false,
              "dataNascimento": "texto",
              "obito": false,
              "situacaoCadastral": null
            },
            "detalhesPessoaJuridica": null,
            "nivel": 0,
            "tipo": "texto",
            "grau": "texto",
            "status": false,
            "historicos": [

            ],
            "relacionamentos": [

            ]
          }
        ]
      }
    ],
    "quantidade_vinculos": 0,
    "quantidade_vinculos_ativos": 0,
    "quantidade_total_vinculos": 0,
    "possui_pep_vinculado": false
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "5.000"
}
```