> 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/back-office-api/members-bo-api/undefined-2.md).

# 임직원할인한도관리

## 임직원 일괄등록 엑셀 업로드

> \## 기능설명\
> \* 등록할 임직원 정보가 있는 엑셀 파일에 대해 유효성 검증을 합니다.\
> \---\
> \## 상세설명\
> \* 누락된 컬럼이 있는지 확인합니다.\
> \* 이미 등록된 사번이 있는지 확인합니다.\
> \* 회원번호와 이름, 아이디가 맞는지 확인합니다.\
> \* 이미 임직원인지 확인합니다.\
> \* 엑셀 데이터간의 회원번호, 사번 중복이 있는지 확인합니다.\
> \---\
> \## 수정번호\
> \* Release v1.03\_231106: 임직원 일괄등록 최초 개발<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":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"StaffManyRegistResponse":{"type":"object","description":"임직원 일괄등록 Response","properties":{"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"stafMgrNo":{"type":"string","description":"사번"},"comGbCd":{"type":"string","description":"회사구분코드(ME038)","enum":["P00"]},"comGbNm":{"type":"string","description":"회사명"},"errorMsg":{"type":"string","description":"에러 메시지"}}},"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"}}}}},"paths":{"/v1/member/staffDcLimMgmt/staffLoadByExcel":{"post":{"tags":["임직원할인한도관리"],"summary":"임직원 일괄등록 엑셀 업로드","description":"## 기능설명\n* 등록할 임직원 정보가 있는 엑셀 파일에 대해 유효성 검증을 합니다.\n---\n## 상세설명\n* 누락된 컬럼이 있는지 확인합니다.\n* 이미 등록된 사번이 있는지 확인합니다.\n* 회원번호와 이름, 아이디가 맞는지 확인합니다.\n* 이미 임직원인지 확인합니다.\n* 엑셀 데이터간의 회원번호, 사번 중복이 있는지 확인합니다.\n---\n## 수정번호\n* Release v1.03_231106: 임직원 일괄등록 최초 개발\n","operationId":"staffLoadByExcel","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StaffManyRegistResponse"}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StaffManyRegistResponse"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

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

> \## 기능설명\
> \* 선택한 임직원의 할인한도 사용 이력 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 선택한 임직원의 할인한도 사용 이력 목록을 조회합니다.\
> \---\
> \## 수정번호\
> \* Release v1.03\_231106: 임직원할인한도 최초 개발<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":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"StaffDcLimUseHistRequest":{"type":"object","description":"임직원할인상세이력 Request","properties":{"langCd":{"type":"string","description":"언어코드"},"mbrNo":{"type":"string","description":"회원번호"},"comGbCd":{"type":"string","description":"회사구분코드(ME016)"},"rsrvUseYear":{"type":"string","description":"사용/적립 연도"}}},"RealGridListResponseStaffDcLimUseHistResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/StaffDcLimUseHistResponse"}}}},"StaffDcLimUseHistResponse":{"type":"object","description":"임직원할인 상세 Response","properties":{"rsrvUseGbNm":{"type":"string","description":"구분"},"ocurAmt":{"type":"number","description":"발생금액"},"ordNo":{"type":"string","description":"주문번호"},"claimNo":{"type":"string","description":"클레임번호"},"useDtm":{"type":"string","format":"date-time","description":"사용일시"}}},"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"}}}}},"paths":{"/v2/member/staffDcLimMgmt/getStaffDcLimUseHistList":{"get":{"tags":["임직원할인한도관리"],"summary":"임직원할인한도 사용이력 조회","description":"## 기능설명\n* 선택한 임직원의 할인한도 사용 이력 목록을 조회합니다.\n---\n## 상세설명\n* 선택한 임직원의 할인한도 사용 이력 목록을 조회합니다.\n---\n## 수정번호\n* Release v1.03_231106: 임직원할인한도 최초 개발\n","operationId":"getStaffDcLimUseHist","parameters":[{"name":"staffDcLimUseHistRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/StaffDcLimUseHistRequest"}},{"name":"mbrNo","in":"query","description":"회원번호","schema":{"type":"string"}},{"name":"comGbCd","in":"query","description":"회사구분코드","schema":{"type":"string"}},{"name":"langCd","in":"query","description":"언어코드","schema":{"type":"string"}},{"name":"rsrvUseYear","in":"query","description":"사용/적립 연도","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseStaffDcLimUseHistResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 임직원할인한도 잔여 마일리지 조회

> \## 기능설명\
> \* 선택한 임직원의 할인한도 잔여 마일리지를 조회합니다.\
> \---\
> \## 상세설명\
> \* 선택한 임직원의 할인한도 잔여 마일리지를 조회합니다.\
> \---\
> \## 수정번호\
> \* Release v1.03\_231106: 임직원할인한도 최초 개발<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":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"StaffDcLimUseHistRequest":{"type":"object","description":"임직원할인상세이력 Request","properties":{"langCd":{"type":"string","description":"언어코드"},"mbrNo":{"type":"string","description":"회원번호"},"comGbCd":{"type":"string","description":"회사구분코드(ME016)"},"rsrvUseYear":{"type":"string","description":"사용/적립 연도"}}},"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"}}}}},"paths":{"/v2/member/staffDcLimMgmt/getStaffDcLimRemainMileage":{"get":{"tags":["임직원할인한도관리"],"summary":"임직원할인한도 잔여 마일리지 조회","description":"## 기능설명\n* 선택한 임직원의 할인한도 잔여 마일리지를 조회합니다.\n---\n## 상세설명\n* 선택한 임직원의 할인한도 잔여 마일리지를 조회합니다.\n---\n## 수정번호\n* Release v1.03_231106: 임직원할인한도 최초 개발\n","operationId":"getStaffDcLimRemainMileage","parameters":[{"name":"staffDcLimUseHistRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/StaffDcLimUseHistRequest"}},{"name":"mbrNo","in":"query","description":"회원번호","schema":{"type":"string"}},{"name":"comGbCd","in":"query","description":"회사구분코드","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"number"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

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

> \## 기능설명\
> \* 화면에서 선택한 조건에 따라 임직원할인한도 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 선택한 조건에 따라 임직원할인한도 목록을 조회합니다.\
> \---\
> \## 수정번호\
> \* Release v1.03\_231106: 임직원할인한도 최초 개발<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":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"StaffDcLimRequest":{"type":"object","description":"임직원할인한도관리 Request","properties":{"siteNo":{"type":"string","description":"사이트번호"},"condxMbrOpt":{"type":"string","description":"찾을대상:사번,회원명,회원번호"},"condxMbrValue":{"type":"string","description":"해당입력값"},"condxCompanyCd":{"type":"string","description":"회사구분코드(ME038)"},"useYn":{"type":"string","description":"사용여부"}}},"RealGridListResponseStaffDcLimResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/StaffDcLimResponse"}}}},"StaffDcLimResponse":{"type":"object","description":"임직원할인한도관리 Response","properties":{"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"stafMgrNo":{"type":"string","description":"사번"},"mbrMgrNm":{"type":"string","description":"회원분류"},"comGbCd":{"type":"string","description":"회사구분코드(ME038)"},"comGbNm":{"type":"string","description":"회사명"},"rmndAmt":{"type":"number","description":"잔여금액"},"limAmt":{"type":"number","description":"한도금액"},"useYn":{"type":"string","description":"사용여부"},"sysRegId":{"type":"string","description":"등록자"},"sysRegDtm":{"type":"string","format":"date-time","description":"등록일시"},"sysModId":{"type":"string","description":"수정자"},"sysModDtm":{"type":"string","format":"date-time","description":"수정일시"},"siteNm":{"type":"string","description":"사이트명"}}},"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"}}}}},"paths":{"/v2/member/staffDcLimMgmt/getStaffDcLimList":{"get":{"tags":["임직원할인한도관리"],"summary":"임직원할인한도 목록 조회","description":"## 기능설명\n* 화면에서 선택한 조건에 따라 임직원할인한도 목록을 조회합니다.\n---\n## 상세설명\n* 화면에서 선택한 조건에 따라 임직원할인한도 목록을 조회합니다.\n---\n## 수정번호\n* Release v1.03_231106: 임직원할인한도 최초 개발\n","operationId":"getStaffDcLimList","parameters":[{"name":"staffDcLimRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/StaffDcLimRequest"}},{"name":"condxMbrOpt","in":"query","description":"찾을대상:사번,회원명,회원번호","schema":{"type":"string"}},{"name":"condxMbrValue","in":"query","description":"해당입력값","schema":{"type":"string"}},{"name":"condxCompanyCd","in":"query","description":"회사구분코드","schema":{"type":"string"}},{"name":"useYn","in":"query","description":"조회 타입","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseStaffDcLimResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```