후원/나눔쇼핑 API

Description

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

지마켓 후원쇼핑 설정하면 ‘후원쇼핑’ 공간에 추가 전시됩니다. 해당 상품이 판매될 때마다 G마켓과 지정한 금액이 사회단체에 기부되어 좋은 일에 쓰입니다. 옥션 나눔쇼핑 설정하면 나눔 금액(판매수량당 50원/VAT 제외)이 옥션 명의로 기부될 수 있도록 약속한 상품을 말합니다. 발생된 후원/나눔쇼핑 금액은 판매자 정산대금에서 그 내역이 이용료에 포함되어 공제금으로 차감됩니다.

Request Description

항목	항목명	필수여부	Type	Description
goodsNo	마스터상품번호	Y	path
gmkt > isUse	후원쇼핑 사용 여부	Y	boolean
gmarket > amount	후원금액	Y	number	100원 이상 등록가능 판매가 80% 까지 설정 가능
gmarket > maxAmount	누적적립한도액	Y	number	10,000원 이상만 등록 가능
gmarket > field	후원분야	Y	int	1 : 아동복지 2 : 여성권익 3 : 환경보호 4 : 국제구호 5 : 소비자권익 6 : 기타 (조회시 99 로 확인 가능)
gmarket > startDate	후원 시작일	Y	string	YYYY-MM-DD 형태로 입력 가능
gmarket > endDate	후원 종료일	Y	string	YYYY-MM-DD 형태로 입력 가능
auction > isUse	나눔쇼핑 사용 여부	Y	boolean
auction > startDate	나눔 시작일	Y	string	YYYY-MM-DD 형태로 입력 가능
auction > endDate	나눔 종료일	Y	string	YYYY-MM-DD 형태로 입력 가능

JSON
등록/수정
{
  "gmarket": {
    "isUse": true,
    "amount": 0,
    "maxAmount": 0,
    "field": int,
    "startDate": "string",
    "endDate": "string"
  },
  "auction": {
    "isUse": true,
    "startDate": "string",
    "endDate": "string"
  }
}

해제 - URL만 호출/Request Body없음
[DELETE] http://sa2.esmplus.com/item/v1/goods/1765352303/customer-benefit/sponsorship

조회 - URL만 호출/Request Body없음
[GET] http://sa2.esmplus.com/item/v1/goods/1765352303/customer-benefit/sponsorship

 

Response Description

항목	항목명	필수여부	Type	Description
goodsNo	마스터상품번호

JSON_Success

등록/수정
{
  "goodsNo": 0
}

조회
{
  "gmarket": {
    "isUse": true,
    "amount": 0,
    "maxAmount": 0,
    "field": "Unknown",
    "startDate": "string",
    "endDate": "string"
  },
  "auction": {
    "isUse": true,
    "startDate": "string",
    "endDate": "string"
  }
}

JSON_Fail

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

Sample Code_Success

{
  "goodsNo": 1158387297
}

Sample Code_Fail

{
  "resultCode":1000,
  "message":"에러메시지."
}