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

Diditのデータベース検証機能は、RENAPER（アルゼンチン）、Receita Federal（ブラジル）、Tribunal Electoral（パナマ、生体認証）、Junta Central Electoral（ドミニカ共和国）などの信頼できる公的な住民登録機関と照合して本人情報を検証します。料金は成功した照会1件ごとに請求され、月額の最低利用料金はありません。実行できるサービスがない場合（必須フィールドが欠落しているか形式が不正、または登録機関が利用できない場合）、書類自体を確認できない場合（設定されたサービスが必要とする識別番号が書類に含まれていない場合。例：国民ID番号のないパスポート）、または集計結果が結論に至らない場合（部分一致、不一致）、この機能はセッションに警告を出力します。発行国がワークフローでまったく有効化されていない場合、このステップは警告も課金もなくスキップされます。このページでは、すべての警告コード、それぞれのトリガー条件、およびワークフローのレスポンスを設定する方法を説明します。

概要

警告は、ワークフローのセッションとスタンドアロンAPI（POST /v3/database-validation/）の両方で生成されます。5つのリスクはすべて機能DATABASE_VALIDATIONとしてタグ付けされ、レポートのdatabase_validations[].warnings[]に表示され、標準の警告オブジェクトの形式（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の結果を導く判定ロジックの詳細は、照合方法を参照してください。

発生する警告

タグ	概要	説明
`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の設定に従います。

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

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

例

{
  "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つのカテゴリに分類されます。

認証

検証

モニタリング

プラットフォーム

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

概要

設定可能なリスク

発生する警告

例

警告の種類

関連情報

​概要

​設定可能なリスク

​発生する警告

​例

​警告の種類

​関連情報

概要

設定可能なリスク

発生する警告

例

警告の種類

関連情報