Coupons

Owned by Hannah
Last updated: Feb 25, 2021
7 min read

쿠폰발행

  • 쿠폰유형(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 : 보유여부 (이미 다운로드)