> ## 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のBusinessエンティティに、UBO、役員、取締役、実質的支配者を紐付けます。各人物はUserエンティティとしてKYCを実行し、1つのプラットフォームでKYBを完結できます。

すべてのBusinessエンティティには**主要人物**が存在します。主要人物とは、企業に対して法的責任を負う自然人、または企業を実質的に所有する自然人です。DiditはKYBの過程でこれらの人物を特定し、それぞれをUserエンティティに紐付けて個人のKYCを実施できるようにします。

## 主要人物に該当する人

| 役割 | 説明 |
| - | - |
| **取締役** | 登記簿に会社の取締役として記載されている人物 |
| **役員** | 秘書役、代表者、その他の登記された役員 |
| **株主** | 登記された株主(法人または個人) |
| **UBO(最終的な実質的支配者)** | 最終的に10/25/50%+を所有または支配する個人(しきい値は設定可能) |
| **署名権限者** | 会社を代表して行動する権限を与えられた人物 |

役割の完全な分類と所有関係の連鎖の算出については、[KYB役員](https://docs.didit.me/ja/business-verification/officers.md)および[所有構造](https://docs.didit.me/ja/business-verification/ownership.md)のページを参照してください。

## 主要人物がBusinessに紐付く仕組み

**1. 法人登記からの特定**

KYBの過程で、Diditは法人登記を照会し、記載されているすべての役員と株主を抽出します。各人物は、法人確認 (KYB) セッションに紐付く**主要人物レコード**になります。

**2. ユーザーによる追加(顧客による入力)**

ワークフローには「主要人物」ステップを含めることができ、企業の管理者が法人登記に記載されていない人物(法人による申告で特定されたUBOなど)を追加できます。

**3. Businessエンティティへの集約**

Businessの主要人物リストは、法人登記から抽出された人物とユーザーが追加した人物を合わせたもので、同一人物に基づいて重複が排除されます。

各主要人物には`source`フィールドがあります。

* `REGISTRY`:公的な法人登記から抽出されたもの。
* `USER`:KYBフローの中で企業の管理者が追加したもの。

## 主要人物をUserエンティティに紐付ける

主要人物(通常はUBOと取締役)にKYCが必要な場合、その当事者をUserエンティティに紐付けることができます。

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

紐付けは次の場合に作成されます。

* Userエンティティと同じ`vendor_data`を使用して、その当事者のユーザー認証 (KYC) セッションが実行された場合。
* アナリストが企業に関連する当事者を既存のUserに手動で関連付けた場合。

紐付けが完了すると、UserのKYCステータスがBusinessの主要人物ビューに反映されます。

## 主要人物の確認

コンソールのBusiness詳細ページでは、**主要人物**タブに次の情報が表示されます。

* 各当事者の氏名、役割、所有比率(%)、ソース(法人登記またはユーザーによる追加)
* 紐付けられたユーザーのKYCステータス
* 人物ごとのAMLスクリーニングのステータス
* 関連書類(取締役の身分証明書、UBO申告書)

プログラムからは、主要人物は法人確認 (KYB) セッションの判定に含まれる`key_people_checks[]`配列内に、2つのバケットに分かれて表示されます。

```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[]`配列は、後方互換性のためにあと1リリースの間レスポンスに残ります。新しい連携では、上記の2バケット形式を使用してください。すべてのフィールドについては、[KYBレスポンススキーマ](https://docs.didit.me/ja/business-verification/response-schema.md#key_people_checks)の全体を参照してください。

## 法人株主

株主が個人ではなく企業である場合、Diditは所有関係を再帰的にたどり最終的な実質的支配者を特定します。法人である当事者は、必要に応じて子の法人確認 (KYB) セッションをトリガーできます。

多層的な所有構造の具体例については、[所有構造](https://docs.didit.me/ja/business-verification/ownership.md)を参照してください。

## 主要人物のWebhook

主要人物の変更は、親セッションのイベントを通じて通知されます。

* `data.updated`(`session_kind: "business"`付き):主要人物を含むセッションデータが更新されました。
* `status.updated`(`session_kind: "business"`付き):その結果としてセッションのステータスが変更されました。

ペイロードについては、[KYB Webhook](https://docs.didit.me/ja/business-verification/webhooks.md)を参照してください。

## 次のステップ

> [card] [役員](https://docs.didit.me/ja/business-verification/officers.md)
>
> 取締役の特定と役割の分類。

> [card] [所有構造](https://docs.didit.me/ja/business-verification/ownership.md)
>
> UBO、法人株主、チェーンの算出。

> [card] [主要人物フロー](https://docs.didit.me/ja/business-verification/key-people.md)
>
> 主要人物を収集するKYBステップ。


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