> ## 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 de administradores e representantes (KYB)

> Verifique administradores e representantes com a Didit: pessoas-chave, etiquetas multifunções e triagem AML. A partir de $2.00 por verificação.

## Taxonomia completa de funções

Dirigentes, administradores e representantes **não são um conceito separado no modelo KYB da Didit**: ficam dentro das [Pessoas-chave](https://docs.didit.me/pt/business-verification/key-people.md), junto com os beneficiários efetivos (UBO) e os acionistas, com uma ou mais funções atribuídas a cada pessoa. Uma mesma pessoa pode ser administradora **e** acionista, ou representante **e** signatária autorizada. O registo da pessoa ou entidade contém a lista completa de funções, e não apenas uma.

### Governação / representação

| Função | Descrição |
| - | - |
| `director` | Membro do conselho de administração com responsabilidades de governação |
| `non_executive_director` | Membro do conselho de administração sem funções de gestão do dia a dia |
| `chairman` | Presidente do conselho de administração |
| `secretary` | Secretário da sociedade, com funções administrativas e de conformidade |
| `representative` | Representante legal ou nomeado da empresa |
| `authorized_signatory` | Pessoa habilitada a assinar em nome da empresa |
| `trustee` | Fiduciário de uma estrutura que detém participações na empresa |
| `company_officer` | Função de dirigente geral |
| `founder` | Membro fundador da empresa |
| `legal_advisor` | Consultor jurídico contratado pela empresa |
| `other` | Qualquer função fora da taxonomia padrão |

### Propriedade / beneficiário

| Função | Descrição |
| - | - |
| `ubo` | Beneficiário efetivo último: pessoa singular que, em última instância, detém ou controla a empresa |
| `shareholder` | Acionista registado (pessoa singular ou coletiva) |
| `beneficiary` | Beneficiário de um trust ou de uma estrutura semelhante |
| `settlor` | Instituidor de um trust |
| `protector` | Protetor de um trust |
| `investor` | Investidor, fora das estruturas formais de detenção de ações |

Uma mesma pessoa pode reunir as duas categorias. Por exemplo, um fundador que também é administrador e UBO tem três funções no mesmo registo de Pessoas-chave.

## Registos com várias funções

Cada registo de Pessoa-chave inclui uma lista de funções, cada uma com as suas próprias percentagens de propriedade ou de direitos de voto, quando aplicável. É assim que se apresenta na resposta um administrador que também é 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/..."
}
```

## Ligação ao KYC

Cada Pessoa-chave pode ser ligada a uma sessão de Verificação de utilizadores (KYC) individual. A ligação é automática quando as definições de fluxo da função exigem KYC: o sistema cria a sessão KYC secundária, envia à pessoa a ligação de verificação por e-mail (se esta opção estiver ativa) e atualiza o estado associado à parte.

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

## Triagem AML

Cada Pessoa-chave identificada é automaticamente submetida a triagem AML face às listas globais de vigilância, como parte do processo de verificação da empresa. As correspondências de pessoas politicamente expostas (PEP) são especialmente relevantes para as funções de governação, porque administradores e signatários de empresas reguladas surgem frequentemente em listas de PEP. Consulte [Triagem AML de empresas](https://docs.didit.me/pt/business-verification/aml.md).

## Sinalizador de verificação obrigatória

Cada parte tem um campo `requires_verification` que indica se o fluxo exige KYC para essa pessoa:

| Valor | Significado |
| - | - |
| `true` | O KYC tem de estar concluído para esta pessoa antes de a sessão poder ser aprovada. |
| `false` | A pessoa está identificada e analisada em AML, mas não precisa de KYC individual. |

Configure as funções que exigem verificação em *Fluxos → \[fluxo KYB] → Pessoas-chave → definições por função*. Predefinições típicas:

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

## Ignorar uma Pessoa-chave

Se uma pessoa não puder ser verificada (falecida, incontactável ou pertencente a um registo histórico), pode ser marcada com `is_skipped: true`. Isto pode ser feito pelo utilizador final no fluxo alojado (se as definições da função o permitirem) ou por um analista na consola. As pessoas ignoradas ficam excluídas do requisito de verificação, mas continuam a aparecer na resposta para efeitos de auditoria.

## Cruzamento de fontes

Os dados de cada Pessoa-chave podem vir de três origens, e a consola mostra as três lado a lado:

* **Registos oficiais**: o que o registo oficial da empresa divulgou.
* **Submetidos pelo utilizador**: o que o administrador da empresa confirmou ou acrescentou no fluxo de Pessoas-chave.
* **Documentos carregados**: nomes extraídos por OCR a partir de estatutos, registos de acionistas ou procurações.

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

## Efeito na entidade Business

Ligar uma Pessoa-chave a uma entidade User através do KYC cria uma relação duradoura na [entidade Business](https://docs.didit.me/pt/entities/businesses/overview.md). Pode então:

* Ver todas as empresas em que cada pessoa desempenha uma função de governação ou de propriedade.
* Propagar as alterações de estado de um User (sinalizado, bloqueado) para as empresas onde ele é Pessoa-chave.
* Executar a monitorização AML contínua de cada pessoa ligada, independentemente de qualquer sessão KYB específica.

## Próximos passos

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

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

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


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