# 회원구조

팝빌 API는 다음의 회원 구조를 기반으로 이용할 수 있습니다.

팝빌의 회원 구조는 프로그램 공급사를 파트너로 정의하고, 파트너 하위에 사업자등록번호 기준의 회원을 다수로 등록하여 관리할 수 있도록 구성되어 있습니다. 각 회원 하위에는 복수의 담당자 계정을 생성할 수 있으며, 담당자 계정을 인증 주체로 하여 API를 호출하고 서비스를 이용합니다.

![팝빌회원구조](https://developers.popbill.com/images/guide/getting-started/img_member.webp)

## 파트너

파트너는 팝빌 API를 연동하여 자체 서비스 또는 시스템을 통해 제공하는 프로그램 공급사입니다.\
팝빌 API 이용에 있어 최상위 관리 주체로서, 하나의 파트너 계정 하위에 다수의 회원을 등록하여 관리할 수 있습니다.

파트너는 다음과 같은 역할을 수행합니다.

- 팝빌 API 연동 및 기술 구현
- 연동회원(사업자등록번호 기준) 등록 및 관리
- API Key(LinkID, SecretKey) 관리
- 연동회원 단위 API 상품 제공 및 운영 관리

팝빌 파트너관리자 사이트(<https://partner.popbill.com>)

> 파트너는 연동신청 시 입력한 계정정보(ID/PW)로 팝빌 테스트 환경과 운영 환경에 자동으로 가입됩니다. [\[연동신청\]](https://developers.popbill.com/customer-center/partner-request)

## 연동회원

연동회원은 파트너가 제공하는 서비스를 이용하는 사업자 단위의 이용 주체로, 사업자등록번호 기준으로 관리되어 중복 등록은 불가합니다.

회원은 다음과 같은 특성을 가집니다.

- 파트너 하위에 소속된 사업자 단위 계정
- 사업자등록번호 기준의 서비스 이용 주체
- 세금계산서, 현금영수증 등 API 서비스 이용 대상
- 담당자 계정을 통해 API 이용 및 서비스 관리 수행

> 연동회원이 다수이거나 파트너 시스템에서 연동회원 가입을 처리하는 경우 API 방식 이용을 권장합니다.

## 담당자

담당자는 회원 하위에 생성되는 계정 단위의 실행 주체로, 팝빌 API 호출 및 서비스 이용을 수행합니다.

담당자는 다음과 같은 역할을 가집니다.

- 팝빌 API 호출 시 인증 주체
- 회원의 서비스 이용 및 설정 관리 수행
- 필요에 따라 복수 계정 생성 가능
- 개발 환경 및 연동 방식에 따라 필수가 아닌 경우도 존재

> 담당자가 다수이거나 파트너 시스템에서 담당자 추가를 처리하는 경우 API 방식 이용을 권장합니다.

### 역할

| 구분         | 설명                                                |
| ---------- | ------------------------------------------------- |
| 관리자(기본 생성) | 담당자 추가/삭제, 권한 변경 등 전체 계정 관리가 가능 (단, 회사 권한만 부여 가능) |
| 담당자(추가 생성) | 관리자가 추가로 등록한 계정으로, 지정된 권한 범위에서 서비스 이용 및 데이터 조회 가능 |

### 권한

| 구분 | 설명                                     |
| -- | -------------------------------------- |
| 회사 | 연동회원의 모든 담당자가 처리한 정보를 조회하고 관리할 수 있는 권한 |
| 읽기 | 연동회원의 모든 담당자가 처리한 정보를 조회만 할 수 있는 권한    |
| 개인 | 담당자 본인이 처리한 정보만 조회 및 관리할 수 있는 권한       |