> 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-1.md).

# 임직원 관리

## 임직원 일괄등록

> \## 기능설명\
> \* 임직원 일괄등록을 진행하고 결과 데이터를 반환합니다.\
> \---\
> \## 상세설명\
> \* 요청 값으로 넘어온 데이터 중 에러 메시지가 없는 데이터만 등록을 진행합니다.\
> \* 이미 임직원으로 등록되어 있으면 등록이 불가능 합니다.\
> \* 요청 데이터의 사번이 이미 등록되어 있으면 등록이 불가능 합니다.\
> \* SQL 예외 발생 시 에러 메시지에 예외 메시지 값을 넣어 반환합니다.\
> \---\
> \## 수정번호\
> \* 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/staffMgmt/staffManyRegist":{"post":{"tags":["임직원 관리"],"summary":"임직원 일괄등록","description":"## 기능설명\n* 임직원 일괄등록을 진행하고 결과 데이터를 반환합니다.\n---\n## 상세설명\n* 요청 값으로 넘어온 데이터 중 에러 메시지가 없는 데이터만 등록을 진행합니다.\n* 이미 임직원으로 등록되어 있으면 등록이 불가능 합니다.\n* 요청 데이터의 사번이 이미 등록되어 있으면 등록이 불가능 합니다.\n* SQL 예외 발생 시 에러 메시지에 예외 메시지 값을 넣어 반환합니다.\n---\n## 수정번호\n* Release v1.03_231106: 임직원 일괄등록 최초 개발\n","operationId":"staffManyRegist","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: 임직원 해제 처리 시 임직원 할인한도 테이블 USE\_YN 값 'N'으로 UPDATE\
> \* Release v2.00\_250314: 회사 임직원이었다가 임직원 해제 시, 포인트 초기화<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":{"DeleteStaffRequest":{"type":"object","description":"임직원 해제 Request","properties":{"mbrNoList":{"type":"array","description":"회원번호 리스트","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"}}}}},"paths":{"/v1/member/staffMgmt/deleteMbrStaff":{"post":{"tags":["임직원 관리"],"summary":"임직원 해제","description":"## 기능설명\n* 화면에서 선택한 회원의 임직원을 해제 처리합니다.\n---\n## 상세설명\n* 화면에서 선택한 회원의 임직원을 해제 처리합니다.\n---\n## 수정번호\n* Release v1.03_231106: 임직원 해제 처리 시 임직원 할인한도 테이블 USE_YN 값 'N'으로 UPDATE\n* Release v2.00_250314: 회사 임직원이었다가 임직원 해제 시, 포인트 초기화\n","operationId":"deleteMbrStaff","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteStaffRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 임직원 목록 조회

> \## 기능설명\
> \* 화면에서 선택한 조건에 따라 임직원 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 선택한 조건에 따라 임직원 목록을 조회합니다.<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":{"StaffMgmtSearchRequest":{"type":"object","properties":{"siteNo":{"type":"string","description":"사이트번호"},"condxMbrOpt":{"type":"string","description":"조회 타입"},"condxMbrValue":{"type":"string","description":"입력 값"},"condxCompanyCd":{"type":"string","description":"회사구분코드"}}},"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":"회원번호"},"mbrGbNm":{"type":"string","description":"회원분류"},"mbrNm":{"type":"string","description":"회원명"},"comGbNm":{"type":"string","description":"회사명"},"comGbCd":{"type":"string","description":"회사구분코드"},"mbrStatNm":{"type":"string","description":"회원상태"},"loginId":{"type":"string","description":"회원아이디"},"emailAddr":{"type":"string","description":"이메일"},"cellNo":{"type":"string","description":"휴대폰번호"},"stafMgrNo":{"type":"string","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/staffMgmt/getStaffList":{"get":{"tags":["임직원 관리"],"summary":"임직원 목록 조회","description":"## 기능설명\n* 화면에서 선택한 조건에 따라 임직원 목록을 조회합니다.\n---\n## 상세설명\n* 화면에서 선택한 조건에 따라 임직원 목록을 조회합니다.\n","operationId":"getStaffList","parameters":[{"name":"staffMgmtSearchRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/StaffMgmtSearchRequest"}},{"name":"condxMbrOpt","in":"query","description":"조회 타입","schema":{"type":"string"}},{"name":"condxMbrValue","in":"query","description":"입력 값","schema":{"type":"string"}},{"name":"condxCompanyCd","in":"query","description":"회사구분코드","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseStaffMgmtSearchResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```