> 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/system-bo-api/undefined-5.md).
# 사용자 정보 관리
## 사용자 목록 조회
> \## 기능설명\
> \* 화면에서 선택한 조건에 따라 사용자 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 선택한 조건에 따라 사용자 목록을 조회합니다.
```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":{"UserListRequest":{"type":"object","description":"사용자 정보 관리 Request DTO","properties":{"jobGrpCd":{"type":"string","description":"업무 그룹 코드","enum":["SYSTEM_MANAGER","MD","MARKETING","LGST_CNTR","CUST_CNTR","COOP_CORP","AFCR"]},"userId":{"type":"string","description":"사용자 아이디"},"userNm":{"type":"string","description":"사용자 아이디"},"sysGbCd":{"type":"string","description":"시스템 구분 코드(UR005)"},"useYn":{"type":"string","description":"사용여부"},"userInfoSearchTgt":{"type":"string","description":"사용자 정보 검색 타입"},"userInfo":{"type":"string","description":"사용자 정보(이름 or 아이디)"},"workStatCd":{"type":"string","description":"근무상태코드(UR004)"},"indInfoDealYn":{"type":"string","description":"개인 정보 취급 여부"},"pwdLockYn":{"type":"string","description":"계정 잠김 여부"},"rtGrpNo":{"type":"string","description":"권한 그룹 번호"}}},"ResponseRealGridListResponseUserListResponse":{"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":{"$ref":"#/components/schemas/RealGridListResponseUserListResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"RealGridListResponseUserListResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/UserListResponse"}}}},"UserListResponse":{"type":"object","description":"사용자 정보 관리 Response DTO","properties":{"userId":{"type":"string","description":"사용자 아이디"},"userNm":{"type":"string","description":"사용자명"},"rcntUseDtm":{"type":"string","description":"최근 사용 일시"},"orgTypNm":{"type":"string","description":"업무 그룹 코드(UR002)","enum":["SYSTEM_MANAGER","MD","MARKETING","LGST_CNTR","CUST_CNTR","COOP_CORP","AFCR"]},"deptNm":{"type":"string","description":"부서명"},"ocpNm":{"type":"string","description":"직책 코드(UR003)"},"workStatNm":{"type":"string","description":"근무 상태 코드(UR004)"},"pwdLockYn":{"type":"string","description":"계정 잠김 여부"},"indInfoDealYn":{"type":"string","description":"개인 정보 취급 여부"},"useYn":{"type":"string","description":"사용여부"},"sysGbCdNm":{"type":"string","description":"시스템구분명"},"rtGrpNm":{"type":"string","description":"권한그룹명"},"totalCount":{"type":"integer","format":"int32","description":"목록 수"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field 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"}}}}}},"paths":{"/v2/system/userMgmt":{"get":{"tags":["사용자 정보 관리"],"summary":"사용자 목록 조회","description":"## 기능설명\n* 화면에서 선택한 조건에 따라 사용자 목록을 조회합니다.\n---\n## 상세설명\n* 화면에서 선택한 조건에 따라 사용자 목록을 조회합니다.\n","operationId":"getUserListInUserMenu","parameters":[{"name":"userListRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/UserListRequest"}},{"name":"sysGbCd","in":"query","description":"시스템 구분 코드","schema":{"type":"string"}},{"name":"jobGrpCd","in":"query","description":"업무 그룹 코드","schema":{"type":"string"}},{"name":"userInfoSearchTgt","in":"query","description":"사용자 정보 검색 타입","schema":{"type":"string"}},{"name":"userInfo","in":"query","description":"사용자 정보(이름 or 아이디)","schema":{"type":"string"}},{"name":"useYn","in":"query","description":"사용여부","schema":{"type":"string"}},{"name":"workStatCd","in":"query","description":"부서코드","schema":{"type":"string"}},{"name":"indInfoDealYn","in":"query","description":"근무상태코드","schema":{"type":"string"}},{"name":"pwdLockYn","in":"query","description":"계정 잠김 여부","schema":{"type":"string"}},{"name":"pageIdx","in":"query","description":"현재 페이지","required":true,"schema":{"type":"string"}},{"name":"rowsPerPage","in":"query","description":"페이지 당 row","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponseUserListResponse"}}}},"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":{"UserDetailRequest":{"type":"object","description":"사용자 저장 Request DTO","properties":{"userInfo":{"$ref":"#/components/schemas/UserCudRequest","description":"사용자 정보"},"individualInfoRightList":{"type":"array","description":"개인정보취급권한","items":{"$ref":"#/components/schemas/IndividualInfoRightCudRequest"}},"changeRtGrpNoYn":{"type":"string","description":"권한그룹 변경 여부","minLength":1},"createYn":{"type":"string","description":"신규 등록 여부","minLength":1},"beforeRtGrpNo":{"type":"string","description":"변경전 권한그룹번호"},"rtGrpChgCausCont":{"type":"string"}},"required":["changeRtGrpNoYn","createYn"]},"UserCudRequest":{"type":"object","description":"사용자 수정 Request DTO","properties":{"userId":{"type":"string","description":"사용자 아이디","minLength":1},"userNm":{"type":"string","description":"사용자명","minLength":1},"empNo":{"type":"string","description":"사번"},"pwd":{"type":"string","description":"비밀번호"},"userGbCd":{"type":"string","description":"사용자 구분 코드(UR001)","minLength":1},"rtGrpNo":{"type":"string","description":"권한 그룹 번호","minLength":1},"jobGrpCd":{"type":"string","description":"업무 그룹 코드","enum":["SYSTEM_MANAGER","MD","MARKETING","LGST_CNTR","CUST_CNTR","COOP_CORP","AFCR"],"minLength":1},"ocpCd":{"type":"string","description":"조직 역할 코드(UR003)","minLength":1},"workStatCd":{"type":"string","description":"근무 상태 코드(UR004)","minLength":1},"deptCd":{"type":"string","description":"부서코드"},"entrNo":{"type":"string","description":"협력사 번호"},"telRgnNo":{"type":"string","description":"전화 지역 번호"},"telTxnoNo":{"type":"string","description":"전화 국번 번호"},"telEndNo":{"type":"string","description":"전화 끝 번호"},"cellSctNo":{"type":"string","description":"휴대폰 구분 번호","minLength":1},"cellTxnoNo":{"type":"string","description":"휴대폰 국번 번호","minLength":1},"cellEndNo":{"type":"string","description":"휴대폰 끝 번호","minLength":1},"cnslEntpNm":{"type":"string","description":"상담 업체명"},"ctiNo":{"type":"string","description":"CTI 번호"},"itelNo":{"type":"string","description":"내선번호"},"emailAddr":{"type":"string","description":"이메일 주소","minLength":1},"indInfoDealYn":{"type":"string","description":"개인정보취급여부","minLength":1},"useYn":{"type":"string","description":"사용여부","minLength":1},"atchFileRouteNm":{"type":"string","description":"첨부파일경로명(현재 미사용)"},"atchFileNm":{"type":"string","description":"첨부파일명(현재 미사용)"},"indInfoDealCausCont":{"type":"string","description":"개인정보취급사유내용"},"userIpAddr":{"type":"string","description":"접근허용 IP"}},"required":["cellEndNo","cellSctNo","cellTxnoNo","emailAddr","indInfoDealYn","jobGrpCd","ocpCd","rtGrpNo","useYn","userGbCd","userId","userNm","workStatCd"]},"IndividualInfoRightCudRequest":{"type":"object","properties":{"userId":{"type":"string","minLength":1},"indInfoGbCd":{"type":"string","minLength":1},"useYn":{"type":"string","minLength":1}},"required":["indInfoGbCd","useYn","userId"]},"ResponseString":{"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":{"type":"string","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"}}},"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"}}}}}},"paths":{"/v2/system/userMgmt":{"post":{"tags":["사용자 정보 관리"],"summary":"사용자 저장","description":"## 기능설명\n* 사용자 정보를 저장합니다.\n---\n## 상세설명\n* 사용자를 새로 등록하거나 기존 사용자 정보를 수정합니다.\n* 변경된 값은 사용자의 휴대폰 번호로 알림톡이 발송됩니다\n* 필수 값 목록\n * 사용자 아이디\n * 사용자 이름\n * 휴대폰 번호\n * 권한 그룹 번호\n * 이메일 주소\n * 업무 그룹 코드\n * 직책 코드\n * 근무 상태 코드\n","operationId":"saveUser","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserDetailRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"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":{"ResponseString":{"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":{"type":"string","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"}}},"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"}}}}}},"paths":{"/v2/system/userMgmt/{userId}/password/reset":{"post":{"tags":["사용자 정보 관리"],"summary":"비밀번호 초기화","description":"## 기능설명\n* 사용자의 비밀번호를 초기화합니다.\n---\n## 상세설명\n* 비밀번호는 랜덤한 값으로 변경됩니다.\n* 변경된 값은 사용자의 휴대폰 번호로 알림톡이 발송됩니다\n","operationId":"modifyInitializePassword","parameters":[{"name":"userId","in":"query","description":"사용자 아이디","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"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":{"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/system/userMgmt/modifyInitializePassword":{"post":{"tags":["사용자 정보 관리"],"summary":"비밀번호 초기화","description":"## 기능설명\n* 사용자의 비밀번호를 초기화합니다.\n---\n## 상세설명\n* 비밀번호는 랜덤한 값으로 변경됩니다.\n* 변경된 값은 사용자의 휴대폰 번호로 알림톡이 발송됩니다\n","operationId":"modifyInitializePassword_1","parameters":[{"name":"userId","in":"query","description":"사용자 아이디","schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"string"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 비밀번호 잠김 해제
> \## 기능설명\
> \* 비밀번호가 잠김을 해제 처리합니다.\
> \---\
> \## 상세설명\
> \* 비밀번호가 잠겨있는 사용자의 대해 비밀번호 잠김을 해제합니다.\
> \* 비밀번호 실패횟수를 0으로 초기화합니다.\
> \* 업데이트된 사용자 정보를 반환합니다.
```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":{"UserDetailResponse":{"type":"object","description":"사용자 정보 Response DTO","properties":{"userInfo":{"$ref":"#/components/schemas/StUserBase","description":"사용자 정보"},"individualInfoRightList":{"type":"array","description":"개인정보 취급 권한","items":{"$ref":"#/components/schemas/PrivacyPolicyInfo"}}}},"StUserBase":{"type":"object","description":"사용자 정보 Entity","properties":{"userId":{"type":"string","description":"사용자 아이디"},"userGbCd":{"type":"string","description":"사용자 구분 코드(UR001)"},"deptCd":{"type":"string","description":"부서코드"},"deptNm":{"type":"string","description":"부서명"},"entrNo":{"type":"string","description":"협력사 번호"},"entrNm":{"type":"string","description":"협력사 명"},"userNm":{"type":"string","description":"사용자명"},"pwd":{"type":"string","description":"비밀번호"},"sysGbCd":{"type":"string","description":"시스템 그룹 번호"},"rtGrpNo":{"type":"string","description":"권한 그룹 번호"},"rtGrpNm":{"type":"string","description":"권한 그룹 명"},"useYn":{"type":"string","description":"사용여부"},"telRgnNo":{"type":"string","description":"전화 지역 번호"},"telTxnoNo":{"type":"string","description":"전화 국번 번호"},"telEndNo":{"type":"string","description":"전화 끝 번호"},"cellSctNo":{"type":"string","description":"휴대폰 구분 번호"},"cellTxnoNo":{"type":"string","description":"휴대폰 국번 번호"},"cellEndNo":{"type":"string","description":"휴대폰 끝 번호"},"emailAddr":{"type":"string","description":"이메일 주소"},"indInfoDealYn":{"type":"string","description":"개인 정보 취급 여부"},"indInfoDealCausCont":{"type":"string","description":"개인 정보 취급 사유 내용"},"empNo":{"type":"string","description":"사원번호"},"jobGrpCd":{"type":"string","description":"업무 그룹 코드(UR002)","enum":["SYSTEM_MANAGER","MD","MARKETING","LGST_CNTR","CUST_CNTR","COOP_CORP","AFCR"]},"ocpCd":{"type":"string","description":"직책코드(UR003)"},"workStatCd":{"type":"string","description":"근무 상태코드(UR004)"},"atchFileRouteNm":{"type":"string","description":"첨부 파일 경로 명(현재 미사용)"},"atchFileNm":{"type":"string","description":"첨부 파일명(현재 미사용)"},"useStrtDt":{"type":"string","description":"사용 시작 일자"},"useEndDt":{"type":"string","description":"사용 종료 일자"},"cnslEntpNm":{"type":"string","description":"상담 업체명"},"itelNo":{"type":"string","description":"내선번호"},"ctiNo":{"type":"string","description":"CTI번호"},"rcntUseDtm":{"type":"string","format":"date-time","description":"최근 사용 일시"},"pwdLockRvcmnId":{"type":"string","description":"잠김 해제 처리지"},"pwdLockRvcDtm":{"type":"string","format":"date-time","description":"잠김 해제 처리 일시"},"pwdCntnFailCnt":{"type":"integer","format":"int64","description":"비밀번호 연속 실패 수"},"lstPwdChgDtm":{"type":"string","format":"date-time","description":"최종 비밀번호 변경 일시"},"pwdLockYn":{"type":"string","description":"비밀번호 잠김 여부"},"pwdIniYn":{"type":"string","description":"비밀번호 초기화 여부"},"userIpAddr":{"type":"string","description":"접근허용 IP"}}},"PrivacyPolicyInfo":{"type":"object","description":"개인정보취급권한 DTO","properties":{"userId":{"type":"string","description":"사용자 아이디"},"indInfoGbCd":{"type":"string","description":"개인정보구분코드(UR008)"},"useYn":{"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/system/userMgmt/modifyUpdatePwdUnlock":{"get":{"tags":["사용자 정보 관리"],"summary":"비밀번호 잠김 해제","description":"## 기능설명\n* 비밀번호가 잠김을 해제 처리합니다.\n---\n## 상세설명\n* 비밀번호가 잠겨있는 사용자의 대해 비밀번호 잠김을 해제합니다.\n* 비밀번호 실패횟수를 0으로 초기화합니다.\n* 업데이트된 사용자 정보를 반환합니다.\n","operationId":"modifyUpdatePwdUnlock","parameters":[{"name":"userId","in":"query","description":"사용자 아이디","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/UserDetailResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 사용자 권한그룹 목록 조회
> \## 기능설명\
> \* 화면에서 선택한 조건에 따라 권한 그룹 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 선택한 조건에 따라 권한 그룹 목록을 조회합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240927 : 사용자 권한그룹 목록 조회 v2 신규 생성
```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":{"UserRightGroupRequest":{"type":"object","description":"권한 그룹 조회 Request DTO","properties":{"sysGbCd":{"type":"string","description":"시스템 구분 코드(UR005)"},"rtGrpNo":{"type":"string","description":"권한 그룹 번호"},"rtGrpNm":{"type":"string","description":"권한 그룹명"},"argSelectType":{"type":"string","description":"선택구분"}}},"RealGridListResponseUserRightGroupResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/UserRightGroupResponse"}}}},"UserRightGroupResponse":{"type":"object","description":"권한그룹 정보 Response DTO","properties":{"rtGrpNo":{"type":"string","description":"권한그룹번호"},"sysGbNm":{"type":"string","description":"시스템구분명"},"rtGrpNm":{"type":"string","description":"권한그룹명"},"sysGbCd":{"type":"string","description":"시스템구분코드(UR005)"},"aplyStrDt":{"type":"string","description":"적용시작일자"},"aplyEndDt":{"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/system/userMgmt/getUserRightGroupInfo":{"get":{"tags":["사용자 정보 관리"],"summary":"사용자 권한그룹 목록 조회","description":"## 기능설명\n* 화면에서 선택한 조건에 따라 권한 그룹 목록을 조회합니다.\n---\n## 상세설명\n* 화면에서 선택한 조건에 따라 권한 그룹 목록을 조회합니다.\n---\n## 수정번호\n* Release v2.00_240927 : 사용자 권한그룹 목록 조회 v2 신규 생성\n","operationId":"getUserRightGroupInfo","parameters":[{"name":"userRightGroupRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/UserRightGroupRequest"}},{"name":"sysGbCd","in":"query","description":"사스템 구분 코드","schema":{"type":"string"}},{"name":"rtGrpNm","in":"query","description":"권한 그룹명","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseUserRightGroupResponse"}}}},"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":{"ResponseUserDetailResponse":{"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":{"$ref":"#/components/schemas/UserDetailResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"UserDetailResponse":{"type":"object","description":"사용자 정보 Response DTO","properties":{"userInfo":{"$ref":"#/components/schemas/StUserBase","description":"사용자 정보"},"individualInfoRightList":{"type":"array","description":"개인정보 취급 권한","items":{"$ref":"#/components/schemas/PrivacyPolicyInfo"}}}},"StUserBase":{"type":"object","description":"사용자 정보 Entity","properties":{"userId":{"type":"string","description":"사용자 아이디"},"userGbCd":{"type":"string","description":"사용자 구분 코드(UR001)"},"deptCd":{"type":"string","description":"부서코드"},"deptNm":{"type":"string","description":"부서명"},"entrNo":{"type":"string","description":"협력사 번호"},"entrNm":{"type":"string","description":"협력사 명"},"userNm":{"type":"string","description":"사용자명"},"pwd":{"type":"string","description":"비밀번호"},"sysGbCd":{"type":"string","description":"시스템 그룹 번호"},"rtGrpNo":{"type":"string","description":"권한 그룹 번호"},"rtGrpNm":{"type":"string","description":"권한 그룹 명"},"useYn":{"type":"string","description":"사용여부"},"telRgnNo":{"type":"string","description":"전화 지역 번호"},"telTxnoNo":{"type":"string","description":"전화 국번 번호"},"telEndNo":{"type":"string","description":"전화 끝 번호"},"cellSctNo":{"type":"string","description":"휴대폰 구분 번호"},"cellTxnoNo":{"type":"string","description":"휴대폰 국번 번호"},"cellEndNo":{"type":"string","description":"휴대폰 끝 번호"},"emailAddr":{"type":"string","description":"이메일 주소"},"indInfoDealYn":{"type":"string","description":"개인 정보 취급 여부"},"indInfoDealCausCont":{"type":"string","description":"개인 정보 취급 사유 내용"},"empNo":{"type":"string","description":"사원번호"},"jobGrpCd":{"type":"string","description":"업무 그룹 코드(UR002)","enum":["SYSTEM_MANAGER","MD","MARKETING","LGST_CNTR","CUST_CNTR","COOP_CORP","AFCR"]},"ocpCd":{"type":"string","description":"직책코드(UR003)"},"workStatCd":{"type":"string","description":"근무 상태코드(UR004)"},"atchFileRouteNm":{"type":"string","description":"첨부 파일 경로 명(현재 미사용)"},"atchFileNm":{"type":"string","description":"첨부 파일명(현재 미사용)"},"useStrtDt":{"type":"string","description":"사용 시작 일자"},"useEndDt":{"type":"string","description":"사용 종료 일자"},"cnslEntpNm":{"type":"string","description":"상담 업체명"},"itelNo":{"type":"string","description":"내선번호"},"ctiNo":{"type":"string","description":"CTI번호"},"rcntUseDtm":{"type":"string","format":"date-time","description":"최근 사용 일시"},"pwdLockRvcmnId":{"type":"string","description":"잠김 해제 처리지"},"pwdLockRvcDtm":{"type":"string","format":"date-time","description":"잠김 해제 처리 일시"},"pwdCntnFailCnt":{"type":"integer","format":"int64","description":"비밀번호 연속 실패 수"},"lstPwdChgDtm":{"type":"string","format":"date-time","description":"최종 비밀번호 변경 일시"},"pwdLockYn":{"type":"string","description":"비밀번호 잠김 여부"},"pwdIniYn":{"type":"string","description":"비밀번호 초기화 여부"},"userIpAddr":{"type":"string","description":"접근허용 IP"}}},"PrivacyPolicyInfo":{"type":"object","description":"개인정보취급권한 DTO","properties":{"userId":{"type":"string","description":"사용자 아이디"},"indInfoGbCd":{"type":"string","description":"개인정보구분코드(UR008)"},"useYn":{"type":"string","description":"사용여부"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field 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"}}}}}},"paths":{"/v2/system/userMgmt/detail":{"get":{"tags":["사용자 정보 관리"],"summary":"사용자 상세 조회","description":"## 기능설명\n* 사용자의 정보를 조회합니다.\n---\n## 상세설명\n* 현재 로그인한 사용자의 정보를 조회합니다.\n* 현재 로그인한 사용자의 개인정보 취급권한 조회합니다.\n","operationId":"getUserDetail","parameters":[{"name":"userId","in":"query","description":"사용자 아이디","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseUserDetailResponse"}}}},"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":{"ResponseInteger":{"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":{"type":"integer","format":"int32","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"}}},"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"}}}}}},"paths":{"/v2/system/userMgmt/check":{"get":{"tags":["사용자 정보 관리"],"summary":"사용자 아이디 중복체크","description":"## 기능설명\n* 사용자 아이디 개수를 조회합니다.\n---\n## 상세설명\n* 파라미터 값과 현재 저장되어 있는 사용자 아이디를 비교하여 일치하는 개수를 반환합니다.\n* 아이디 중복 체크를 위해 사용됩니다.\n","operationId":"getCheckUserId","parameters":[{"name":"userId","in":"query","description":"사용자 아이디","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseInteger"}}}},"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":{"UserRightGroupRequest":{"type":"object","description":"권한 그룹 조회 Request DTO","properties":{"sysGbCd":{"type":"string","description":"시스템 구분 코드(UR005)"},"rtGrpNo":{"type":"string","description":"권한 그룹 번호"},"rtGrpNm":{"type":"string","description":"권한 그룹명"},"argSelectType":{"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/system/userMgmt/getUserRightGroupListCount":{"get":{"tags":["사용자 정보 관리"],"summary":"사용자 권한그룹 목록 건수 조회","description":"## 기능설명\n* 화면에서 선택한 조건에 따라 권한 그룹 목록 건수를 조회합니다.\n---\n## 상세설명\n* 화면에서 선택한 조건에 따라 권한 그룹 목록 건수를 조회합니다.\n","operationId":"getUserRightGroupListCount","parameters":[{"name":"userRightGroupRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/UserRightGroupRequest"}},{"name":"sysGbCd","in":"query","description":"사스템 구분 코드","schema":{"type":"string"}},{"name":"rtGrpNm","in":"query","description":"권한 그룹명","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"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":{"UserRightGroupRequest":{"type":"object","description":"권한 그룹 조회 Request DTO","properties":{"sysGbCd":{"type":"string","description":"시스템 구분 코드(UR005)"},"rtGrpNo":{"type":"string","description":"권한 그룹 번호"},"rtGrpNm":{"type":"string","description":"권한 그룹명"},"argSelectType":{"type":"string","description":"선택구분"}}},"UserRightGroupResponse":{"type":"object","description":"권한그룹 정보 Response DTO","properties":{"rtGrpNo":{"type":"string","description":"권한그룹번호"},"sysGbNm":{"type":"string","description":"시스템구분명"},"rtGrpNm":{"type":"string","description":"권한그룹명"},"sysGbCd":{"type":"string","description":"시스템구분코드(UR005)"},"aplyStrDt":{"type":"string","description":"적용시작일자"},"aplyEndDt":{"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/system/userMgmt/getUserRightGroupInfo":{"get":{"tags":["사용자 정보 관리"],"summary":"사용자 권한그룹 목록 조회","description":"## 기능설명\n* 화면에서 선택한 조건에 따라 권한 그룹 목록을 조회합니다.\n---\n## 상세설명\n* 화면에서 선택한 조건에 따라 권한 그룹 목록을 조회합니다.\n","operationId":"getUserRightGroupInfo_1","parameters":[{"name":"userRightGroupRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/UserRightGroupRequest"}},{"name":"sysGbCd","in":"query","description":"사스템 구분 코드","schema":{"type":"string"}},{"name":"rtGrpNm","in":"query","description":"권한 그룹명","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UserRightGroupResponse"}}}}},"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":{"UserListRequest":{"type":"object","description":"사용자 정보 관리 Request DTO","properties":{"jobGrpCd":{"type":"string","description":"업무 그룹 코드","enum":["SYSTEM_MANAGER","MD","MARKETING","LGST_CNTR","CUST_CNTR","COOP_CORP","AFCR"]},"userId":{"type":"string","description":"사용자 아이디"},"userNm":{"type":"string","description":"사용자 아이디"},"sysGbCd":{"type":"string","description":"시스템 구분 코드(UR005)"},"useYn":{"type":"string","description":"사용여부"},"userInfoSearchTgt":{"type":"string","description":"사용자 정보 검색 타입"},"userInfo":{"type":"string","description":"사용자 정보(이름 or 아이디)"},"workStatCd":{"type":"string","description":"근무상태코드(UR004)"},"indInfoDealYn":{"type":"string","description":"개인 정보 취급 여부"},"pwdLockYn":{"type":"string","description":"계정 잠김 여부"},"rtGrpNo":{"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/system/userMgmt/getUserListInUserMenuCount":{"get":{"tags":["사용자 정보 관리"],"summary":"사용자 목록 수 조회","description":"## 기능설명\n* 화면에서 선택한 조건에 따라 사용자 목록 건수를 조회합니다.\n---\n## 상세설명\n* 화면에서 선택한 조건에 따라 사용자 목록 건수를 조회합니다.\n","operationId":"getUserListInUserMenuCount","parameters":[{"name":"userListRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/UserListRequest"}},{"name":"sysGbCd","in":"query","description":"시스템 구분 코드","schema":{"type":"string"}},{"name":"jobGrpCd","in":"query","description":"업무 그룹 코드","schema":{"type":"string"}},{"name":"userInfoSearchTgt","in":"query","description":"사용자 정보 검색 타입","schema":{"type":"string"}},{"name":"userInfo","in":"query","description":"사용자 정보(이름 or 아이디)","schema":{"type":"string"}},{"name":"useYn","in":"query","description":"사용여부","schema":{"type":"string"}},{"name":"workStatCd","in":"query","description":"부서코드","schema":{"type":"string"}},{"name":"indInfoDealYn","in":"query","description":"근무상태코드","schema":{"type":"string"}},{"name":"pwdLockYn","in":"query","description":"계정 잠김 여부","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 사용자 개인정보 취급권한 조회
> \## 기능설명\
> \* 사용자의 개인정보 취급권한 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 현재 로그인한 사용자의 개인정보 취급권한 목록을 조회합니다.\
> \* 사용 여부가 Y인 목록을 조회합니다.\
> \--\
> \## 수정번호\
> \* Release v2.00\_240912: 최초 개발
```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":{"PrivacyPolicyInfoV2":{"type":"object","description":"개인정보취급권한 DTO","properties":{"userId":{"type":"string","description":"사용자 아이디"},"indInfoGbCd":{"type":"string","description":"개인정보구분코드(UR008)"},"useYn":{"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/system/userMgmt/getIndividualInfoRightList":{"get":{"tags":["사용자 정보 관리"],"summary":"사용자 개인정보 취급권한 조회","description":"## 기능설명\n* 사용자의 개인정보 취급권한 목록을 조회합니다.\n---\n## 상세설명\n* 현재 로그인한 사용자의 개인정보 취급권한 목록을 조회합니다.\n* 사용 여부가 Y인 목록을 조회합니다.\n--\n## 수정번호\n* Release v2.00_240912: 최초 개발\n","operationId":"getIndividualInfoRightList","responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PrivacyPolicyInfoV2"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```