> ## 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 の企業エンティティモデル：法人登記データ、実質的支配者（UBO）、役員、AMLステータス、書類、KYBセッション集計、紐づく取引を一元管理するクローズドループKYB。

このページでは、Businessエンティティのすべてのフィールドと、Diditが各フィールドに値を設定する方法を説明します。

## 識別フィールド

| フィールド | 型 | 説明 |
| - | - | - |
| `uuid` | UUID | Diditが割り当てる主キーです。不変かつ一意です。 |
| `didit_internal_id` | string | 人が読める形式の内部識別子です。 |
| `vendor_data` | string | お客様が企業に付ける識別子です。アプリケーションごとに一意です。[詳細はこちら](https://docs.didit.me/ja/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/ja/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`というキーが1つだけあり、その企業の最新の確認ステータス (`"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/ja/entities/businesses/operations.md)
>
> 作成、更新、ステータス変更、削除。

> [card] [KYB履歴](https://docs.didit.me/ja/entities/businesses/kyb-history.md)
>
> 企業に紐づくすべてのセッションを取得します。

> [card] [APIリファレンス](https://docs.didit.me/ja/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.