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

# 할인

쇼핑몰에서는 소비자가 혜택을 받을 수 있는 코드나 쿠폰을 제공하고, 이를 활용하여 상품을 할인된 가격에 구매할 수 있습니다. 쿠폰은 일반 할인 쿠폰과 무료배송 쿠폰 두 가지로 제공되며, 이러한 혜택은 소비자들의 관심을 유도하고 더 많은 구매를 유도하는 마케팅 수단으로 활용됩니다.

### 주요 기능

* 쿠폰 및 할인 적용
  * 회원은 쇼핑몰에서 제공하는 다양한 쿠폰 및 할인을 활용하여 상품을 구매할 수 있습니다.
* 다양한 쿠폰 및 프로모션
  * 다양한 종류의 쿠폰 및 프로모션을 쇼핑몰에서 제공하여 회원에게 많은 할인 혜택을 제공합니다.
* 할인 유형
  * 할인 혜택을 적용할 때 정액 혜택과 정률 혜택 두 가지 유형이 제공됩니다.
* 마진 체크
  * 할인 혜택을 적용할 때 마진 체크를 통해 공급원가보다 큰 할인 혜택 적용을 제한하여 자사 상품의 손해를 최소화합니다.

### 프로세스 정의

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

{% stepper %}
{% step %}

### 주문서 쿠폰 목록 조회

주문서 페이지에서 회원이 보유하고 있는 쿠폰 목록을 조회합니다.
{% endstep %}

{% step %}

### 쿠폰 기본 정보 조회

이벤트 유형 중 쿠폰다운로드 이벤트 시, 해당 쿠폰 기본 정보를 조회합니다.
{% endstep %}

{% step %}

### 회원 별 쿠폰 건수 조회

회원이 보유하고 있는 쿠폰 중 무료배송쿠폰 수량과 일반쿠폰의 수량을 각각 조회합니다.
{% endstep %}

{% step %}

### 상품 별 즉시 할인가 조회

상품별 사용 가능한 상품즉시할인가를 조회합니다.
{% endstep %}

{% step %}

### 상품상세 최대혜택가 조회

상품상세 페이지에서 해당 상품의 최대 혜택가를 조회합니다.
{% endstep %}

{% step %}

### 주문서 쿠폰 사용 처리

주문 및 클레임 처리 시 선택한 쿠폰을 사용처리 합니다.
{% endstep %}

{% step %}

### 주문서 최대 혜택가 조회

장바구니, 주문, 클레임 처리 시 회원이 받을 수 있는 최대혜택금액 및 사용 가능한 할인 정보를 조회합니다.
{% endstep %}

{% step %}

### 주문서 배송비 쿠폰 조회

주문 및 클레임 처리 시 무료배송 및 무료반품 쿠폰 목록을 조회합니다.
{% endstep %}

{% step %}

### 쿠폰 취소/복원

클레임 처리 시 사용했던 쿠폰을 미사용 쿠폰으로 상태를 변경합니다.
{% endstep %}

{% step %}

### 사용 가능 혜택 정보 조회

해당 로직은 서비스 단위 검증 및 계산 로직으로, 기능개요 \[프로모션 검증] 중 ’업무 프로세스 정의’를 참고 해 주세요.
{% endstep %}
{% endstepper %}

### API 기능 목록

