쿠폰발행

쿠폰유형(couponType)을 선언

쿠폰발급

회원에게 쿠폰이 부여되는 것
쿠폰(coupon)이 생성
회원은 하나의 미사용 쿠폰유형만 갖을 수 있다

발급방법

자동지급
- 조건이 충족할때 시스템에서 회원에게 자동으로 발급한다
- 조건
  - 첫구매 : 구매이력이 없는 회원이 구매확정 했을 때 즉시 발급
  - 재구매 : 최근 6개월간 구매이력이 있는 회원 구매확정 했을 때 즉시 발급
  - 직접지정 : 회원 직접 지정하여 즉시 발급
수동지급
- CS를 통해 관리자가 특정 쿠폰을 회원에게 직접 발급할 수 있다.
다운로드
- 다운로드 가능한 쿠폰을 조회하고 직접 회원이 다운로드 발급을 받는다.
- 다운로드 가능한 시점
  - 상품상세화면
    - 상품기준 적용가능한 쿠폰 목록 조회
  - 쿠폰 목록
    - 전체 이용가능한 쿠폰 목록 조회
  - 주문서
    - 주문서 내 주문상품에 대하여 적용가능한 쿠폰 목록 조회
쿠폰등록
- 마이페이지에서 회원이 쿠폰번호를 입력하여 발급받을 수 있다.
즉시사용
- 발급받지 않은 쿠폰을 주문서에서 즉시사용할 수 있다.
- 주문완료 시 쿠폰발급 및 즉시 사용처리

쿠폰사용

발급받은 쿠폰을 주문서에서 사용할 수 있다.
임시주문서 진입 시 최대할인혜택 가능한 쿠폰을 default 로 지정된다.
- 최대할인혜택의 기준
  - 중복여부 상관없이 각 주문서, 각 주문상품, 각 배송비에 대하여
  - 보유하고 있는 쿠폰 중에 쿠폰할인 폭이 가장 큰 쿠폰 1개씩 만 지정.
중복쿠폰을 사용할 경우 회원이 직접 쿠폰설정에서 조정이 필요하다.
주문완료 시 최종 사용 처리
- 사용한 쿠폰(coupon)의 사용여부, 사용일자, 할인금액 갱신
- 사용한 쿠폰의 쿠폰이력(couponHistory) 추가
- 쿠폰을 사용한 각 위치(주문서,주문상품,주문배송비 정보)에 사용한 쿠폰(usedCoupon)이 생성

쿠폰사용취소(복원)

주문 취소완료, 반품완료 시 사용한 쿠폰이 사용취소 될 수 있다.
쿠폰사용취소(복원) 시 사용가능 기준에 따라 다시 주문서에 사용할 수 있다.
- 유효종료일 < 복원일자 : 기간만료
- 유효시작일 < 복원일자 < 유효종료일 : 미사용 처리
기준
- 전체 주문 취소완료, 반품완료
- 부분 주문 취소완료, 반품완료 시 쿠폰사용기준 미달로 쿠폰할인금액이 0이 될 때

쿠폰유형 (couponType)

쿠폰종류 (couponKind)

상품 쿠폰
- 하나의 상품 쿠폰은 주문서에서 하나의 주문상품(orderProduct)에 적용 가능
- 하나의 주문상품(orderProduct)은 중복사용가능한 쿠폰을 2개이상 사용할 수 있다.
- 중복사용가능한 쿠폰과 아닌 쿠폰을 동시 사용할 수 없다.
- 상품쿠폰할인금액
  - 정률 : 기준금액 / 100 * 정률
  - 정액 : 기준금액 < 쿠폰할인금액 ? 0 : 쿠폰할인금액
  - 기준금액 = 주문상품의 (총주문금액 = 총판매금액 - 즉시할인 - 쿠폰할인 - 프로모션할인)
