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

# データベース検証の警告とスキップコード

> Didit のデータベース検証で発生するすべての警告のリファレンスです。COULD_NOT_PERFORM_DATABASE_VALIDATION、部分一致・不一致、登記機関への接続不可、フィールドの欠落を解説します。

Diditの[データベース検証](https://docs.didit.me/ja/core-technology/database-validation/overview.md)機能は、RENAPER（アルゼンチン）、Receita Federal（ブラジル）、Tribunal Electoral（パナマ、生体認証）、Junta Central Electoral（ドミニカ共和国）などの信頼できる公的な住民登録機関と照合して本人情報を検証します。料金は成功した照会1件ごとに請求され、月額の最低利用料金はありません。

実行できるサービスがない場合（必須フィールドが欠落しているか形式が不正、または登録機関が利用できない場合）、書類自体を確認できない場合（設定されたサービスが必要とする識別番号が書類に含まれていない場合。例：国民ID番号のないパスポート）、または集計結果が結論に至らない場合（部分一致、不一致）、この機能はセッションに**警告**を出力します。発行国がワークフローでまったく有効化されていない場合、このステップは警告も課金もなくスキップされます。このページでは、すべての警告コード、それぞれのトリガー条件、およびワークフローのレスポンスを設定する方法を説明します。

## 概要

警告は、ワークフローのセッションとスタンドアロンAPI（`POST /v3/database-validation/`）の両方で生成されます。5つのリスクはすべて機能`DATABASE_VALIDATION`としてタグ付けされ、レポートの`database_validations[].warnings[]`に表示され、標準の[警告オブジェクト](https://docs.didit.me/ja/reference/data-models.md#警告オブジェクト)の形式（`feature`、`risk`、`additional_data`、`log_type`、`short_description`、`long_description`、`node_id`）に従います。

データベース検証には、固定の自動却下トリガーはありません。2つの照合結果リスク、差し替え済み書類リスク、適用対象外リスクは**設定可能なアクション**（`DECLINE`、`REVIEW`、`NO_ACTION`）に対応します。`COULD_NOT_PERFORM_DATABASE_VALIDATION`は唯一の固定動作で、常にこの機能を**レビュー中**にします。

## 設定可能なリスク

| 設定 | リスクコード | 動作 |
| - | - | - |
| No Match Action | `DATABASE_VALIDATION_NO_MATCH` | `REVIEW`（ワークフローのデフォルト）は機能を**レビュー中**にします。`DECLINE`は却下します。`NO_ACTION`はステータスに影響を与えずに警告を記録します。スタンドアロンAPIの`no_match_action`パラメーターは、デフォルトが`DECLINE`になります。 |
| Partial Match Action | `DATABASE_VALIDATION_PARTIAL_MATCH` | `NO_ACTION`（デフォルト）はステータスに影響を与えずに警告を記録します。`REVIEW`は機能を**レビュー中**にします。`DECLINE`は却下します。 |
| No Match Action | `DATABASE_VALIDATION_DOCUMENT_SUPERSEDED` | **No Match Action**の設定を共有し、個別の設定項目はありません。法人登記の情報が提出内容と矛盾しているため、不一致で却下する組織では、古くなった書類も却下されます。 |
| Not Applicable Action | `DATABASE_VALIDATION_NOT_APPLICABLE` | `NO_ACTION`（デフォルト）はステータスに影響を与えずに警告を記録します。`REVIEW`は機能を**レビュー中**にします。`DECLINE`は却下します。書類をまったく確認できない場合、つまり設定されたサービスが照会に使う識別番号が書類に含まれていない場合（例：国民ID番号のないパスポート）に発生します。 |

設定したアクションは警告の`log_type`も決定します：`DECLINE` → `error`、`REVIEW` → `warning`、`NO_ACTION` → `information`。

照合結果自体は、サービスごとの`validation`エントリから集計されます（いずれかが完全一致なら`full_match`、それ以外でいずれかが部分一致なら`partial_match`、それ以外は`no_match`）。1×1 / 2×2の結果を導く判定ロジックの詳細は、[照合方法](https://docs.didit.me/ja/core-technology/database-validation/database-validation-matching-methods.md)を参照してください。

## 発生する警告

| タグ | 概要 | 説明 |
| - | - | - |
| `COULD_NOT_PERFORM_DATABASE_VALIDATION` | データベース検証を実行できませんでした | どのサービスからも利用可能な結果が返されなかった状態です（`match_type`は`null`のままです）。主な原因は、必須フィールドの欠落や形式の不正、またはレジストリからのエラーです。`additional_data`には、サービスごとのスキップ概要（`reason`、`database_validation_errors`、`missing_required_fields_by_service`、`invalid_format_fields_by_service`、`field_reasons_by_service`）が含まれます。スタンドアロンAPIでは、代わりに`{ "validation_errors": [...] }`が返されます。この警告が発生した場合、**料金は請求されません**。データが修正されるまで、この機能は**レビュー中**になります。 |
| `DATABASE_VALIDATION_NOT_APPLICABLE` | この書類にはデータベース検証を適用できません | 提出された書類に、設定されたデータベースサービスが必要とする識別子が含まれていない状態です（`match_type`は`null`のままです）。たとえば、ブラジルのパスポートにはCPFが記載されていないため、CPFレジストリに照会できません。これはその書類の種類では想定どおりの動作であり、書類に問題があることを示すものではありません。`additional_data`には、サービスごとのスキップ概要が含まれます。この警告が発生した場合、**料金は請求されません**。アクションは設定可能です（デフォルトは`NO_ACTION`）。 |
| `DATABASE_VALIDATION_PARTIAL_MATCH` | データベース検証で部分一致 | 集計された`match_type`が`partial_match`の状態です。照合したフィールドの一部はレジストリと一致しましたが、すべては一致しませんでした。アクションは設定可能です（デフォルトは`NO_ACTION`）。 |
| `DATABASE_VALIDATION_NO_MATCH` | データベース検証で不一致 | 集計された`match_type`が`no_match`の状態です。レジストリは照合対象の本人を確認できませんでした。アクションは設定可能です（デフォルトは、ワークフローでは`REVIEW`、スタンドアロンAPIでは`DECLINE`）。 |
| `DATABASE_VALIDATION_DOCUMENT_SUPERSEDED` | 書類の旧版 | サービスが`DOCUMENT_SUPERSEDED`を返した状態です。レジストリで本人は確認できましたが、提示された書類の版は登録されている版ではなく、その後に新しい版が発行されています。この警告は`match_type`とは独立して発生します。個人情報のフィールドはすべて一致しているため、その値は`full_match`のままとなり、この警告がなければこの検出結果は見えません。`additional_data`には、これを報告したサービスが示されます。**No Match Action**の設定に従います。 |

> [!NOTE]
>
> `COULD_NOT_PERFORM_DATABASE_VALIDATION`は2つの異なる状況を対象としています。警告の`long_description`（サービス単位の失敗の場合は`database_validation_errors[].message`も）には、汎用的な一文ではなく、どちらの状況に該当したかが記載されるようになりました。2つの状況とは、いずれかのサービスに照会する前に照合対象のデータが欠落していたか形式が不正だった場合と、サービスに照会したものの利用可能な結果が返されなかった場合です。後者で、その試行についてレジストリ自身が診断の詳細を返したときは、その詳細がメッセージに含まれます。そのため、原因を知るためにサポートに問い合わせる必要はありません。上流のサービス名がレスポンスに記載されることはありません。

> [!NOTE]
>
> ワークフローのセッションで`COULD_NOT_PERFORM_DATABASE_VALIDATION`または`DATABASE_VALIDATION_NOT_APPLICABLE`が発生した場合、Consoleのセッション詳細ページで不足しているデータを入力すると、チェックが自動的に再実行されます。フィールドを保存すると検証が再実行され、成功すると警告は削除されます。これは、該当なしの場合のアクションによってセッションが却下された場合にも機能するため、却下されたセッションもデータを修正することで対処できます。`DATABASE_VALIDATION_NOT_APPLICABLE`で再実行が役立つのは、書類に識別子が記載され得るものの読み取られなかった場合です（例: 国民ID番号が抽出されなかった在留カード）。識別子が記載されることのない書類の種類（例: 国民ID番号のないパスポート）では、警告は残ります。スキップされたサービスについては**料金は発生しません**。料金が発生するのは、サービスが課金対象の結果を返した場合のみです。

## 例

```json theme={null}
{
  "warnings": [
    {
      "feature": "DATABASE_VALIDATION",
      "risk": "DATABASE_VALIDATION_NO_MATCH",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "Database validation no match",
      "long_description": "The system identified a no match in the database validation, requiring further investigation.",
      "node_id": "feature_db_validation_1"
    }
  ]
}
```

## 警告の種類

各リスクには、アプリケーションの設定に基づいて重大度が割り当てられます。重大度は次の3つのカテゴリに分類されます。

## 関連情報

* [データベース検証の概要](https://docs.didit.me/ja/core-technology/database-validation/overview.md)：機能の全体的な仕組みと対応しているレジストリ。
* [データベース検証レポート](https://docs.didit.me/ja/core-technology/database-validation/database-validation-report.md)：サービスごとの`validations[]`を含むレスポンスの完全な構造。
* [照合方式](https://docs.didit.me/ja/core-technology/database-validation/database-validation-matching-methods.md)：1×1 / 2×2の結果（`validation_type: one_by_one` / `two_by_two`）がサービスごとの一致結果からどのように導き出されるか。
* [結果コード](https://docs.didit.me/ja/core-technology/database-validation/database-validation-outcome-codes.md)：国別の詳細コードを含む、結果ごとの完全な分類。
* [対応国とサービス](https://docs.didit.me/ja/core-technology/database-validation/database-validation-supported-countries.md)：利用可能なすべてのレジストリ、必須フィールド、呼び出し1回あたりの料金。
* [データモデル: データベース検証](https://docs.didit.me/ja/reference/data-models.md#データベース検証)：フィールド単位の正式なスキーマ。


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