# 마일리지 기준정보 관리

쇼핑 거래 및 이벤트를 통해 지급하는 마일리지의 유형에 따른 기준정보를 등록합니다.

***

## 프로세스 정의

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

{% stepper %}
{% step %}

### 마일리지 기준정보 조회

* 적립구분 : 기본적립율, 고객 등급별 추가적립, 프로모션적립, 상품평 적립, 환불적립, 이벤트적립, 고객보상적립
  {% endstep %}

{% step %}

### 사은행사를 등록 / 수정

* 적립대상 예시:
  * 기본적립율
  * 회원 등급 기본 추가적립(GREEN)
  * 회원 등급 기본 추가적립(FAMILY)
  * 회원 등급 기본 추가적립(GOLD)
  * 회원 등급 기본 추가적립(VIP)
  * 회원 등급 기본 추가적립(VVIP)
  * 프로모션적립
  * 고객보상적립
  * 상품 리뷰적립(첫 상품평)
  * 상품 리뷰적립(일반1회 이상)
  * 상품 리뷰적립(포토+동영상)
  * 환불적립
  * 이벤트적립
* 동작:
  * 1번의 적립구분/적립대상을 기준으로 등록된 기준정보가 있는지 확인하고, 데이터가 존재할 경우 등록되어 있는 기준정보를 가져옵니다.
  * 적립구분의 유형에 따라서 노출되는 화면이 변경됩니다.
  * 적립기준, 소멸기준, 적립한도 데이터 저장 시 변경이력 데이터를 생성하고 저장 또는 수정을 수행합니다.
    {% endstep %}

{% step %}

### 기준정보 조회

* 마일리지 기준상세 정보를 조회합니다.
  {% endstep %}

{% step %}

### 이력 정보 조회

* 마일리지 변경이력 정보를 조회합니다.
  {% endstep %}
  {% endstepper %}

## API 기능 목록

<table><thead><tr><th width="204.5555419921875">API</th><th width="272.77783203125">설명</th><th width="94.6666259765625">Server</th><th width="92.4444580078125">메소드</th><th>비고</th></tr></thead><tbody><tr><td>마일리지 기준정보저장</td><td>마일리지 기준정보를 저장합니다.</td><td>API-BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=saveMilgStdDetail">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 기준정보목록조회</td><td>마일리지 기준정보 목록을 조회합니다.</td><td>API-BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=getMilgStdList">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 기준정보 목록 개수 조회</td><td>마일리지 기준정보 목록의 개수를 조회합니다.</td><td>API-BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=getMilgStdListCount">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 기준정보 조회</td><td>마일리지 기준정보를 조회합니다.</td><td>API-BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=getMilgStdDetail">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 기준정보 등록을 위한 기본정보 조회</td><td>마일리지 기준정보 등록시에 참고를 위한 데이터 조회합니다.</td><td>API-BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=getSaveBasedMilgStdDetail">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 기준정보 변경이력 목록 조회</td><td>마일리지 기준정보 변경이력 조회합니다.</td><td>API-BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=getSaveBasedMilgStdDetail">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 기준정보 변경이력 목록 개수 조회</td><td>마일리지 기준정보 변경이력 목록 개수 조회합니다.</td><td>API-BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=getMilgStdChgHistListCount">🔗API 확인하기 ></a></td></tr></tbody></table>

## 기타 참고사항

* 마일리지 사용 조건은 주문시 10마일리지 이상 사용가능
* **마일리지 기준정보 디폴트 정리**

<table><thead><tr><th width="102.4444580078125" align="center">적립구분</th><th width="91.3333740234375">적립항목</th><th width="153.5555419921875">적립대상</th><th>적립율</th><th></th><th>적립일자</th><th>소멸</th><th></th><th>비고</th></tr></thead><tbody><tr><td align="center"></td><td></td><td></td><td><strong>적용율</strong></td><td><strong>기준금액</strong></td><td></td><td><strong>주문소멸</strong></td><td><strong>자동소멸</strong></td><td></td></tr><tr><td align="center"><strong>주문적립</strong></td><td>기본적립</td><td>N/A</td><td>별도관리</td><td>주문금액기준</td><td>배송완료+14일</td><td>반품</td><td>적립일자기준1년</td><td>배송비미포함</td></tr><tr><td align="center"></td><td>고객등급별 추가적립</td><td>GREEN/FAMILY/GOLD/VIP/VVIP</td><td>별도관리</td><td>주문금액기준</td><td>배송완료+14일</td><td>반품</td><td>적립일자기준1년</td><td>배송비미포함</td></tr><tr><td align="center"></td><td>프로모션 적립</td><td>프로모션</td><td>입력값기준</td><td>주문금액기준</td><td>배송완료+14일</td><td>　</td><td>적립일자기준30일</td><td>배송비미포함</td></tr><tr><td align="center"></td><td>고객보상 적립</td><td>　</td><td>입력값기준</td><td>N/A</td><td>승인시</td><td>　</td><td>적립일자기준30일</td><td>　배송비미포함</td></tr><tr><td align="center"><strong>기타적립</strong></td><td>상품리뷰 적립</td><td>첫상품평</td><td>별도관리</td><td>주문금액기준 00원 이상</td><td>상품리뷰 작성일자+5일</td><td>반품</td><td>적립일자기준1년</td><td>배송완료후 30일까지 작성가능 상품판매종료시 상품리뷰작성및적립불가</td></tr><tr><td align="center"></td><td></td><td>일반</td><td>별도관리</td><td>주문금액기준 00원 이상</td><td>상품리뷰 작성일자+5일</td><td>반품</td><td>적립일자기준1년</td><td></td></tr><tr><td align="center"></td><td></td><td>포토+동영상</td><td>별도관리</td><td>주문금액기준 00원 이상</td><td>상품리뷰 작성일자+5일</td><td>반품</td><td>적립일자기준1년</td><td></td></tr><tr><td align="center"></td><td>환불적립(환불후재적립)</td><td>　</td><td>입력값기준</td><td>N/A</td><td>즉시</td><td>　</td><td>적립일자기준30일</td><td>　</td></tr><tr><td align="center"></td><td>이벤트 적립</td><td>이벤트조건</td><td>입력값기준</td><td>　</td><td>　</td><td>N/A</td><td>적립일자기준30일</td><td>　</td></tr></tbody></table>


---

# 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/back-office/marketing-bo/undefined-2.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.