쿠폰발행

• 쿠폰유형(couponType)을 선언

쿠폰발급

...

• 주문 취소완료, 반품완료 시 사용한 쿠폰이 사용취소 될 수 있다.

• 쿠폰사용취소(복원) 시 사용가능 기준에 따라 다시 주문서에 사용할 수 있다.

  • 유효종료일 < 복원일자 : 기간만료

  • 유효시작일 < 복원일자 < 유효종료일 : 미사용 처리

• 기준

  • 전체 주문 취소완료, 반품완료

  • 부분 주문 취소완료, 반품완료 시 쿠폰사용기준 미달로 쿠폰할인금액이 0이 될 때

...

쿠폰유형 (couponType)

쿠폰종류 (couponKind)

• 상품 쿠폰

  • 하나의 상품 쿠폰은 주문서에서 하나의 주문상품(orderProduct)에 적용 가능

  • 하나의 주문상품(orderProduct)은 중복사용가능한 쿠폰을 2개이상 사용할 수 있다.

    • 앞서 적용된 쿠폰 할인가를 차감하여 기준금액 갱신

  • 중복사용가능한 쿠폰과 아닌 쿠폰을 동시 사용할 수 없다.

  • 상품쿠폰할인금액

    • 정률 : 기준금액 / 100 * 정률

    • 정액 : 기준금액 < 쿠폰할인금액 ? 0 : 쿠폰할인금액

    • 기준금액 = 주문상품의 (총주문금액 = 총판매금액 - 즉시할인 - 쿠폰할인 - 프로모션할인)

• 장바구니 쿠폰

  주문서(orderSheet)에서 하나의 장바구니 쿠폰만 사용 가능

  • 하나의 주문서(orderSheet)에서 장바구니 중복사용가능한 쿠폰을 2개 이상 중복 2개이상 사용할 수 없다있다.

  • 장바구니쿠폰할인금액

    • 정률 : 기준금액 / 100 * 정률설정 불가능

    • 정액 : 기준금액 < 쿠폰할인금액 ? 0 : 쿠폰할인금액

    • 기준금액 = 주문서의 (총주문금액 - 총배송금액)

• 배송비 무료 쿠폰

  • 주문배송비(orderDeliveryFee)에 하나의 배송비 무료 쿠폰만 적용 가능

  • 배송금액 : 0원

...

• true : 사용가능

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

중복사용여부 (duplicateUseduplicated)

• defaultValue : false

• 상품쿠폰 선택 시 적용 가능

발급방법 (couponIssueType)

• 자동지급 (auto)

  • 쿠폰 자동 발급 대상 지정 (specifyCouponTargetautoIssueTarget)

    • 첫구매 : 구매이력이 없는 회원이 구매확정 했을 때 즉시 발급

    • 재구매 : 최근 6개월간 구매이력이 있는 회원 구매확정 했을 때 즉시 발급

    • 직접지정 : 회원 직접 지정하여 즉시 발급

• 다운로드 (download)

• 쿠폰등록 (couponRegistration) : 쿠폰 코드를 선발행 하고, 마이페이지에서 회원이 쿠폰 코드를 입력 인증 받고 발급

• 발급건수 제한 (issueCountLimit) = limit

최대발급건수 (maxIssueCount) 필수

• 타입 (couponRegistrationType)

  • 대표 (representative) : 직접 입력

  • 유일 (unique) :

    • 최대발급건수 만큼 난수코드 발행

• 즉시사용 (immediately)

상품상세 다운로드가능한 쿠폰 목록 / 임시주문서에서 적용가능한 쿠폰 목록

→ 즉시사용 가능한 쿠폰의 노출 기준….?

네이버는 즉시할인금액을 주문서의 쿠폰할인 내역에서 쿠폰할인인것마냥 보여주고 있음. 최대할인금액을 표현하기 위함이라 함…

• • • • . ( yyyyMMdd + hash ) = 18 digits

      • 쿠폰유형 등록할때만 발행된다. 수정시 추가발행할 수 없음.

        • 발급건수 제한 (issueCountLimit) = limit

        • 최대발급건수 (maxIssueCount) 필수

• 즉시사용 (immediately)

발급건수 제한 (issueCountLimit)

