> 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/api-en/back-office-api-reference/members-bo-api/employee-management.md).
# Employee Management
## Bulk Register Employees
> \## Function Description\
> \* Performs bulk registration of employees and returns the result data.\
> \---\
> \## Detailed Description\
> \* Registers only the data without error messages among the data passed in the request.\
> \* Registration is not possible if the member is already registered as an employee.\
> \* Registration is not possible if the employee number in the request data is already registered.\
> \* If a SQL exception occurs, the exception message value is included in the error message and returned.\
> \---\
> \## Revision History\
> \* Release v1.03\_231106: Initial development of employee bulk registration
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/staffMgmt/staffManyRegist":{"post":{"tags":["Employee Management"],"summary":"Bulk Register Employees","description":"## Function Description\n* Performs bulk registration of employees and returns the result data.\n---\n## Detailed Description\n* Registers only the data without error messages among the data passed in the request.\n* Registration is not possible if the member is already registered as an employee.\n* Registration is not possible if the employee number in the request data is already registered.\n* If a SQL exception occurs, the exception message value is included in the error message and returned.\n---\n## Revision History\n* Release v1.03_231106: Initial development of employee bulk registration\n","operationId":"staffManyRegist","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StaffManyRegistResponse"}}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StaffManyRegistResponse"}}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"StaffManyRegistResponse":{"type":"object","description":"Employee Bulk Registration Response","properties":{"mbrNo":{"type":"string","description":"Member No."},"loginId":{"type":"string","description":"Member ID"},"mbrNm":{"type":"string","description":"Member Name"},"stafMgrNo":{"type":"string","description":"Employee No."},"comGbCd":{"type":"string","description":"Company Classification Code (ME038)","enum":["P00"]},"comGbNm":{"type":"string","description":"Company Name"},"errorMsg":{"type":"string","description":"Error Message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```
## Unregister Employee
> \## Function Description\
> \* Unregisters the employee status of the member selected on screen.\
> \---\
> \## Detailed Description\
> \* Unregisters the employee status of the member selected on screen.\
> \---\
> \## Revision History\
> \* Release v1.03\_231106: Updates the USE\_YN value of the employee discount limit table to 'N' when unregistering an employee\
> \* Release v2.00\_250314: Resets points when a member who was a company employee is unregistered as an employee
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/staffMgmt/deleteMbrStaff":{"post":{"tags":["Employee Management"],"summary":"Unregister Employee","description":"## Function Description\n* Unregisters the employee status of the member selected on screen.\n---\n## Detailed Description\n* Unregisters the employee status of the member selected on screen.\n---\n## Revision History\n* Release v1.03_231106: Updates the USE_YN value of the employee discount limit table to 'N' when unregistering an employee\n* Release v2.00_250314: Resets points when a member who was a company employee is unregistered as an employee\n","operationId":"deleteMbrStaff","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteStaffRequest"}}},"required":true},"responses":{"200":{"description":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"DeleteStaffRequest":{"type":"object","description":"Employee Unregistration Request","properties":{"mbrNoList":{"type":"array","description":"Member No. List","items":{"type":"string"}}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```
## Retrieve Employee List
> \## Function Description\
> \* Retrieves the employee list according to the conditions selected on screen.\
> \---\
> \## Detailed Description\
> \* Retrieves the employee list according to the conditions selected on screen.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v2/member/staffMgmt/getStaffList":{"get":{"tags":["Employee Management"],"summary":"Retrieve Employee List","description":"## Function Description\n* Retrieves the employee list according to the conditions selected on screen.\n---\n## Detailed Description\n* Retrieves the employee list according to the conditions selected on screen.\n","operationId":"getStaffList","parameters":[{"name":"staffMgmtSearchRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/StaffMgmtSearchRequest"}},{"name":"condxMbrOpt","in":"query","description":"Search Type","schema":{"type":"string"}},{"name":"condxMbrValue","in":"query","description":"Input Value","schema":{"type":"string"}},{"name":"condxCompanyCd","in":"query","description":"Company Classification Code","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseStaffMgmtSearchResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"StaffMgmtSearchRequest":{"type":"object","properties":{"siteNo":{"type":"string","description":"Site No."},"condxMbrOpt":{"type":"string","description":"Search Type"},"condxMbrValue":{"type":"string","description":"Input Value"},"condxCompanyCd":{"type":"string","description":"Company Classification Code"}}},"RealGridListResponseStaffMgmtSearchResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/StaffMgmtSearchResponse"}}}},"StaffMgmtSearchResponse":{"type":"object","properties":{"sysRegDtm":{"type":"string"},"sysRegId":{"type":"string"},"sysModDtm":{"type":"string"},"sysModId":{"type":"string"},"rowsPerPage":{"type":"integer","format":"int32"},"pageIdx":{"type":"integer","format":"int32"},"endPage":{"type":"boolean"},"mbrNo":{"type":"string","description":"Member No."},"mbrGbNm":{"type":"string","description":"Member Classification"},"mbrNm":{"type":"string","description":"Member Name"},"comGbNm":{"type":"string","description":"Company Name"},"comGbCd":{"type":"string","description":"Company Classification Code"},"mbrStatNm":{"type":"string","description":"Member Status"},"loginId":{"type":"string","description":"Member ID"},"emailAddr":{"type":"string","description":"Email"},"cellNo":{"type":"string","description":"Mobile Phone Number"},"stafMgrNo":{"type":"string","description":"Employee No."},"siteNm":{"type":"string","description":"Site Name"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```