> ## 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.

# API KYB de diretores e representantes: funções-chave

> A Didit verifica diretores, administradores e representantes com pessoas-chave, múltiplas funções e triagem AML. Desde $2.00 por verificação.

Diretores, administradores e representantes **não são um conceito separado no modelo de KYB da Didit**. Eles ficam em [Pessoas-chave](https://docs.didit.me/pt-br/business-verification/key-people.md), junto com UBOs e acionistas, e cada pessoa recebe uma ou mais funções. Uma mesma pessoa pode ser diretora **e** acionista, ou representante **e** signatária autorizada: o registro traz a lista completa de funções, e não apenas uma.

## Taxonomia completa de funções

Cada pessoa-chave pode ter uma ou mais destas funções:

### Governança / representação

| Função | Descrição |
| - | - |
| `director` | Membro do conselho com responsabilidades de governança |
| `non_executive_director` | Membro do conselho sem atribuições de gestão do dia a dia |
| `chairman` | Presidente do conselho |
| `secretary` | Secretário da empresa, responsável pelas obrigações administrativas e de conformidade |
| `representative` | Representante legal ou nomeado da empresa |
| `authorized_signatory` | Pessoa com poderes para assinar em nome da empresa |
| `trustee` | Trustee de uma estrutura que detém participações na empresa |
| `company_officer` | Função genérica de administrador |
| `founder` | Membro fundador da empresa |
| `legal_advisor` | Assessor jurídico contratado pela empresa |
| `other` | Qualquer função fora da taxonomia padrão |

### Propriedade / beneficiário

| Função | Descrição |
| - | - |
| `ubo` | Beneficiário final (UBO): pessoa física que, em última instância, é proprietária da empresa ou a controla |
| `shareholder` | Acionista registrado (pessoa física ou jurídica) |
| `beneficiary` | Beneficiário de um trust ou estrutura semelhante |
| `settlor` | Instituidor de um trust |
| `protector` | Protetor de um trust |
| `investor` | Função de investidor (fora das estruturas formais de participação acionária) |

Uma mesma pessoa pode exercer funções nas duas categorias. Por exemplo, um fundador que também é diretor e UBO tem três funções no mesmo registro de pessoa-chave.

## Registros com várias funções

Cada registro de pessoa-chave inclui uma lista de funções, cada uma com seus próprios percentuais de propriedade e de direito a voto, quando aplicável. Veja como aparece na resposta alguém que é diretor e acionista:

```json theme={null}
{
  "uuid": "...",
  "name": "Jane Doe",
  "first_name": "John",
  "last_name": "Doe",
  "entity_type": "person",
  "roles": [
    { "role": "director", "ownership_percent": null, "voting_percent": null },
    { "role": "shareholder", "ownership_percent": 15.0, "voting_percent": 15.0 }
  ],
  "kyc_status": "Approved",
  "kyc_session_url": "https://verify.didit.me/..."
}
```

## Vinculação com KYC

Cada pessoa-chave pode ser vinculada a uma sessão individual de Verificação de Usuário (KYC). A vinculação acontece automaticamente quando as configurações da função no fluxo de verificação (workflow) exigem KYC. O sistema cria a sessão de KYC filha, envia por e-mail o link de verificação para a pessoa (se essa opção estiver ativada) e acompanha o status no registro da pessoa.

Consulte [Propriedade → Como as configurações de função direcionam a verificação](https://docs.didit.me/pt-br/business-verification/ownership.md#como-as-configurações-de-função-orientam-a-verificação) para ver a lógica completa de encaminhamento. Para os valores de status de KYC adequados para B2C exibidos em cada pessoa (`Approved`, `Declined`, `Pending`), consulte o [esquema de resposta](https://docs.didit.me/pt-br/business-verification/response-schema.md#bloco-company).

## Análise AML

Cada pessoa-chave identificada é automaticamente triada em relação às listas globais de monitoramento AML como parte do processo de verificação de empresas. Correspondências com PEP são especialmente relevantes para funções de governança, porque diretores e signatários de empresas reguladas costumam aparecer em listas de PEP. Consulte [Triagem AML de empresas](https://docs.didit.me/pt-br/business-verification/aml.md).

## Indicador de verificação obrigatória

Cada pessoa tem um indicador `requires_verification` que informa se o fluxo exige KYC para ela:

| Valor | Significado |
| - | - |
| `true` | O KYC dessa pessoa precisa ser concluído antes que a sessão possa ser aprovada. |
| `false` | A pessoa é identificada e passa pela análise AML, mas não precisa de KYC individual. |

Configure quais funções exigem verificação em *Workflows → \[KYB workflow] → Key People → configurações por função*. Padrões comuns:

* Diretores e UBOs acima do limiar do fluxo → `requires_verification: true`.
* Signatários autorizados e secretários → opcional.
* Membros não executivos do conselho → opcional.

## Dispensar uma pessoa-chave

Se não for possível verificar uma pessoa (falecida, inacessível, histórica), ela pode ser marcada com `is_skipped: true`, seja pelo usuário final no fluxo hospedado (se as configurações da função permitirem dispensar), seja por um analista no console. Pessoas dispensadas ficam fora do bloqueio de verificação, mas continuam aparecendo na resposta para fins de auditoria.

## Cruzamento de dados entre fontes

Os dados de cada pessoa-chave podem vir de três lugares, e o console mostra os três lado a lado:

* **Registros oficiais**: o que o registro oficial divulgou.
* **Enviados pelo usuário**: o que o administrador da empresa confirmou ou adicionou no fluxo de Pessoas-chave.
* **Documentos enviados**: nomes extraídos via OCR de contratos ou estatutos sociais, livros de registro de acionistas ou procurações.

As inconsistências aparecem como avisos na decisão da sessão.

## Efeito na entidade de empresa

Vincular uma pessoa-chave a uma entidade de usuário por meio de KYC cria uma relação permanente com a [entidade de empresa](https://docs.didit.me/pt-br/entities/businesses/overview.md). A partir disso, você pode:

* Ver todas as empresas em que cada pessoa exerce uma função de governança ou de propriedade.
* Propagar as mudanças de status de um usuário (sinalizado, bloqueado) para as empresas em que ele atua como pessoa-chave.
* Executar o monitoramento AML contínuo de cada pessoa vinculada, independentemente de qualquer sessão de KYB específica.

## Próximos passos

> [card] [Pessoas-chave](https://docs.didit.me/pt-br/business-verification/key-people.md)
>
> O fluxo completo de Pessoas-chave.

> [card] [Propriedade](https://docs.didit.me/pt-br/business-verification/ownership.md)
>
> Identificação de UBOs e cadeias de propriedade.

> [card] [AML](https://docs.didit.me/pt-br/business-verification/aml.md)
>
> Análise AML de empresas e pessoas.


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