# 임직원 관리
## 임직원 일괄등록
> \## 기능설명\
> \* 임직원 일괄등록을 진행하고 결과 데이터를 반환합니다.\
> \---\
> \## 상세설명\
> \* 요청 값으로 넘어온 데이터 중 에러 메시지가 없는 데이터만 등록을 진행합니다.\
> \* 이미 임직원으로 등록되어 있으면 등록이 불가능 합니다.\
> \* 요청 데이터의 사번이 이미 등록되어 있으면 등록이 불가능 합니다.\
> \* SQL 예외 발생 시 에러 메시지에 예외 메시지 값을 넣어 반환합니다.\
> \---\
> \## 수정번호\
> \* Release v1.03\_231106: 임직원 일괄등록 최초 개발
```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: 회사 임직원이었다가 임직원 해제 시, 포인트 초기화
```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"}}}}}}}}}
```
## 임직원 목록 조회
> \## 기능설명\
> \* 화면에서 선택한 조건에 따라 임직원 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 선택한 조건에 따라 임직원 목록을 조회합니다.
```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"}}}}}}}}}
```
---
# 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-1.md?ask=
```
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.