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

# Верификация бизнеса (KYB): постоянная запись о компании

> Vendor Businesses в Didit объединяют историю KYB, данные реестра, бенефициаров, руководителей, AML, документы и транзакции в одном постоянном профиле юрлица.

A **Сущность Business** представляет юридическое лицо (компанию, LLC, фонд, фонд-учреждение, индивидуальное предпринимательство, траст) во всех взаимодействиях, связанных с KYB-верификацией, транзакциями и комплаенсом, которые оно имеет с вашей платформой на Didit.

Как и сущности User, сущности Business привязываются по `vendor_data` и объединяют все связанные сессии и транзакции в один профиль.

## Что хранится в Business

| Категория | Поля / объекты |
| - | - |
| **Идентификационные данные** | `vendor_data`, `uuid`, `display_name`, `legal_name`, `registration_number`, `country_code` |
| **Статус** | `ACTIVE`, `FLAGGED`, `BLOCKED` |
| **Агрегаты сессий** | `session_count`, `approved_count`, `declined_count`, `in_review_count`, карта `features` |
| **Активность** | `first_session_at`, `last_session_at`, `last_activity_at` |
| **Ключевые лица** | Связанные должностные лица, директора, UBO, бенефициарные владельцы (каждый может быть связан с сущностью User для KYC) |
| **Документы** | Свидетельства о регистрации, учредительные документы, реестры акционеров, POA, финансовая отчётность, дополнительные документы |
| **AML-проверка** | Результаты скрининга компании на санкции, PEP и негативные публикации в СМИ |
| **Метаданные** | Произвольный JSON для ваших собственных данных |

См. полную [модель данных Business](https://docs.didit.me/ru/entities/businesses/data-model.md) с типами полей и пограничными случаями.

## Когда создаётся Business

**1. Автоматически: из сессии верификации бизнеса (KYB)**

Когда вы создаёте сессию верификации бизнеса (KYB) с `vendor_data`, которого Didit ещё не встречал, создаётся сущность Business в статусе `ACTIVE` и связывается с этой сессией.

**2. Явно: через POST /v3/businesses/create/**

Создайте Business заранее, до запуска любой сессии верификации бизнеса (KYB). Удобно для заполнения метаданных или массового онбординга компаний.

**3. Из консоли**

Ваша команда создаёт Business на странице Businesses, например, когда компания проверена офлайн и её нужно онбордить вручную.

## Что можно делать

| Операция | Как |
| - | - |
| [Просмотр списка Business](https://docs.didit.me/ru/entities/businesses/operations.md#получить-список-компаний) | `GET /v3/businesses/` с фильтрами |
| [Получить Business](https://docs.didit.me/ru/entities/businesses/operations.md#получить-компанию) | `GET /v3/businesses/{vendor_data}/` |
| [Создать Business](https://docs.didit.me/ru/entities/businesses/operations.md#создать-компанию) | `POST /v3/businesses/create/` |
| [Обновить профиль](https://docs.didit.me/ru/entities/businesses/operations.md#обновить-компанию) | `PATCH /v3/businesses/{vendor_data}/` |
| [Изменить статус](https://docs.didit.me/ru/entities/businesses/operations.md#изменить-статус) | `PATCH /v3/businesses/{vendor_data}/update-status/` |
| [Удалить Business (пакетно)](https://docs.didit.me/ru/entities/businesses/operations.md#удалить-компании-пакетно) | `POST /v3/businesses/delete/` (пакетно) |
| [Просмотр истории KYB](https://docs.didit.me/ru/entities/businesses/kyb-history.md) | `GET /v3/sessions?vendor_data=...` |
| [Просмотр транзакций](https://docs.didit.me/ru/entities/businesses/transactions.md) | `GET /v3/transactions/?vendor_data=...` |
| [Просмотр ключевых лиц](https://docs.didit.me/ru/entities/businesses/key-people.md) | Через решения по сессиям верификации бизнеса (KYB) |
| [Добавить в список блокировки](https://docs.didit.me/ru/entities/businesses/blocklist.md) | Консоль + Lists API |
| [Импорт / экспорт](https://docs.didit.me/ru/entities/businesses/import-export.md) | Только консоль (CSV) |
| [Управление в консоли](https://docs.didit.me/ru/entities/businesses/console.md) | Полное руководство по интерфейсу |

## Связи Business ↔ User

Сущность Business редко существует сама по себе. Во время [KYB](https://docs.didit.me/ru/business-verification/overview.md) Didit определяет каждого должностного лица, директора, UBO и бенефициарного владельца. Каждого из них можно связать с сущностью User для индивидуального KYC:

```mermaid theme={null}
flowchart LR
    B[Business: biz-acme]
    U1[User: jane-doe<br/>Director]
    U2[User: john-smith<br/>UBO 40%]
    U3[User: alice-chen<br/>UBO 35%]
    U1 --> B
    U2 --> B
    U3 --> B
```

Если один из связанных User не прошёл KYC или получил совпадение в AML, это отражается в профиле риска Business. См. [Ключевые лица](https://docs.didit.me/ru/entities/businesses/key-people.md) со схемой связывания.

## Business и сессия KYB

Бизнес-сессия представляет собой одно событие верификации KYB, а сущность Business — это постоянный профиль, который агрегирует все сессии.

У одного Business может быть много сессий верификации бизнеса (KYB): первичная верификация, повторные отправки, периодическая повторная проверка KYB. Карта `features` в Business отражает последнее состояние по всем сессиям.

## Дальнейшие шаги

> [card] [Модель данных](https://docs.didit.me/ru/entities/businesses/data-model.md)
>
> Каждое поле, тип и индекс.

> [card] [Операции](https://docs.didit.me/ru/entities/businesses/operations.md)
>
> Создание, обновление, изменение статуса, удаление.

> [card] [История KYB](https://docs.didit.me/ru/entities/businesses/kyb-history.md)
>
> Каждая сессия верификации бизнеса (KYB), связанная с компанией.

> [card] [Ключевые лица](https://docs.didit.me/ru/entities/businesses/key-people.md)
>
> Связывание должностных лиц, UBO и директоров.

> [card] [Список блокировки](https://docs.didit.me/ru/entities/businesses/blocklist.md)
>
> Блокировка компаниям доступа к транзакциям.

> [card] [Консоль](https://docs.didit.me/ru/entities/businesses/console.md)
>
> Полное руководство по интерфейсу Businesses.


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