버전 비교

  • 이 줄이 추가되었습니다.
  • 이 줄이 삭제되었습니다.
  • 서식이 변경되었습니다.

마일리지는 일종의 축적된 혜택 또는 보상 포인트 시스템으로, 고객이 상품을 구매하거나 서비스를 이용할 때마다 적립되는 포인트를 의미합니다. 마일리지는 특정 기준에 따라 적립되며, 대표적인 적립 기준으로는 소비 금액에 비례하여 적립 됩니다.소비자가 적립한 마일리지는 다양한 혜택으로 환급되거나 사용할 수 있습니다. 이를 통해 다음 구매 시에 할인으로 사용하거나 특별한 상품이나 서비스로 교환할 수 있습니다. 마일리지는 고객들에게 추가적인 혜택을 제공하고 충성도를 유지시키는 데 도움을 주며, 소비자들에게 더 많은 가치를 제공하는데 사용됩니다쇼핑몰에서의 구매나 서비스 이용 시 적립되는 일종의 혜택 포인트 시스템입니다. 이는 고객들이 소비를 할 때마다 일정 비율로 쌓이며, 이후 특별한 혜택으로 환급되거나 다음 구매에 사용될 수 있습니다. 마일리지는 소비자들에게 더 많은 혜택을 제공하여 충성도를 높이고 쇼핑 경험을 향상시키는 데 활용됩니다.

...

주요 기능

  • 마일리지로 상품 구매

    • X2BEE

    쇼핑몰
    • 쇼핑몰에서 상품을

    구매 시
    • 구매할 때 보유한 마일리지로

    구매할 수 있습니다
    • 결제 가능합니다.

  • 마일리지 적립과 유효기간

    • 마일리지는 여러 방법으로 적립되며, 적립 시

    유효기간은 다음과 같습니다
    • 유효기간이 존재합니다.

      • 기본적립, 상품리뷰,

      회원등급별추가
      • 회원등급별 추가 적립: 1년 유효

      • 프로모션, 고객보상, 환불, 이벤트 적립: 30일 유효

  • 마일리지 사용 우선순위

    • 마일리지 사용 시

    , 보유한 마일리지 중 유효기간 종료가 임박한 마일리지를 가장 먼저 사용하며 그 다음으로는
    • 유효기간이 임박한 순서대로 먼저 사용되며, 잔여 마일리지가 적은

    마일리지를 사용합니다
    • 마일리지가 그 다음으로 사용됩니다.

프로세스 정의

...

번호

구분

설명

1

마일리지 사용/적립 목록 조회

마일리지 사용/ 적립 목록 조회를 통해 회원의 마일리지 사용 및 적립 이력을 확인 할 수 있습니다.

조회 시, 최대 3개월 범위 이내로 조회 가능합니다.

2

보유 마일리지 요약 조회

회원의 보유한 마일리지의 상태를 요약하여 조회합니다. 총 보유 마일리지를 포함하여, 당일 및 당월 소멸 예정인 마일리지를 출력합니다.

3

가용 마일리지 조회

가용 마일리지 조회 API는 FO에서 직접 요청할 수 없는 각 모듈 전용 API로, 특정 회원의 사용 가능한 마일리지 금액을 조회합니다.

4

마일리지 사용/적립 처리

마일리지 사용/적립 처리 API는 FO에서 직접 요청할 수 없는 각 모듈 전용 API입니다. 마일리지 사용 및 적립 요청을 통하여 마일리지를 사용 및 적립처리를 진행 하고, 마일리지 이력 및 마일리지의 상태를 관리합니다.

5

적립

마일리지 유효종료일시를 계산하기 위해
마일리지 기준 정보에서 소멸기간을 조회합니다.

API 기능 목록

API

설명

Server

매소드메소드

비고

가용 마일리지 조회

마일리지 사용 처리를 요청 하기 전 요청을 원하는 모듈에서 가용 마일리지 조회 API를 통하여 회원의 사용 가능한 잔여 마일리지를 조회합니다.

Member

GET

🔗API 확인하기 >

보유 마일리지 요약 조회

보유한 전체 마일리지를 요약함으로, 회원의 마일리지 상태를 한 눈에 파악할 수 있도록 제공합니다.

Member

GET

🔗API 확인하기 >

마일리지 사용/적립 처리

마일리지 사용 및 적립을 통해 마일리지를 이용하여 제품을 구매 및 할인 받을 수 있고, 특정 기준에 부합할 때 마일리지 적립을 제공합니다.

Member

POST

🔗API 확인하기 >

마일리지 사용/적립 목록 조회

보유한 마일리지의 사용 혹은 적립된 이력을 조회할 수 있습니다. 조회 시 조회 가능한 범위는 최대 3개월 이내 입니다.

Member

GET

🔗API 확인하기 >

용어 정의

명칭

설명

비고

마일리지

마일리지는 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 인 마일리지

    • 유효기간이 만료된 마일리지