> ## 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 가져오기/내보내기를 지원하며 인증 건당 $2.00부터입니다.

Didit는 검증하는 회사마다 기업 프로필을 자동으로 생성하고, 검증 데이터와 세션 기록을 하나의 엔터티로 통합합니다. 기업 프로필은 모든 검증 세션에 걸쳐 각 회사를 한눈에 볼 수 있도록 제공합니다.

> [!NOTE]
>
> 기업 프로필은 더 일반적인 **기업 엔티티** 모델 중 KYB에 특화된 영역입니다. 운영, 사용자와 연결되는 주요 인물, 차단 목록 메커니즘, 가져오기 및 내보내기 등 전체 엔티티 모델은 [기업 개요](https://docs.didit.me/ko/entities/businesses/overview.md)를 참조하십시오.

## 기업 프로필이란

[기업 세션](https://docs.didit.me/ko/business-verification/overview.md)이 `vendor_data` 식별자와 함께 제출되면 기업 프로필이 자동으로 생성됩니다. 같은 식별자를 가진 프로필이 이미 존재하면 새 세션이 해당 프로필에 연결됩니다.

| 필드 | 설명 |
| - | - |
| **벤더 데이터** | 이 기업에 대해 귀사가 부여한 고유 식별자(예: `company-123`) |
| **표시 이름** | 콘솔에 표시되는 이름 |
| **법인명** | 등기부 또는 수동 입력에서 가져온 공식 법인명 |
| **등록번호** | 회사 등록 또는 설립 번호 |
| **국가** | 설립 국가(ISO 3166-1 alpha-2) |

## 프로필 상태

| 상태 | 설명 |
| - | - |
| `ACTIVE` | 기업 상태가 양호하며 문제가 감지되지 않았습니다 |
| `FLAGGED` | 기업에 주의가 필요합니다. 검토 결과 또는 대기 중인 확인 항목을 살펴보십시오 |
| `BLOCKED` | 기업의 추가 활동이 차단되었습니다 |

상태는 콘솔에서 수동으로 변경하거나, 일괄 변경하거나, 검증 결과에 따라 자동으로 변경할 수 있습니다.

## 세션 지표

각 프로필은 연결된 모든 세션에 걸쳐 검증 지표를 추적합니다.

| 지표 | 설명 |
| - | - |
| **전체 세션** | 이 기업의 검증 세션 수 |
| **승인됨** | 모든 검사를 통과한 세션 |
| **거부됨** | 하나 이상의 핵심 검사에 실패한 세션 |
| **검토 중** | 분석가 검토를 기다리는 세션 |
| **마지막 세션** | 가장 최근 검증의 타임스탬프 |
| **첫 세션** | 가장 이른 검증의 타임스탬프 |
| **마지막 활동** | 최근 활동(상태 변경, 세션 업데이트 등)의 타임스탬프 |

## 태그

기업 프로필에 태그를 적용하여 분류하고 필터링할 수 있습니다. 태그는 애플리케이션에서 정의하며, 워크플로에 맞는 사용자 지정 태그를 만들 수 있습니다(예: `high-risk`, `vip-client`, `re-verification-needed`).

## 일괄 작업

여러 기업 프로필을 한 번에 관리할 수 있습니다.

| 작업 | 설명 |
| - | - |
| **일괄 상태 업데이트** | 선택한 프로필(또는 현재 필터와 일치하는 모든 프로필)의 상태를 변경합니다 |
| **CSV 내보내기** | 열 선택을 구성하여 프로필 데이터를 CSV로 내보냅니다 |
| **CSV 가져오기** | 검증 전에 프로필을 미리 생성하도록 CSV 파일에서 기업 프로필을 가져옵니다 |
| **일괄 삭제** | 선택한 프로필과 연결된 데이터를 삭제합니다 |

### CSV 가져오기

기업 프로필을 일괄로 가져오려면 다음을 수행합니다.

1. 콘솔에서 **가져오기 템플릿**을 다운로드하여 필요한 열 형식을 확인합니다
2. 템플릿에 기업 데이터를 입력합니다
3. 파일을 업로드합니다. Didit는 가져오기 작업을 생성하고 행을 비동기로 처리합니다

완료 후 가져오기 요약에서 생성, 업데이트, 실패한 행 수를 확인합니다. 실패한 행에는 구체적인 오류 세부 정보가 포함됩니다.

## 검토 및 댓글

기업 프로필에 내부 검토 메모를 추가할 수 있습니다. 댓글은 접근 권한이 있는 모든 팀원에게 표시되며 감사 추적의 일부가 됩니다.

* 자유 형식의 텍스트로 메모를 추가합니다
* 이메일로 팀원을 멘션하여 알림을 보냅니다
* 작성자와 타임스탬프가 포함된 전체 댓글 기록을 확인합니다

## 다음 단계

> [card] [기업 인증 개요](https://docs.didit.me/ko/business-verification/overview.md)
>
> 기업 인증 세션이 처음부터 끝까지 어떻게 작동하는지 알아봅니다.

> [card] [콘솔 가이드](https://docs.didit.me/ko/business-verification/console.md)
>
> Business Console에서 기업 프로필과 세션을 관리하는 방법을 알아봅니다.

> [card] [API 참조](https://docs.didit.me/ko/management-api/businesses/list.md)
>
> 기업 관리 API 엔드포인트를 확인합니다.


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