가격/재고/판매상태 수정 API

Description

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

상품 가격 / 본품 재고 / 판매상태만 수정하는 API입니다. 상품 등록 API 호출하고 정상 등록 처리 시간(약 3분) 이후 변경할 수 있습니다.

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까지 입력 가능함 * 옵션 등록 시 옵션재고관리(true)로 선택하면, 본판매수량은 입력해도 무시되고 옵션의 합산 재고로 산정됨
ItemBasicInfo > stock > iac	옥션 재고수량	Y	int	옥션에서 판매할 재고 입력 1~99999까지 입력 가능함 * 옵션 등록 시 옵션재고관리(true)로 선택하면, 본판매수량은 입력해도 무시되고 옵션의 합산 재고로 산정됨
ItemBasicInfo > sellingPeriod > gmkt	G마켓 판매기간	Y	int	G마켓에서 판매할 기간 입력 기간 만료시 판매중지되고 상품 수정시 연장 필요 아래 기간 호출 시 호출 시점부터 기간만큼 연장 입력 가능 기간 : -1 (무제한), 0, 15, 30, 60, 90, 365 * 수정(PUT) 시 판매기간을 0으로 입력하면 기존 판매기간 유지 * 조회(GET) 시 판매종료일 조회 (YYYYMMDD) * ESM+ 판매기간 노출 (Beta) 상품 조회/수정 : 설정안함 상품관리2.0 : 9999-12-31 (365일+)
ItemBasicInfo > sellingPeriod > iac	옥션 판매기간	Y	int	옥션에서 판매할 기간 입력 기간 만료시 판매중지되고 상품 수정시 연장 필요 아래 기간 호출 시 호출 시점부터 기간만큼 연장 입력 가능 기간 : -1 (무제한), 0, 15, 30, 60, 90, 365 * 수정(PUT) 시 판매기간을 0으로 입력하면 기존 판매기간 유지 * 조회(GET) 시 판매종료일 조회 (YYYYMMDD) * ESM+ 판매기간 노출 (Beta) 상품 조회/수정 : 설정안함 상품관리2.0 : 9999-12-31 (365일+)

수정
{
  "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://sa2.esmplus.com/item/v1/goods/1158387297/sell-status

Sample - 수정
{
  "isSell": {
    "gmkt": true,
    "iac": false
  },
  "itemBasicInfo": {
    "price": {
      "gmkt": 80000,
      "iac": 0
    },
    "stock": {
      "gmkt": 100,
      "iac": 0
    },
    "sellingPeriod": {
      "gmkt": 60,
      "iac": 0
    }
  }
}

 

Response Description

항목	항목명	Type	Description
goodsNo	마스터상품번호	int	조회 시 내려가는 정보 성공 시, 적용된 상품번호 Return
isSell > gmkt	G마켓 판매여부	boolean	조회 시 내려가는 정보
isSell > iac	옥션 판매여부	boolean	조회 시 내려가는 정보
itemBasicInfo > Price > Gmkt	G마켓 판매가격	number	조회 시 내려가는 정보
itemBasicInfo > Price > Iac	옥션 판매가격	number	조회 시 내려가는 정보
itemBasicInfo > Stock > Gmkt	G마켓 재고	int	조회 시 내려가는 정보
itemBasicInfo > Stock > Iac	옥션 재고	int	조회 시 내려가는 정보
itemBasicInfo > SellingPeriod > Gmkt	G마켓 판매기간	int	조회 시 내려가는 정보
itemBasicInfo > SellingPeriod > Iac	옥션 판매기간	int	조회 시 내려가는 정보
resultCode	결과코드	int	실패 시 내려가는 정보
message	메시지	string	실패 시 내려가는 정보
data	데이터	object	실패 시 내려가는 정보

 JSON_Success

{
  "goodsNo": 0,
  "resultCode": 0,
  "message": null
}

JSON_Fail

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

Sample Code_Success

수정
{
    "goodsNo": 2035313538,
    "resultCode": 0,
    "message": null
}

조회
{
  "IsSell":{
   "gmkt":true,
   "iac":true
     },
  "itemBasicInfo":{
   "Price":{
     "gmkt":10000.0,
     "iac":10000.0
     },
  "Stock":{
     "gmkt":99999,
     "iac":120
     },
  "SellingPeriod":{
     "gmkt":20190328,
     "iac":20190328
     }
   }
}

Sample Code_Fail

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

 

Error Code

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