• 쿠폰유형에 대하여 총 발급건수 또는 ID당 발급건수를 제한할 수 있다.

• 제한 (limited)

  • 최대발급건수 (maxIssueCount) 설정 가능

  • ID당 발급건수 (idPerIssueCount) 설정 가능, defaultValue = 1

• 무제한 (unlimited)

할인방식 (discountType)

• 정액 (price)

  • 할인금액 (discountPrice) 설정

• 정률 (rate)

  • 할인율 (discountRate) 설정

  • 최대할인금액 (maxDiscountPrice) : 정률인 경우 최대할인금액 제한을 할 수 있다.

    • ex) 할인율 10% 최대할인금액 2000원, 총 주문금액 50000 일때

    • 쿠폰할인금액 50000/100*10 = 5000 → 2000

...

• 쿠폰을 사용할 수 있는 제한 조건

• (총 주문금액 >= 최소주문금액) 이면 쿠폰을 사용할 수 있다.

다운로드 발급 기간 설정

• 다운로드가능시작일 발급가능시작일 (downlodableStartDateissuableStartDate)

• 다운로드가능종료일 발급가능종료일 (downlodableEndDateissuableEndDate)

쿠폰 유효 기준 설정 (validPeriodType)

...

• 플랫폼과 셀러의 비용 배분율 설정

  • 플랫폼 비용배분율 (platformCostBurdenRate)

  • 셀러 비용배분율 (sellerCostBurdenRate)

쿠폰 적용범위

• 적용범위

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

• 쿠폰종류별 설정가능한 적용범위

• 쿠폰을 적용하거나 제외할 수 있는 범위를 지정할 수 있다.

  • 포함된 적용범위 (includedCoverage)

  • 제외된 적용범위 (excludedCoverage)

• 각 적용범위 별로 N개 선택 가능, 최대 1000개 제한된다.

• 최종 적용범위 : included에서 excluded를 뺀 나머지

발급가능한 기준

• couponType.issuable = true & enable = true

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

• couponType.enable = true

• coupon

  • 유효 시작일 <= 지금

  • 유효 종료일 >= 지금

  • 사용여부 = false

상품상세화면에서 …

• 노출기준

임시 주문서에서 쿠폰 할인 적용 팝업

• 노출 기준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 에 따라서 적용가능, 적용불가능한 범위를

• 적용대상에 따라 대상의 정보가 적용범위에 포함 또는 제외 되는지 가려낸다.

주문 취소 & 반품

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

...

Coupon API

Download

• Define

  • 쿠폰유형 ID에 대하여 회원이 다운로드

  • 회원 로그인 사용자만 사용 가능

• parameters

  • id : couponType ID

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

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

{
    "result": "401",
    "resultMessage": "로그인이 필요합니다."
}

Registration

• Define

  • 회원이 쿠폰 코드를 등록하여 쿠폰을 받을 수 있다.

  • 회원 로그인 사용자만 사용 가능

• parameters

  • couponCode : 발급방식이 쿠폰등록인 쿠폰에서 선발행된 쿠폰 코드

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

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

{
    "result": "401",
    "resultMessage": "로그인이 필요합니다."
}

UsableList

• Define

  • 임시주문서에 대하여 사용가능한 쿠폰 리스트를 반환

  • 선택한 쿠폰이 없으면 “최대 혜택 가능한 쿠폰”을 기본으로 선택

  • 회원 로그인 사용자만 조회 가능

• parameters

  • tempOrderSheet : 임시주문서 ID

  • selectedCoupons : 선택한 쿠폰

    • type : 쿠폰 유형

      • cart, product, deliveryFree

    • id : 쿠폰 적용할 대상

      • 임시 주문서 ID, 임시 주문 상품 ID, 임시 주문 합배송 ID

    • coupon : 선택한 쿠폰 ID

  • Code Block
    [ { "type":"cart", "id": "0f594031f61d4f4998f3dcf2e5594f53", "coupon": "210673746"}, { "type":"product", "id": "1342159441", "coupon": "1032521039"}, { "type":"deliveryFree", "id": "1258148033", "coupon": "2028237231"} ]

• 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 : 선택 적용 가능한 쿠폰 리스트

