> ## 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書類API：法人書類の検証

> DiditのKYBでは、設立証明書・定款・財務諸表などの法人書類を収集し、OCRで読み取って法人登記と照合します。料金は法人登記の取得とは別に設定されています。

企業確認には構造化された書類収集が含まれており、法人登記で得られる情報に加えて企業情報を検証できます。

## 料金

KYBの書類収集は**ワークフローのステップ1件あたり\$0.20**で、そのステップでアップロードされる書類の数には左右されません。同じステップ内で書類を再アップロードしても追加料金は発生しませんが、別の書類収集ステップにはそれぞれ料金が発生します。

## 書類グループ

書類は4つの構造化されたグループに整理されており、各グループは企業確認に必要な証拠のカテゴリを表します。これに加えて、Diditが分類できない書類をまとめる包括的なグループがあります。

| グループ (`document_group`) | 説明 | 認識される書類サブタイプ |
| - | - | - |
| **法的存在** (`LEGAL_PRESENCE`) | 会社が法的に存在することを証明する書類 | `CERTIFICATE_OF_INCORPORATION`, `CERTIFICATE_OF_GOOD_STANDING`, `CERTIFICATE_OF_INCUMBENCY`, `REGISTRY_EXCERPT`, `BUSINESS_LICENSE`, `TAX_REGISTRATION` |
| **会社詳細** (`COMPANY_DETAILS`) | 会社の現在の詳細情報を記載した書類 | `CONFIRMATION_STATEMENT`, `ANNUAL_RETURN`, `STATEMENT_OF_INFORMATION` |
| **所有構造** (`OWNERSHIP_STRUCTURE`) | 所有関係の連鎖を証明する書類 | `SHAREHOLDER_REGISTRY`, `MEMORANDUM_OF_ASSOCIATION`, `ARTICLES_OF_ASSOCIATION` |
| **代表者の権限** (`REPRESENTATIVES_AUTHORIZATION`) | 会社を代表して行動する権限を証明する書類 | `DIRECTOR_REGISTRY`, `POWER_OF_ATTORNEY`, `TRUST_AGREEMENT` |
| **その他** (`OTHER`) | Diditが確信をもって分類できない書類 | `UNKNOWN` |

各グループは、グループごとのカウンター(`total`、`approved`、`pending`、`declined`、`in_review`、`other`、`missing`)でそれぞれの進捗を管理します。企業セッション全体の書類ステータスは、すべてのグループを集計したものです。

## 書類の種類

| カテゴリ | 例 |
| - | - |
| **設立関連書類** | 設立証明書、定款、基本定款 |
| **所有関連書類** | 株主名簿、株券、UBO申告書 |
| **住所関連書類** | 登記上の住所に関する公共料金の請求書、銀行取引明細書、賃貸借契約書 |
| **財務関連書類** | 年次決算書、監査報告書、財務諸表 |
| **税務関連書類** | 税務登録証明書、納税証明書 |
| **規制関連書類** | ライセンス、許可証、規制当局の承認 |
| **追加書類** | お客様のコンプライアンスプロセスで必要となるその他の書類 |

## 書類のワークフロー

**1. 自動リクエスト**

ワークフローの設定に基づき、Diditは企業確認に必要な書類を自動的に特定します。必要な書類の種類が企業に提示され、アップロードが求められます。

**2. アップロード**

書類は、ホスト型検証フロー、Business Console、または[書類のアップロード](https://docs.didit.me/ja/sessions-api/kyb-upload-documents.md)エンドポイントを使用したお客様独自のフロントエンドからアップロードします。対応形式はPDF、JPG、JPEG、PNG、TIFF、WebP、またはこれらのZIPアーカイブです。圧縮前のサイズで、PDFは最大50MB、写真は最大6MBまでです。パスワードで保護されたPDFの場合は、APIからアップロードする際に`document_passwords`でパスワードを送信してください。

**3. OCRによる抽出**

Diditは、アップロードされた書類からOCRを使用して構造化データを抽出します。

* 証明書から会社名と登記番号
* 公共料金の請求書から住所データ
* 財務諸表から財務数値
* 株主名簿から氏名と役割

**4. 照合**

抽出されたデータは、以下と照合されます。

* 会社検索で取得した登記データ
* セッション作成時に提供された情報
* アップロードされた他の書類のデータ

不一致がある場合は、アナリストによるレビュー用にフラグが付けられます。

**5. レビュー**

アナリストはコンソールでアップロードされた書類をレビューし、その真正性を確認したうえで、書類ごとに個別に承認または却下します。

## アナリストによる書類リクエスト

レビューの過程で、アナリストは追加の書類をリクエストできます。

1. コンソールで対象の企業セッションに移動します
2. **Request document**をクリックし、書類の種類と説明を指定します
3. 企業に通知が届き、リクエストされた書類をアップロードできるようになります
4. 書類はアップロードされるまで、**Requested**ステータスでセッションに表示されます

これにより、アナリストは企業セッション全体を却下することなく、追加の証拠を収集できます。

## 書類のステータス

各書類と、それらを集計した`document_verifications[]`チェックには、KYB機能の標準ステータスセットが使用されます。

| ステータス | 説明 |
| - | - |
| `"Not Finished"` | 書類はまだ処理中です（アップロード中、OCR実行中、または照合待ちです）。 |
| `"Approved"` | 書類はレビューされ、承認されました。 |
| `"Declined"` | 書類はレビューされ、却下されました。 |
| `"In Review"` | 書類にはアナリストによる手動レビューが必要です。 |
| `"Resub Requested"` | アナリストが再提出をリクエストしました。セッションを進めるには、企業がこの書類を再アップロードする必要があります。 |

## 照合結果

書類が処理されると、DiditはOCRで抽出したデータを、主要人物フローで送信された**ユーザー提供データ**(および登記情報のレビュー中に確認されたデータ)や、アップロード済みの他の書類と照合します。照合では、次のような構造化された結果が得られます。

| カテゴリ | 説明 |
| - | - |
| **重要フィールド** | 書類のデータとユーザー提供データが一致しないフィールドです。これらはアナリストによるレビューが必要です。各フィールドには、書類上の値、ユーザー提供の値、信頼度スコアが表示されます。 |
| **非重要フィールド** | 軽微な相違や表記の違いがあるものの、対応が不要な場合があるフィールドです(例:会社名の略称表記の違い)。 |
| **人物の重複** | 書類に記載された人物とユーザーが送信した人物を比較した分析です。不足している人物や追加されている人物が強調表示されます。 |

照合結果は[Business Console](https://docs.didit.me/ja/business-verification/console.md)で書類のプレビューと並べて表示されるため、アナリストは一致している項目と確認が必要な項目を明確に把握できます。

## APIによる書類の取得

書類は法人確認 (KYB)のセッションに紐付けられます。セッションの判定を通じて取得してください。

```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"
```

レスポンスには`document_verifications[]`配列が含まれます。各要素には`status`、`node_id`、`items[]`(それぞれ署名付きの`file_url`、`document_group`、`document_subtype`、OCR抽出結果を含みます)、`groups`、`required_groups`があります。完全な構造については[レスポンススキーマ](https://docs.didit.me/ja/business-verification/response-schema.md#document_verifications)を参照してください。

## 次のステップ

> [card] [レスポンススキーマ](https://docs.didit.me/ja/business-verification/response-schema.md)
>
> 書類がペイロード内のどこに含まれるか。

> [card] [Business Console](https://docs.didit.me/ja/business-verification/console.md)
>
> アナリストとして書類をレビューする方法。


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