> ## 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 登记查询、KYB 证件、KYB 关键人员、AML、电话、邮箱、问卷及设备与 IP 分析。

企业验证会在产生警告的功能项上显示该警告。每条警告都采用平台通用的结构化格式，包含 `feature`、`risk`、`log_type`、`short_description`、`long_description`、可选的 `additional_data` 和 `node_id`，便于你把审核工作分派给对应的运营团队。

## 概述

KYB 会话会在三个核心功能标签下生成警告，这些标签对应 V3 决策响应中的专属功能数组：

| 功能标签 | 决策响应键 | 涵盖内容 |
| - | - | - |
| `KYB_REGISTRY` | `registry_checks[].warnings[]` | 官方公司登记查询。包括营业状态、国家/地区限制、可推导的股权结构，以及缺失的高管或实际受益人记录。 |
| `KYB_DOCUMENTS` | `document_verifications[].warnings[]` | 用户上传的设立、股权、地址和股东证件。包括跨证件一致性、OCR、元数据、篡改、有效期以及子类型规则。 |
| `KYB_KEY_PEOPLE` | `key_people_checks[].warnings[]` | 针对董事、高管、实际受益人或用户提交的相关人员的个人层面信号，包括从 AML 和先前拒绝结果复用中传递过来的 PEP 与制裁结果。 |

同一个 KYB 工作流还可以包含下列共享功能，它们会在各自的数组中输出警告：

| 功能标签 | 决策响应键 |
| - | - |
| `AML` | `aml_screenings[].warnings[]` |
| `PHONE` | `phone_verifications[].warnings[]` |
| `EMAIL` | `email_verifications[].warnings[]` |
| `QUESTIONNAIRE` | `questionnaire_responses`（警告位于会话日志中） |
| `LOCATION` | `ip_analyses[].warnings[]` |

## KYB 公司登记警告

注册局警告使用 `feature: "KYB_REGISTRY"`，并出现在 `registry_checks[].warnings[]` 中。

| 标签 | 说明 |
| - | - |
| `KYB_COUNTRY_RESTRICTED` | 该公司所在国家/地区不在工作流配置的允许国家/地区范围内。 |
| `KYB_OFFICERS_DATA_NOT_FOUND` | 公司登记处无法提供高管数据。 |
| `KYB_OWNERSHIP_DATA_NOT_FOUND` | 公司登记处无法提供股权数据。 |
| `KYB_BENEFICIAL_OWNERSHIP_NOT_DERIVABLE` | 无法根据公司登记处数据确定最终实际受益所有权。 |
| `KYB_COMPANY_NOT_ACTIVE` | 公司登记处显示该公司未处于活跃状态。 |
| `KYB_COMPANY_NOT_FROM_REGISTRY` | 该公司为手动录入，无法通过公司登记处进行核验。 |
| `KYB_REGISTRY_DATA_MISMATCH_WITH_EXPECTED` | 从公司登记处获取的公司注册号与你在创建会话时发送的 `expected_details.registration_number` 不一致。 |
| `KYB_REGISTRY_DATA_PARTIAL_MATCH_WITH_EXPECTED` | 从公司登记处获取的注册号与预期注册号只有部分重合，例如分支机构或子公司后缀。 |
| `KYB_COMPANY_VAT_INVALID` | 官方税务登记处没有该公司增值税号或税号的有效登记，或者该增值税号不符合其所在国家/地区的格式和校验位规则。系统会应用已配置的 `kyb_vat_invalid_action`（默认：审核中）。 |
| `KYB_COMPANY_VAT_COULD_NOT_VALIDATE` | 由于官方注册局暂时不可用，无法验证该增值税号或税号。系统会应用已配置的 `kyb_vat_unverified_action`（默认：无影响）。 |
| `KYB_COMPANY_VAT_NAME_MISMATCH` | 官方登记处登记的该号码对应名称与提交的公司名称不同。仅供参考，其中 `additional_data` 包含 `registry_name`、`registry_source` 和 `submitted_name`；当注册局为 VIES 时，还包含 `vies_name`。 |