장바구니 쿠폰
- 하나의 주문서(orderSheet)에서 중복사용가능한 쿠폰을 2개이상 사용할 수 있다.
- 장바구니쿠폰할인금액
  - 정률 설정 불가능
  - 정액 : 기준금액 < 쿠폰할인금액 ? 0 : 쿠폰할인금액
  - 기준금액 = 주문서의 (총주문금액 - 총배송금액)
배송비 무료 쿠폰
- 주문배송비(orderDeliveryFee)에 하나의 배송비 무료 쿠폰만 적용 가능
- 배송금액 : 0원

발급가능여부 (issuable)

true : 발급가능. 다운로드 가능.
false : 발급불가능. 발급중지. 다운로드 불가능. 이미 발급한 쿠폰은 사용 가능.

사용가능여부 (enable)

true : 사용가능
false : 사용불가능(이미 발급한 모든 쿠폰도 모두 사용중지). 발급불가능 (issuable 즉시 false 처리)

중복사용여부 (duplicated)

defaultValue : false
상품쿠폰 선택 시 적용 가능

발급방법 (couponIssueType)

자동지급 (auto)
- 자동 발급 대상 지정 (autoIssueTarget)
  - 첫구매 : 구매이력이 없는 회원이 구매확정 했을 때 즉시 발급
  - 재구매 : 최근 6개월간 구매이력이 있는 회원 구매확정 했을 때 즉시 발급
  - 직접지정 : 회원 직접 지정하여 즉시 발급
다운로드 (download)
쿠폰등록 (couponRegistration) : 쿠폰 코드를 선발행 하고, 마이페이지에서 회원이 쿠폰 코드를 입력 인증 받고 발급
- 타입 (couponRegistrationType)
  - 대표 (representative) : 직접 입력
  - 유일 (unique)
    - 최대발급건수 만큼 난수코드 발행. ( yyyyMMdd + hash ) = 18 digits
    - 쿠폰유형 등록할때만 발행된다. 수정시 추가발행할 수 없음.
      - 발급건수 제한 (issueCountLimit) = limit
      - 최대발급건수 (maxIssueCount) 필수
즉시사용 (immediately)

발급건수 제한 (issueCountLimit)

쿠폰유형에 대하여 총 발급건수 또는 ID당 발급건수를 제한할 수 있다.
제한 (limited)
- 최대발급건수 (maxIssueCount) 설정 가능
- ID당 발급건수 (idPerIssueCount) 설정 가능, defaultValue = 1
무제한 (unlimited)

issueCountLimit	maxIssueCount	idPerIssueCount	발급가능여부

issueCountLimit	maxIssueCount	idPerIssueCount	발급가능여부
unlimited	0	-	o
unlimited	-	0	o
limited	0	-	x
limited	-	0	x
limited	1	0	x
limited	0	1	x
limited	N	N	o

할인방식 (discountType)

정액 (price)
- 할인금액 (discountPrice) 설정
정률 (rate)
- 할인율 (discountRate) 설정
- 최대할인금액 (maxDiscountPrice) : 정률인 경우 최대할인금액 제한을 할 수 있다.
  - ex) 할인율 10% 최대할인금액 2000원, 총 주문금액 50000 일때
  - 쿠폰할인금액 50000/100*10 = 5000 → 2000

최소주문금액 (minOrderPrice)

쿠폰을 사용할 수 있는 제한 조건
(총 주문금액 >= 최소주문금액) 이면 쿠폰을 사용할 수 있다.

발급 기간 설정

발급가능시작일 (issuableStartDate)
발급가능종료일 (issuableEndDate)

쿠폰 유효 기준 설정 (validPeriodType)

발급한 쿠폰의 유효기간 기준
- 기간 (period) : 설정한 유효기간으로 쿠폰 발급
  - 유효시작일 (validStartDate)
  - 유효종료일 (validStartDate)
- 발급일기준 (day) : 쿠폰이 발급될 때 유효기간이 확정된다.
  - 발급일로부터 *일 간 유효 (validDay)
  - 유효시작일 = 쿠폰발급일
  - 유효종료일 = 쿠폰발급일 + N일

비용배분율

