Pessoas-chave de empresas: UBOs e administradores

​

Quem é considerado pessoa-chave

​

Como as pessoas-chave são associadas a uma Business

• REGISTRY — extraída de um registo oficial.
• USER — adicionada pelo administrador da empresa durante o fluxo de KYB.

​

Ligar uma pessoa-chave a uma entidade User

• É executada uma sessão de Verificação de utilizadores (KYC) para a parte, usando o mesmo vendor_data da entidade User.
• Um analista associa manualmente uma parte da empresa a um User existente.

​

Consultar pessoas-chave

• O nome, a função, a percentagem de propriedade e a origem de cada parte (registo ou adicionada pelo utilizador)
• O estado de KYC dos Users ligados
• O estado da triagem AML de cada pessoa
• Os documentos associados (documento de identificação do administrador, declaração de UBO)

"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 identificadas através da verificação no registo.
• submitted.parties — partes adicionadas pelo administrador da empresa durante o fluxo Pessoas-chave (source: USER).
• ubo_kyc_summary — progresso agregado do KYC dos UBO.

​

Acionistas que são empresas

​

Webhooks de pessoas-chave

• data.updated (com session_kind: "business") — os dados da sessão, incluindo as pessoas-chave, foram atualizados.
• status.updated (com session_kind: "business") — o estado da sessão mudou em consequência.

​

Próximos passos