# 임직원할인한도관리

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

> \## 기능설명\
> \* 등록할 임직원 정보가 있는 엑셀 파일에 대해 유효성 검증을 합니다.\
> \---\
> \## 상세설명\
> \* 누락된 컬럼이 있는지 확인합니다.\
> \* 이미 등록된 사번이 있는지 확인합니다.\
> \* 회원번호와 이름, 아이디가 맞는지 확인합니다.\
> \* 이미 임직원인지 확인합니다.\
> \* 엑셀 데이터간의 회원번호, 사번 중복이 있는지 확인합니다.\
> \---\
> \## 수정번호\
> \* 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"}}}}}}}}}
```


---

# Agent Instructions: 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:

```
GET https://tech.x2bee.com/api/back-office-api/members-bo-api/undefined-2.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
