> 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.md).

# 할인/마일리지 관리

할인/마일리지 관리 서비스는 상품 즉시 할인, 상품 마일리지, 그리고 임직원할인과 같은 다양한 혜택을 효율적으로 등록하고 관리하는 서비스입니다. 이 서비스를 통해 프로모션 관리자는 세부 조건을 설정하여 유연하게 혜택을 조절하고, 이용자에게 다양한 혜택을 제공할 수 있습니다. 임직원할인 혜택을 통해 직원들의 충성도와 만족도를 높이며, 회사 제품에 대한 이해도와 홍보에도 도움을 줄 수 있습니다.

***

## 주요 기능

* **할인 혜택**
  * 상품 가격에 정률로 할인을 적용하여 손실을 최소화합니다.
  * 원가 확인을 통해 역마진 여부를 신속하게 판단합니다.
* **마일리지 혜택**
  * 상품 구매 시 일정 비율의 마일리지를 적립하여 고객 유도를 증진시킵니다.
  * 할인 및 마일리지 유형을 유연하게 설정하여 혜택을 다양하게 조절합니다.
* **임직원할인**
  * 회사 내 임직원에게 할인을 제공하여 충성도와 만족도를 높이고 홍보에 기여합니다.
  * 할인 비율 설정과 세부 조건을 통한 효과적인 서비스 관리를 지원합니다.

## 프로세스 정의

<figure><img src="/files/2wTCHPRc9ogVoCjEckVR" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 할인/마일리지 조회

등록된 할인/마일리지 혜택 목록 및 개수를 조회합니다.
{% endstep %}

{% step %}

### 혜택 역마진 체크

할인/마일리지 혜택 신규 등록 시, 상품 즉시할인 또는 임직원 할인 혜택은 역마진 체크를 통해 공급원가를 조회하여 회사의 손실을 최소화 합니다.
{% endstep %}

{% step %}

### 할인/마일리지 상세조회

등록된 할인/마일리지 혜택의 상세 정보를 조회합니다.
{% endstep %}

{% step %}

### 할인/마일리지 등록

신규 등록 또는 등록된 할인/마일리지 혜택을 저장 및 수정 합니다.
{% endstep %}

{% step %}

### 다국어 조회

할인/마일리지 혜택의 다국어 등록 정보를 조회합니다.
{% endstep %}

{% step %}

### 다국어 등록

할인/마일리지 혜택의 다국어 정보를 등록합니다.
{% endstep %}
{% endstepper %}

## API 기능 목록

<table><thead><tr><th width="139" align="center">API</th><th width="334.22216796875" align="center">설명</th><th width="95.7777099609375">Server</th><th width="89.111083984375">메소드</th><th align="center">비고</th></tr></thead><tbody><tr><td align="center">할인/마일리지 목록 조회</td><td align="center">조건을 이용하여, 등록된 할인 및 마일리지 혜택을 조회합니다.</td><td>BO</td><td>GET</td><td align="center"><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=getPromotionManagingList">🔗API 확인하기 ></a></td></tr><tr><td align="center">할인/마일리지 목록 개수 조회</td><td align="center">조건을 이용하여, 등록된 할인 및 마일리지 혜택의 전체 개수를 조회합니다.</td><td>BO</td><td>GET</td><td align="center"><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=getPromotionManagingListCount">🔗API 확인하기 ></a></td></tr><tr><td align="center">공통코드 조회</td><td align="center">할인/마일리지 조회 시 조회 조건 중 할인/마일리지 유형 공통 코드를 조회합니다.</td><td>BO</td><td>GET</td><td align="center"><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=getPromotionManagingList">🔗API 확인하기 ></a></td></tr><tr><td align="center">할인/마일리지 상세 화면 호출</td><td align="center">등록된 할인 및 마일리지 상세 정보를 조회합니다.</td><td>BO</td><td>GET</td><td align="center"><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=getPromotion">🔗API 확인하기 ></a></td></tr><tr><td align="center">혜택 등록 시 <br>역마진 상품 <br>체크</td><td align="center">할인/마일리지 혜택 등록 시, 상품즉시할인 또는 임직원 할인 유형의 경우 상품의 공급원가를 조회하여 역마진을 체크합니다.</td><td>BO</td><td>POST</td><td align="center"><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=getOverMrgnGoods">🔗API 확인하기 ></a></td></tr><tr><td align="center">할인/마일리지 등록 및 <br>업데이트</td><td align="center">등록된 할인/마일리지 혜택의 정보를 신규 등록 또는 수정 합니다.</td><td>BO</td><td>POST</td><td align="center"><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=cudPromotion">🔗API 확인하기 ></a></td></tr><tr><td align="center">프로모션 <br>다국어 정보<br>조회</td><td align="center">할인/마일리지 혜택의 다국어 정보를 조회합니다.</td><td>BO</td><td>GET</td><td align="center"><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=getMultilingualInfo">🔗API 확인하기 ></a></td></tr><tr><td align="center">프로모션 <br>다국어 등록</td><td align="center">할인/마일리지 혜택의 다국어 정보를 등록합니다.</td><td>BO</td><td>POST</td><td align="center"><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=saveMultilingualInfo">🔗API 확인하기 ></a></td></tr></tbody></table>

