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

# 企業プロファイルAPI：認証済み企業を一元管理・追跡

> Diditの企業プロファイルAPIで、認証済み企業をセッションをまたいで追跡できます。プロファイルの自動作成、ステータス、タグ、一括アクション、CSVのインポート/エクスポートに対応。チェック1件あたり$2.00から。

Diditは、確認する企業ごとに企業プロファイルを自動で作成し、認証データとセッション履歴を1つのエンティティに集約します。企業プロファイルでは、各企業のすべての認証セッションをまとめて確認できます。

> [!NOTE]
>
> 企業プロファイルは、より汎用的な**企業エンティティ**モデルのうち、KYBに特化した部分です。操作、主要人物とユーザーの紐付け、ブロックリストの仕組み、インポート/エクスポートなど、エンティティモデルの全体については[企業の概要](https://docs.didit.me/ja/entities/businesses/overview.md)を参照してください。

## 企業プロファイルとは

企業プロファイルは、`vendor_data`識別子を指定して[法人セッション](https://docs.didit.me/ja/business-verification/overview.md)が送信されると自動で作成されます。その識別子を持つプロファイルがすでに存在する場合、新しいセッションはそのプロファイルに紐付けられます。

| フィールド | 説明 |
| - | - |
| **ベンダーデータ** | この企業に対してお客様が付与する一意の識別子(例: `company-123`) |
| **表示名** | コンソールに表示される名前 |
| **法人名** | 登記情報または手動入力による正式な法人名 |
| **登記番号** | 企業の登記番号または設立番号 |
| **国** | 設立国(ISO 3166-1 alpha-2) |

## プロファイルのステータス

| ステータス | 説明 |
| - | - |
| `ACTIVE` | 企業は良好な状態で、問題は検出されていません |
| `FLAGGED` | 企業には対応が必要です。結果または保留中のチェックを確認してください |
| `BLOCKED` | 企業は以降の活動を行えないようブロックされています |

ステータスは、コンソールから手動で変更することも、一括で変更することもできます。また、認証結果に基づいて自動で変更されることもあります。

## セッションの指標

各プロファイルは、紐付けられたすべてのセッションにわたる認証の指標を記録します。

| 指標 | 説明 |
| - | - |
| **セッション総数** | この企業の認証セッション数 |
| **承認済み** | すべてのチェックに合格したセッション |
| **却下** | 1つ以上の重要なチェックに不合格となったセッション |
| **レビュー中** | アナリストのレビュー待ちのセッション |
| **最後のセッション** | 最新の認証のタイムスタンプ |
| **初回セッション** | 最も古い認証のタイムスタンプ |
| **最終アクティビティ** | 直近のアクティビティ(ステータス変更、セッション更新など)のタイムスタンプ |

## タグ

企業プロファイルにタグを付けて、分類やフィルタリングに利用できます。タグはアプリケーションで定義するもので、ワークフローに合わせたカスタムタグを作成できます(例: `high-risk`、`vip-client`、`re-verification-needed`)。

## 一括操作

複数の企業プロファイルをまとめて管理できます。

| 操作 | 説明 |
| - | - |
| **一括ステータス更新** | 選択したプロファイル(または現在のフィルターに一致するすべてのプロファイル)のステータスを変更します |
| **CSVエクスポート** | 出力する列を選択して、プロファイルデータをCSVにエクスポートします |
| **CSVインポート** | CSVファイルから企業プロファイルをインポートし、認証の前にプロファイルを作成しておきます |
| **一括削除** | 選択したプロファイルとその関連データを削除します |

### CSVインポート

企業プロファイルを一括でインポートする手順は次のとおりです。

1. コンソールから**インポートテンプレート**をダウンロードし、想定される列形式を確認します
2. テンプレートに企業データを入力します
3. ファイルをアップロードします。Diditがインポートジョブを作成し、各行を非同期で処理します

完了後、インポートの概要で作成、更新、失敗した行の数を確認してください。失敗した行には、具体的なエラーの詳細が含まれます。

## レビューとコメント

任意のビジネスプロファイルに社内用のレビューメモを追加できます。コメントはアクセス権を持つすべてのチームメンバーに表示され、監査証跡の一部となります。

* 自由記述のメモを追加する
* メールアドレスでチームメンバーをメンションして通知する
* 作成者とタイムスタンプ付きで、コメント履歴をすべて表示する

## 次のステップ

> [card] [法人確認の概要](https://docs.didit.me/ja/business-verification/overview.md)
>
> 法人確認セッションの全体的な流れを説明します。

> [card] [コンソールガイド](https://docs.didit.me/ja/business-verification/console.md)
>
> Business Consoleで企業プロファイルとセッションを管理する方法を説明します。

> [card] [APIリファレンス](https://docs.didit.me/ja/management-api/businesses/list.md)
>
> 企業管理用のAPIエンドポイントです。


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