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

# 企业关键人员：实际受益人与董事

> 将实际受益人（UBO）、高管、董事等关键人员关联到 Didit 企业实体。每位人员作为用户实体完成 KYC，并在同一平台完成闭环 KYB。

Every Business entity has **关键人员**——即依法对企业负责或实际拥有企业股权的自然人。Didit 会在 KYB 期间识别这些人员，并允许你将每位关键人员关联到一个用户实体，以进行个人 KYC。

## 哪些人属于关键人员

| 角色 | 说明 |
| - | - |
| **董事** | 在登记信息中被列为公司董事 |
| **高级职员** | 秘书、代表或其他已登记的高级职员 |
| **股东** | 已登记的股东（法人或自然人） |
| **UBO（最终实际受益人）** | 最终拥有或控制企业 10/25/50%+ 权益的自然人（阈值可配置） |
| **授权签署人** | 有权代表公司行事的人员 |

请参阅 [KYB 高级职员](https://docs.didit.me/zh/business-verification/officers.md)和[股权结构](https://docs.didit.me/zh/business-verification/ownership.md)页面，了解完整的角色分类和股权链计算。

## 关键人员如何关联到企业

**1. 从登记信息中识别**

在 KYB 过程中，Didit 会查询公司登记，并提取所有列出的高级职员和股东。每个人都会成为一条关联到企业验证（KYB）会话的**关键人员记录**。

**2. 用户添加（由客户填写）**

工作流可以包含“关键人员”步骤，企业管理员可在其中添加登记信息中没有的人员（例如通过公司声明识别的 UBO）。

**3. 在企业实体上汇总**

企业的关键人员列表是登记信息提取的人员与用户添加的人员的并集，并按身份去重。

每位关键人员都有一个 `source` 字段：

* `REGISTRY`：从官方登记机构提取。
* `USER`：由企业管理员在 KYB 流程中添加。

## 将关键人员关联到用户实体

当某位关键人员需要进行 KYC（通常是 UBO 和董事）时，可以将该人员关联到一个用户实体：

```mermaid theme={null}
flowchart LR
    B[Business: biz-acme]
    P1[Key Person: Jane Doe, Director]
    P2[Key Person: John Smith, UBO 40%]
    U1[User: user-jane]
    U2[User: user-john]
    P1 --> B
    P2 --> B
    P1 -.linked.-> U1
    P2 -.linked.-> U2
```

在以下情况下会创建关联：

* 对该人员运行用户验证（KYC）会话时，使用与用户实体相同的 `vendor_data`。
* 分析师手动将企业相关人员与现有用户关联。

关联后，用户的 KYC 状态会同步到企业的关键人员视图。

## 查看关键人员

在控制台的企业详情页面中，**关键人员**选项卡显示以下内容：

* 每位人员的姓名、角色、股权比例、来源（登记信息或用户添加）
* 已关联用户的 KYC 状态
* 每位人员的 AML 筛查状态
* 相关证件（董事身份证件、UBO 声明）

通过编程方式，关键人员会出现在企业验证（KYB）会话决策的 `key_people_checks[]` 数组中，并分为两类：

```json theme={null}
"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`**：通过登记信息核验发现的人员。
* **`submitted.parties`**：企业管理员在关键人员流程中添加的人员（`source: USER`）。
* **`ubo_kyc_summary`**：UBO KYC 的总体进度。

为向后兼容，响应中的旧版扁平数组 `officers[]` 和 `beneficial_owners[]` 将再保留一个版本。新集成应使用上述两类结构。有关每个字段，请参阅完整的 [KYB 响应模式](https://docs.didit.me/zh/business-verification/response-schema.md#key_people_checks)。

## 企业股东

当股东本身是公司（而非个人）时，Didit 会递归查看股权链，以识别最终实际受益人。法人相关方可以选择触发企业验证（KYB）子会话。

多层股权链的实际示例请参阅[股权结构](https://docs.didit.me/zh/business-verification/ownership.md)。

## 关键人员 Webhook

关键人员的变更会通过父会话事件体现：

* `data.updated`（`session_kind: "business"`）：包括关键人员在内的会话数据已更新。
* `status.updated`（`session_kind: "business"`）：会话状态因此发生变化。

有关 payload，请参阅 [KYB Webhook](https://docs.didit.me/zh/business-verification/webhooks.md)。

## 后续步骤

> [card] [高级职员](https://docs.didit.me/zh/business-verification/officers.md)
>
> 董事身份识别和角色分类。

> [card] [股权结构](https://docs.didit.me/zh/business-verification/ownership.md)
>
> UBO、企业股东和股权链计算。

> [card] [关键人员流程](https://docs.didit.me/zh/business-verification/key-people.md)
>
> 收集关键人员信息的 KYB 步骤。


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