> ## 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 и руководители

> Привяжите UBO, руководителей, директоров и бенефициарных владельцев к бизнес-сущности Didit. Каждый проходит KYC как сущность User. KYB на одной платформе.

Каждая сущность Business содержит **ключевых лиц**: физических лиц, которые несут юридическую ответственность за компанию или являются её бенефициарными владельцами. Didit выявляет их в ходе KYB и позволяет связать каждого с сущностью User для индивидуальной проверки KYC.

## Кто считается ключевым лицом

| Роль | Описание |
| - | - |
| **Директор** | Указан в реестре как директор компании |
| **Должностное лицо** | Секретарь, представитель или иное зарегистрированное должностное лицо |
| **Акционер** | Зарегистрированный акционер (юридическое или физическое лицо) |
| **UBO (конечный бенефициарный владелец)** | Физическое лицо, которое в конечном счёте владеет или контролирует 10/25/50%+ (порог настраивается) |
| **Уполномоченный подписант** | Лицо, наделённое полномочиями действовать от имени компании |

Полную таксономию ролей и расчёт цепочки владения см. на страницах [Должностные лица KYB](https://docs.didit.me/ru/business-verification/officers.md) и [Структура владения](https://docs.didit.me/ru/business-verification/ownership.md).

## Как ключевые лица привязываются к Business

**1. Определены по реестру**

В ходе KYB Didit запрашивает реестр компаний и извлекает всех указанных в нём должностных лиц и акционеров. Каждое такое лицо становится **записью о ключевом лице**, связанной с сессией «Верификация бизнеса (KYB)».

**2. Добавлено пользователем (заполняется клиентом)**

Сценарии могут включать шаг «Ключевые лица», на котором администратор бизнеса добавляет лиц, которых нет в реестре (например, UBO, выявленных по корпоративной декларации).

**3. Объединены в сущности Business**

Список ключевых лиц Business представляет собой объединение лиц, извлечённых из реестра, и лиц, добавленных пользователем, с удалением дубликатов по идентификатору.

У каждого ключевого лица есть поле `source`:

* `REGISTRY` означает, что лицо извлечено из официального реестра.
* `USER` означает, что лицо добавлено администратором бизнеса в ходе процесса KYB.

## Привязка ключевого лица к сущности User

Когда для ключевого лица требуется KYC (обычно это UBO и директора), это лицо можно связать с сущностью 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
```

Связь создаётся, когда:

* Для этого лица запускается сессия «Проверка пользователей (KYC)» с тем же `vendor_data`, что и у сущности User.
* Аналитик вручную связывает лицо из бизнеса с существующим User.

После привязки статус KYC пользователя передаётся в представление ключевых лиц в Business.

## Просмотр ключевых лиц

На странице сведений о Business в консоли вкладка **Ключевые лица** показывает:

* Имя, роль, долю владения в процентах и источник каждого лица (крест-накрест: реестр или добавление пользователем)
* Статус KYC связанных пользователей
* Статус AML-скрининга для каждого лица
* Связанные документы (удостоверение личности директора, декларация UBO)

Программно ключевые лица доступны в массиве `key_people_checks[]` в решении сессии «Верификация бизнеса (KYB)», который разделён на два блока:

```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`**: сводный прогресс KYC для UBO.

Устаревшие плоские массивы `officers[]` и `beneficial_owners[]` сохраняются в ответе для обратной совместимости ещё один релиз. Новые интеграции должны использовать описанную выше двухблочную структуру. Полный перечень полей см. в [схеме ответа KYB](https://docs.didit.me/ru/business-verification/response-schema.md#key_people_checks).

## Корпоративные акционеры

Если акционер сам является компанией (а не физическим лицом), Didit рекурсивно изучает цепочку владения, чтобы определить конечных бенефициарных владельцев. Корпоративные стороны могут по желанию запускать дочерние сессии «Верификация бизнеса (KYB)».

Пример многоуровневых цепочек владения см. в разделе [Структура владения](https://docs.didit.me/ru/business-verification/ownership.md).

## Вебхуки ключевых лиц

Изменения ключевых лиц передаются через события родительской сессии:

* `data.updated` (с `session_kind: "business"`): обновлены данные сессии, включая ключевых лиц.
* `status.updated` (с `session_kind: "business"`): в результате изменился статус сессии.

См. payload в разделе [Вебхуки KYB](https://docs.didit.me/ru/business-verification/webhooks.md).

## Следующие шаги

> [card] [Должностные лица](https://docs.didit.me/ru/business-verification/officers.md)
>
> Идентификация директоров и таксономия ролей.

> [card] [Структура владения](https://docs.didit.me/ru/business-verification/ownership.md)
>
> UBO, корпоративные акционеры и расчёт цепочек.

> [card] [Сценарий «Ключевые лица»](https://docs.didit.me/ru/business-verification/key-people.md)
>
> Шаг KYB, на котором собираются ключевые лица.


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