## 용어 정의

<table><thead><tr><th width="106.7777099609375" align="center">명칭</th><th>설명</th><th data-hidden align="center">비고</th></tr></thead><tbody><tr><td align="center">할인유형 (정률)</td><td>상품 구매 시 해당 상품의 가격에 일정 비율 만큼을 할인 및 적립해주는 혜택입니다. <br>이 할인/마일리지 유형에 따라 할인 또는 마일리지 적립을 통해 실구매가 혹은 적립에 의한 체감 금액이 변동됩니다. <br>정률 방식은 상품의 가격에 따라 실 구매 금액이 상대적으로 변동하기 때문에 상품의 <br>가격이 높을수록 혜택 받는 금액도 그에 따라 더 커질 수 있습니다.</td><td align="center"></td></tr></tbody></table>

## 기타 참고사항

* 역마진
  * 상품의 판매 가격에서 혜택을 적용한 금액을 뺀 것이 상품의 공급원가보다 크거나 같아서, 제품을 판매하더라도 손실이 발생하는 경우를 말합니다.
  * 상품 즉시 할인이나 임직원 할인 혜택의 경우에는 역마진을 반드시 확인해야 합니다.
* **마일리지 정책**

<table><thead><tr><th width="102.4443359375" align="center">적립구분</th><th align="center">적립항목</th><th width="152.4444580078125" align="center">적립대상</th><th align="center">적립율</th><th width="142.4444580078125" align="center"></th><th align="center">적립일자</th><th align="center">소멸</th><th align="center"></th><th align="center">적립한도</th><th align="center">비고</th></tr></thead><tbody><tr><td align="center"></td><td align="center"></td><td align="center"></td><td align="center"><strong>적용율</strong></td><td align="center"><strong>기준금액</strong></td><td align="center"></td><td align="center"><strong>주문소멸</strong></td><td align="center"><strong>자동소멸</strong></td><td align="center"></td><td align="center"></td></tr><tr><td align="center">주문적립</td><td align="center">기본적립</td><td align="center">N/A</td><td align="center">별도관리</td><td align="center">주문금액기준</td><td align="center">배송완료+14일</td><td align="center">반품</td><td align="center">적립일자 기준1년</td><td align="center">N/A</td><td align="center">배송비 미포함</td></tr><tr><td align="center"></td><td align="center">고객등급별 추가적립</td><td align="center">GREEN/FAMILY/GOLD/VIP/VVIP</td><td align="center">별도관리</td><td align="center"></td><td align="center"></td><td align="center"></td><td align="center"></td><td align="center"></td><td align="center"></td></tr><tr><td align="center"></td><td align="center">프로모션 적립</td><td align="center">프로모션</td><td align="center">입력값기준</td><td align="center">입력값기준</td><td align="center">배송완료+14일</td><td align="center">　</td><td align="center">적립일자 기준30일</td><td align="center"></td><td align="center"></td></tr></tbody></table>

