Class DiscountPlan | Infocenter

Salesforce B2C Commerce 24.7 > B2C Commerce API > B2C Commerce Script > dw.campaign

dw.campaign

Class DiscountPlan

dw.campaign.DiscountPlan

DiscountPlan represents a set of Discounts. Instances of the class are returned by the PromotionMgr when requesting applicable discounts for a specified set of promotions and a line item container (see PromotionMgr.getDiscounts(LineItemCtnr, PromotionPlan)).

DiscountPlan provides methods to access the discounts contained in the plan, add additional discounts to the plan (future) or remove discounts from the plan.

See Also:

PromotionMgr

approachingOrderDiscounts : Collection (Read Only)

Get the collection of order discounts that the LineItemCtnr "almost" qualifies for based on the merchandise total in the cart. Nearness is controlled by thresholds configured at the promotion level.

The collection of returned approaching discounts is ordered by the condition threshold of the promotion (e.g. "spend $100 and get 10% off" discount is returned before "spend $150 and get 15% off" discount.) A discount is not returned if it would be prevented from applying (because of compatibility rules) by an order discount already in the DiscountPlan or an approaching order discount with a lower condition threshold.

bonusDiscounts : Collection (Read Only)

All bonus discounts contained in the discount plan.

lineItemCtnr : LineItemCtnr (Read Only)

Returns line item container associated with discount plan.
A discount plan is created from and associated with a line item container. This method returns the line item container associated with this discount plan.

orderDiscounts : Collection (Read Only)

The percentage and amount order discounts contained in the discount plan.

This class does not have a constructor, so you cannot create it directly.

getApproachingOrderDiscounts() : Collection

Get the collection of order discounts that the LineItemCtnr "almost" qualifies for based on the merchandise total in the cart.

getApproachingShippingDiscounts(shipment : Shipment) : Collection

Get the collection of shipping discounts that the passed shipment "almost" qualifies for based on the merchandise total in the shipment.

getApproachingShippingDiscounts(shipment : Shipment, shippingMethod : ShippingMethod) : Collection

Get the collection of shipping discounts that the passed shipment "almost" qualifies for based on the merchandise total in the shipment.

getApproachingShippingDiscounts(shipment : Shipment, shippingMethods : Collection) : Collection

Get the collection of shipping discounts that the passed shipment "almost" qualifies for based on the merchandise total in the shipment.

getBonusDiscounts() : Collection

Returns all bonus discounts contained in the discount plan.

getLineItemCtnr() : LineItemCtnr

Returns line item container associated with discount plan.

getOrderDiscounts() : Collection

Returns the percentage and amount order discounts contained in the discount plan.

getProductDiscounts(productLineItem : ProductLineItem) : Collection

Returns the percentage, amount and fix price discounts associated with the specified product line item.

getProductShippingDiscounts(productLineItem : ProductLineItem) : Collection

Returns the product-shipping discounts associated with the specified product line item.

getShippingDiscounts(shipment : Shipment) : Collection

Returns the percentage, amount and fix price discounts associated with the specified shipment.

removeDiscount(discount : Discount) : void

Removes the specified discount from the discount plan.

Methods inherited from class Object

assign, create, create, defineProperties, defineProperty, entries, freeze, fromEntries, getOwnPropertyDescriptor, getOwnPropertyNames, getOwnPropertySymbols, getPrototypeOf, hasOwnProperty, is, isExtensible, isFrozen, isPrototypeOf, isSealed, keys, preventExtensions, propertyIsEnumerable, seal, setPrototypeOf, toLocaleString, toString, valueOf, values

Salesforce B2C Commerce Developer - Certification Tests

Why risk failing the SFCC exam? Get 180 real questions, killer content, and everything you need to crush the Salesforce B2C Commerce Developer certification.

Becoming a Salesforce B2C Commerce Developer is your ticket to higher salaries, better job opportunities, and the credibility to stand out from the competition. But let's be honest—passing the certification exam isn't easy. That's where we come in.

Salesforce Javascript Developer I - Certification Tests

Not just another prep course—this is your shortcut to passing. Master JavaScript for Salesforce and go from 'hoping to pass' to knowing you will. Ready to start?

This isn't just another prep course—it's your shortcut to mastering the skills and confidence you need to pass. With multiple practice tests covering every section and a final exam simulation designed to mirror the real thing, you'll feel like you've already aced it before test day.