플랫폼과 셀러의 비용 배분율 설정
- 플랫폼 비용배분율 (platformCostBurdenRate)
- 셀러 비용배분율 (sellerCostBurdenRate)

쿠폰 적용범위

적용범위
- 전시카테고리, 상품카테고리, 브랜드, 공급사, 판매사, 상품
쿠폰종류별 설정가능한 적용범위

	전시카테고리	상품카테고리	브랜드	공급사	판매사	상품

	전시카테고리	상품카테고리	브랜드	공급사	판매사	상품
장바구니쿠폰	-	-	-	-	-	-
상품쿠폰	o	o	o	o	o	o
배송비쿠폰	-	-	-	o	o	-

쿠폰을 적용하거나 제외할 수 있는 범위를 지정할 수 있다.
- 포함된 적용범위 (includedCoverage)
- 제외된 적용범위 (excludedCoverage)
각 적용범위 별로 N개 선택 가능, 최대 100개 제한된다.

기준금액

장바구니 쿠폰 : 주문서 하위 모든 상품의 총 주문금액 (배송비 제외)
상품 쿠폰 : 상품의 총 주문금액
배송비 무료 쿠폰 : 합배송 하위 상품의 총 주문금액

중복쿠폰 처리 기준

앞서 적용된 쿠폰 할인가를 차감하여 기준금액 갱신
할인혜택별 계산 순서 정렬

정률+정률 : 할인률 큰것부터 적용
정률+정액 : 정률부터 적용
정액+정액 : 할인금액 큰것부터 적용

임시주문서에서 쿠폰의 사용

다운받은 사용가능한 쿠폰 목록을 조회
- 각 쿠폰 별로 선택 가능여부 체크
최초 장바구니쿠폰, 상품별 상품쿠폰, 배송비 쿠폰 별로 각각 1개씩 최대 혜택 가능한 쿠폰이 Default 선택.
중복 쿠폰 설정하고 싶을 때 사용자가 직접 선택 필요
쿠폰 선택 시 즉시 계산.
- 총 할인가 노출
- 선택한 쿠폰으로 나머지 선택가능한 쿠폰의 선택 가능여부 체크

임시주문서에서 쿠폰 선택 가능여부

중복끼리만 중복 사용 가능
총주문금액 < 최소주문금액 : false
총주문금액 < 쿠폰할인금액 : false
상품쿠폰 : 단품 상품 판매가 < 쿠폰할인가 : false
배송비 무료 쿠폰 : 배송금액 = 0 : false

발급 가능한 기준

쿠폰유형 (couponType)
- 발급가능여부 issuable : true
- 사용가능여부 enable : true
- 발급가능 시작일 issuableStartDate <= now
- 발급가능 종료일 issuableEndDate >= now
- 쿠폰유효 기준 설정 validPeriodType이 기간 period 이면
  - 유효 시작일 validStartDate >= now
- 발급건수 제한 issueCountLimit 설정이 제한 limited 이면
  - 최대발급건수 maxIssueCount < 총 쿠폰 발급수량
  - ID당발급건수 idPerIssueCount < 회원의 쿠폰 발급수량

다운로드 가능한 기준

쿠폰유형이 발급 가능하고
발급방법 couponIssueType 이 download 인 쿠폰유형

발급받은 쿠폰의 사용 가능한 기준

쿠폰유형 (couponType)
- 사용가능여부 enable : true
쿠폰 (coupon)
- 유효 시작일 validStartDate <= now
- 유효 종료일 validEndDate >= now
- 사용여부 used = false
- 쿠폰 소유자 customer = 나 자신

발급받은 쿠폰의 적용 가능한 기준

쿠폰유형 (couponType)
- 쿠폰종류 couponKind 에 따라서 적용가능, 적용불가능한 범위를
적용대상에 따라 대상의 정보가 적용범위에 포함 또는 제외 되는지 가려낸다.

주문 취소 & 반품

클레임 시 사용한 쿠폰에 대한 처리

	취소	재계산

취소

재계산

장바구니쿠폰

정액 쿠폰만 존재 하므로

