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

# 마일리지 기준정보 관리

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

***

## 프로세스 정의

<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>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>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>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>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>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>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>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>