> ## 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 的供应商企业功能将 KYB 历史、注册数据、实际受益人、高管、AML、证件和交易整合到一个持久化的法律实体档案中。

**企业实体**代表一个法律实体（公司、有限责任公司（LLC）、基金、基金会、个体工商户、信托），涵盖其在 Didit 上与您的平台之间发生的每一次 KYB 验证、交易和合规交互。

与用户实体一样，企业实体以 `vendor_data` 作为键，并将所有关联的会话和交易汇总到单一档案中。

## 企业包含哪些内容

| 类别 | 字段 / 对象 |
| - | - |
| **身份** | `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/zh/entities/businesses/data-model.md)。

## 企业何时创建

**1. 自动创建，基于企业验证（KYB）会话**

当您使用 Didit 从未见过的 `vendor_data` 创建企业验证（KYB）会话时，系统会创建一个状态为 `ACTIVE` 的企业实体，并将其关联到该会话。

**2. 显式创建，通过 POST /v3/businesses/create/**

在运行任何企业验证（KYB）会话之前，先预先创建企业。适用于预置元数据或批量入驻企业。

**3. 通过控制台创建**

您的团队可在企业页面中创建企业，例如，手动入驻一家通过线下流程完成验证的公司时。

## 您可以执行的操作

| 操作 | 方式 |
| - | - |
| [列出企业](https://docs.didit.me/zh/entities/businesses/operations.md#列出企业) | 使用带筛选条件的 `GET /v3/businesses/` |
| [获取企业](https://docs.didit.me/zh/entities/businesses/operations.md#获取企业) | `GET /v3/businesses/{vendor_data}/` |
| [创建企业](https://docs.didit.me/zh/entities/businesses/operations.md#创建企业) | `POST /v3/businesses/create/` |
| [更新档案](https://docs.didit.me/zh/entities/businesses/operations.md#更新企业) | `PATCH /v3/businesses/{vendor_data}/` |
| [更改状态](https://docs.didit.me/zh/entities/businesses/operations.md#变更状态) | `PATCH /v3/businesses/{vendor_data}/update-status/` |
| [删除企业](https://docs.didit.me/zh/entities/businesses/operations.md#批量删除企业) | `POST /v3/businesses/delete/`（批量） |
| [查看 KYB 历史](https://docs.didit.me/zh/entities/businesses/kyb-history.md) | `GET /v3/sessions?vendor_data=...` |
| [查看交易](https://docs.didit.me/zh/entities/businesses/transactions.md) | `GET /v3/transactions/?vendor_data=...` |
| [检查关键人员](https://docs.didit.me/zh/entities/businesses/key-people.md) | 通过企业验证（KYB）会话的决策 |
| [加入黑名单](https://docs.didit.me/zh/entities/businesses/blocklist.md) | 控制台 + Lists API |
| [导入 / 导出](https://docs.didit.me/zh/entities/businesses/import-export.md) | 仅限控制台（CSV） |
| [在控制台中管理](https://docs.didit.me/zh/entities/businesses/console.md) | 完整的界面操作指南 |

## 企业与用户的关系

企业实体很少是独立存在的。在 [KYB](https://docs.didit.me/zh/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/zh/entities/businesses/key-people.md)。

## 企业与企业会话

**企业会话**是一次 KYB 验证事件。**企业实体**则是汇总所有会话的持久档案。

一个企业可以拥有多个企业验证（KYB）会话，包括初次验证、重新提交和定期重新 KYB。企业的 `features` 映射反映所有会话的最新状态。

## 后续步骤

> [card] [数据模型](https://docs.didit.me/zh/entities/businesses/data-model.md)
>
> 每个字段、类型和索引。

> [card] [操作](https://docs.didit.me/zh/entities/businesses/operations.md)
>
> 创建、更新、更改状态、删除。

> [card] [KYB 历史](https://docs.didit.me/zh/entities/businesses/kyb-history.md)
>
> 与该企业相关的每个企业验证（KYB）会话。

> [card] [关键人员](https://docs.didit.me/zh/entities/businesses/key-people.md)
>
> 高管、UBO 和董事关联。

> [card] [黑名单](https://docs.didit.me/zh/entities/businesses/blocklist.md)
>
> 阻止企业参与交易。

> [card] [控制台](https://docs.didit.me/zh/entities/businesses/console.md)
>
> 企业界面完整操作指南。


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