> ## 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のVendor Businessesは、KYB履歴、法人登記データ、実質的支配者（UBO）、役員、AML、書類、取引を1つの永続的な法人プロファイルに統合します。

**企業エンティティ**は、Didit上であなたのプラットフォームと行うすべてのKYB認証、取引、コンプライアンス上のやり取りにおける法人（会社、LLC、ファンド、財団、個人事業、信託）を表します。

ユーザーエンティティと同様に、企業エンティティは`vendor_data`をキーとし、紐付けられたすべてのセッションと取引を1つのプロファイルに集約します。

## 企業エンティティに含まれる情報

| カテゴリ | フィールド / オブジェクト |
| - | - |
| **識別情報** | `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、実質的支配者（それぞれKYCのためにユーザーエンティティに紐付けることができます） |
| **書類** | 設立証明書、定款、株主名簿、POA、財務諸表、カスタム書類 |
| **AML** | 企業単位の制裁 / PEP / ネガティブメディアのスクリーニング結果 |
| **メタデータ** | 独自データを格納できる任意のJSON |

フィールドの型やエッジケースについては、[企業のデータモデル](https://docs.didit.me/ja/entities/businesses/data-model.md)の全体を参照してください。

## 企業エンティティが作成されるタイミング

**1. 法人確認 (KYB)セッションから自動的に作成**

Diditがこれまでに受け取ったことのない`vendor_data`で法人確認 (KYB)セッションを作成すると、企業エンティティが`ACTIVE`ステータスで作成され、そのセッションに紐付けられます。

**2. POST /v3/businesses/create/で明示的に作成**

法人確認 (KYB)セッションを実行する前に、企業エンティティを事前に作成します。メタデータの初期登録や、企業の一括オンボーディングに便利です。

**3. コンソールから作成**

チームが企業ページから企業エンティティを作成します。たとえば、オフラインのプロセスで確認済みの企業を手動でオンボーディングする場合に使います。

## できること

| 操作 | 方法 |
| - | - |
| [企業の一覧取得](https://docs.didit.me/ja/entities/businesses/operations.md#企業の一覧取得) | フィルターを指定して`GET /v3/businesses/` |
| [企業の取得](https://docs.didit.me/ja/entities/businesses/operations.md#企業の取得) | `GET /v3/businesses/{vendor_data}/` |
| [企業の作成](https://docs.didit.me/ja/entities/businesses/operations.md#企業の作成) | `POST /v3/businesses/create/` |
| [プロファイルの更新](https://docs.didit.me/ja/entities/businesses/operations.md#企業の更新) | `PATCH /v3/businesses/{vendor_data}/` |
| [ステータスの変更](https://docs.didit.me/ja/entities/businesses/operations.md#ステータスの変更) | `PATCH /v3/businesses/{vendor_data}/update-status/` |
| [企業の削除](https://docs.didit.me/ja/entities/businesses/operations.md#企業の削除-一括) | `POST /v3/businesses/delete/`（一括） |
| [KYB履歴の確認](https://docs.didit.me/ja/entities/businesses/kyb-history.md) | `GET /v3/sessions?vendor_data=...` |
| [取引の確認](https://docs.didit.me/ja/entities/businesses/transactions.md) | `GET /v3/transactions/?vendor_data=...` |
| [主要人物の確認](https://docs.didit.me/ja/entities/businesses/key-people.md) | 法人確認（KYB）セッションの判定で確認 |
| [ブロックリストへの追加](https://docs.didit.me/ja/entities/businesses/blocklist.md) | コンソール + Lists API |
| [インポート / エクスポート](https://docs.didit.me/ja/entities/businesses/import-export.md) | コンソールのみ（CSV） |
| [コンソールでの管理](https://docs.didit.me/ja/entities/businesses/console.md) | UIの操作手順 |

## 企業とユーザーの関係

企業エンティティが単独で存在することはほとんどありません。[KYB](https://docs.didit.me/ja/business-verification/overview.md)の過程で、Diditはすべての役員、取締役、UBO、実質的支配者を特定します。これらの人物はそれぞれ、個人の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
```

紐付けられたユーザーのいずれかがKYCに失敗した場合、またはAMLでヒットした場合、その結果は企業のリスクプロファイルに反映されます。紐付けのパターンについては[主要人物](https://docs.didit.me/ja/entities/businesses/key-people.md)を参照してください。

## 企業エンティティと企業セッションの違い

**企業セッション**は、1回のKYB認証イベントです。**企業エンティティ**は、すべてのセッションを集約する永続的なプロファイルです。

1つの企業エンティティは、初回の認証、再提出、定期的な再KYBなど、複数の法人確認 (KYB)セッションを持つことができます。企業エンティティの`features`マップには、すべてのセッションを通じた最新の状態が反映されます。

## 次のステップ

> [card] [データモデル](https://docs.didit.me/ja/entities/businesses/data-model.md)
>
> すべてのフィールド、型、インデックス。

> [card] [操作](https://docs.didit.me/ja/entities/businesses/operations.md)
>
> 作成、更新、ステータス変更、削除。

> [card] [KYB履歴](https://docs.didit.me/ja/entities/businesses/kyb-history.md)
>
> 企業に紐付くすべての法人確認 (KYB)セッション。

> [card] [主要人物](https://docs.didit.me/ja/entities/businesses/key-people.md)
>
> 役員、UBO、取締役の紐付け。

> [card] [ブロックリスト](https://docs.didit.me/ja/entities/businesses/blocklist.md)
>
> 企業の取引をブロックする方法。

> [card] [コンソール](https://docs.didit.me/ja/entities/businesses/console.md)
>
> 企業UIの詳しい解説。


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