쿠폰발행

쿠폰유형(couponType)을 선언

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

...

쿠폰유형 (couponType)

쿠폰종류 (couponKind)

...

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

상품상세 다운로드가능한 쿠폰 목록 / 임시주문서에서 적용가능한 쿠폰 목록
→ 즉시사용 가능한 쿠폰의 노출 기준….?
네이버는 즉시할인금액을 주문서의 쿠폰할인 내역에서 쿠폰할인인것마냥 보여주고 있음. 최대할인금액을 표현하기 위함이라 함…

발급건수 제한 (issueCountLimit)

...

발급건수 제한 (issueCountLimit)

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

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

...

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

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

...

앞서 적용된 쿠폰 할인가를 차감하여 기준금액 갱신
중복쿠폰 우선 처리 순서 ??

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

다운받은 사용가능한 쿠폰 목록을 조회
각 쿠폰 별로 선택
할인혜택별 계산 순서 정렬

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

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

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

...

취소

재계산

장바구니쿠폰

정액 쿠폰만 존재 하므로

조건 해제 시 쿠폰 사용 취소

X

상품쿠폰

정률 쿠폰이고

조건 유지 되는 경우

배송비 무료 쿠폰

X

...

Coupon API

Download

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

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

Expand

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

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

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

Registration

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

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

Expand

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

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

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

UsableList

Info
POST {{protocol}}://{{hostname}}:{{port}}/svc/coupon/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 : 선택 적용 가능한 쿠폰 리스트

Expand

Code Block

{
    "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": []
            }
        ]
    }
}

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

DownloadableList

Info
POST {{protocol}}://{{hostname}}:{{port}}/svc/coupon/downloadableList

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

Expand

Code Block

{
    "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
        }
    ]
}

Versions Compared

Old Version 4

New Version Current

Key

쿠폰유형 (couponType)

Coupon API

Download

Registration

UsableList

DownloadableList

Page Comparison

Versions Compared

Old Version 4

New Version Current

Key

쿠폰유형 (couponType)

Coupon API

Download

Registration

UsableList

DownloadableList