增值税警告适用于能够验证该公司增值税号或税号的所有情形。有关国家/地区和数据来源，请参阅 [VAT 与税号验证](https://docs.didit.me/zh/business-verification/company-data.md#vat-号码与税号验证)。

## KYB 证件警告

证件警告使用 `feature: "KYB_DOCUMENTS"`，并出现在 `document_verifications[].warnings[]` 中。

| 标签 | 描述 |
| - | - |
| `KYB_DOCUMENT_MISSING_REQUIRED_FIELD` | 证件中未找到必填的企业字段，例如企业名称或注册号。 |
| `KYB_DOCUMENT_NAME_MISMATCH` | 证件中的企业名称与公司登记不一致。 |
| `KYB_DOCUMENT_REG_NUMBER_MISMATCH` | 证件中的注册号与公司登记不一致。 |
| `KYB_DOCUMENT_INCORPORATION_DATE_MISMATCH` | 证件中的成立日期与公司登记不一致。 |
| `KYB_DOCUMENT_ADDRESS_MISMATCH` | 证件中的注册地址与公司登记不一致。 |
| `KYB_CROSS_DOCUMENT_MISMATCH` | 已上传的企业证件之间，企业信息存在差异。 |
| `KYB_DOCUMENT_METADATA_MISMATCH` | 证件的签名、元数据或文件结构显示可能存在问题。 |
| `KYB_ASSOCIATED_PARTY_MISMATCH` | 证件中的董事或股东与公司登记不一致。 |
| `KYB_DOCUMENT_GRAPHIC_EDITOR` | 该证件似乎经过图形编辑软件处理。 |
| `KYB_DOCUMENT_SUSPECTED_MANIPULATION` | 系统检测到企业证件可能被篡改的迹象。 |
| `KYB_DOCUMENT_UNPROVEN_TEXT_REPLACEMENT` | 企业证件的某个文本字段被清空后，用另一种字体重新输入，而文件中没有证据表明内容是否发生变化。如果文件无法被完整检查，也会触发此警告，此时 `additional_data.detection_method` 设为 `analysis_incomplete`，因为未检查的部分可能包含此类字段。由 `kyb_document_unproven_text_replacement_action` 控制（默认为审核）。使用工作流但从不审核的情况下，若其 `kyb_document_tampering_action` 为拒绝，则采用该设置，否则为无操作。 |
| `KYB_ADDITIONAL_DATA_NOT_FOUND` | 由于对应的公司登记数据不可用，无法验证某个证件字段。 |
| `KYB_DOCUMENT_EXPIRED` | 企业证件超过了配置的最大允许年限。 |
| `KYB_DOCUMENT_UNSUPPORTED_SUBTYPE` | 所上传证件的子类型已在该工作流中被禁用。 |
| `KYB_DOCUMENT_MAX_ATTEMPTS_EXCEEDED` | 企业证件的上传尝试次数已超过上限。 |

对于 PDF 覆盖文本篡改，`KYB_DOCUMENT_SUSPECTED_MANIPULATION` 可以包含 `additional_data.manipulated_regions`。文本字段被清空后用另一种字体重新输入，会触发 `KYB_DOCUMENT_UNPROVEN_TEXT_REPLACEMENT`，其 `manipulated_regions` 结构相同，但绝不会单独触发 `KYB_DOCUMENT_SUSPECTED_MANIPULATION`，因为在线编辑器也会重新输入未修改的文本，所以此警告并不表示内容已经改变。如果同一份证件上的其他信号也触发了 `KYB_DOCUMENT_SUSPECTED_MANIPULATION`，则以两者中更严格的操作为准。这些都是页面坐标矩形，用于标识疑似被编辑的区域，并与 `document_verifications[].items[].document_metadata.overlay_manipulation.manipulated_regions` 中返回的矩形一致。

## KYB 关键人员警告

关键人员警告使用 `feature: "KYB_KEY_PEOPLE"`，出现在 `key_people_checks[].warnings[]` 中。它们提示董事、高管、UBO 和用户提交的相关方的个人层面问题。

| 标签 | 说明 |
| - | - |
| `KYB_PREVIOUSLY_DECLINED_INDIVIDUAL` | 与该公司关联的某人此前在同一申请的另一次企业验证中被拒绝。 |
| `KYB_KEY_PEOPLE_MISMATCH_WITH_DOCUMENTS` | 关键人员页面中申报的董事或股东与上传的企业证件中列明的人员不一致：证件中列明的某人未被申报，某个姓名几乎匹配，证件中的某位股东被申报但未设置股权角色，或申报的股权比例与证件相矛盾。将应用已配置的 `kyb_key_people_document_mismatch_action`（默认：审核中）。 |

> [!NOTE]
>
> **关键人员的 PEP 或制裁命中**会作为标准 AML 命中结果，报告在对应的 `aml_screenings[]` 项目中，而不是作为 KYB 关键人员警告。关键人员检查会将由此产生的 `Declined` 或 `In Review` 状态同步到每个受影响的相关方，使关键人员的整体结论反映 AML 结果。

## 共享功能警告

以下功能可以在 KYB 工作流中运行。它们使用与用户验证相同的警告目录。各功能的完整说明请参阅其各自的警告页面。

### AML

`feature: "AML"` 位于 `aml_screenings[].warnings[]` 中。

| 标签 | 说明 |
| - | - |
| `POSSIBLE_MATCH_FOUND` | AML 筛查发现了可能的匹配结果，需要审核。 |
| `COULD_NOT_PERFORM_AML_SCREENING` | 由于缺少或无法获取必要的筛查数据，Didit 无法执行 AML 筛查。 |

### 电话

`feature: "PHONE"` 位于 `phone_verifications[].warnings[]` 中。

| 标签 | 说明 |
| - | - |
| `DISPOSABLE_NUMBER_DETECTED` | 该电话号码为一次性号码。 |
| `VERIFICATION_CODE_ATTEMPTS_EXCEEDED` | 验证码尝试次数已超过上限。 |
| `VOIP_NUMBER_DETECTED` | 该电话号码为 VoIP 号码。 |
| `DUPLICATED_PHONE_NUMBER` | 该电话号码曾用于另一次验证流程。 |
| `HIGH_RISK_PHONE_NUMBER` | 该电话号码为高风险号码。 |
| `PHONE_NUMBER_IN_BLOCKLIST` | 该电话号码与您黑名单中的条目匹配。 |

### 邮箱

`feature: "EMAIL"` 位于 `email_verifications[].warnings[]` 中。

| 标签 | 说明 |
| - | - |
| `BREACHED_EMAIL_DETECTED` | 该邮箱地址出现在已知的数据泄露事件中。 |
| `DISPOSABLE_EMAIL_DETECTED` | 该邮箱地址为一次性邮箱。 |
| `UNDELIVERABLE_EMAIL_DETECTED` | 该邮箱地址无法送达。 |
| `DUPLICATED_EMAIL` | 该邮箱地址曾用于另一次验证流程。 |
| `EMAIL_IN_BLOCKLIST` | 该邮箱地址与您黑名单中的条目匹配。 |
| `EMAIL_CODE_ATTEMPTS_EXCEEDED` | 邮箱验证码尝试次数已超过上限。 |

### 问卷

`feature: "QUESTIONNAIRE"`。

| 标签 | 说明 |
| - | - |
| `CUSTOM_STATUS_RULE_TRIGGERED` | 工作流状态规则评估了问卷答案，并更改了功能状态。 |

### 设备与 IP 分析

`feature: "LOCATION"` 位于 `ip_analyses[].warnings[]` 中。

| 标签 | 说明 |
| - | - |
| `COUNTRY_FROM_DOCUMENT_DOES_NOT_MATCH_COUNTRY_FROM_IP` | 证件所属国家与 IP 所属国家不一致。 |
| `PRIVATE_NETWORK_DETECTED` | 检测到私有网络、VPN、代理或 Tor 信号。 |
| `EXPECTED_IP_ADDRESS_MISMATCH` | IP 地址与为该会话提供的预期 IP 地址不一致。 |
| `IP_ADDRESS_IN_BLOCKLIST` | 该 IP 地址与您黑名单中的条目匹配。 |
| `DEVICE_FINGERPRINT_IN_BLOCKLIST` | 该设备指纹与您黑名单中的条目匹配。 |
| `DUPLICATED_IP_ADDRESS` | 同一 IP 地址曾用于另一次验证，且 `vendor_data` 不同。 |
| `DUPLICATED_DEVICE_FINGERPRINT` | 同一设备指纹曾用于另一次验证，且 `vendor_data` 不同。 |

## 示例

### 公司登记 - 企业未处于活跃状态

```json theme={null}
{
  "registry_checks": [
    {
      "node_id": "feature_kyb_registry",
      "status": "Declined",
      "warnings": [
        {
          "feature": "KYB_REGISTRY",
          "risk": "KYB_COMPANY_NOT_ACTIVE",
          "log_type": "error",
          "short_description": "Company is not active",
          "long_description": "The company is not active according to the registry.",
          "additional_data": null,
          "node_id": "feature_kyb_registry"
        }
      ]
    }
  ]
}
```

### 证件 - 疑似叠加篡改

```json theme={null}
{
  "document_verifications": [
    {
      "node_id": "feature_kyb_documents",
      "status": "In Review",
      "warnings": [
        {
          "feature": "KYB_DOCUMENTS",
          "risk": "KYB_DOCUMENT_SUSPECTED_MANIPULATION",
          "log_type": "warning",
          "short_description": "Possible document manipulation",
          "long_description": "The system detected signs of possible corporate-document manipulation.",
          "additional_data": {
            "manipulated_regions": [
              { "page": 1, "x": 120, "y": 240, "width": 180, "height": 22, "page_width": 612, "page_height": 792 }
            ]
          },
          "node_id": "feature_kyb_documents"
        }
      ]
    }
  ]
}
```

### 关键人员 - 此前被拒绝的个人

```json theme={null}
{
  "key_people_checks": [
    {
      "node_id": "feature_kyb_key_people",
      "status": "In Review",
      "warnings": [
        {
          "feature": "KYB_KEY_PEOPLE",
          "risk": "KYB_PREVIOUSLY_DECLINED_INDIVIDUAL",
          "log_type": "warning",
          "short_description": "Previously declined individual",
          "long_description": "A person associated with the company was previously declined in another business verification for the same application.",
          "additional_data": null,
          "node_id": "feature_kyb_key_people"
        }
      ]
    }
  ]
}
```

## 相关内容

> [card] [响应结构](https://docs.didit.me/zh/business-verification/response-schema.md)
>
> 查看警告在每个 KYB 功能数组中的位置。

> [card] [状态](https://docs.didit.me/zh/business-verification/statuses.md)
>
> 了解警告严重程度如何映射到验证状态。

> [card] [证件](https://docs.didit.me/zh/business-verification/documents.md)
>
> 查看证件分组、OCR 及交叉核验行为。

> [card] [关键人员](https://docs.didit.me/zh/business-verification/key-people.md)
>
> 负责人、UBO 和提交方的验证流程。

> [card] [AML 报告](https://docs.didit.me/zh/core-technology/aml-screening/report-aml-screening.md)
>
> 企业与个人 AML 筛查命中级别的结构。

> [card] [参考数据模型](https://docs.didit.me/zh/reference/data-models.md)
>
> 警告及功能数组的标准结构。


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