{
    "result": "200",
    "resultMessage": "SUCCESS",
    "item": {
        "count": {
            "owned": 6,
            "usable": 1,
            "selected": 3
        },
        "finalTotalCouponDiscount": 148260,
        "cart": {
            "id": "0f594031f61d4f4998f3dcf2e5594f53",
            "totalOrderPrice": 943500,
            "totalCouponDiscountPrice": 50000,
            "applicationCoupons": [
                {
                    "id": "210673746",
                    "name": "장바구니-다운로드",
                    "discount": "50000원",
                    "duplicated": false,
                    "couponDiscountPrice": 50000
                }
            ],
            "applicableCoupons": []
        },
        "product": [
            {
                "id": "1342159441",
                "totalOrderPrice": 638400,
                "totalCouponDiscountPrice": 95760,
                "applicationCoupons": [
                    {
                        "id": "1032521039",
                        "name": "상품-다운로드",
                        "discount": "15%",
                        "duplicated": false,
                        "couponDiscountPrice": 95760
                    }
                ],
                "applicableCoupons": [
                    {
                        "id": "948578403",
                        "name": "상품-ID당발급건수제한",
                        "discount": "15%",
                        "duplicated": false,
                        "couponDiscountPrice": 95760
                    }
                ]
            },
            {
                "id": "702291891",
                "totalOrderPrice": 305100,
                "totalCouponDiscountPrice": 0,
                "applicationCoupons": [],
                "applicableCoupons": []
            }
        ],
        "deliveryFree": [
            {
                "id": "1258148033",
                "deliveryPrice": 2500,
                "totalOrderPrice": 638400,
                "totalCouponDiscountPrice": 2500,
                "applicationCoupons": [
                    {
                        "id": "2028237231",
                        "name": "배송비무료-다운로드",
                        "duplicated": false,
                        "couponDiscountPrice": 2500
                    }
                ],
                "applicableCoupons": []
            },
            {
                "id": "245162021",
                "deliveryPrice": 2500,
                "totalOrderPrice": 305100,
                "totalCouponDiscountPrice": 0,
                "applicationCoupons": [],
                "applicableCoupons": []
            }
        ]
    }
}

{
    "result": "401",
    "resultMessage": "로그인이 필요합니다."
}

DownloadableList

• Define

  • 기준 데이터에 대하여 다운로드 가능한 쿠폰 리스트 반환

  • 회원/비회원 조회 가능

• parameters

  • siteCategory : 전시 카테고리 ID

  • productCategory : 상품 표준 카테고리 ID

  • brand : 브랜드 코드

  • vendor : 공급사 ID

  • seller : 판매사 ID

  • siteProduct : 전시 상품 ID

  • product : 상품 ID

• Description

  • id : 쿠폰 ID

  • couponKind : 쿠폰 종류

  • name : 쿠폰 이름

  • discount : 할인정보

  • owned : 보유여부 (이미 다운로드)

{
    "result": "200",
    "resultMessage": "SUCCESS",
    "totalCount": 6,
    "items": [
        {
            "id": "122",
            "couponKind": {
                "value": "product",
                "label": "상품쿠폰"
            },
            "name": "상품-할인방식,정액 (50,000)",
            "discount": "50000원",
            "owned": false
        },
        {
            "id": "123",
            "couponKind": {
                "value": "product",
                "label": "상품쿠폰"
            },
            "name": "상품-할인방식,정률 (20%)",
            "discount": "20%",
            "owned": false
        },
        {
            "id": "138",
            "couponKind": {
                "value": "product",
                "label": "상품쿠폰"
            },
            "name": "상품-중복가능4 (3,000)",
            "discount": "3000원",
            "owned": false
        },
        {
            "id": "104",
            "couponKind": {
                "value": "deliveryFree",
                "label": "배송비무료쿠폰"
            },
            "name": "배송비무료-다운로드",
            "owned": true
        },
        {
            "id": "110",
            "couponKind": {
                "value": "product",
                "label": "상품쿠폰"
            },
            "name": "상품-다운로드",
            "discount": "15%",
            "owned": true
        },
        {
            "id": "116",
            "couponKind": {
                "value": "cart",
                "label": "장바구니쿠폰"
            },
            "name": "장바구니-다운로드",
            "discount": "50000원",
            "owned": true
        }
    ]
}