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

# 企业档案 API：追踪已验证企业

> Didit 提供企业档案 API，可跨会话追踪已验证企业，支持自动创建档案、状态与标签管理、批量操作及 CSV 导入导出。每次检查 $2.00 起。

Didit 会为您验证的每家企业自动创建一个企业档案，将验证数据和会话历史汇总到一个实体中。企业档案可跨所有验证会话提供每家企业的统一视图。

> [!NOTE]
>
> 企业档案是通用**企业实体**模型中专门面向 KYB 的部分。有关完整的实体模型（包括操作、关键人员与用户的关联、黑名单机制、导入和导出），请参阅[企业概览](https://docs.didit.me/zh/entities/businesses/overview.md)。

## 什么是企业档案

提交带有 `vendor_data` 标识符的[企业会话](https://docs.didit.me/zh/business-verification/overview.md)时，系统会自动创建企业档案。如果已存在具有该标识符的档案，则新会话会关联到该档案。

| 字段 | 说明 |
| - | - |
| **供应商数据** | 您为该企业分配的唯一标识符（例如 `company-123`） |
| **显示名称** | 控制台中显示的名称 |
| **法定名称** | 来自登记机构的官方法定名称或手动输入的名称 |
| **注册号** | 公司注册号或注册成立编号 |
| **国家** | 注册成立国家/地区（ISO 3166-1 alpha-2） |

## 档案状态

| 状态 | 说明 |
| - | - |
| `ACTIVE` | 企业状况良好，未发现任何问题 |
| `FLAGGED` | 企业需要关注，请查看结果或待处理的检查 |
| `BLOCKED` | 企业已被禁止进行进一步操作 |

状态可以在控制台中手动更改、批量更改，也可以根据验证结果自动更改。

## 会话指标

每个档案会跟踪所有关联会话的验证指标：

| 指标 | 说明 |
| - | - |
| **总会话数** | 该企业的验证会话数量 |
| **已通过** | 通过所有检查的会话 |
| **已拒绝** | 未通过一项或多项关键检查的会话 |
| **审核中** | 等待分析师审核的会话 |
| **最近会话** | 最近一次验证的时间戳 |
| **首次会话** | 最早一次验证的时间戳 |
| **上次活动** | 近期任何活动的时间戳（状态变更、会话更新等） |

## 标签

为企业档案添加标签，以便分类和筛选。标签由应用自行定义，请创建适合您工作流程的自定义标签，例如 `high-risk`、`vip-client` 或 `re-verification-needed`。

## 批量操作

一次管理多个企业档案：

| 操作 | 说明 |
| - | - |
| **批量更新状态** | 更改所选档案的状态（或当前筛选条件匹配的所有档案） |
| **CSV 导出** | 将档案数据导出为 CSV，并可配置列的选择 |
| **CSV 导入** | 从 CSV 文件导入企业档案，以便在验证前预先创建档案 |
| **批量删除** | 删除所选档案及其关联数据 |

### CSV 导入

要批量导入企业档案：

1. 从控制台下载**导入模板**，查看预期的列格式
2. 将您的企业数据填入模板
3. 上传文件。Didit 会创建导入任务，并异步处理各行数据

完成后，请查看导入摘要中已创建、已更新和失败的行数。失败的行会附带具体的错误详情。

## 审核与评论

您可以为任何企业档案添加内部审核备注。评论对所有有权限的团队成员可见，并构成审计记录的一部分：

* 添加纯文本备注
* 通过电子邮件提及团队成员以通知他们
* 查看包含作者和时间戳的完整评论历史

## 后续步骤

> [card] [企业验证概览](https://docs.didit.me/zh/business-verification/overview.md)
>
> 了解企业验证会话的完整端到端工作方式。

> [card] [控制台指南](https://docs.didit.me/zh/business-verification/console.md)
>
> 在企业控制台中管理企业档案和会话。

> [card] [API 参考](https://docs.didit.me/zh/management-api/businesses/list.md)
>
> 企业管理 API 端点。


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