> ## 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) 영구 기록: 벤더 기업 프로필

> Didit의 벤더 기업은 KYB 이력, 법인 등기부 데이터, 실소유자, 임원, AML, 문서, 거래를 하나의 영구적인 법인 프로필로 통합합니다.

**기업 엔티티**는 Didit 플랫폼에서 귀사와 맺는 모든 KYB 인증, 거래, 컴플라이언스 상호작용에 걸쳐 법적 실체(회사, LLC, 펀드, 재단, 개인사업자, 신탁)를 나타냅니다.

사용자 엔티티와 마찬가지로 기업 엔티티는 `vendor_data`를 키로 사용하며, 연결된 모든 세션과 거래를 하나의 프로필로 집계합니다.

## 기업 엔티티에 포함되는 항목

| 분류 | 필드 / 객체 |
| - | - |
| **신원** | `vendor_data`, `uuid`, `display_name`, `legal_name`, `registration_number`, `country_code` |
| **상태** | `ACTIVE`, `FLAGGED`, `BLOCKED` |
| **세션 집계** | `session_count`, `approved_count`, `declined_count`, `in_review_count`, `features` 맵 |
| **활동** | `first_session_at`, `last_session_at`, `last_activity_at` |
| **주요 인물** | 연결된 임원, 이사, UBO, 실소유자(각각 KYC를 위해 사용자 엔티티와 연결될 수 있음) |
| **문서** | 법인 설립 증명서, 정관, 주주명부, 주소 증명(POA), 재무제표, 사용자 정의 문서 |
| **AML** | 회사 단위의 제재 / PEP / 부정적 언론 보도 스크리닝 결과 |
| **메타데이터** | 귀사의 데이터를 위한 임의의 JSON |

필드 유형과 예외 사례는 [기업 데이터 모델](https://docs.didit.me/ko/entities/businesses/data-model.md)을 참조하십시오.

## 기업 엔티티가 생성되는 시점

**1. 자동 생성: 기업 확인(KYB) 세션에서**

Didit에서 한 번도 확인한 적이 없는 `vendor_data`로 기업 확인(KYB) 세션을 생성하면, `ACTIVE` 상태의 기업 엔티티가 만들어지고 해당 세션에 연결됩니다.

**2. 명시적 생성: POST /v3/businesses/create/ 사용**

기업 확인(KYB) 세션을 실행하기 전에 기업을 미리 생성합니다. 메타데이터를 미리 입력하거나 여러 기업을 일괄 온보딩할 때 유용합니다.

**3. 콘솔에서 생성**

팀에서 Businesses 페이지를 통해 기업을 생성합니다. 예를 들어 오프라인 절차로 검증된 기업을 수동으로 온보딩할 때 사용합니다.

## 할 수 있는 작업

| 작업 | 방법 |
| - | - |
| [기업 목록 조회](https://docs.didit.me/ko/entities/businesses/operations.md#기업-목록-조회) | 필터를 적용하여 `GET /v3/businesses/` 호출 |
| [기업 조회](https://docs.didit.me/ko/entities/businesses/operations.md#기업-조회) | `GET /v3/businesses/{vendor_data}/` |
| [기업 생성](https://docs.didit.me/ko/entities/businesses/operations.md#기업-생성) | `POST /v3/businesses/create/` |
| [프로필 업데이트](https://docs.didit.me/ko/entities/businesses/operations.md#기업-수정) | `PATCH /v3/businesses/{vendor_data}/` |
| [상태 변경](https://docs.didit.me/ko/entities/businesses/operations.md#상태-변경) | `PATCH /v3/businesses/{vendor_data}/update-status/` |
| [기업 삭제](https://docs.didit.me/ko/entities/businesses/operations.md#기업-일괄-삭제) | `POST /v3/businesses/delete/` (일괄) |
| [KYB 이력 검토](https://docs.didit.me/ko/entities/businesses/kyb-history.md) | `GET /v3/sessions?vendor_data=...` |
| [거래 검토](https://docs.didit.me/ko/entities/businesses/transactions.md) | `GET /v3/transactions/?vendor_data=...` |
| [주요 인물 검토](https://docs.didit.me/ko/entities/businesses/key-people.md) | 기업 확인(KYB) 세션 결정을 통해 |
| [차단 목록에 추가](https://docs.didit.me/ko/entities/businesses/blocklist.md) | 콘솔 및 Lists API |
| [가져오기 / 내보내기](https://docs.didit.me/ko/entities/businesses/import-export.md) | 콘솔에서만 가능(CSV) |
| [콘솔에서 관리](https://docs.didit.me/ko/entities/businesses/console.md) | 전체 UI 안내 |

## 기업 ↔ 사용자 관계

기업 엔티티는 단독으로 존재하는 경우가 드뭅니다. [KYB](https://docs.didit.me/ko/business-verification/overview.md) 과정에서 Didit은 모든 임원, 이사, UBO, 실소유자를 식별합니다. 이들 각각은 개별 KYC를 위해 사용자 엔티티와 연결될 수 있습니다:

```mermaid theme={null}
flowchart LR
    B[Business: biz-acme]
    U1[User: jane-doe<br/>Director]
    U2[User: john-smith<br/>UBO 40%]
    U3[User: alice-chen<br/>UBO 35%]
    U1 --> B
    U2 --> B
    U3 --> B
```

연결된 사용자 중 한 명에게 KYC 실패 또는 AML 일치 결과가 발생하면, 그 내용이 기업의 위험 프로필에 반영됩니다. 연결 방식은 [주요 인물](https://docs.didit.me/ko/entities/businesses/key-people.md)을 참조하십시오.

## 기업 엔티티와 기업 세션

**기업 세션**은 하나의 KYB 인증 이벤트입니다. **기업 엔티티**는 모든 세션을 집계하는 지속적인 프로필입니다.

하나의 기업은 여러 기업 확인(KYB) 세션을 가질 수 있습니다. 최초 인증, 재제출, 정기적인 KYB 재인증이 여기에 해당합니다. 기업의 `features` 맵은 모든 세션에 걸친 최신 상태를 반영합니다.

## 다음 단계

> [card] [데이터 모델](https://docs.didit.me/ko/entities/businesses/data-model.md)
>
> 모든 필드, 유형, 인덱스.

> [card] [운영](https://docs.didit.me/ko/entities/businesses/operations.md)
>
> 생성, 업데이트, 상태 변경, 삭제.

> [card] [KYB 이력](https://docs.didit.me/ko/entities/businesses/kyb-history.md)
>
> 해당 기업과 연결된 모든 기업 확인(KYB) 세션.

> [card] [주요 인물](https://docs.didit.me/ko/entities/businesses/key-people.md)
>
> 임원, UBO, 이사 연결.

> [card] [차단 목록](https://docs.didit.me/ko/entities/businesses/blocklist.md)
>
> 거래에서 기업 차단.

> [card] [콘솔](https://docs.didit.me/ko/entities/businesses/console.md)
>
> Businesses UI 전체 안내.


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