# 관심고객 정보 관리

## 관심고객 해제

> \## 기능설명\
> \* 지정한 회원을 관심고객 해제 처리합니다.\
> \---\
> \## 상세설명\
> \* 회원 번호 목록을 받아 처리합니다.<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":{"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"}}}}}}}}}
```

## 관심고객 등록

> \## 기능설명\
> \* 지정한 회원을 관심고객으로 등록합니다.\
> \---\
> \## 상세설명\
> \* 필수값 목록\
> &#x20;  \* 회원번호\
> &#x20;  \* 관리구분코드\
> &#x20;  \* 관리유형코드\
> &#x20;  \* 등록사유<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":{"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"}}}}}}}}}
```

## 관심고객 기등록 확인

> \## 기능설명\
> \* 지정한 회원을 관심고객 등록여부를 확인합니다.\
> \---\
> \## 상세설명\
> \* 필수값 목록\
> &#x20;  \* 회원번호\
> &#x20;  \* 관리구분코드<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":{"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"}}}}}}}}}
```

## 관심고객 정보 목록 조회

> \## 기능설명\
> \* 화면에서 선택한 조건에 따라 관심고객 정보 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 선택한 조건에 따라 관심고객 정보 목록을 조회합니다.\
> \* 조회 정보는 마스킹됩니다.\
> \* 마스킹 목록\
> &#x20;  \* 회원이름\
> &#x20;  \* 휴대폰번호\
> &#x20;  \* 회원아이디\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240613: 기간 검색 조건 개선<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":{"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"}}}}}}}}}
```


---

# 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-5.md?ask=<question>
```

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.
