5.1 지마켓 복수구매할인 API
등록/수정 : [POST] https://sa.esmplus.com/item/v1/goods/{goodsNo}/customer-benefit/multiple-purchase-discount
해제 : [DELETE] https://sa.esmplus.com/item/v1/goods/{goodsNo}/customer-benefit/multiple-purchase-discount
조회 : [GET] https://sa.esmplus.com/item/v1/goods/{goodsNo}/customer-benefit/multiple-purchase-discount
Description
구매자가 상품을 복수로 구매할 경우 추가 할인 적용되도록 설정할 수 있는 API입니다(G마켓 상품만 가능)
구매수량별 할인 또는 무료배송 혜택을 제공할 수 있습니다
구매수량별 할인 또는 무료배송 혜택을 제공할 수 있습니다
Request Description
G마켓 ID의 토큰으로 사용합니다
| 항목 | 항목명 | 필수여부 | Type | Description |
|---|---|---|---|---|
| goodsNo | 마스터상품번호 | Y | path | |
| type | 할인타입 | Y | int | 1 : 구매수량별 할인 설정 2 : 구매수량별 무료제공 설정 (주문옵션 사용시 설정 불가) |
| condition > value | 조건>개수 | Y | number | 숫자입력 |
| condition > unit | 조건>단위 | Y | int | 1 : 개(수량) 2 : 원(금액) type 2일 경우 unit : 1로 고정 |
| discount > value | 할인금액/할인율 | Y | number | 숫자입력 type : 2일 경우 파라미터 삭제후 호출 |
| discount > unit | 할인단위 | Y | int | 1 : % 2 : 원 type : 2일 경우 파라미터 삭제후 호출 |
| startDate | 적용시작일자 | Y | date | YYYY-MM-DD |
| endDate | 적용종료일자 | Y | date | YYYY-MM-DD |
JSON_등록/수정JSON_해제/조회Sample Code_등록/수정
{
"type": int,
"condition": {
"value": 0,
"unit": int
},
"discount": {
"value": 0,
"unit": int
},
"startDate": "2022-07-01",
"endDate": "2022-07-01"
}
URL만 호출/Request Body없음
복수구매할인 해제
DELETE https://sa.esmplus.com/item/v1/goods/1139546520/customer-benefit/multiple-purchase-discount
복수구매할인 조회
GET https://sa.esmplus.com/item/v1/goods/1139546520/customer-benefit/multiple-purchase-discount
복수구매할인 해제
DELETE https://sa.esmplus.com/item/v1/goods/1139546520/customer-benefit/multiple-purchase-discount
복수구매할인 조회
GET https://sa.esmplus.com/item/v1/goods/1139546520/customer-benefit/multiple-purchase-discount
{
"type": "1",
"condition": {
"value": 4,
"unit": "1"
},
"discount": {
"value": 700,
"unit": "2"
},
"startDate": "2018-09-17",
"endDate": "2018-09-23"
}
Response Description
| 항목 | 항목명 | Type | Description |
|---|---|---|---|
| goodsNo | 마스터상품번호 | int | 조회 시 내려가는 정보 |
| type | 할인타입 | int | 조회 시 내려가는 정보 1. 구매수량별 할인 설정 2. 구매수량별 무료제공 설정 |
| condition > value | 조건>개수 | number | 조회 시 내려가는 정보 |
| condition > unit | 조건>단위 | int | 조회 시 내려가는 정보 1.개(수량) 2.원(금액) type 2일 경우, unit 1로 고정 |
| discount > value | 할인금액/할인율 | number | 조회 시 내려가는 정보 숫자입력 type : 2일 경우 파라미터 삭제후 호출 |
| discount > unit | 할인단위 | int | 조회 시 내려가는 정보 1 : % 2 : 원 type : 2일 경우 파라미터 삭제후 호출 |
| startDate | 적용시작일자 | date | 조회 시 내려가는 정보 YYYY-MM-DD |
| endDate | 적용종료일자 | date | 조회 시 내려가는 정보 YYYY-MM-DD |
| resultCode | 결과코드 | int | 실패 시 내려가는 정보 |
| message | 메시지 | string | 실패 시 내려가는 정보 |
| data | 데이터 | object | 실패 시 내려가는 정보 |
JSON_Success_등록/수정/해제JSON_Success_조회JSON_FailSample Code_Success_등록/수정/해제Sample Code_Success_조회Sample Code_Fail
{
"goodsNo": 0
}
{
"type": int,
"condition": {
"value": 0,
"unit": int
},
"discount": {
"value": 0,
"unit": int
},
"startDate": "2022-07-01",
"endDate": "2022-07-01"
}
{
"ResultCode": 0,
"Message": "string",
"Data": {}
}
{
"goodsNo": 1158387297
}
{
"type": 1,
"condition": {
"value": 3000,
"unit": 2
},
"discount": {
"value": 10,
"unit": 1
},
"startDate": "2018-01-02",
"endDate": "2018-02-03"
}
{
"ResultCode":1000,
"Message":"에러메시지.",
"Data":null
}
Error Code
| 결과코드 | 메시지 | 원인 |
|---|