> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Pessoas-chave da empresa: UBOs e administradores

> Vincule UBOs, administradores, diretores e beneficiários finais a uma entidade de Empresa na Didit. Cada um faz KYC como entidade de Usuário.

Cada entidade Business tem **pessoas-chave**: as pessoas físicas legalmente responsáveis pela empresa ou que são suas beneficiárias finais. A Didit as identifica durante o KYB e permite vincular cada uma a uma entidade User para KYC individual.

## Quem é considerado pessoa-chave

| Função | Descrição |
| - | - |
| **Diretor** | Consta no registro como diretor da empresa |
| **Responsável** | Secretário, representante ou outro oficial registrado |
| **Acionista** | Acionista registrado (pessoa jurídica ou física) |
| **UBO (beneficiário final)** | Pessoa física que, em última instância, detém ou controla 10/25/50%+ (limiar configurável) |
| **Signatário autorizado** | Pessoa com poderes para agir em nome da empresa |

Consulte as páginas [Responsáveis de KYB](https://docs.didit.me/pt-br/business-verification/officers.md) e [Propriedade](https://docs.didit.me/pt-br/business-verification/ownership.md) para ver a taxonomia completa de funções e o cálculo da cadeia de propriedade.

## Como as pessoas-chave se vinculam a uma empresa

**1. Identificadas a partir do registro**

Durante o KYB, a Didit consulta o registro de empresas e extrai todos os administradores e acionistas listados. Cada pessoa se torna um **registro de pessoa-chave** vinculado à sessão de Verificação de empresas (KYB).

**2. Adicionadas pelo usuário (preenchidas pelo cliente)**

Os fluxos de verificação (workflows) podem incluir uma etapa "Pessoas-chave" em que o administrador da empresa adiciona pessoas que não constam no registro (por exemplo, UBOs identificados por declaração corporativa).

**3. Agregadas na entidade empresa**

A lista de pessoas-chave da empresa reúne as pessoas extraídas do registro e as adicionadas pelo usuário, com duplicatas removidas por identidade.

Cada pessoa-chave tem um campo `source`:

* `REGISTRY`: extraída de um registro oficial.
* `USER`: adicionada pelo administrador da empresa durante o fluxo de KYB.

## Como vincular uma pessoa-chave a uma entidade User

Quando o KYC é exigido para uma pessoa-chave (normalmente UBOs e diretores), a parte pode ser vinculada a uma entidade User:

```mermaid theme={null}
flowchart LR
    B[Business: biz-acme]
    P1[Key Person: Jane Doe, Director]
    P2[Key Person: John Smith, UBO 40%]
    U1[User: user-jane]
    U2[User: user-john]
    P1 --> B
    P2 --> B
    P1 -.linked.-> U1
    P2 -.linked.-> U2
```

O vínculo é criado quando:

* Uma sessão de Verificação de usuário (KYC) é executada para a parte usando o mesmo `vendor_data` da entidade User.
* Um analista associa manualmente uma pessoa-chave da empresa a um User existente.

Depois do vínculo, o status de KYC do User é propagado para a visualização de pessoas-chave da Business.

## Como inspecionar as pessoas-chave

Na página de detalhes da empresa no console, a aba **Pessoas-chave** mostra:

* Nome, função, % de propriedade e origem (registro ou inclusão pelo usuário) de cada parte
* Status de KYC dos Users vinculados
* Status da triagem AML de cada pessoa
* Documentos associados (documento de identidade do diretor, declaração de UBO)

Via API, as pessoas-chave aparecem no array `key_people_checks[]` da decisão da sessão de Verificação de empresas (KYB), divididas em dois grupos:

```json theme={null}
"key_people_checks": [
  {
    "status": "Approved",
    "node_id": "feature_kyb_key_people",
    "registry": {
      "officers": [
        { "uuid": "...", "name": "Jane Doe", "role": "director", "kyc_status": "Approved", "kyc_session_url": "..." }
      ],
      "beneficial_owners": [
        { "uuid": "...", "name": "John Smith", "roles": ["ubo"], "ownership_min_shares": 40, "kyc_status": "Pending" }
      ]
    },
    "submitted": {
      "parties": [
        { "uuid": "...", "entity_type": "person", "name": "Alice Chen", "role": "ubo", "ownership_percent": 35.0, "source": "USER", "requires_verification": true, "kyc_session_status": "Not Started", "kyc_session_url": "..." }
      ]
    },
    "ubo_kyc_summary": { "total": 2, "approved": 1, "flagged": 0, "pending": 1 }
  }
]
```

* **`registry.officers` / `registry.beneficial_owners`**: partes descobertas pela verificação no registro.
* **`submitted.parties`**: partes que o administrador da empresa adicionou durante o fluxo de Pessoas-chave (`source: USER`).
* **`ubo_kyc_summary`**: progresso agregado do KYC dos UBOs.

Os arrays planos legados `officers[]` e `beneficial_owners[]` continuam na resposta por mais uma versão, para manter a compatibilidade com versões anteriores. Novas integrações devem consumir o formato de dois grupos acima. Consulte o [esquema completo da resposta de KYB](https://docs.didit.me/pt-br/business-verification/response-schema.md#key_people_checks) para ver todos os campos.

## Acionistas pessoa jurídica

Quando um acionista é uma empresa (e não uma pessoa), a Didit explora recursivamente a cadeia de propriedade para identificar os beneficiários finais. Partes que são pessoas jurídicas podem, opcionalmente, disparar sessões filhas de Verificação de Empresas (KYB).

Consulte [Estrutura de propriedade](https://docs.didit.me/pt-br/business-verification/ownership.md) para ver um exemplo prático de cadeias de propriedade com várias camadas.

## Webhooks de pessoas-chave

As alterações nas pessoas-chave aparecem nos eventos da sessão principal:

* `data.updated` (com `session_kind: "business"`): os dados da sessão, incluindo as pessoas-chave, foram atualizados.
* `status.updated` (com `session_kind: "business"`): o status da sessão mudou como resultado.

Consulte [Webhooks de KYB](https://docs.didit.me/pt-br/business-verification/webhooks.md) para ver os payloads.

## Próximos passos

> [card] [Administradores](https://docs.didit.me/pt-br/business-verification/officers.md)
>
> Identificação de diretores e taxonomia de funções.

> [card] [Propriedade](https://docs.didit.me/pt-br/business-verification/ownership.md)
>
> UBOs, acionistas pessoas jurídicas e cálculo da cadeia.

> [card] [Fluxo de pessoas-chave](https://docs.didit.me/pt-br/business-verification/key-people.md)
>
> A etapa de KYB que coleta as pessoas-chave.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.