* **쿠폰 및 할인 정책**

<table><thead><tr><th width="102.4443359375" align="center">구분</th><th align="center">1차 할인</th><th align="center">2차 할인</th><th align="center"></th><th align="center"></th><th align="center">3차 할인</th><th align="center"></th></tr></thead><tbody><tr><td align="center"><strong>종류</strong></td><td align="center">판매가할인(단품할인)</td><td align="center">상품할인쿠폰</td><td align="center">임직원할인</td><td align="center">상품즉시할인</td><td align="center">중복할인쿠폰</td><td align="center">장바구니쿠폰</td></tr><tr><td align="center"><strong>할인유형</strong></td><td align="center">정액</td><td align="center">정액/정률</td><td align="center">정률</td><td align="center">정률</td><td align="center">정액/정률</td><td align="center">정액/정률</td></tr><tr><td align="center"><strong>성격</strong></td><td align="center">상품 등록시 설정</td><td align="center">동일 차수 내에서는 다른 할인 유형 선택 불가(동시사용불가) (예 : 2차 상품 쿠폰 + 임직원 할인 사용 불가) 최대혜택가 계산시 금액이 큰 경우 우선적용 금액 동일 시 상품즉시할인->상품할인쿠폰->임직원할인 순으로 적용</td><td align="center"></td><td align="center"></td><td align="center">동일 차수 내에서는 다른 할인유형 선택 불가(동시사용불가) 3차 할인 단독 사용 가능. 최대혜택가 계산시 금액 큰 경우 우선 적용 금액 동일 시 쿠폰유효기간 마감일 순으로 적용</td><td align="center"></td></tr><tr><td align="center"><strong>계산기준금액</strong></td><td align="center">판매가</td><td align="center">1차 할인 적용가</td><td align="center"></td><td align="center"></td><td align="center">2차 할인 적용가</td><td align="center"></td></tr><tr><td align="center"><strong>최소 구매 기준</strong></td><td align="center">N/A</td><td align="center">수량 : 1 개 고정<br>금액 : 상품 1개의 판매가</td><td align="center">N/A</td><td align="center">N/A</td><td align="center">수량 : 1 개 고정<br>금액 : 상품 1개의 판매가</td><td align="center">수량 : 적용 가능 상품의 합<br>금액 : 적용 가능 상품의 할인 후 금액의 합(이전차수)</td></tr><tr><td align="center"><strong>적용 기준</strong></td><td align="center">상품 판매가 조정</td><td align="center">상품의 모든 수량에 개별 할인 적용</td><td align="center"></td><td align="center"></td><td align="center"></td><td align="center">적용 가능 상품들의 모든 수량에 할인 적용</td></tr><tr><td align="center"><strong>마진 체크</strong></td><td align="center">상품 등록시</td><td align="center">“공급가 >= 판매가 - 할인금액” 인 경우에만 쿠폰/할인 노출 및 사용 가능</td><td align="center"></td><td align="center"></td><td align="center"></td><td align="center"></td></tr><tr><td align="center"><strong>3차할인 적용 가능여부</strong></td><td align="center">N/A</td><td align="center">O</td><td align="center">X</td><td align="center">O</td><td align="center">N/A</td><td align="center">N/A</td></tr><tr><td align="center"><strong>공통 적용 사항</strong></td><td align="center">N/A</td><td align="center">할인은 1원 단위로 사용이 가능하고, 1원 단위 미만은 반올림 처리를 한다<br>주문의 모든 상품이 배송중 되기 전에 클레임 진행 시에만 프로모션 재계산을 진행한다.<br>0원 결제 방지를 위해 판매가보다 큰 할인 금액의 쿠폰/할인은 사용이 불가능하다.</td><td align="center"></td><td align="center"></td><td align="center"></td><td align="center"></td></tr></tbody></table>