구매수량별 할인(구간할인) 정보입니다. 판매대상이 B2B인 상품에서만 사용할 수 있습니다.
B2C 상품에 값을 전달하면 -35004 오류가 반환됩니다.
필드 상세
| 필드명 | 타입 | 필수여부 | 설명 |
| type | Type | 필수 | 할인 종류 PRICE(정액할인)만 사용할 수 있습니다. RATE(할인율)는 사용할 수 없습니다. |
| value | Integer | 필수 | 구간 할인 금액 최소 10원, 10원 단위로 입력 이전 구간의 할인 금액보다 큰 값이어야 합니다. |
| useDiscount | Boolean | 필수 | 반드시 true로 전달해야 합니다. false이거나 값을 전달하지 않으면 해당 구간은 저장되지 않습니다. |
| startPurchaseQuantity | Integer | 필수 | 구간 시작 구매수량 최소 2, 최대 5,000 |
| endPurchaseQuantity | Integer | 필수 | 구간 종료 구매수량 최대 5,000 마지막 구간이 아닌 경우 4,998 이하로 입력해야 합니다. |
| id | Long | 선택 | 구간 ID 상품 수정 시 기존 구간을 변경하려면 조회 결과의 id를 함께 전달합니다. 새로 추가하는 구간은 id 없이 전달합니다. |
필드 제약사항
# 구간
- 구간은 최대 5개까지 등록 가능합니다.
- 구간끼리 구매수량이 겹칠 수 없습니다.
- 다음 구간의 시작수량은 이전 구간의 종료수량 + 1 이어야 합니다.
- 시작수량은 2 이상, 종료수량은 5,000 이하로 입력 가능합니다.
- 마지막 구간이 아닌 구간의 종료수량은 4,998 이하로 입력해 주세요.
# 할인 금액
- 정액할인(PRICE)만 가능하며 할인율(RATE)은 사용할 수 없습니다.
- 할인 금액은 10원 단위로 입력 가능하며 최소 입력 금액은 10원입니다.
- 구매수량이 많은 구간일수록 할인 금액이 커야 합니다. (이전 구간보다 큰 값)
- 할인 적용 후 최종 판매가가 100원 미만이면 등록/수정이 거절됩니다.
# 적용 대상
- 판매대상이 B2B인 상품에만 설정 가능합니다.
- B2C 상품에 값을 전달하면 -35004 오류가 반환됩니다.
요청 예시
2개 구간을 설정하는 경우
"slidingDiscounts": [
{
"type": "PRICE",
"value": 600,
"useDiscount": true,
"startPurchaseQuantity": 2,
"endPurchaseQuantity": 3000
},
{
"type": "PRICE",
"value": 700,
"useDiscount": true,
"startPurchaseQuantity": 3001,
"endPurchaseQuantity": 5000
}
]
상품 수정 시 기존 구간을 변경하고 새 구간을 추가하는 경우
"slidingDiscounts": [
{
"id": 11231,
"type": "PRICE",
"value": 600,
"useDiscount": true,
"startPurchaseQuantity": 2,
"endPurchaseQuantity": 3000
},
{
"type": "PRICE",
"value": 700,
"useDiscount": true,
"startPurchaseQuantity": 3001,
"endPurchaseQuantity": 5000
}
]