> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api-guide/back-office/members-bo/undefined-1.md).

# 임직원 관리

쇼핑몰 고객이 임직원으로 등록된 회원을 효율적으로 조회하고 관리하는 기능을 제공합니다. 또한, 임직원에게 할인한도를 설정하고 해당 정보를 간편하게 조회할 수 있습니다.

***

## 주요 기능

* **임직원 조회**
  * 현재 임직원으로 등록된 회원 목록을 확인합니다.
* **임직원 해제 처리**
  * 등록된 임직원을 편리하게 해제할 수 있습니다.
* **할인한도 관리**
  * 임직원에게 할인한도를 설정하고 관리합니다.
  * 할인한도 목록을 조회하여 정보를 확인합니다.
* **할인한도 사용 이력 조회**
  * 임직원의 할인한도 사용 이력을 간편히 조회합니다.
* **엑셀 일괄등록**
  * 엑셀 파일을 이용하여 임직원을 일괄 등록합니다.

## 프로세스 정의

<figure><img src="/files/7vMtzO5eY0MfrQgR41tn" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 임직원목록 조회

현재 임직원으로 등록되어 있는 회원의 목록과 건수를 조회합니다.
{% endstep %}

{% step %}

### 임직원 해제

임직원으로 등록되어 있는 회원을 임직원 해제 처리합니다. 이 때, 기존 임직원 할인한도 정보는 유지되지만 사용안함 처리를 하여 사용할 수 없습니다.
{% endstep %}

{% step %}

### 임직원할인한도 목록 및 건수조회

임직원 회원의 임직원 할인한도 목록과 건수를 조회합니다.
{% endstep %}

{% step %}

### 임직원할인한도 사용이력 조회

임직원이 사용한 임직원 할인한도 사용이력을 조회합니다.
{% endstep %}

{% step %}

### 임직원 엑셀업로드

임직원 일괄등록 엑셀 파일을 업로드 합니다. 이 때, 각 행마다 유효성 검증을 진행하는데 검증에 실패한 행은 각각의 맞는 에러 메시지가 함께 출력됩니다.
{% endstep %}

{% step %}

### 임직원 일괄등록

임직원 일괄등록을 진행합니다. 임직원이 최초로 등록된다면 최초 등록 이력과 임직원 할인한도 정보가 함께 생성됩니다. 만약 기존 임직원으로 등록되었던 회사가 있는데 타사 임직원 등록을 진행할 경우 기존 회사의 임직원 정보는 삭제되고 이력 테이블에 모두 소진한 것으로 기록됩니다.
{% endstep %}
{% endstepper %}

## API 기능 목록

<table><thead><tr><th width="148.888916015625">API</th><th width="281.2222900390625">설명</th><th width="92.4444580078125">Server</th><th width="89">메소드</th><th></th></tr></thead><tbody><tr><td>임직원 목록 조회</td><td>임직원으로 등록되어 있는 회원 목록을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=member&#x26;depth=%EC%9E%84%EC%A7%81%EC%9B%90%20%EA%B4%80%EB%A6%AC&#x26;path=getStaffList">🔗API 확인하기 ></a></td></tr><tr><td>임직원 목록 건수 조회</td><td>임직원으로 등록되어 있는 회원 목록 건수를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=member&#x26;depth=%EC%9E%84%EC%A7%81%EC%9B%90%20%EA%B4%80%EB%A6%AC&#x26;path=getStaffListCount">🔗API 확인하기 ></a></td></tr><tr><td>임직원 해제</td><td>임직원으로 등록되어 있는 회원을 해제 처리합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=member&#x26;depth=%EC%9E%84%EC%A7%81%EC%9B%90%20%EA%B4%80%EB%A6%AC&#x26;path=deleteMbrStaff">🔗API 확인하기 ></a></td></tr><tr><td>임직원할인한도 목록 조회</td><td>임직원으로 등록되어 있는 회원의 임직원할인한도 목록을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="http://apibo.x2bee.com/content?bo=member&#x26;depth=%EC%9E%84%EC%A7%81%EC%9B%90%ED%95%A0%EC%9D%B8%ED%95%9C%EB%8F%84%EA%B4%80%EB%A6%AC&#x26;path=getStaffDcLimList">🔗API 확인하기 ></a></td></tr><tr><td>임직원할인한도 목록 건수 조회</td><td>임직원으로 등록되어 있는 회원의 임직원할인한도 목록 건수를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="http://apibo.x2bee.com/content?bo=member&#x26;depth=%EC%9E%84%EC%A7%81%EC%9B%90%ED%95%A0%EC%9D%B8%ED%95%9C%EB%8F%84%EA%B4%80%EB%A6%AC&#x26;path=getStaffDcLimListCount">🔗API 확인하기 ></a></td></tr><tr><td>임직원할인한도 사용이력 조회</td><td>임직원의 할인한도 사용이력 목록을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="http://apibo.x2bee.com/content?bo=member&#x26;depth=%EC%9E%84%EC%A7%81%EC%9B%90%ED%95%A0%EC%9D%B8%ED%95%9C%EB%8F%84%EA%B4%80%EB%A6%AC&#x26;path=getStaffDcLimUseHist">🔗API 확인하기 ></a></td></tr><tr><td>임직원 일괄등록 엑셀 업로드</td><td>등록할 임직원 정보가 있는 엑셀 파일에 대해 유효성 검증을 합니다.</td><td>BO</td><td>GET</td><td><a href="http://apibo.x2bee.com/content?bo=member&#x26;depth=%EC%9E%84%EC%A7%81%EC%9B%90%ED%95%A0%EC%9D%B8%ED%95%9C%EB%8F%84%EA%B4%80%EB%A6%AC&#x26;path=staffLoadByExcel">🔗API 확인하기 ></a></td></tr><tr><td>임직원 일괄등록</td><td>임직원 일괄등록을 진행합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=member&#x26;depth=%EC%9E%84%EC%A7%81%EC%9B%90%20%EA%B4%80%EB%A6%AC&#x26;path=staffManyRegist">🔗API 확인하기 ></a></td></tr></tbody></table>

## 용어 정의

<table><thead><tr><th width="151.7777099609375">명칭</th><th>설명</th><th data-hidden></th></tr></thead><tbody><tr><td>임직원 할인한도</td><td>임직원 할인한도는 상품을 구매할 때 쓸 수 있는 일종의 마일리지 개념입니다.</td><td></td></tr></tbody></table>

## 기타 참고사항

* 임직원 등록/해제에 따른 임직원과 임직원 할인한도 상태 정리
  * 최초 임직원 등록: 등록 이력과 임직원 할인한도 정보가 함께 생성
  * 임직원 등록: 임직원 할인한도 사용여부 ‘Y’ 처리
  * 타사 임직원 등록 → A라는 회사에 임직원으로 등록되어 있다가 임직원 해제 처리된 상태인데 B회사에 새로 임직원으로 등록하는 경우 : 기존 임직원 할인한도 정보에 남아있는 잔여금액 모두 소진처리(이력 생성) → 기존 임직원 할인한도 정보 삭제 → 신규 임직원 할인한도 정보 생성
  * 임직원 해제: 임직원 할인한도 사용여부 ‘N’처리


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://tech.x2bee.com/api-guide/back-office/members-bo/undefined-1.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.