스마일배송(3PL) 가격/판매상태 관리 API

Description

가격/판매상태 수정 : [PUT] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/sell-status 가격/판매상태 조회 : [GET] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/sell-status

3PL상품의 가격 / 판매상태만 관리하는 API입니다.

Request Description

항목	항목명	필수여부	Type	Description
goodsNo	마스터 상품번호	Y	path	변경하고자 하는 마스터 상품번호 입력
IsSell > gmkt	(G마켓용) 판매상태 변경	Y	boolean	true : 판매가능 상태로 전환 false : 판매중지 상태로 전환 *중지상태로 1개월 유지할 경우 삭제되며, 판매중지 상태로 정보 호출 시 반영되지 않음
IsSell > iac	(옥션용) 판매상태 변경	Y	boolean	true : 판매가능 상태로 전환 false : 판매중지 상태로 전환 *중지상태로 1개월 유지할 경우 삭제되며, 판매중지 상태로 정보 호출 시 반영되지 않음
itemBasicInfo > Price > gmkt	G마켓 판매가격	Y	number	G마켓에서 판매될 금액 입력(십억이상 입력 불가) 10원단위로 등록 판매자할인 등록 시, 판매가격 기준으로 할인 적용됨
itemBasicInfo > Price > iac	옥션 판매가격	Y	number	옥션에서 판매될 금액 입력(십억이상 입력 불가) 10원단위로 등록 판매자할인 등록 시, 판매가격 기준으로 할인 적용됨
itemBasicInfo > Stock > gmkt	G마켓 재고수량	Y	int	G마켓에서 판매할 재고 입력 1~99999까지 입력 가능 3PL상품은 해당 항목값 입력 필수이나, 연동된 SKU의 재고로 자동 연동됨
itemBasicInfo > Stock > iac	옥션 재고수량	Y	int	옥션에서 판매할 재고 입력 1~99999까지 입력 가능 3PL상품은 해당 항목값 입력 필수이나, 연동된 SKU의 재고로 자동 연동됨
itemBasicInfo > SellingPeriod > gmkt	G마켓 판매기간	Y	int	G마켓에서 판매할 기간 입력 -1: 무제한 3PL상품은 -1: 무제한 만 입력 가능 단, 해당 API GET 조회시, YYYYMMDD 판매종료날짜가 99991231로 내려감
itemBasicInfo > SellingPeriod > iac	옥션 판매기간	Y	int	옥션에서 판매할 기간 입력 -1: 무제한 3PL상품은 -1: 무제한 만 입력 가능 단, 해당 API GET 조회시, YYYYMMDD 판매종료날짜가 99991231로 내려감

JSON
등록/수정
{
  "isSell": {
    "gmkt": true,
    "iac": true
  },
  "itemBasicInfo": {
    "Price": {
      "gmkt": 0,
      "iac": 0
    },
    "Stock": {
      "gmkt": 0,
      "iac": 0
    },
    "SellingPeriod": {
      "gmkt": 0,
      "iac": 0
    }
  }
}

조회
URL만 호출 / Request Body 없음
https://sa.esmplus.com/item/v1/goods/마스터상품번호/sell-status

 

Response Description

항목	항목명	Type	Description
goodsNo	마스터 상품번호	int	조회 시 내려가는 정보 *성공 시, 적용된 상품번호 return
IsSell > gmkt	G마켓 판매상태	boolean	조회 시 내려가는 정보
IsSell > iac	옥션 판매상태	boolean	조회 시 내려가는 정보
itemBasicInfo > Price > gmkt	G마켓 판매가격	money	조회 시 내려가는 정보
itemBasicInfo > Price > iac	옥션 판매가격	money	조회 시 내려가는 정보
itemBasicInfo > Stock > gmkt	G마켓 재고수량	int	조회 시 내려가는 정보
itemBasicInfo > Stock > iac	옥션 재고수량	int	조회 시 내려가는 정보
itemBasicInfo > SellingPeriod > gmkt	G마켓 판매기간	string	조회 시 내려가는 정보 *남은일자 NNNNNNNN(8자리) return
itemBasicInfo > SellingPeriod > iac	옥션 판매기간	string	조회 시 내려가는 정보 *남은일자 NNNNNNNN(8자리) return
ResultCode	결과코드	int	실패 시 내려가는 정보
Message	메시지	string	실패 시 내려가는 정보
Data	데이터	object	실패 시 내려가는 정보

JSON_Success

수정
{
  "goodsNo": 0
}

조회
{
  "IsSell": {
    "gmkt": true,
    "iac": true
  },
  "itemBasicInfo": {
    "Price": {
      "gmkt": 0,
      "iac": 0
    },
    "Stock": {
      "gmkt": 0,
      "iac": 0
    },
    "SellingPeriod": {
      "gmkt": 0,
      "iac": 0
    }
  }
}

JSON_Fail

{
   "ResultCode": 0,
   "Message": "string",
   "Data": {}
}

Sample Code_Success

수정
{
  "goodsNo": 2300092780
}

조회
{
  "IsSell":{
   "gmkt":true,
   "iac":true
     },
  "itemBasicInfo":{
   "Price":{
     "gmkt":10000.0,
     "iac":10000.0
     },
  "Stock":{
     "gmkt":1000,
     "iac":1000
     },
  "SellingPeriod":{
     "gmkt":99991231,
     "iac":99991231
     }
   }
}

Sample Code_Fail

{
  "ResultCode":1000,
  "Message":"[InvalidApiRequestEx][GMKT]0원 금액은 입력하실 수 없습니다.",
  "Data":null
}

Error Code

결과코드	메시지	원인
1000	[InvalidApiRequestEx][GMKT]0원 금액은 입력하실 수 없습니다.	판매금액에 0원을 입력했을 경우