판매자할인 관리 API

Description

등록/수정 : [POST] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/seller-discounts 해제 : [DELETE] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/seller-discounts 조회 : [GET] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/seller-discounts

사이트별 판매자부담 할인 금액을 정율/정액으로 설정할 수 있습니다.

Request Description

항목	항목명	필수여부	Type	Description
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로 호출 Ex.  (O) "iac": {      "type": "0",      "priceOrRate1": 0 } (X) "iac": {      "type": "0",      "priceOrRate1": 0,      "priceOrRate2": 0,      "startDate": "2018-06-21T03:12:47.461Z",      "endDate": "2018-06-30T03:12:47.461Z" }
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
{
  "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://sa2.esmplus.com/item/v1/goods/1158387297/seller-discounts

Sample
{
  "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

항목	항목명	Type	Description
goodsNo	마스터상품번호	int	조회 시 내려가는 정보
resultCode	결과코드	int	실패 시 내려가는 정보
message	메시지	string	실패 시 내려가는 정보

 JSON_Success

등록/수정/해제
{
  "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"
    }
  }
}

JSON_Fail

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

Sample Code_Success

등록/수정/해제
{
  "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"
    }
  }
}

Sample Code_Fail

{
  "resultCode":1000,
  "message":"판매자 부담할인이 등록 되어 있지 않습니다."
}

 

Error Code

결과코드	메시지	원인
1000	판매자 부담할인이 등록 되어 있지 않습니다	판매자부담할인 조회 시, 할인이 등록된 상품이 아닐 경우
1000	상품 번호가 잘 못 되었습니다 (GoodsMaster)	조회하고자 하는 상품번호가 존재하지 않거나 잘 못 되었을 경우
1000	판매자 즉시할인 값은 판매가의 70%까지만 입력가능합니다.	할인 비율 70% 초과 할 때 발생