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

# 회원 가입 승인 정보 관리

## 회원 가입 승인/반려 처리

> \## 기능설명\
> \* 회원 가입 승인/반려 처리합니다.\
> \* 사업자 회원의 가입 승인 대기 상태를 승인/반려로 변경합니다.\
> \
> \## 처리 내용\
> \* JOIN\_SGT\_STAT\_CD: 10(대기) → 20(승인) 또는 30(반려)\
> \* MBR\_STAT\_CD: 회원 상태를 정상(10)으로 변경\
> \* 승인/반려일시 업데이트<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":{"JoinProcessRequest":{"type":"object","description":"회원가입회원 목록 (승인/반려)","properties":{"joinApprovalList":{"type":"array","description":"회원 정보 목록","items":{"$ref":"#/components/schemas/JoinApprovalMgmtRequest"}},"joinSgtStatCd":{"type":"string","description":"가입신청상태코드 (20: 승인, 30: 반려)","minLength":1},"mbrStatCd":{"type":"string","description":"회원상태코드 (10: 정상, 50: 반려)","minLength":1}},"required":["joinApprovalList","joinSgtStatCd","mbrStatCd"]},"JoinApprovalMgmtRequest":{"type":"object","description":"회원가입 처리 Request","properties":{"siteNo":{"type":"string","description":"사이트번호"},"mbrNo":{"type":"string","description":"회원번호"},"mbrMgrCd":{"type":"string","description":"회원관리코드"},"mbrMgrNm":{"type":"string","description":"회원관리명"},"mbrGradeCd":{"type":"string","description":"회원등급코드"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrStatCd":{"type":"string","description":"회원상태코드"},"mbrStatNm":{"type":"string","description":"회원상태명"},"mbrNm":{"type":"string","description":"회원명"},"loginId":{"type":"string","description":"로그인ID"},"siteNm":{"type":"string","description":"사이트명"},"cellNo":{"type":"string","description":"휴대폰번호"},"joinSgtStatCd":{"type":"string","description":"가입신청상태코드"},"joinSgtStatNm":{"type":"string","description":"가입신청상태명"},"bmanRegNo":{"type":"string","description":"사업자등록번호"},"bmanRegDt":{"type":"string","description":"사업자등록일자"},"rpstmnNm":{"type":"string","description":"대표자명"},"repTelNo":{"type":"string","description":"대표전화번호"},"bmanNm":{"type":"string","description":"사업체명"},"mbrJoinReqDtm":{"type":"string","format":"date-time","description":"회원가입요청일시"},"aprvRtrnCaus":{"type":"string","description":"승인반려사유"},"aprvRtrnDtm":{"type":"string","format":"date-time","description":"승인반려일시"},"mbrJoinDtm":{"type":"string","format":"date-time","description":"가입일시"}}},"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":{"/v1/member/joinApprovalMgmt/updateJoinProcess":{"post":{"tags":["회원 가입 승인 정보 관리"],"summary":"회원 가입 승인/반려 처리","description":"## 기능설명\n* 회원 가입 승인/반려 처리합니다.\n* 사업자 회원의 가입 승인 대기 상태를 승인/반려로 변경합니다.\n\n## 처리 내용\n* JOIN_SGT_STAT_CD: 10(대기) → 20(승인) 또는 30(반려)\n* MBR_STAT_CD: 회원 상태를 정상(10)으로 변경\n* 승인/반려일시 업데이트\n","operationId":"updateJoinProcess","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JoinProcessRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"400":{"description":"잘못된 요청","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 회원 가입 승인 정보 목록 조회

