# 마일리지 적립

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

***

## 주요 기능

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

## 프로세스 정의

<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 테이블           | 프로모션 정보           |
| 대상 상품    | 전체                      | 전체                                | 적용/제외 조건에 부합하는 상품 |

##


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tech.x2bee.com/api-guide/store-front/promotion/undefined-3.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.