조건 해제 시 쿠폰 사용 취소

X

상품쿠폰

정률 쿠폰이고

조건 유지 되는 경우

배송비 무료 쿠폰

X

Coupon API

Download

POST {{protocol}}://{{hostname}}:{{port}}/svc/coupon/download

Define
- 쿠폰유형 ID에 대하여 회원이 다운로드
- 회원 로그인 사용자만 사용 가능
parameters
- id : couponType ID

{
    "result": "200",
    "resultMessage": "SUCCESS"
}

{
    "result": "400",
    "resultMessage": "쿠폰을 다운로드할 수 없습니다. : 117"
}

Registration

POST {{protocol}}://{{hostname}}:{{port}}/svc/coupon/registration

Define
- 회원이 쿠폰 코드를 등록하여 쿠폰을 받을 수 있다.
- 회원 로그인 사용자만 사용 가능
parameters
- couponCode : 발급방식이 쿠폰등록인 쿠폰에서 선발행된 쿠폰 코드

UsableList

POST {{protocol}}://{{hostname}}:{{port}}/svc/coupon/usableList

Define
- 임시주문서에 대하여 사용가능한 쿠폰 리스트를 반환
- 선택한 쿠폰이 없으면 “최대 혜택 가능한 쿠폰”을 기본으로 선택
- 회원 로그인 사용자만 조회 가능
parameters
- tempOrderSheet : 임시주문서 ID
- selectedCoupons : 선택한 쿠폰
  - type : 쿠폰 유형
    - cart, product, deliveryFree
  - id : 쿠폰 적용할 대상
    - 임시 주문서 ID, 임시 주문 상품 ID, 임시 주문 합배송 ID
  - coupon : 선택한 쿠폰 ID
Description
- count : 사용가능한 쿠폰 수량
  - owned : 보유 수량
  - usable : 사용가능한 수량 (선택한 수량 제외)
  - selected : 선택한 수량
- finalTotalCouponDiscount : 선택한 쿠폰으로 예상되는 총 쿠폰 할인 금액
- cart : 장바구니 쿠폰 영역
  - id : 임시주문서 ID
  - totalOrderPrice : 쿠폰적용 기준 금액 (총 상품 주문 금액)
  - totalCouponDiscountPrice : 예상되는 장바구니 쿠폰 할인 금액
  - applicationCoupons : 선택 적용한 쿠폰 리스트
  - applicableCoupons : 선택 적용 가능한 쿠폰 리스트
- product : 상품 쿠폰 영역
  - id : 임시 주문 상품 ID
  - totalOrderPrice : 쿠폰적용 기준 금액 (상품 주문 금액)
  - totalCouponDiscountPrice : 예상되는 상품 쿠폰 할인 금액
  - applicationCoupons : 선택 적용한 쿠폰 리스트
  - applicableCoupons : 선택 적용 가능한 쿠폰 리스트
- deliveryFree : 배송비 무료 쿠폰 영역
  - id : 임시 주문 합배송 ID
  - totalOrderPrice : 쿠폰적용 기준 금액 (합배송 하위 총 상품 주문 금액)
  - totalCouponDiscountPrice : 예상되는 배송비 무료 쿠폰 할인 금액
  - applicationCoupons : 선택 적용한 쿠폰 리스트
  - applicableCoupons : 선택 적용 가능한 쿠폰 리스트

DownloadableList

Define
- 기준 데이터에 대하여 다운로드 가능한 쿠폰 리스트 반환
- 회원/비회원 조회 가능
parameters
- siteCategory : 전시 카테고리 ID
- productCategory : 상품 표준 카테고리 ID
- brand : 브랜드 코드
- vendor : 공급사 ID
- seller : 판매사 ID
- siteProduct : 전시 상품 ID
- product : 상품 ID
Description
- id : 쿠폰 ID
- couponKind : 쿠폰 종류
- name : 쿠폰 이름
- discount : 할인정보
- owned : 보유여부 (이미 다운로드)

Hannah

Coupons