> 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/promotion/undefined-3.md).

# 마일리지 적립

쇼핑몰은 특정 조건을 충족하거나 상품을 구매할 때 마일리지를 적립하는 시스템을 운영합니다. 이를 통해 소비자들은 지속적으로 쇼핑하고 활동하도록 유도되며, 마일리지 시스템을 활용하여 사용자들은 더 많은 할인 혜택 및 특별한 혜택을 받을 수 있습니다. 이는 쇼핑몰의 활성화와 매출 증대를 도모하는 중요한 수단으로 활용됩니다.

***

## 주요 기능

* **프로모션 정보 조회 및 마일리지 적립금액 계산**
  * 특정 조건을 충족하거나 상품을 구매 시 적용되는 프로모션 정보를 조회합니다.
  * 프로모션 정보를 기반으로 마일리지 적립금액을 계산합니다.
* 코드 간결화 및 모듈 관리 최소화

## 프로세스 정의

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

{% stepper %}
{% step %}

### 적립정보 조회

주문 및 클레임 처리 시 주문 정보 및 회원 정보를 통해 마일리지 적립 금액을 계산합니다.
{% endstep %}

{% step %}

### 적립정보 확인

해당 로직은 서비스 단위 검증 및 계산 로직입니다. 기능 개요 중 '업무 프로세스 정의'를 참고하세요: [프로모션 검증](broken://pages/911d66d84f51de7b10b0913837aabb5cf7189a57)
{% endstep %}
{% endstepper %}

## API 기능 목록

<table><thead><tr><th width="102.3333740234375">API</th><th width="365.4444580078125">설명</th><th width="93.5555419921875">Server</th><th width="89.111083984375">매소드</th><th>비고</th></tr></thead><tbody><tr><td>프로모션 적립정보 조회</td><td>주문 및 클레임 처리 시 요청한 주문 내용에 따라 프로모션 정보 및 마일리지 적립 금액을 계산한 정보를 제공합니다.</td><td>Order</td><td>POST</td><td><a href="https://api.x2bee.com/content?msa=order&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EC%A0%81%EB%A6%BD&#x26;path=getAccumulationInfo_1">🔗API 확인하기></a></td></tr></tbody></table>

## 용어 정의

<table><thead><tr><th width="91.7777099609375">명칭</th><th>설명</th><th data-hidden>비고</th></tr></thead><tbody><tr><td>마일리지</td><td>구매나 이용 등의 활동에 따라 적립되거나 사용할 수 있는 포인트 시스템을 의미합니다. 고객들이 특정 상품을 구매 및 리뷰를 남기는 등 쇼핑몰 내 서비스를 이용할 때 얻을 수 있는 일종의 보상 혹은 혜택을 의미합니다.</td><td></td></tr></tbody></table>

## 기타 참고사항

* 적립구분에 따른 적립금 계산
  * 기본 적립, 고객등급별 추가 적립, 프로모션 적립 세 가지 정보에 따라 적립금이 계산됩니다. 기본적립은 상품테이블 속성에 마일리지적립가능여부(milg\_rsrv\_psb\_yn)를 보고 판단하여 계산합니다.

### 주문에서 적립되는 마일리지 관리방법

| 적립구분        | 적립항목                               | 적립대상  | 적립율   | 적립일자     | 소멸       | 적립한도      | 비고                          |
| ----------- | ---------------------------------- | ----- | ----- | -------- | -------- | --------- | --------------------------- |
| 적용율         | 기준금액                               | 주문소멸  | 자동소멸  |          |          |           |                             |
| 주문적립        | 기본적립                               | N/A   | 별도관리  | 주문금액기준   | 배송완료+14일 | 반품        | <p>적립일자 기준1년<br>배송비 미포함</p> |
| 고객등급 별 추가적립 | GREEN / FAMILY / GOLD / VIP / VVIP | 별도관리  |       |          |          |           |                             |
| 프로모션 적립     | 프로모션                               | 입력값기준 | 입력값기준 | 배송완료+14일 |          | 적립일자기준30일 |                             |

|          | 기본 적립                   | 고객 등급 추가 적립                       | 프로모션 적립           |
| -------- | ----------------------- | --------------------------------- | ----------------- |
| 적립 대상 금액 | 할인 후 금액                 | 할인 후 금액                           | 할인 후 금액           |
| 적립 기준 금액 | N/A                     | ET\_MILG\_STD\_INFO 테이블에서 등급별로 관리 | N/A               |
| 적립율 관리   | ET\_MILG\_STD\_INFO 테이블 | ET\_MILG\_STD\_INFO 테이블           | 프로모션 정보           |
| 대상 상품    | 전체                      | 전체                                | 적용/제외 조건에 부합하는 상품 |

##