---
title: Serpro類似度返却
description: 給与担保ローン（INSS）およびSerproデータベースとの照合が必要な操作に特化したCapability。撮影されたセルフィーとSerproに登録された顔写真の類似度スコアを返します。
canonical: https://developer.unico.io/ja/capabilities/serpro-similarity-return
locale: ja
generated_by: markdown-export
---

- [/ja/](/ja/)
- [機能](/ja/capabilities)
- Serpro類似度返却

**このページの内容Serpro類似度返却給与担保ローン（INSS）およびSerproデータベースとの照合が必要な操作に特化したCapability。撮影されたセルフィーとSerproに登録された顔写真の類似度スコアを返します。

### 機能概要​

このCapabilityは、セッションのセルフィーと提供されたCPFに紐付くSerproの顔写真を照合します。照合が可能な場合は0〜100のスコアを返し、Serproが顔を見つけられない場合やSerproとの連携に失敗した場合は特別なコード（-1、-2）を返します。
### 入力​

Serpro類似度を含むフローで `POST /v1/process` を通じて開かれたキャプチャセッション。
ユーザーのCPF。
Serpro Capabilityに対する事前のテナント有効化（Unicoオンボーディングチームとの協議が必要）。

### 返却される可能性のあるレスポンス​

レスポンス意味**スコア 0〜100**Serproが顔を検出した場合。スコアが高いほど類似度が高い。**スコア -1**Serproが当該CPFに紐付く顔を**見つけられなかった**場合。**スコア -2**Serproとの**連携エラー** — スコアを取得できなかった場合。
スコア -1 と -2 は低スコアではありませんこれらは異なるシナリオを示すシグナルコードです。ゼロスコアと同様に扱うと誤った判断につながります。
### 対応状況​

必要な統合コンポーネントAPI Web or SDK
有効化が必要対応サーフェスであっても、テナントがSerpro Capabilityに対して**有効化**されている必要があります。まだアクセスできない場合は、Unicoのオンボーディングチームにお問い合わせください。
### 有効  な組み合わせ​

Serpro類似度は、`serpro` を含むフローまたは給与担保ローン専用のフローに表示されます：
`idcheckserpro`, `idcheckserprodocs`, `idcheckserprodocssign`, `idunicoserprodocssign`, `creditoconsignado`。
完全な対応マトリクスは[利用可能なフロー](/ja/developers/start/flows)を参照してください。
### このCapabilityを使用する製品​

### `creditoconsignado` 内の動作​

`creditoconsignado` フローはSerproの返却値に基づいて**ジャーニーを分岐**します：

**Serpro 陽性** → 電子署名に直接進む。
**Serpro 否定的（-1、または低類似度）** → 顔照合のためにドキュメントを要求。

顔照合 陽性 → 署名に進む。
顔照合 否定的 → ジャーニーは**署名なし**で終了。

この条件分岐は、バックエンドでのオーケストレーションを必要とせず、フローの一部  として組み込まれています。最終更新 2026年10月8日**に