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

> Модель сущности Didit Business: данные реестра, UBO, руководители, статус AML, документы, агрегаты KYB-сессий, связанные транзакции. Замкнутый цикл KYB.

Этот раздел описывает все поля сущности компании и то, как Didit заполняет каждое из них.

## Поля идентификации

| Поле | Тип | Описание |
| - | - | - |
| `uuid` | UUID | Первичный ключ, назначаемый Didit. Стабилен и уникален. |
| `didit_internal_id` | string | Внутренний идентификатор, понятный человеку. |
| `vendor_data` | string | Ваш идентификатор компании. Уникален в рамках приложения. [Подробнее](https://docs.didit.me/ru/entities/vendor-data-linking.md). |
| `display_name` | string | Переопределяемое название, отображаемое в консоли. По умолчанию используется `legal_name` или `vendor_data`. |
| `legal_name` | string | Юридическое название компании согласно регистрации. Берётся из результата поиска в реестре в последней одобренной сессии верификации бизнеса (KYB). |
| `registration_number` | string | Официальный регистрационный номер компании. Берётся из реестра. |
| `country_code` | string (ISO 3166-1 alpha-3) | Страна регистрации компании. |

> [!NOTE]
>
> `legal_name`, `registration_number` и `country_code` доступны только для чтения, если они получены из проверенного результата поиска в реестре. Их можно переопределить вручную в консоли или через `PATCH /v3/businesses/{vendor_data}/`, но каждое переопределение отмечается в журнале аудита.

## Статус

| Поле | Тип | Значения | Описание |
| - | - | - | - |
| `status` | enum | `ACTIVE`, `FLAGGED`, `BLOCKED` | Определяет правила применения для будущих сессий и транзакций. См. [жизненный цикл](https://docs.didit.me/ru/entities/lifecycle.md). |

## Агрегированные поля сессий

| Поле | Тип | Описание |
| - | - | - |
| `session_count` | int | Общее количество сессий верификации бизнеса (KYB), когда-либо созданных для этой компании |
| `approved_count` | int | Сессии, завершённые со статусом `Approved` |
| `declined_count` | int | Сессии, завершённые со статусом `Declined` |
| `in_review_count` | int | Сессии, которые сейчас имеют статус `In Review` |
| `features` | object | Статус последней проверки компании, под ключом `KYB` |

### Карта `features`

```json theme={null}
{
  "KYB": "Approved"
}
```

Карта содержит один ключ, `KYB`, со статусом последней проверки компании: `"Not Finished"`, `"Approved"`, `"Declined"`, `"In Review"` или `"Resub Requested"`.
Чтобы узнать статус каждой отдельной функции KYB, смотрите решение по сессии.

Используйте карту `features` для быстрой проверки того, полностью ли верифицирована компания прямо сейчас, без перебора всех сессий.

## Временные метки активности

| Поле | Тип | Когда обновляется |
| - | - | - |
| `first_session_at` | ISO timestamp | Создана первая сессия верификации бизнеса (KYB) |
| `last_session_at` | ISO timestamp | Создана или обновлена последняя сессия |
| `last_activity_at` | ISO timestamp | При любом изменении сессии, транзакции, статуса, профиля или заметок |
| `created_at` | ISO timestamp | Создана запись сущности |
| `updated_at` | ISO timestamp | Последнее обновление записи сущности |

## Метаданные

| Поле | Тип | Описание |
| - | - | - |
| `metadata` | object (JSON) | Произвольный JSON, которым управляете вы |
| `tags[]` | array | Теги, которыми управляют консоль и API |

## Связи (не хранятся в строке компании)

| Связь | Как получить доступ |
| - | - |
| Сессии верификации бизнеса (KYB) | `GET /v3/sessions?vendor_data=<value>` |
| Связанные пользователи (руководители, UBO, директора) | Отображаются на странице сведений о компании в консоли; берутся из последней одобренной сессии верификации бизнеса (KYB) |
| Транзакции (как заявитель или контрагент) | Фильтруйте транзакции по `vendor_data` компании |
| Документы | Через решения по сессиям верификации бизнеса (KYB) |
| AML-срабатывания | Через решения по сессиям верификации бизнеса (KYB) |

## Пример ответа

```json theme={null}
{
  "uuid": "f7a9c1b2-4e6d-4f8a-9c5d-2a1b3c4d5e6f",
  "didit_internal_id": "B-2026-00018",
  "vendor_data": "biz-acme",
  "display_name": "Acme Corp",
  "legal_name": "Acme Corporation Limited",
  "registration_number": "12345678",
  "country_code": "GBR",
  "status": "ACTIVE",
  "session_count": 2,
  "approved_count": 1,
  "declined_count": 0,
  "in_review_count": 1,
  "features": {
    "KYB": "Approved"
  },
  "first_session_at": "2025-09-01T12:00:00Z",
  "last_session_at": "2026-04-01T09:00:00Z",
  "last_activity_at": "2026-04-16T10:00:00Z",
  "metadata": { "partner": "Acme Holdings" }
}
```

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

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

> [card] [История KYB](https://docs.didit.me/ru/entities/businesses/kyb-history.md)
>
> Получение всех сессий, связанных с компанией.

> [card] [Справочник API](https://docs.didit.me/ru/management-api/businesses/get.md)
>
> Схема GET /v3/businesses/{vendor_data}/.


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