Salesforce B2C Commerce Architect - Certification Tests

Think the Developer exam was hard? Welcome to the next level.

The Salesforce B2C Commerce Architect certification is a whole different game—complex solutions, elevated difficulty, and skills that set you apart in the eCommerce industry. That's why we're including 11 downloadable PDF guides, packed with best practices and strategies to help you prepare for the exam and build confidence in every topic.

getApproachingOrderDiscounts

getApproachingOrderDiscounts() : Collection

Get the collection of order discounts that the LineItemCtnr "almost" qualifies for based on the merchandise total in the cart. Nearness is controlled by thresholds configured at the promotion level.

Returns:

Collection of approaching order discounts ordered by the condition threshold of the promotion ascending.

getApproachingShippingDiscounts

getApproachingShippingDiscounts(shipment : Shipment) : Collection

Get the collection of shipping discounts that the passed shipment "almost" qualifies for based on the merchandise total in the shipment. Nearness is controlled by thresholds configured at the promotion level.

The collection of returned approaching discounts is ordered by the condition threshold of the promotion (e.g. "spend $100 and get free standard shipping" discount is returned before "spend $150 and get free standard shipping" discount.) A discount is not returned if it would be prevented from applying (because of compatibility rules) by a shipping discount already in the DiscountPlan or an approaching shipping discount with a lower condition threshold.

Parameters:

shipment - The shipment to calculate approaching discounts for.

Returns:

Collection of approaching shipping discounts ordered by the condition threshold of the promotion ascending.

getApproachingShippingDiscounts

getApproachingShippingDiscounts(shipment : Shipment, shippingMethod : ShippingMethod) : Collection

Get the collection of shipping discounts that the passed shipment "almost" qualifies for based on the merchandise total in the shipment. Here "almost" is controlled by thresholds configured at the promotion level.

This method only returns discounts for shipping promotions which apply to the passed shipping method.

Parameters:

shipment - The shipment to calculate approaching discounts for.

shippingMethod - The shipping method to filter by.

Returns:

Collection of approaching shipping discounts ordered by the condition threshold of the promotion, ascending.

getApproachingShippingDiscounts

getApproachingShippingDiscounts(shipment : Shipment, shippingMethods : Collection) : Collection

This method only returns discounts for shipping promotions which apply to one of the passed shipping methods.

Parameters:

shipment - The shipment to calculate approaching discounts for.

shippingMethods - The shipping methods to filter by.

Returns:

Collection of approaching shipping discounts ordered by the condition threshold of the promotion ascending.

getBonusDiscounts

getBonusDiscounts() : Collection

Returns all bonus discounts contained in the discount plan.

Returns:

All bonus discounts contained in discount plan

getLineItemCtnr

getLineItemCtnr() : LineItemCtnr

Returns:

Line item container associated with plan

getOrderDiscounts

getOrderDiscounts() : Collection

Returns the percentage and amount order discounts contained in the discount plan.

Returns:

Order discounts contained in the discount plan

getProductDiscounts

getProductDiscounts(productLineItem : ProductLineItem) : Collection

Returns the percentage, amount and fix price discounts associated with the specified product line item. If the specified product line item is not contained in the discount plan, an empty collection is returned.

Parameters:

productLineItem - Product line item

Returns:

Discounts associated with specified product line item

getProductShippingDiscounts

getProductShippingDiscounts(productLineItem : ProductLineItem) : Collection

Returns the product-shipping discounts associated with the specified product line item. If the specified product line item is not contained in the discount plan, an empty collection is returned.

Parameters:

productLineItem - Product line item

Returns:

Product-shipping discounts associated with specified product line item

getShippingDiscounts

getShippingDiscounts(shipment : Shipment) : Collection

Returns the percentage, amount and fix price discounts associated with the specified shipment. If the specified shipment is not contained in the discount plan, an empty collection is returned.

Parameters:

shipment - the shipment for which to fetch discounts.

Returns:

Discounts associated with specified shipment

removeDiscount

removeDiscount(discount : Discount) : void

Removes the specified discount from the discount plan.
This method should only be used for very simple discount scenarios. It is not recommended to use the method in case of stacked discounts (i.e. multiple order or product discounts), or complex discount types like Buy X Get Y or Total Fixed Price, since correct re-calculation of the discount plan based on the promotion rules is not guaranteed.

Parameters:

discount - Discount to be removed