마이페이지

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

---

주요 기능

• 회원 기본 정보 조회

  • 자신의 회원번호, 회원이름, 임직원 여부를 조회합니다.

• 혜택 및 구매 정보 조회

  • 마일리지 및 프로모션 쿠폰 개수 확인 할수 있습니다.

  • 등급 조회 및 최근 6개월 구매 실적을 통한 등급을 산정합니다.

• 활동 및 상담 현황 조회

  • 이벤트 참여내역, 상품 Q&A, 1:1 문의 건수를 조회합니다.

• 메뉴 및 즐겨찾기 조회

  • 전체 메뉴 및 즐겨찾기로 등록한 메뉴 목록을 조회합니다.

• 임직원 할인 정보 조회

  • 임직원인 경우 할인한도와 남은 잔여금액을 조회합니다.

• 등급 갱신 정보 조회

  • 등급 갱신을 위한 현재 등급과 전체 등급 정보를 조회합니다.

• 기간별 구매 금액 조회

  • 최근 6개월 동안의 구매 실적 조회로 등급 갱신을 위한 필요 주문 금액을 확인합니다.

프로세스 정의

1

마이페이지

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

2

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

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

• 기본정보, 전체/즐겨찾기 메뉴 조회: 회원 데이터베이스에서 기본정보에 해당하는 회원번호, 임직원여부, 회원이름과 전체메뉴, 즐겨찾기 메뉴를 조회합니다.

• 보유혜택: 회원 데이터베이스에서 마일리지를 조회하고 프로모션 API로 쿠폰개수를 조회합니다.

• 활동현황: 이벤트 API로 이벤트참여, 상품 API로 상품 Q&A, 주문 API로 고객센터 1:1 건수를 조회합니다.

3

회원 상위등급 조회

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

• 회원 데이터베이스에서 등록되어 있는 등급 정보와 현재 회원 등급을 조회합니다.

• 주문 API에서 최근 6개월 동안 구매 실적을 조회해 회원 상위 등급을 계산합니다.

4

임직원 할인한도 조회

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

API 기능 목록

API	설명	Server	메소드	비고
회원 마이페이지 메인 정보 조회	회원의 보유혜택, 활동현황, 즐겨찾기 목록, 전체 메뉴 목록을 조회합니다. 쿠폰발급조회: v1/marketing/cpnIssuList 나의 참여 이벤트 목록 수 조회: v1/marketing/getParticipationEventCount 회원별 상품 Q&A 등록 건수 조회: v1/qna/getUserQnaCount 고객 1:1 문의 개수 조회: v1/customerservice/getInquiryCount	Member	GET	🔗API 확인하기 >
회원 상위 등급 조회	최근 6개월 구매 금액으로 등급정보 테이블을 조회하여 현재 등급과 상위등급 정보를 조회합니다.	Member	GET	🔗API 확인하기 > 기간별구매금액조회: v1/member/getOrdTotAmt
임직원 할인한도 조회	임직원할인 한도금액과 주문 시 사용하고 남은 잔여금액을 조회합니다.	Member	GET	🔗API 확인하기 >
주문/배송 클레임 건수 조회	마이페이지 진입 시 주문모듈의 주문/클레임건수를 조회합니다.	Order	POST	🔗API 확인하기 >

용어 정의

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

기타 참고사항

등급 기준

• 등급산정은 등급산정 배치에서 매월 처리되며, 회원별로 6개월 구매금액 합계하여 처리 하고 있습니다.

• 주문금액기준은 공통코드 : 회원등급코드(ME008)의 참조2값에 있는 금액 기준으로 처리합니다.

등급	구매실적
GREEN	0 미만
FAMILY	50,000 미만
GOLD	300,000 미만
VIP	500,000 미만
VVIP	500,000 이상

등급 계산

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

주문현황

• 주문/배송 클레임 건수 데이터가 없거나 모두 0일 경우에는 주문현황 데이터가 나타나지 않습니다.

• API 호출 시 API에서 에러가 발생하면 0으로 간주하여 주문현황이 노출되지 않습니다.