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

Diretores, administradores e representantes não são um conceito separado no modelo de KYB da Didit. Eles ficam em Pessoas-chave, 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:

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

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.

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

Pessoas-chave

O fluxo completo de Pessoas-chave.

Propriedade

Identificação de UBOs e cadeias de propriedade.

AML

Análise AML de empresas e pessoas.

Primeiros passos

Recursos

Perfis de empresas

Referência

Console

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

Taxonomia completa de funções

Governança / representação

Propriedade / beneficiário

Registros com várias funções

Vinculação com KYC

Análise AML

Indicador de verificação obrigatória

Dispensar uma pessoa-chave

Cruzamento de dados entre fontes

Efeito na entidade de empresa

Próximos passos

Pessoas-chave

Propriedade

AML

​Taxonomia completa de funções

​Governança / representação

​Propriedade / beneficiário

​Registros com várias funções

​Vinculação com KYC

​Análise AML

​Indicador de verificação obrigatória

​Dispensar uma pessoa-chave

​Cruzamento de dados entre fontes

​Efeito na entidade de empresa

​Próximos passos

Pessoas-chave

Propriedade

AML

Taxonomia completa de funções

Governança / representação

Propriedade / beneficiário

Registros com várias funções

Vinculação com KYC

Análise AML

Indicador de verificação obrigatória

Dispensar uma pessoa-chave

Cruzamento de dados entre fontes

Efeito na entidade de empresa

Próximos passos