> 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-guide/store-front/member/undefined-9.md).

# 마이페이지

쇼핑몰의 로그인한 회원이 다양한 정보를 효율적으로 조회하는 기능을 제공합니다. 회원은 최근 6개월 동안의 구매 실적, 등급 정보, 임직원 여부, 보유 혜택, 주문/배송 및 활동 현황 등을 마이페이지에서 손쉽게 확인할 수 있습니다.

***

## 주요 기능

* **회원 기본 정보 조회**
  * 자신의 회원번호, 회원이름, 임직원 여부를 조회합니다.
* **혜택 및 구매 정보 조회**
  * 마일리지 및 프로모션 쿠폰 개수 확인 할수 있습니다.
  * 등급 조회 및 최근 6개월 구매 실적을 통한 등급을 산정합니다.
* **활동 및 상담 현황 조회**
  * 이벤트 참여내역, 상품 Q\&A, 1:1 문의 건수를 조회합니다.
* **메뉴 및 즐겨찾기 조회**
  * 전체 메뉴 및 즐겨찾기로 등록한 메뉴 목록을 조회합니다.
* **임직원 할인 정보 조회**
  * 임직원인 경우 할인한도와 남은 잔여금액을 조회합니다.
* **등급 갱신 정보 조회**
  * 등급 갱신을 위한 현재 등급과 전체 등급 정보를 조회합니다.
* **기간별 구매 금액 조회**
  * 최근 6개월 동안의 구매 실적 조회로 등급 갱신을 위한 필요 주문 금액을 확인합니다.

## 프로세스 정의

<figure><img src="/files/jjD6jaqybh5YMcIEZEPT" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 마이페이지

회원이 마이페이지에 접근할 때 로그인 상태일 시 회원의 정보를 노출시켜주고 비로그인 상태일 시 로그인 페이지로 이동됩니다.
{% endstep %}

{% step %}

### 회원 마이페이지 메인 정보 조회

회원의 마이페이지 메인 정보를 조회합니다.

* 기본정보, 전체/즐겨찾기 메뉴 조회: 회원 데이터베이스에서 기본정보에 해당하는 회원번호, 임직원여부, 회원이름과 전체메뉴, 즐겨찾기 메뉴를 조회합니다.
* 보유혜택: 회원 데이터베이스에서 마일리지를 조회하고 프로모션 API로 쿠폰개수를 조회합니다.
* 활동현황: 이벤트 API로 이벤트참여, 상품 API로 상품 Q\&A, 주문 API로 고객센터 1:1 건수를 조회합니다.
  {% endstep %}

{% step %}

### 회원 상위등급 조회

회원의 등급 정보를 조회합니다. 회원의 등급은 최근 6개월 구매 실적을 통해 매달 산정됩니다.

* 회원 데이터베이스에서 등록되어 있는 등급 정보와 현재 회원 등급을 조회합니다.
* 주문 API에서 최근 6개월 동안 구매 실적을 조회해 회원 상위 등급을 계산합니다.
  {% endstep %}

{% step %}

### 임직원 할인한도 조회

회원이 임직원으로 등록되어 있을 경우 해당 회사가 등록한 할인한도에 따라 회원의 할인한도와 잔여금액을 조회합니다. 할인한도는 매년 초기화 됩니다.
{% endstep %}
{% endstepper %}

## API 기능 목록

<table><thead><tr><th width="107.888916015625">API</th><th width="347.7779541015625">설명</th><th width="92.4444580078125">Server</th><th width="90.2222900390625">메소드</th><th>비고</th></tr></thead><tbody><tr><td>회원 마이페이지<br>메인 정보 조회</td><td>회원의 보유혜택, 활동현황, 즐겨찾기 목록, 전체 메뉴 목록을 조회합니다.<br> <br>쿠폰발급조회: <br>v1/marketing/cpnIssuList <br>나의 참여 이벤트 목록 수 조회:<br>v1/marketing/getParticipationEventCount <br>회원별 상품 Q&#x26;A 등록 건수 조회: v1/qna/getUserQnaCount <br>고객 1:1 문의 개수 조회: v1/customerservice/getInquiryCount</td><td>Member</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=member&#x26;depth=%EB%A7%88%EC%9D%B4%ED%8E%98%EC%9D%B4%EC%A7%80&#x26;path=myPageMain">🔗API 확인하기 ></a></td></tr><tr><td>회원 상위 등급 조회</td><td>최근 6개월 구매 금액으로 등급정보 테이블을 조회하여 현재 등급과 상위등급 정보를 조회합니다.</td><td>Member</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=member&#x26;depth=%EB%A7%88%EC%9D%B4%ED%8E%98%EC%9D%B4%EC%A7%80&#x26;path=getHighGradeInfo">🔗API 확인하기 ></a><br>기간별구매금액조회: v1/member/getOrdTotAmt</td></tr><tr><td>임직원 <br>할인한도 조회</td><td>임직원할인 한도금액과 주문 시 사용하고 남은 잔여금액을 조회합니다.</td><td>Member</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=member&#x26;depth=%EB%A7%88%EC%9D%B4%ED%8E%98%EC%9D%B4%EC%A7%80&#x26;path=getHighGradeInfo">🔗API 확인하기 ></a></td></tr><tr><td>주문/배송 클레임 <br>건수 조회</td><td>마이페이지 진입 시 주문모듈의 주문/클레임건수를 조회합니다.</td><td>Order</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%ED%9A%8C%EC%9B%90%EC%A0%9C%EA%B3%B5&#x26;path=getMemberOrderClaimCnt">🔗API 확인하기 ></a></td></tr></tbody></table>

## 용어 정의

<table><thead><tr><th width="141.77783203125">명칭</th><th>설명</th><th data-hidden></th></tr></thead><tbody><tr><td>회원등급</td><td>등급은 GREEN(default)등급부터 VVIP 등급까지 존재하며 최근 6개월 동안 구매 실적을 계산하여 매달 산정합니다. 등급이 높을수록 더 많은 혜택을 받을 수 있습니다.</td><td></td></tr><tr><td>임직원할인한도</td><td>회원이 해당 회사의 임직원으로 등록되어 있을 경우 회사가 설정한 할인한도만큼 할인혜택을 받을 수 있습니다. 임직원 할인한도는 매년 1월 1일 초기화 됩니다.</td><td></td></tr></tbody></table>

## 기타 참고사항

**등급 기준**

* 등급산정은 등급산정 배치에서 매월 처리되며, 회원별로 6개월 구매금액 합계하여 처리 하고 있습니다.
* 주문금액기준은 공통코드 : 회원등급코드(ME008)의 참조2값에 있는 금액 기준으로 처리합니다.

| 등급     | 구매실적       |
| ------ | ---------- |
| GREEN  | 0 (신규)     |
| FAMILY | 50,000 이상  |
| GOLD   | 200,000 이상 |
| VIP    | 300,000 이상 |
| VVIP   | 500,000 이상 |

**등급 계산**

ex) 2023년 12월 등급 \
\- 2023.06.01 \~ 2023.11.30 구매 실적이 300,000원 일 때 회원의 등급은 ‘GOLD’입니다.

**주문현황**

* 주문/배송 클레임 건수 데이터가 없거나 모두 0일 경우에는 주문현황 데이터가 나타나지 않습니다.
* API 호출 시 API에서 에러가 발생하면 0으로 간주하여 주문현황이 노출되지 않습니다.

##