마일리지
- X2BEE 관리자
- 정현 도
쇼핑몰에서의 구매나 서비스 이용 시 적립되는 일종의 혜택 포인트 시스템입니다. 이는 고객들이 소비를 할 때마다 일정 비율로 쌓이며, 이후 특별한 혜택으로 환급되거나 다음 구매에 사용될 수 있습니다. 마일리지는 소비자들에게 더 많은 혜택을 제공하여 충성도를 높이고 쇼핑 경험을 향상시키는 데 활용됩니다.
주요 기능
마일리지로 상품 구매
X2BEE 쇼핑몰에서 상품을 구매할 때 보유한 마일리지로 결제 가능합니다.
마일리지 적립과 유효기간
마일리지는 여러 방법으로 적립되며, 적립 시 유효기간이 존재합니다.
기본적립, 상품리뷰, 회원등급별 추가 적립: 1년 유효
프로모션, 고객보상, 환불, 이벤트 적립: 30일 유효
마일리지 사용 우선순위
마일리지 사용 시 유효기간이 임박한 순서대로 먼저 사용되며, 잔여 마일리지가 적은 마일리지가 그 다음으로 사용됩니다.
프로세스 정의
번호 | 구분 | 설명 |
|---|---|---|
1 | 마일리지 사용/적립 목록 조회 | 마일리지 사용/ 적립 목록 조회를 통해 회원의 마일리지 사용 및 적립 이력을 확인 할 수 있습니다. 조회 시, 최대 3개월 범위 이내로 조회 가능합니다. |
2 | 보유 마일리지 요약 조회 | 회원의 보유한 마일리지의 상태를 요약하여 조회합니다. 총 보유 마일리지를 포함하여, 당일 및 당월 소멸 예정인 마일리지를 출력합니다. |
3 | 가용 마일리지 조회 | 가용 마일리지 조회 API는 FO에서 직접 요청할 수 없는 각 모듈 전용 API로, 특정 회원의 사용 가능한 마일리지 금액을 조회합니다. |
4 | 마일리지 사용/적립 처리 | 마일리지 사용/적립 처리 API는 FO에서 직접 요청할 수 없는 각 모듈 전용 API입니다. 마일리지 사용 및 적립 요청을 통하여 마일리지를 사용 및 적립처리를 진행 하고, 마일리지 이력 및 마일리지의 상태를 관리합니다. |
5 | 적립 | 마일리지 유효종료일시를 계산하기 위해 |
API 기능 목록
API | 설명 | Server | 메소드 | 비고 |
|---|---|---|---|---|
가용 마일리지 조회 | 마일리지 사용 처리를 요청 하기 전 요청을 원하는 모듈에서 가용 마일리지 조회 API를 통하여 회원의 사용 가능한 잔여 마일리지를 조회합니다. | Member | GET | |
보유 마일리지 요약 조회 | 보유한 전체 마일리지를 요약함으로, 회원의 마일리지 상태를 한 눈에 파악할 수 있도록 제공합니다. | Member | GET |
|
마일리지 사용/적립 처리 | 마일리지 사용 및 적립을 통해 마일리지를 이용하여 제품을 구매 및 할인 받을 수 있고, 특정 기준에 부합할 때 마일리지 적립을 제공합니다. | Member | POST | |
마일리지 사용/적립 목록 조회 | 보유한 마일리지의 사용 혹은 적립된 이력을 조회할 수 있습니다. 조회 시 조회 가능한 범위는 최대 3개월 이내 입니다. | Member | GET |
용어 정의
명칭 | 설명 | 비고 |
|---|---|---|
마일리지 | 마일리지는 X2BEE 쇼핑몰에서 물건을 구매할 때 현금 대신 사용할 수 있는 포인트 입니다. 마일리지를 적립하기 위해서는 물건 구매, 상품평 등록, 이벤트 참여 등 다양한 방식을 통해 적립이 가능하며, 적립 방식에 따라 마일리지의 유효기간이 상이합니다. |
|
기타 참고사항
마일리지 사용/적립 처리
마일리지 사용 및 적립 처리는 FO에서 직접 사용할 수 없는 모듈 전용 API 입니다.
마일리지 적립
마일리지 적립 시, 적립구분코드(CM016)와 적립대상코드(CM017) 두 코드에 따라 마일리지기준정보(ET_MILG_STD_INFO) 테이블에서 소멸기간을 조회하여 마일리지 유효기간이 설정합니다.
마일리지 적립 시 ET_MBR_AST_MGR_HIST 테이블에 이력이 추가 되며, ME_MBR_AST_SUM 테이블의 TOT_AMT 컬럼에 누적되어 관리됩니다.
마일리지 적립 시 자산관리번호 와 자산관리상세 번호는 각 모듈 별 프로세스에서 식별이 가능한 유니크한 값을 전달받아 관리 됩니다.
상품 리뷰에 의한 마일리지 적립 시 월 최대 3,000 마일리지 / 년 최대 36,000 마일리지 만 적립됩니다.
마일리지 사용
마일리지 사용 시, 사용하기 위한 마일리지보다 적립된 마일리지 중 사용 가능한 총 마일리지가 더 큰 경우 사용이 가능합니다.
마일리지 사용 시 ET_MBR_AST_MGR_HIST 테이블에 이력이 추가 되며, ME_MBR_AST_SUM 테이블의 USE_AMT 컬럼에 누적되어 관리됩니다.
마일리지 사용 시 ET_MBR_AST_MGR_HIST 테이블에 적립된 마일리지의 BAL_AMT의 값을 사용한 만큼 차감하여 업데이트 하고, 사용한 마일리지 이력을 삽입합니다.
마일리지 사용 우선순위
마일리지를 사용 할 때 적립된 마일리지 중 우선 순위가 존재합니다.
유효기간 종료가 임박한 마일리지 > 마일리지 금액이 적은 마일리지
사용 불가 마일리지
사용이 불가능한 마일리지는 다음과 같습니다.
ET_MBR_AST_MGR_HIST 테이블에 적립된 마일리지 중 BAL_AMT의 금액이 0원인 마일리지
동일 테이블에 APLY_YN이 N 인 마일리지
유효기간이 만료된 마일리지