> 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-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":{"InstCusRvcRequest":{"type":"object","description":"관심회원 해제 Request","properties":{"instMbrSeqList":{"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/instCusMgmt/rvcInstCus":{"post":{"tags":["관심고객 정보 관리"],"summary":"관심고객 해제","description":"## 기능설명\n* 지정한 회원을 관심고객 해제 처리합니다.\n---\n## 상세설명\n* 회원 번호 목록을 받아 처리합니다.\n","operationId":"rvcInstCus","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstCusRvcRequest"}}},"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":{"EtInstMbrInfo":{"type":"object","description":"관심회원정보 Entity","properties":{"instMbrSeq":{"type":"string","description":"관심회원순번"},"mbrNo":{"type":"string","description":"회원번호"},"mgrGbCd":{"type":"string","description":"관리구분코드(ME019)"},"mgrTypCd":{"type":"string","description":"관리유형코드(ME009)"},"ordNo":{"type":"string","description":"주문번호"},"regCausCont":{"type":"string","description":"등록사유"},"mgrMbrRegId":{"type":"string","description":"관리회원등록아이디"},"mgrMbrRegDtm":{"type":"string","format":"date-time","description":"관리회원등록일시"},"mgrMbrRvcId":{"type":"string","description":"관리회원해제아이디"},"mgrMbrRvcDtm":{"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/instCusMgmt/regInstCus":{"post":{"tags":["관심고객 정보 관리"],"summary":"관심고객 등록","description":"## 기능설명\n* 지정한 회원을 관심고객으로 등록합니다.\n---\n## 상세설명\n* 필수값 목록\n * 회원번호\n * 관리구분코드\n * 관리유형코드\n * 등록사유\n","operationId":"regInstCus","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EtInstMbrInfo"}}},"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":{"EtInstMbrInfo":{"type":"object","description":"관심회원정보 Entity","properties":{"instMbrSeq":{"type":"string","description":"관심회원순번"},"mbrNo":{"type":"string","description":"회원번호"},"mgrGbCd":{"type":"string","description":"관리구분코드(ME019)"},"mgrTypCd":{"type":"string","description":"관리유형코드(ME009)"},"ordNo":{"type":"string","description":"주문번호"},"regCausCont":{"type":"string","description":"등록사유"},"mgrMbrRegId":{"type":"string","description":"관리회원등록아이디"},"mgrMbrRegDtm":{"type":"string","format":"date-time","description":"관리회원등록일시"},"mgrMbrRvcId":{"type":"string","description":"관리회원해제아이디"},"mgrMbrRvcDtm":{"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/instCusMgmt/getInstCusExist":{"post":{"tags":["관심고객 정보 관리"],"summary":"관심고객 기등록 확인","description":"## 기능설명\n* 지정한 회원을 관심고객 등록여부를 확인합니다.\n---\n## 상세설명\n* 필수값 목록\n * 회원번호\n * 관리구분코드\n","operationId":"getInstCusExist","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EtInstMbrInfo"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 관심고객 정보 목록 조회
> \## 기능설명\
> \* 화면에서 선택한 조건에 따라 관심고객 정보 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 선택한 조건에 따라 관심고객 정보 목록을 조회합니다.\
> \* 조회 정보는 마스킹됩니다.\
> \* 마스킹 목록\
> \* 회원이름\
> \* 휴대폰번호\
> \* 회원아이디\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240613: 기간 검색 조건 개선
```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":{"InstCusRequest":{"type":"object","description":"관심고객조회 Request","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"},"mbrOpt":{"type":"string","description":"요청타입 (NAME, ID, mbrNo)"},"mbrValue":{"type":"string","description":"회원 이름 or 아이디 or 번호"},"dateSelect":{"type":"string","description":"전체기간 조회여부"},"regStrDt":{"type":"string","format":"date","description":"등록 시작 일자"},"regEndDt":{"type":"string","format":"date","description":"등록 종료 일자"},"instMbrYn":{"type":"string","description":"관심 고객 여부"},"mgrGbCd":{"type":"string","description":"관리구분"},"mgrTypCd":{"type":"string","description":"관리유형"},"ordLmtYn":{"type":"string","description":"구매 제한 여부"},"cellSctNo":{"type":"string","description":"휴대폰 국번"},"cellTxnoNo":{"type":"string","description":"휴대폰 중간번호"},"cellEndNo":{"type":"string","description":"휴대폰 끝번호"},"langCd":{"type":"string","description":"언어코드(CM009)"},"regDt":{"type":"string","description":"조회기간 버튼"},"siteNo":{"type":"string","description":"사이트번호"}}},"RealGridListResponseInstCusResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/InstCusResponse"}}}},"InstCusResponse":{"type":"object","description":"관심고객 조회 Response","properties":{"instMbrSeq":{"type":"string","description":"관심회원순번"},"mbrNo":{"type":"string","description":"회원번호"},"mbrNm":{"type":"string","description":"회원이름"},"cellNo":{"type":"string","description":"휴대폰번호"},"loginId":{"type":"string","description":"회원아이디"},"instMbrYn":{"type":"string","description":"관심고객여부"},"mgrGbNm":{"type":"string","description":"관리구분명(ME019)"},"mgrTypNm":{"type":"string","description":"관리유형명(ME009)"},"ordLmtYn":{"type":"string","description":"구매제한여부"},"regCausCont":{"type":"string","description":"등록사유"},"ordNo":{"type":"string","description":"주문번호"},"mgrMbrRegDt":{"type":"string","format":"date","description":"관리회원등록일자"},"mgrMbrRegId":{"type":"string","description":"관리회원등록아이디"},"mgrMbrRvcDt":{"type":"string","format":"date","description":"관리회원해제일자"},"mgrMbrRvcId":{"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/instCusMgmt/getInstCusList":{"get":{"tags":["관심고객 정보 관리"],"summary":"관심고객 정보 목록 조회","description":"## 기능설명\n* 화면에서 선택한 조건에 따라 관심고객 정보 목록을 조회합니다.\n---\n## 상세설명\n* 화면에서 선택한 조건에 따라 관심고객 정보 목록을 조회합니다.\n* 조회 정보는 마스킹됩니다.\n* 마스킹 목록\n * 회원이름\n * 휴대폰번호\n * 회원아이디\n---\n## 수정 번호\n* Release v2.00_240613: 기간 검색 조건 개선\n","operationId":"getInstCusList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/InstCusRequest"}},{"name":"mbrOpt","in":"query","description":"요청타입 (NAME, ID, mbrNo)","schema":{"type":"string"}},{"name":"mbrValue","in":"query","description":"회원 이름 or 아이디 or 번호","schema":{"type":"string"}},{"name":"dateSelect","in":"query","description":"조회 전체기간 조회여부","schema":{"type":"string"}},{"name":"regStrDt","in":"query","description":"등록 시작 일자","schema":{"type":"string"}},{"name":"regEndDt","in":"query","description":"등록 종료 일자","schema":{"type":"string"}},{"name":"instMbrYn","in":"query","description":"관심 고객 여부","schema":{"type":"string"}},{"name":"mgrGbCd","in":"query","description":"관리구분","schema":{"type":"string"}},{"name":"mgrTypCd","in":"query","description":"관리유형","schema":{"type":"string"}},{"name":"ordLmtYn","in":"query","description":"구매 제한 여부","schema":{"type":"string"}},{"name":"cellSctNo","in":"query","description":"휴대폰 국번","schema":{"type":"string"}},{"name":"cellTxnoNo","in":"query","description":"휴대폰 중간번호","schema":{"type":"string"}},{"name":"cellEndNo","in":"query","description":"휴대폰 끝번호","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseInstCusResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```