API de administradores e representantes (KYB)

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, 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:

{
  "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 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.

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.

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

Pessoas-chave

O fluxo completo de Pessoas-chave.

Propriedade

Identificação de UBO e cadeias de propriedade.

AML

Triagem AML de empresas e de pessoas.

Primeiros passos

Funcionalidades

Perfis de empresas

Referência

Consola

API de administradores e representantes (KYB)

Taxonomia completa de funções

Governação / representação

Propriedade / beneficiário

Registos com várias funções

Ligação ao KYC

Triagem AML

Sinalizador de verificação obrigatória

Ignorar uma Pessoa-chave

Cruzamento de fontes

Efeito na entidade Business

Próximos passos

Pessoas-chave

Propriedade

AML

​Taxonomia completa de funções

​Governação / representação

​Propriedade / beneficiário

​Registos com várias funções

​Ligação ao KYC

​Triagem AML

​Sinalizador de verificação obrigatória

​Ignorar uma Pessoa-chave

​Cruzamento de fontes

​Efeito na entidade Business

​Próximos passos

Pessoas-chave

Propriedade

AML

Taxonomia completa de funções

Governação / representação

Propriedade / beneficiário

Registos com várias funções

Ligação ao KYC

Triagem AML

Sinalizador de verificação obrigatória

Ignorar uma Pessoa-chave

Cruzamento de fontes

Efeito na entidade Business

Próximos passos