> ## 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分析の各警告を確認できます。

法人確認 (KYB) は、警告を生成した機能項目に警告を表示します。各警告はプラットフォーム全体で共通の構造化された形式(`feature`、`risk`、`log_type`、`short_description`、`long_description`、任意の`additional_data`、`node_id`)を持つため、レビュー作業を適切な運用チームに振り分けることができます。

## 概要

KYBセッションは3つの主要な機能タグで警告を出力します。これらのタグは、V3の判定レスポンスにおける専用の配列に対応しています。

| 機能タグ | 判定レスポンスのキー | 対象範囲 |
| - | - | - |
| `KYB_REGISTRY` | `registry_checks[].warnings[]` | 公的な法人登記の照会。有効ステータス、国の制限、所有構造の導出可否、役員/UBO記録の欠落。 |
| `KYB_DOCUMENTS` | `document_verifications[].warnings[]` | ユーザーがアップロードする設立書類、所有構造書類、住所書類、株主書類。書類間の整合性、OCR、メタデータ、改ざん、書類の発行からの経過期間、サブタイプのルール。 |
| `KYB_KEY_PEOPLE` | `key_people_checks[].warnings[]` | 取締役、役員、UBO、またはユーザーが提出した関係者に関する個人レベルのシグナル。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` | 公式の税務登録簿に、企業のVAT番号または納税者番号の有効な登録がないか、VAT番号がその国の形式およびチェックディジットのルールを満たしていません。設定された`kyb_vat_invalid_action`が適用されます(デフォルト: レビュー中)。 |
| `KYB_COMPANY_VAT_COULD_NOT_VALIDATE` | 公式の登録機関が一時的に利用できなかったため、VAT番号または納税者番号を検証できませんでした。設定された`kyb_vat_unverified_action`が適用されます(デフォルト: 影響なし)。 |
| `KYB_COMPANY_VAT_NAME_MISMATCH` | この番号で公式の登録機関に登録されている名称が、提出された企業名と異なります。情報提供のみです。`additional_data`に`registry_name`、`registry_source`、`submitted_name`が含まれ、登録機関がVIESの場合は`vies_name`も含まれます。 |

VAT警告は、企業のVAT番号または納税者番号を検証できるすべての場合に適用されます。対象の国とデータソースについては、[VATおよび納税者番号の検証](https://docs.didit.me/ja/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_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`が含まれることがあります。これは編集が疑われる領域を示すページ座標上の矩形で、`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・制裁のヒット**は、KYB主要人物の警告ではなく、該当する`aml_screenings[]`項目上の標準的なAMLヒットとして報告されます。主要人物チェックでは、その結果の`Declined`または`In Review`ステータスが影響を受ける各関係者に反映されるため、主要人物全体の判定にもAMLの結果が反映されます。

## 共通機能の警告

以下の機能はKYBワークフロー内で実行できます。これらはユーザー認証と同じ警告カタログを使用します。詳細なリファレンスは各機能の警告ページを参照してください。

### AML

`aml_screenings[].warnings[]`上の`feature: "AML"`。

| タグ | 説明 |
| - | - |
| `POSSIBLE_MATCH_FOUND` | AMLスクリーニングで、レビューが必要な一致の可能性が見つかりました。 |
| `COULD_NOT_PERFORM_AML_SCREENING` | 必要なスクリーニングデータが欠落しているか利用できなかったため、DiditはAMLスクリーニングを実行できませんでした。 |

### 電話番号

`phone_verifications[].warnings[]`上の`feature: "PHONE"`。

| タグ | 説明 |
| - | - |
| `DISPOSABLE_NUMBER_DETECTED` | 電話番号が使い捨て番号です。 |
| `VERIFICATION_CODE_ATTEMPTS_EXCEEDED` | 認証コードの試行回数の上限を超えました。 |
| `VOIP_NUMBER_DETECTED` | 電話番号がVoIP番号です。 |
| `DUPLICATED_PHONE_NUMBER` | 電話番号が別の認証プロセスで使用されています。 |
| `HIGH_RISK_PHONE_NUMBER` | 電話番号が高リスクです。 |
| `PHONE_NUMBER_IN_BLOCKLIST` | 電話番号がブロックリストのエントリーと一致します。 |

### メールアドレス

`email_verifications[].warnings[]`上の`feature: "EMAIL"`。

| タグ | 説明 |
| - | - |
| `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分析

`ip_analyses[].warnings[]`上の`feature: "LOCATION"`。

| タグ | 説明 |
| - | - |
| `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/ja/business-verification/response-schema.md)
>
> 各KYB機能の配列で警告が表示される場所を確認できます。

> [card] [ステータス](https://docs.didit.me/ja/business-verification/statuses.md)
>
> 警告の重大度が検証ステータスにどう対応するかを説明します。

> [card] [書類](https://docs.didit.me/ja/business-verification/documents.md)
>
> 書類グループ、OCR、クロスチェックの動作を確認できます。

> [card] [主要人物](https://docs.didit.me/ja/business-verification/key-people.md)
>
> 役員、UBO、提出された当事者の検証フローです。

> [card] [AMLレポート](https://docs.didit.me/ja/core-technology/aml-screening/report-aml-screening.md)
>
> 企業と個人のAMLスクリーニングにおけるヒット単位の構造です。

> [card] [リファレンスデータモデル](https://docs.didit.me/ja/reference/data-models.md)
>
> 警告と機能の配列の標準的な構造です。


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