This complex type defines a discount as being either a monetary amount or a percentage of a sales price that's subtracted from the price of an item or order.
Set the amount of the discount and the rules that govern when the discount triggers using the discountBenefit and discountSpecification fields.
Note: In volume pricing discounts, you must configure at least two discountRule containers and at most four.
Types that use DiscountRule
ItemPromotionItemPromotionResponse
Calls that use DiscountRule
Fields
Note: When configuring discount benefits, populate just one of the following fields in the discountBenefit container:
- amountOffItem
- amountOffOrder
- percentageOffItem
- percentageOffOrder
For volume pricing, only percentageOffOrder is applicable as a discountBenefit. Also, the first discountBenefit container in a volume pricing configuration must set percentageOffOrder to 0
.
Tip: Refer to Configuring threshold discounts for information and examples on how to combine discountBenefit and discountSpecification to create different types of discounts.
When configuring the rules that govern when the discounts are applied, populate just one of the following fields in the discountSpecification container:
- minAmount
- minQuantity
- forEachQuantity
- forEachAmount
Important: When configuring volume pricing discounts, only minQuantity is applicable as a discountSpecification. Also, the configuration for minQuantity in a volume pricing configuration is specific. In the first discountSpecification container, set minQuantity to 1
, and in the second, set minQuantity to 2
. If you include a third discountRules pair, minQuantity must be set to 3
, and in a fourth, it must be set to 4
. Also, you must set a ruleOrder value in each discountRules container. In the first container, discountRules must be set to 1
, and in each subsequent container, the value be be incremented by 1. For more, see Configuring volume pricing discounts.
Tip: see Configuring threshold discounts for information and examples on how to combine discountBenefit and discountSpecification to create different types of discounts.
CODED_COUPON
discount type. Permitted values are 1-1000. Supported currency codes include USD, GBP, EUR, and AUD. Note: The Currency Code for 'maxDiscountAmount' must be the same as the Currency Code for 'budget'.
Required if you are creating a volume pricing discount.