지마켓 복수구매할인 API

Description

등록/수정 : [POST] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/customer-benefit/multiple-purchase-discount 해제 : [DELETE] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/customer-benefit/multiple-purchase-discount 조회 : [GET] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/customer-benefit/multiple-purchase-discount

G마켓 상품에 대해 복수 구매할 경우 추가 할인 적용되도록 설정할 수 있습니다. 할인은 구매수량별 할인 또는 N개 구매시 무료 제공 혜택 설정 가능 합니다.

Request Description

항목	항목명	필수여부	Type	Description
goodsNo	마스터상품번호	Y	path
type	할인타입	Y	int	1 : 구매수량별 할인 설정 2 : 구매수량별 무료제공 설정 (주문옵션 사용시 설정 불가)
condition > value	조건>개수	Y	number	숫자입력
condition > unit	조건>단위	Y	int	1 : 개(수량) 2 : 원(금액) type 2일 경우 unit : 1로 고정
discount > value	할인금액/할인율	Y	number	숫자입력 type : 2일 경우 파라미터 삭제후 호출
discount > unit	할인단위	Y	int	1 : % 2 : 원 type : 2일 경우 파라미터 삭제후 호출
startDate	적용시작일자	Y	date	YYYY-MM-DD
endDate	적용종료일자	Y	date	YYYY-MM-DD

JSON
등록/수정
{
  "type": int,
  "condition": {
    "value": 0,
    "unit": int
  },
  "discount": {
    "value": 0,
    "unit": int
  },
  "startDate": "2022-07-01",
  "endDate": "2022-07-01"
}

해제 - URL만 호출/Request Body없음
[DELETE] https://sa2.esmplus.com/item/v1/goods/1139546520/customer-benefit/multiple-purchase-discount

조회 - URL만 호출/Request Body없음
[GET] https://sa2.esmplus.com/item/v1/goods/1139546520/customer-benefit/multiple-purchase-discount

 

Response Description

항목	항목명	Type	Description
goodsNo	마스터상품번호	int	조회 시 내려가는 정보
type	할인타입	int	조회 시 내려가는 정보 1. 구매수량별 할인 설정 2. 구매수량별 무료제공 설정
condition > value	조건>개수	number	조회 시 내려가는 정보
condition > unit	조건>단위	int	조회 시 내려가는 정보 1.개(수량) 2.원(금액) type 2일 경우, unit 1로 고정
discount > value	할인금액/할인율	number	조회 시 내려가는 정보 숫자입력 type : 2일 경우 파라미터 삭제후 호출
discount > unit	할인단위	int	조회 시 내려가는 정보 1 : % 2 : 원 type : 2일 경우 파라미터 삭제후 호출
startDate	적용시작일자	date	조회 시 내려가는 정보 YYYY-MM-DD
endDate	적용종료일자	date	조회 시 내려가는 정보 YYYY-MM-DD
resultCode	결과코드	int	실패 시 내려가는 정보
message	메시지	string	실패 시 내려가는 정보

 

JSON_Success

등록/수정/해제
{
  "goodsNo": 0
}

조회
{
  "type": int,
  "condition": {
    "value": 0,
    "unit": int
  },
  "discount": {
    "value": 0,
    "unit": int
  },
  "startDate": "2022-07-01",
  "endDate": "2022-07-01"
}

JSON_Fail

{
   "resultCode": 0,
   "message": "string"
}

Sample Code_Success

등록/수정/해제
{
  "goodsNo": 1158387297
}

조회
{
    "type": 1,
    "condition": {
        "value": 3000,
        "unit": 2
    },
    "discount": {
        "value": 10,
        "unit": 1
    },
    "startDate": "2018-01-02",
    "endDate": "2018-02-03"
}

Sample Code_Fail

{
  "resultCode":1000,
  "message":"Category is not exist. 오류카테고리코드"
}