> 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/api-guides-en/back-office/members-bo/staff-management.md).

# Staff Management

Provides functionality to efficiently look up and manage members who are registered as staff of the shopping mall. It also allows setting discount limits for staff and conveniently viewing that information.

***

## Key Features

* **Staff Lookup**
  * View the list of members currently registered as staff.
* **Staff Deregistration**
  * Conveniently deregister registered staff.
* **Discount Limit Management**
  * Set and manage discount limits for staff.
  * Look up the discount limit list to check information.
* **Discount Limit Usage History Lookup**
  * Conveniently look up a staff member's discount limit usage history.
* **Excel Bulk Registration**
  * Bulk-register staff using an Excel file.

## Process Definition

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FvhmTgu9XAtIsYtoHUeHo%2F%E1%84%8B%E1%85%B5%E1%86%B7%E1%84%8C%E1%85%B5%E1%86%A8%E1%84%8B%E1%85%AF%E1%86%AB%20%E1%84%80%E1%85%AA%E1%86%AB%E1%84%85%E1%85%B5.png?alt=media&#x26;token=59b454f6-5a3b-4530-bad4-65744327b8d8" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Staff List Lookup

Look up the list and count of members currently registered as staff.
{% endstep %}

{% step %}

### Staff Deregistration

Deregister a member who is registered as staff. At this time, the existing staff discount-limit information is retained but is marked unusable.
{% endstep %}

{% step %}

### Staff Discount Limit List and Count Lookup

Look up the discount limit list and count for a staff member.
{% endstep %}

{% step %}

### Staff Discount Limit Usage History Lookup

Look up the discount limit usage history used by a staff member.
{% endstep %}

{% step %}

### Staff Excel Upload

Upload the Excel file for staff bulk registration. At this time, validation is performed for each row, and rows that fail validation are displayed with the corresponding error message.
{% endstep %}

{% step %}

### Staff Bulk Registration

Proceed with staff bulk registration. If the staff member is registered for the first time, an initial registration history and staff discount-limit information are created together. If the member was previously registered as staff at another company and staff registration is now processed for a different company, the existing company's staff information is deleted, and the history table records that it has all been consumed.
{% endstep %}
{% endstepper %}

## API Function List

<table><thead><tr><th width="148.888916015625">API</th><th width="281.2222900390625">Description</th><th width="92.4444580078125">Server</th><th width="89">Method</th><th></th></tr></thead><tbody><tr><td>Staff List Lookup</td><td>Look up the list of members registered as staff.</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">🔗View API ></a></td></tr><tr><td>Staff List Count Lookup</td><td>Look up the count of members registered as staff.</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">🔗View API ></a></td></tr><tr><td>Staff Deregistration</td><td>Deregister a member registered as staff.</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">🔗View API ></a></td></tr><tr><td>Staff Discount Limit List Lookup</td><td>Look up the staff discount limit list for a member registered as staff.</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">🔗View API ></a></td></tr><tr><td>Staff Discount Limit List Count Lookup</td><td>Look up the count of the staff discount limit list for a member registered as staff.</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">🔗View API ></a></td></tr><tr><td>Staff Discount Limit Usage History Lookup</td><td>Look up the discount limit usage history list of a staff member.</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">🔗View API ></a></td></tr><tr><td>Staff Bulk Registration Excel Upload</td><td>Validate the Excel file that contains the staff information to be registered.</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">🔗View API ></a></td></tr><tr><td>Staff Bulk Registration</td><td>Proceed with staff bulk registration.</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">🔗View API ></a></td></tr></tbody></table>

## Term Definitions

<table><thead><tr><th width="151.7777099609375">Term</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>Staff Discount Limit</td><td>The staff discount limit is a mileage-like concept that can be used when purchasing products.</td><td></td></tr></tbody></table>

## Other Notes

* Summary of staff and staff discount-limit status by registration/deregistration
  * Initial staff registration: Registration history and staff discount-limit information are created together
  * Staff registration: Staff discount-limit usage status is set to 'Y'
  * Registering staff at a different company → When a member was registered as staff at company A, then deregistered, and is now newly registered as staff at company B: All remaining balance in the existing staff discount-limit information is fully consumed (history created) → Existing staff discount-limit information is deleted → New staff discount-limit information is created
  * Staff deregistration: Staff discount-limit usage status is set to 'N'