3.6 판매자할인 관리 API – ESM Trading API

3.6 판매자할인 관리 API

판매자할인 등록/수정 : [POST] https://sa.esmplus.com/item/v1/goods/{goodsNo}/seller-discounts

판매자할인 해제 : [DELETE] https://sa.esmplus.com/item/v1/goods/{goodsNo}/seller-discounts

판매자할인 조회 : [GET] https://sa.esmplus.com/item/v1/goods/{goodsNo}/seller-discounts

Description
사이트별 판매자부담 할인 금액을 정율/정액으로 설정할 수 있습니다
판매자할인 금액을 설정하면 상품의 판매가에서 꺾인 금액으로 노출됩니다
Request Description
G마켓 / 옥션 상품 동시 관리 시, G마켓 ID & 옥션 ID 토큰으로 사용합니다
G마켓 상품만 관리 시, G마켓 ID의 토큰으로 사용합니다
옥션 상품만 관리 시, 옥션 ID의 토큰으로 사용합니다
항목항목명필수여부TypeDescription
goodsNo 마스터 상품번호 Y path변경하고자 하는 마스터 상품번호 입력
sellerDiscount > isUse판매자할인 사용여부 Y Boolean 상품가격에서 추가로 판매자 할인 적용할 경우 입력
위에 등록한 G판매가격/A판매가격에서 할인 적용됨
true : 할인적용,
false :할인미적용

* 옥션 할인일 경우, 아래 ""gmkt"" Entity대신 ""iac"" 입력
sellerDiscount > gmkt > type(G마켓/옥션용)
할인타입
int 판매자할인 사용여부 true일 경우 필수
0:사용안함,
1:정액,
2:정률
*
type을 0으로 지정 시, 다른 값을 보내지 않거나, null로 호출 ""iac"":
{ ""type"": ""0"", ""priceOrRate1"": 0, ""priceOrRate2"": 0, ""startDate"": ""2018-06-21T03:12:47.461Z"", ""endDate"": ""2018-06-30T03:12:47.461Z"" }
(X)
""iac"":
{ ""type"": ""0"" }
(O)
sellerDiscount > gmkt > priceOrRate1(G마켓/옥션용)
할인액(율)
number 판매자할인 사용여부 true일 경우 필수
최소 100원 이상, 10원단위 입력, 판매가대비 70%까지 허용
sellerDiscount > gmkt > priceOrRate2(G마켓/옥션용)
할인액(율)_SD2
number 권한이 있는 셀러만 사용 가능
최소 100원 이상, 10원단위 입력, 판매가대비 70%까지 허용
sellerDiscount > gmkt > startDate(G마켓/옥션용)
할인시작일자
date 판매자할인 사용여부 true일 경우 필수
입력형식 YYYY-MM-DD 가능 (시간 설정은 현재 제공하지 않음)
sellerDiscount > gmkt > endDate(G마켓/옥션용) 할인종료일자date 판매자할인 사용여부 true일 경우 필수
입력형식 YYYY-MM-DD 가능 (시간 설정은 현재 제공하지 않음)
JSON_수정JSON_해제/조회Sample Code_수정
{
  "sellerDiscount": {
    "isUse": true,
    "gmkt": {
      "type": 0,
      "priceOrRate1": 0,
      "priceOrRate2": 0,
      "startDate": "2019-04-24",
      "endDate": "2019-04-24"
    },
    "iac": {
      "type": 0,
      "priceOrRate1": 0,
      "priceOrRate2": 0,
      "startDate": "2019-04-24",
      "endDate": "2019-04-24"
    }
  }
}

URL만 호출 / Request Body 없음
https://sa.esmplus.com/item/v1/goods/1158387297/seller-discounts

{
  "sellerDiscount": {
    "isUse": true,
    "gmkt": {
      "type": "1",
      "priceOrRate1": 1000,
      "priceOrRate2": 0,
      "startDate": "2019-04-08",
      "endDate": "2020-04-25"
    },
    "iac": {
      "type": "1",
      "priceOrRate1": 1000,
      "priceOrRate2": 0,
      "startDate": "2019-04-08",
      "endDate": "2020-04-25"
    }
  }
}

Response Description
항목항목명TypeDescription
goodsNo 마스터상품번호 int 조회 시 내려가는 정보
resultCode 결과코드 int 실패 시 내려가는 정보
message 메시지 string 실패 시 내려가는 정보
data 데이터 object 실패 시 내려가는 정보
JSON_Success_등록/수정/해제JSON_Success_조회JSON_FailSample Code_Success_등록/수정/해제Sample Code_Success_조회Sample Code_Fail
{
  "goodsNo": 0
}
{
  "sellerDiscount": {
    "isUse": true,
    "gmkt": {
      "type": "Unknown",
      "priceOrRate1": 0,
      "priceOrRate2": 0,
      "startDate": "2019-04-24T00:00:00.000Z",
      "endDate": "2019-04-24T00:00:00.000Z"
    },
    "iac": {
      "type": "Unknown",
      "priceOrRate1": 0,
      "priceOrRate2": 0,
      "startDate": "2019-04-24T00:00:00.000Z",
      "endDate": "2019-04-24T00:00:00.000Z"
    }
  }
}
{
   "ResultCode": 0,
   "Message": "string",
   "Data": {}
}
{
  "goodsNo": 1158387297
}
{
  "sellerDiscount": {
    "isUse": true,
    "gmkt": {
      "type": 2,
      "priceOrRate1": 30,
      "priceOrRate2": 0,
      "startDate": "2018-12-28T00:00:00.000Z",
      "endDate": "2018-12-30T00:00:00.000Z"
    },
    "iac": {
      "type": 2,
      "priceOrRate1": 30,
      "priceOrRate2": 0,
      "startDate": "2018-12-28T00:00:00.000Z",
      "endDate": "2018-12-30T00:00:00.000Z"
    }
  }
}
{
  "ResultCode":1000,
  "Message":"판매자 부담할인이 등록 되어 있지 않습니다.",
  "Data":null
}
Error Code
결과코드메시지원인
1000 판매자 부담할인이 등록 되어 있지 않습니다 < 판매자부담할인 조회 시, 할인이 등록된 상품이 아닐 경우
1000 상품 번호가 잘 못 되었습니다 < < (GoodsMaster) 조회하고자 하는 상품번호가 존재하지 않거나 잘 못 되었을 경우
1000판매자 즉시할인 값은 판매가의 70%까지만 입력가능합니다.할인 비율 70% 초과 할 때 발생