> \## 기능설명\
> \* 회원 가입 승인 정보 목록을 조회합니다.\
> \* 사업자 회원의 가입 승인 대기/승인/반려 상태를 관리합니다.\
> \
> \## 조회 조건\
> \### 기간조회 (allDay=false)\
> \* 가입신청일자 기준: startDate \~ endDate (최대 30일)\
> \
> \### 전체기간 조회 (allDay=true)\
> \* 다음 중 하나 이상 필수: 사업자등록번호, 회원정보(bmanRegNo/bmanNm/mbrNo/rpstmnNm/mbrNm), 휴대폰번호\
> \
> \### 필터 조건\
> \* siteNo: 사이트번호\
> \* joinSgtStatCd: 승인상태 (10-대기, 20-승인, 30-반려)\
> \
> \## 응답 데이터\
> \* 회원 기본정보, 분류/등급, 사업자등록정보, 승인상태, 시스템정보<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":{"RealGridListResponseJoinApprovalMgmtResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/JoinApprovalMgmtResponse"}}}},"JoinApprovalMgmtResponse":{"type":"object","description":"회원 가입 승인 정보 관리 Response","properties":{"mbrNo":{"type":"string","description":"회원번호"},"mbrMgrCd":{"type":"string","description":"회원관리코드"},"mbrMgrNm":{"type":"string","description":"회원관리명"},"mbrGradeCd":{"type":"string","description":"회원등급코드"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrStatCd":{"type":"string","description":"회원상태코드"},"mbrStatNm":{"type":"string","description":"회원상태명"},"mbrNm":{"type":"string","description":"회원명"},"loginId":{"type":"string","description":"로그인ID"},"siteNo":{"type":"string","description":"사이트번호"},"siteNm":{"type":"string","description":"사이트명"},"cellNo":{"type":"string","description":"휴대폰번호"},"joinSgtStatCd":{"type":"string","description":"가입신청상태코드"},"joinSgtStatNm":{"type":"string","description":"가입신청상태명"},"bmanRegNo":{"type":"string","description":"사업자등록번호"},"bmanRegDt":{"type":"string","description":"사업자등록일자"},"rpstmnNm":{"type":"string","description":"대표자명"},"repTelNo":{"type":"string","description":"대표전화번호"},"bmanNm":{"type":"string","description":"사업체명"},"mbrJoinReqDtm":{"type":"string","format":"date-time","description":"회원가입요청일시"},"aprvRtrnCaus":{"type":"string","description":"승인반려사유"},"aprvRtrnDtm":{"type":"string","format":"date-time","description":"승인반려일시"},"atchFilePathNm":{"type":"string","description":"첨부파일경로명"},"mbrJoinDtm":{"type":"string","format":"date-time","description":"가입일시"},"sysProcId":{"type":"string","description":"시스템처리자ID"},"sysRegId":{"type":"string","description":"시스템등록자ID"},"sysRegDtm":{"type":"string","format":"date-time","description":"시스템등록일시"},"sysModId":{"type":"string","description":"시스템수정자ID"},"sysModDtm":{"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":{"/v1/member/joinApprovalMgmt/getJoinApprovalList":{"get":{"tags":["회원 가입 승인 정보 관리"],"summary":"회원 가입 승인 정보 목록 조회","description":"## 기능설명\n* 회원 가입 승인 정보 목록을 조회합니다.\n* 사업자 회원의 가입 승인 대기/승인/반려 상태를 관리합니다.\n\n## 조회 조건\n### 기간조회 (allDay=false)\n* 가입신청일자 기준: startDate ~ endDate (최대 30일)\n\n### 전체기간 조회 (allDay=true)\n* 다음 중 하나 이상 필수: 사업자등록번호, 회원정보(bmanRegNo/bmanNm/mbrNo/rpstmnNm/mbrNm), 휴대폰번호\n\n### 필터 조건\n* siteNo: 사이트번호\n* joinSgtStatCd: 승인상태 (10-대기, 20-승인, 30-반려)\n\n## 응답 데이터\n* 회원 기본정보, 분류/등급, 사업자등록정보, 승인상태, 시스템정보\n","operationId":"getJoinApprovalList","parameters":[{"name":"joinApprovalMgmtSearchRequest","in":"query","description":"회원 가입 승인 정보 목록 조회","required":true,"schema":{"type":"JoinApprovalMgmtSearchRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseJoinApprovalMgmtResponse"}}}},"400":{"description":"잘못된 요청","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseJoinApprovalMgmtResponse"}}}},"900":{"description":"업무처리 오류","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```