프로모션 할인

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

주요 기능

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

프로세스 정의

번호	구분	설명

번호	구분	설명
1	주문서 쿠폰 목록 조회	주문서 페이지에서 회원이 보유하고 있는 쿠폰 목록을 조회합니다.
2	쿠폰 기본 정보 조회	이벤트 유형 중 쿠폰다운로드 이벤트 시, 해당 쿠폰 기본 정보를 조회합니다.
3	회원 별 쿠폰 건수 조회	회원이 보유하고 있는 쿠폰 중 무료배송쿠폰 수량과 일반쿠폰의 수량을 각각 조회 합니다.
4	상품 별 즉시 할인가 조회	상품별 사용 가능한 상품즉시할인가를 조회합니다.
5	상품상세 최대혜택가 조회	상품상세 페이지에서 해당 상품의 최대 혜택가를 조회합니다.
6	주문서 쿠폰 사용 처리	주문 및 클레임 처리 시 선택한 쿠폰을 사용처리 합니다.
7	주문서 최대 혜택가 조회	장바구니, 주문, 클레임 처리 시 회원이 받을 수 있는 최대혜택금액 및 사용 가능한 할인 정보를 조회합니다.
8	주문서 배송비 쿠폰 조회	주문 및 클레임 처리 시 무료배송 및 무료반품 쿠폰 목록을 조회합니다.
9	쿠폰 취소/복원	클레임 처리 시 사용했던 쿠폰을 미사용 쿠폰으로 상태를 변경합니다.
10	사용 가능 혜택 정보 조회	해당 로직은 서비스 단위 검증 및 계산 로직으로, 기능개요 [프로모션 검증] 중 ’업무 프로세스 정의’를 참고 해 주세요.

API 기능 목록

API	설명	Server	메소드	비고

API	설명	Server	메소드	비고
회원별 쿠폰 건수 조회	회원이 보유한 쿠폰의 개수를 유형별로 조회합니다. 일반쿠폰과 무료배송쿠폰의 개수를 조회합니다.	Order	GET	🔗API 확인하기>
주문서 쿠폰 목록 조회	주문서 내 회원이 보유한 쿠폰 및 할인 정보를 조회합니다.	Order	POST	🔗API 확인하기> 임직원 할인 한도 조회: /api/member/v1/staff/getDsctLmtStat
상품상세 최대혜택가조회	상품상세 페이지 내 최대혜택가를 조회합니다.	Order	POST	🔗API 확인하기> 임직원 할인 한도 조회: /api/member/v1/staff/getDsctLmtStat
쿠폰 기본 정보 조회	이벤트 유형 중 쿠폰 다운로드 유형일 때, 발급되는 쿠폰의 정보를 조회합니다.	Order	GET	🔗API 확인하기>
상품별 즉시할인가 조회	상품별 사용 가능한 상품즉시할인가를 조회합니다.	Order	POST	🔗API 확인하기> 할인&path=getGoodsDirectDiscountInfo
주문서 쿠폰 사용 처리	주문 시 선택한 쿠폰을 사용 처리 하여 상품 가격 및 배송비 혜택을 적용합니다.	Order	POST	🔗API 확인하기>
쿠폰 취소/복원	클레임 처리를 통해 주문이 취소 된 경우 기존 주문 시 사용되었던 쿠폰을 취소 처리하여 복원합니다.	Order	POST	🔗API 확인하기>
주문서 최대혜택가 조회	장바구니, 주문서, 클레임 처리 시 해당 주문건에 대한 최대혜택가를 조회합니다.	Order	POST	🔗API 확인하기> 임직원 할인 한도 조회: /api/member/v1/staff/getDsctLmtStat
주문서 배송비 쿠폰 조회	주문 및 클레임 처리 시 회원이 보유한 무료배송쿠폰 혹은 무료반품 쿠폰을 조회합니다.	Order	POST	🔗API 확인하기>

용어 정의

명칭	설명	비고

명칭	설명	비고
할인	판매가 할인, 임직원 할인, 상품즉시 할인
쿠폰	상품쿠폰, 중복쿠폰, 장바구니쿠폰, 배송비 및 반품비 쿠폰

기타 참고사항

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

구분	1차 할인	2차 할인			3차 할인

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

최대혜택 정책

	상품상세	장바구니	주문서

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