> 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-discount-limit-management.md).

# Employee Discount Limit Management

## Upload Excel for Employee Bulk Registration

> \## Function Description\
> \* Validates the Excel file containing employee information to be registered.\
> \---\
> \## Detailed Description\
> \* Checks whether any columns are missing.\
> \* Checks whether the employee number is already registered.\
> \* Checks whether the member number matches the name and ID.\
> \* Checks whether the member is already an employee.\
> \* Checks for duplicate member numbers or employee numbers within the Excel data.\
> \---\
> \## Revision History\
> \* Release v1.03\_231106: Initial development of employee bulk registration<br>

```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/staffDcLimMgmt/staffLoadByExcel":{"post":{"tags":["Employee Discount Limit Management"],"summary":"Upload Excel for Employee Bulk Registration","description":"## Function Description\n* Validates the Excel file containing employee information to be registered.\n---\n## Detailed Description\n* Checks whether any columns are missing.\n* Checks whether the employee number is already registered.\n* Checks whether the member number matches the name and ID.\n* Checks whether the member is already an employee.\n* Checks for duplicate member numbers or employee numbers within the Excel data.\n---\n## Revision History\n* Release v1.03_231106: Initial development of employee bulk registration\n","operationId":"staffLoadByExcel","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"}}}}}}
```

## Retrieve Employee Discount Limit Usage History

> \## Function Description\
> \* Retrieves the discount limit usage history list of the selected employee.\
> \---\
> \## Detailed Description\
> \* Retrieves the discount limit usage history list of the selected employee.\
> \---\
> \## Revision History\
> \* Release v1.03\_231106: Initial development of employee discount limit<br>

```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/staffDcLimMgmt/getStaffDcLimUseHistList":{"get":{"tags":["Employee Discount Limit Management"],"summary":"Retrieve Employee Discount Limit Usage History","description":"## Function Description\n* Retrieves the discount limit usage history list of the selected employee.\n---\n## Detailed Description\n* Retrieves the discount limit usage history list of the selected employee.\n---\n## Revision History\n* Release v1.03_231106: Initial development of employee discount limit\n","operationId":"getStaffDcLimUseHist","parameters":[{"name":"staffDcLimUseHistRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/StaffDcLimUseHistRequest"}},{"name":"mbrNo","in":"query","description":"Member No.","schema":{"type":"string"}},{"name":"comGbCd","in":"query","description":"Company Classification Code","schema":{"type":"string"}},{"name":"langCd","in":"query","description":"Language Code","schema":{"type":"string"}},{"name":"rsrvUseYear","in":"query","description":"Usage/Accrual Year","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseStaffDcLimUseHistResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"StaffDcLimUseHistRequest":{"type":"object","description":"Employee Discount Detail History Request","properties":{"langCd":{"type":"string","description":"Language Code"},"mbrNo":{"type":"string","description":"Member No."},"comGbCd":{"type":"string","description":"Company Type Code (ME016)"},"rsrvUseYear":{"type":"string","description":"Usage/Accrual Year"}}},"RealGridListResponseStaffDcLimUseHistResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/StaffDcLimUseHistResponse"}}}},"StaffDcLimUseHistResponse":{"type":"object","description":"Employee Discount Detail Response","properties":{"rsrvUseGbNm":{"type":"string","description":"Type"},"ocurAmt":{"type":"number","description":"Amount Incurred"},"ordNo":{"type":"string","description":"Order No."},"claimNo":{"type":"string","description":"Claim No."},"useDtm":{"type":"string","format":"date-time","description":"Usage Date/Time"}}},"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 Discount Limit Remaining Mileage

> \## Function Description\
> \* Retrieves the remaining discount limit mileage of the selected employee.\
> \---\
> \## Detailed Description\
> \* Retrieves the remaining discount limit mileage of the selected employee.\
> \---\
> \## Revision History\
> \* Release v1.03\_231106: Initial development of employee discount limit<br>

```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/staffDcLimMgmt/getStaffDcLimRemainMileage":{"get":{"tags":["Employee Discount Limit Management"],"summary":"Retrieve Employee Discount Limit Remaining Mileage","description":"## Function Description\n* Retrieves the remaining discount limit mileage of the selected employee.\n---\n## Detailed Description\n* Retrieves the remaining discount limit mileage of the selected employee.\n---\n## Revision History\n* Release v1.03_231106: Initial development of employee discount limit\n","operationId":"getStaffDcLimRemainMileage","parameters":[{"name":"staffDcLimUseHistRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/StaffDcLimUseHistRequest"}},{"name":"mbrNo","in":"query","description":"Member No.","schema":{"type":"string"}},{"name":"comGbCd","in":"query","description":"Company Classification Code","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"number"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"StaffDcLimUseHistRequest":{"type":"object","description":"Employee Discount Detail History Request","properties":{"langCd":{"type":"string","description":"Language Code"},"mbrNo":{"type":"string","description":"Member No."},"comGbCd":{"type":"string","description":"Company Type Code (ME016)"},"rsrvUseYear":{"type":"string","description":"Usage/Accrual Year"}}},"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 Discount Limit List

