5.1 지마켓 복수구매할인 API – ESM Trading API

5.1 지마켓 복수구매할인 API

등록/수정 : [POST] https://sa.esmplus.com/item/v1/goods/{goodsNo}/customer-benefit/multiple-purchase-discount

해제 : [DELETE] https://sa.esmplus.com/item/v1/goods/{goodsNo}/customer-benefit/multiple-purchase-discount

조회 : [GET] https://sa.esmplus.com/item/v1/goods/{goodsNo}/customer-benefit/multiple-purchase-discount

Description
구매자가 상품을 복수로 구매할 경우 추가 할인 적용되도록 설정할 수 있는 API입니다(G마켓 상품만 가능)
구매수량별 할인 또는 무료배송 혜택을 제공할 수 있습니다
Request Description
G마켓 ID의 토큰으로 사용합니다
항목항목명필수여부TypeDescription
goodsNo마스터상품번호Ypath
type할인타입Yint1 : 구매수량별 할인 설정
2 : 구매수량별 무료제공 설정 (주문옵션 사용시 설정 불가)
condition > value조건>개수Ynumber숫자입력
condition > unit조건>단위 Yint1 : 개(수량)
2 : 원(금액)
type 2일 경우 unit : 1로 고정
discount > value할인금액/할인율Ynumber숫자입력
type : 2일 경우 파라미터 삭제후 호출
discount > unit할인단위Yint1 : %
2 : 원
type : 2일 경우 파라미터 삭제후 호출
startDate적용시작일자YdateYYYY-MM-DD
endDate적용종료일자YdateYYYY-MM-DD
JSON_등록/수정JSON_해제/조회Sample Code_등록/수정
 {
  "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://sa.esmplus.com/item/v1/goods/1139546520/customer-benefit/multiple-purchase-discount

복수구매할인 조회
GET https://sa.esmplus.com/item/v1/goods/1139546520/customer-benefit/multiple-purchase-discount
{
  "type": "1",
  "condition": {
    "value": 4,
    "unit": "1"
  },
  "discount": {
    "value": 700,
    "unit": "2"
  },
  "startDate": "2018-09-17",
  "endDate": "2018-09-23"
}

Response Description
항목항목명TypeDescription
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실패 시 내려가는 정보
data 데이터object실패 시 내려가는 정보
JSON_Success_등록/수정/해제JSON_Success_조회JSON_FailSample Code_Success_등록/수정/해제Sample Code_Success_조회Sample Code_Fail
{
  "goodsNo": 0
}
{
  "type": int,
  "condition": {
    "value": 0,
    "unit": int
  },
  "discount": {
    "value": 0,
    "unit": int
  },
  "startDate": "2022-07-01",
  "endDate": "2022-07-01"
}
{
   "ResultCode": 0,
   "Message": "string",
   "Data": {}
}
{
  "goodsNo": 1158387297
}
{
    "type": 1,
    "condition": {
        "value": 3000,
        "unit": 2
    },
    "discount": {
        "value": 10,
        "unit": 1
    },
    "startDate": "2018-01-02",
    "endDate": "2018-02-03"
}
{
  "ResultCode":1000,
  "Message":"에러메시지.",
  "Data":null
}
Error Code
결과코드메시지원인