Personas clave de empresas: UBO y directivos

​

Quién se considera persona clave

​

Cómo se asocian las personas clave a una entidad Business

• REGISTRY: extraída de un registro oficial.
• USER: añadida por el administrador de la empresa durante el flujo de KYB.

​

Vincular una persona clave a una entidad User

• Se ejecuta una sesión de Verificación de usuarios (KYC) para la parte con el mismo vendor_data que la entidad User.
• Un analista asocia manualmente a una persona de la empresa con un User existente.

​

Consultar las personas clave

• El nombre, el rol, el porcentaje de propiedad y el origen (registro o incorporación por el usuario) de cada persona
• El estado de KYC de los Users vinculados
• El estado del análisis AML de cada persona
• Los documentos asociados (documento de identidad del director, declaración 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: personas detectadas mediante la comprobación en el registro.
• submitted.parties: personas que el administrador de la empresa añadió durante el flujo de personas clave (source: USER).
• ubo_kyc_summary: progreso agregado del KYC de los UBO.

​

Accionistas corporativos

​

Webhooks de personas clave

• data.updated (con session_kind: "business"): se actualizaron los datos de la sesión, incluidas las personas clave.
• status.updated (con session_kind: "business"): el estado de la sesión cambió como consecuencia.

​

Próximos pasos