<table><thead><tr><th width="122.333251953125">API</th><th width="360.4444580078125">설명</th><th width="94.666748046875">Server</th><th width="93.5555419921875">메소드</th><th>비고</th></tr></thead><tbody><tr><td>회원별 쿠폰 건수 조회</td><td>회원이 보유한 쿠폰의 개수를 유형별로 조회합니다. 일반쿠폰과 무료배송쿠폰의 개수를 조회합니다.</td><td>Order</td><td>GET</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%ED%95%A0%EC%9D%B8&#x26;path=getMbrCpnCnt">🔗API 확인하기></a></td></tr><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%ED%95%A0%EC%9D%B8&#x26;path=getCouponPopupData">🔗API 확인하기></a> 임직원 할인 한도 조회: /api/member/v1/staff/getDsctLmtStat</td></tr><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%ED%95%A0%EC%9D%B8&#x26;path=getGoodsMaxBenefit">🔗API 확인하기></a> 임직원 할인 한도 조회: /api/member/v1/staff/getDsctLmtStat</td></tr><tr><td>쿠폰 기본 정보 조회</td><td>이벤트 유형 중 쿠폰 다운로드 유형일 때, 발급되는 쿠폰의 정보를 조회합니다.</td><td>Order</td><td>GET</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%ED%95%A0%EC%9D%B8&#x26;path=getCouponInfo">🔗API 확인하기></a></td></tr><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%ED%95%A0%EC%9D%B8&#x26;path=getGoodsDirectDiscountInfo">🔗API 확인하기></a> 할인&#x26;path=getGoodsDirectDiscountInfo</td></tr><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%ED%95%A0%EC%9D%B8&#x26;path=useCpn">🔗API 확인하기></a></td></tr><tr><td>쿠폰 취소/<br>복원</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%ED%95%A0%EC%9D%B8&#x26;path=cnclCpn">🔗API 확인하기></a></td></tr><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%ED%95%A0%EC%9D%B8&#x26;path=getBenefitInfo">🔗API 확인하기></a> 임직원 할인 한도 조회: /api/member/v1/staff/getDsctLmtStat</td></tr><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%ED%95%A0%EC%9D%B8&#x26;path=getDlvBenefitInfo">🔗API 확인하기></a></td></tr></tbody></table>

### 용어 정의

<table><thead><tr><th width="80.6666259765625">명칭</th><th>설명</th><th data-hidden>비고</th></tr></thead><tbody><tr><td>할인</td><td>판매가 할인, 임직원 할인, 상품즉시 할인</td><td></td></tr><tr><td>쿠폰</td><td>상품쿠폰, 중복쿠폰, 장바구니쿠폰, 배송비 및 반품비 쿠폰</td><td></td></tr></tbody></table>

### 기타 참고사항

* **상품별 즉시할인가 조회 API**
  * 현재 해당 API는 상품 API에서 호출하고 있으나, 상품 API가 사용되지 않고 있습니다.
* **혜택**
  * 차수 별 적용 가능한 혜택을 정률 또는 정액 혜택에 따라 계산합니다.
  * 혜택 적용은 총 세 번의 차수로 적용되며, 차수 당 한 개의 쿠폰 및 할인 혜택을 받을 수 있습니다.
  * 자사의 손실을 방지하기 위해 혜택 적용 시 상품의 공급원가보다 저렴한 경우, 쿠폰 및 할인 혜택이 제한됩니다.
* **쿠폰 및 할인 정책**

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

* 최대혜택 정책

<table data-full-width="true"><thead><tr><th align="center"></th><th>상품상세</th><th>장바구니</th><th>주문서</th></tr></thead><tbody><tr><td align="center"><strong>사용 가능 할인 종류</strong></td><td>상품할인쿠폰, 상품즉시 할인, 임직원 할인</td><td>상품할인쿠폰, 상품즉시 할인, 임직원 할인</td><td>상품할인쿠폰, 상품즉시 할인, 임직원 할인, 중복할인쿠폰, 장바구니 쿠폰</td></tr><tr><td align="center"><strong>대상</strong></td><td>회원/비회원(상품즉시할인 만)</td><td>회원</td><td>회원</td></tr><tr><td align="center"><strong>특이사항</strong></td><td>고객이 <strong>다운로드 받지 않았지만</strong>, <strong>다운로드 가능한 상품할인 쿠폰이 존재</strong> 하는 경우, <strong>해당 쿠폰을 최대 혜택 계산에 포함</strong>한다. 비회원인 경우 상품즉시할인은 적용회원등급이 전부 선택된 할인만 노출한다.</td><td></td><td></td></tr></tbody></table>