> \## Function Description\
> \* Retrieves the employee discount limit list according to the conditions selected on screen.\
> \---\
> \## Detailed Description\
> \* Retrieves the employee discount limit list according to the conditions selected on screen.\
> \---\
> \## Revision History\
> \* Release v1.03\_231106: Initial development of employee discount limit<br>

```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/staffDcLimMgmt/getStaffDcLimList":{"get":{"tags":["Employee Discount Limit Management"],"summary":"Retrieve Employee Discount Limit List","description":"## Function Description\n* Retrieves the employee discount limit list according to the conditions selected on screen.\n---\n## Detailed Description\n* Retrieves the employee discount limit list according to the conditions selected on screen.\n---\n## Revision History\n* Release v1.03_231106: Initial development of employee discount limit\n","operationId":"getStaffDcLimList","parameters":[{"name":"staffDcLimRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/StaffDcLimRequest"}},{"name":"condxMbrOpt","in":"query","description":"Search Target: Employee No., Member Name, Member No.","schema":{"type":"string"}},{"name":"condxMbrValue","in":"query","description":"Corresponding Input Value","schema":{"type":"string"}},{"name":"condxCompanyCd","in":"query","description":"Company Classification Code","schema":{"type":"string"}},{"name":"useYn","in":"query","description":"Search Type","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseStaffDcLimResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"StaffDcLimRequest":{"type":"object","description":"Employee Discount Limit Management Request","properties":{"siteNo":{"type":"string","description":"Site No."},"condxMbrOpt":{"type":"string","description":"Search Target: Employee No., Member Name, Member No."},"condxMbrValue":{"type":"string","description":"Corresponding Input Value"},"condxCompanyCd":{"type":"string","description":"Company Classification Code (ME038)"},"useYn":{"type":"string","description":"Usage Status"}}},"RealGridListResponseStaffDcLimResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/StaffDcLimResponse"}}}},"StaffDcLimResponse":{"type":"object","description":"Employee Discount Limit Management 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."},"mbrMgrNm":{"type":"string","description":"Member Classification"},"comGbCd":{"type":"string","description":"Company Classification Code (ME038)"},"comGbNm":{"type":"string","description":"Company Name"},"rmndAmt":{"type":"number","description":"Remaining Amount"},"limAmt":{"type":"number","description":"Limit Amount"},"useYn":{"type":"string","description":"Usage Status"},"sysRegId":{"type":"string","description":"Registrant"},"sysRegDtm":{"type":"string","format":"date-time","description":"Registration Date/Time"},"sysModId":{"type":"string","description":"Modifier"},"sysModDtm":{"type":"string","format":"date-time","description":"Modification Date/Time"},"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"}}}}}}
```