> ## 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를 위해 User 엔티티에 연결할 수 있도록 합니다.

## 주요 인물의 범위

| 역할 | 설명 |
| - | - |
| **이사** | 등기부에 회사 이사로 기재된 인물 |
| **임원** | 비서, 대표자 또는 기타 등록된 임원 |
| **주주** | 등록된 주주(법인 또는 개인) |
| **UBO (최종 실소유자)** | 최종적으로 10/25/50%+ 지분을 소유하거나 통제하는 개인(임계값은 구성 가능) |
| **서명 권한자** | 회사를 대신하여 행동할 권한이 있는 인물 |

전체 역할 분류와 소유 체인 계산에 대해서는 [KYB 임원](https://docs.didit.me/ko/business-verification/officers.md) 및 [소유 구조](https://docs.didit.me/ko/business-verification/ownership.md) 페이지를 참조하십시오.

## 주요 인물이 기업에 연결되는 방식

**1. 등기부에서 식별**

KYB 과정에서 Didit은 법인 등기부를 조회하여 등재된 모든 임원과 주주를 추출합니다. 각 인물은 기업 확인(KYB) 세션에 연결된 **주요 인물 레코드**가 됩니다.

**2. 사용자 추가(고객 입력)**

워크플로에는 "주요 인물" 단계가 포함될 수 있으며, 이 단계에서 기업 관리자는 등기부에 없는 인물(예: 법인 신고서로 확인된 UBO)을 추가합니다.

**3. 기업 엔티티에 통합**

기업의 주요 인물 목록은 등기부에서 추출된 당사자와 사용자가 추가한 당사자를 합친 것이며, 신원을 기준으로 중복이 제거됩니다.

각 주요 인물에는 `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 상태가 기업의 주요 인물 보기에 반영됩니다.

## 주요 인물 조회하기

기업 상세 페이지의 콘솔에서 **주요 인물** 탭에는 다음이 표시됩니다:

* 각 당사자의 이름, 역할, 지분율, 출처(등기부 또는 사용자 추가)
* 연결된 User의 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/ko/business-verification/response-schema.md#key_people_checks)를 참조하십시오.

## 법인 주주

주주가 개인이 아닌 법인인 경우, Didit은 소유 체인을 재귀적으로 탐색하여 최종 실소유자를 식별합니다. 법인 당사자는 선택적으로 하위 기업 확인(KYB) 세션을 트리거할 수 있습니다.

다층 소유 체인의 작업 예시는 [소유 구조](https://docs.didit.me/ko/business-verification/ownership.md) 페이지를 참조하십시오.

## 주요 인물 웹훅

주요 인물의 변경 사항은 상위 세션 이벤트를 통해 전달됩니다:

* `data.updated` (`session_kind: "business"` 포함): 주요 인물을 포함한 세션 데이터가 업데이트되었습니다.
* `status.updated` (`session_kind: "business"` 포함): 그 결과 세션 상태가 변경되었습니다.

페이로드는 [KYB 웹훅](https://docs.didit.me/ko/business-verification/webhooks.md)을 참조하십시오.

## 다음 단계

> [card] [임원](https://docs.didit.me/ko/business-verification/officers.md)
>
> 이사 식별 및 역할 분류.

> [card] [소유 구조](https://docs.didit.me/ko/business-verification/ownership.md)
>
> UBO, 법인 주주 및 체인 계산.

> [card] [주요 인물 워크플로](https://docs.didit.me/ko/business-verification/key-people.md)
>
> 주요 인물을 수집하는 KYB 단계.


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