주요 인물의 범위
전체 역할 분류와 소유 체인 계산에 대해서는 KYB 임원 및 소유 구조 페이지를 참조하십시오.
주요 인물이 기업에 연결되는 방식
1
등기부에서 식별
KYB 과정에서 Didit은 법인 등기부를 조회하여 등재된 모든 임원과 주주를 추출합니다. 각 인물은 기업 확인(KYB) 세션에 연결된 주요 인물 레코드가 됩니다.
2
사용자 추가(고객 입력)
워크플로에는 “주요 인물” 단계가 포함될 수 있으며, 이 단계에서 기업 관리자는 등기부에 없는 인물(예: 법인 신고서로 확인된 UBO)을 추가합니다.
3
기업 엔티티에 통합
기업의 주요 인물 목록은 등기부에서 추출된 당사자와 사용자가 추가한 당사자를 합친 것이며, 신원을 기준으로 중복이 제거됩니다.
source 필드가 있습니다:
REGISTRY: 공식 등기부에서 추출됨.USER: KYB 흐름 중 기업 관리자가 추가함.
주요 인물을 User 엔티티에 연결하기
주요 인물(일반적으로 UBO 및 이사)에 대해 KYC가 필요한 경우, 해당 당사자를 User 엔티티에 연결할 수 있습니다: 다음의 경우에 링크가 생성됩니다:- User 엔티티와 동일한
vendor_data를 사용하여 해당 당사자에 대한 사용자 인증(KYC) 세션이 실행될 때. - 분석가가 기업 당사자를 기존 User와 수동으로 연결할 때.
주요 인물 조회하기
기업 상세 페이지의 콘솔에서 주요 인물 탭에는 다음이 표시됩니다:- 각 당사자의 이름, 역할, 지분율, 출처(등기부 또는 사용자 추가)
- 연결된 User의 KYC 상태
- 인물별 AML 스크리닝 상태
- 연결된 문서(이사 신분증, UBO 신고서)
key_people_checks[] 배열에 나타나며, 다음 두 개의 버킷으로 나뉩니다:
registry.officers/registry.beneficial_owners: 등기부 조회를 통해 발견된 당사자입니다.submitted.parties: 주요 인물 흐름에서 기업 관리자가 추가한 당사자입니다(source: USER).ubo_kyc_summary: UBO KYC 진행 상황을 집계한 값입니다.
officers[] 및 beneficial_owners[] 배열은 하위 호환성을 위해 다음 한 번의 릴리스까지 응답에 계속 포함됩니다. 새 연동에서는 위의 두 버킷 구조를 사용하십시오. 각 필드에 대해서는 KYB 응답 스키마를 참조하십시오.
법인 주주
주주가 개인이 아닌 법인인 경우, Didit은 소유 체인을 재귀적으로 탐색하여 최종 실소유자를 식별합니다. 법인 당사자는 선택적으로 하위 기업 확인(KYB) 세션을 트리거할 수 있습니다. 다층 소유 체인의 작업 예시는 소유 구조 페이지를 참조하십시오.주요 인물 웹훅
주요 인물의 변경 사항은 상위 세션 이벤트를 통해 전달됩니다:data.updated(session_kind: "business"포함): 주요 인물을 포함한 세션 데이터가 업데이트되었습니다.status.updated(session_kind: "business"포함): 그 결과 세션 상태가 변경되었습니다.
다음 단계
임원
이사 식별 및 역할 분류.
소유 구조
UBO, 법인 주주 및 체인 계산.
주요 인물 워크플로
주요 인물을 수집하는 KYB 단계.