Package de.hybris.platform.promotions

Interface PromotionsService

All Known Implementing Classes:

DefaultPromotionEngineService, DefaultPromotionsService

public interface PromotionsService

The service for the Promotions extension. Manages applying promotions to carts and orders.

• Use the updatePromotions(java.util.Collection<de.hybris.platform.promotions.model.PromotionGroupModel>, de.hybris.platform.core.model.order.AbstractOrderModel) methods to evaluate the promotions that can be applied to a cart or order.
• Use the getPromotionResults(de.hybris.platform.core.model.order.AbstractOrderModel) methods to retrieve the promotions calculated for an order.
• Use the getProductPromotions(java.util.Collection<de.hybris.platform.promotions.model.PromotionGroupModel>, de.hybris.platform.core.model.product.ProductModel) methods to retrieve the promotions that a ProductModel can be part of.
• The promotions extension stores additional database items for the cart and order items. When a cart is removed from the system it is necessary to call the cleanupCart(de.hybris.platform.core.model.order.CartModel) method to removed these items.

Method Summary

Modifier and Type	Method	Description
void	cleanupCart(CartModel cart)	Delete the the stored promotion results for a Cart.
List<? extends AbstractPromotionModel>	getAbstractProductPromotions(Collection<PromotionGroupModel> promotionGroups, ProductModel product)	Get the ordered list of AbstractPromotionModel instances that are related to the ProductModel specified.
List<? extends AbstractPromotionModel>	getAbstractProductPromotions(Collection<PromotionGroupModel> promotionGroups, ProductModel product, boolean evaluateRestrictions, Date date)	Get the ordered list of AbstractPromotionModel instances that are related to the ProductModel specified.
PromotionGroupModel	getDefaultPromotionGroup()	Lookup the default promotion group created by the promotions extension.
List<OrderPromotionModel>	getOrderPromotions(Collection<PromotionGroupModel> promotionGroups)	Get the ordered list of OrderPromotion instances.
List<OrderPromotionModel>	getOrderPromotions(Collection<PromotionGroupModel> promotionGroups, boolean evaluateRestrictions)	Get the ordered list of OrderPromotion instances.
List<OrderPromotionModel>	getOrderPromotions(Collection<PromotionGroupModel> promotionGroups, boolean evaluateRestrictions, ProductModel product)	Get the ordered list of OrderPromotion instances.
List<OrderPromotionModel>	getOrderPromotions(Collection<PromotionGroupModel> promotionGroups, boolean evaluateRestrictions, ProductModel product, Date date)	Get the ordered list of OrderPromotion instances.
List<OrderPromotionModel>	getOrderPromotions(Collection<PromotionGroupModel> promotionGroups, boolean evaluateRestrictions, Date date)	Get the ordered list of OrderPromotion instances.
List<OrderPromotionModel>	getOrderPromotions(Collection<PromotionGroupModel> promotionGroups, ProductModel product)	Get the ordered list of OrderPromotion instances.
List<OrderPromotionModel>	getOrderPromotions(Collection<PromotionGroupModel> promotionGroups, ProductModel product, Date date)	Get the ordered list of OrderPromotion instances.
List<OrderPromotionModel>	getOrderPromotions(Collection<PromotionGroupModel> promotionGroups, Date date)	Get the ordered list of OrderPromotion instances.
List<ProductPromotionModel>	getProductPromotions(Collection<PromotionGroupModel> promotionGroups, ProductModel product)	Get the ordered list of ProductPromotion instances that are related to the ProductModel specified.
List<ProductPromotionModel>	getProductPromotions(Collection<PromotionGroupModel> promotionGroups, ProductModel product, boolean evaluateRestrictions, Date date)	Get the ordered list of ProductPromotion instances that are related to the ProductModel specified.
String	getPromotionDescription(AbstractPromotionModel promotion)	Get the description of given promotion.
PromotionGroupModel	getPromotionGroup(String identifier)	Lookup a promotion group with the given identifier.
PromotionOrderResults	getPromotionResults(AbstractOrderModel order)	Get the promotion results for the specified order.
PromotionOrderResults	getPromotionResults(Collection<PromotionGroupModel> promotionGroups, AbstractOrderModel order, boolean evaluateRestrictions, PromotionsManager.AutoApplyMode productPromotionMode, PromotionsManager.AutoApplyMode orderPromotionMode, Date date)	Get the promotion results for the specified order.
Collection<AbstractPromotionRestrictionModel>	getRestrictions(AbstractPromotionModel promotion)	Get the collection of AbstractPromotionRestrictionModel instances.
void	transferPromotionsToOrder(AbstractOrderModel source, OrderModel target, boolean onlyTransferAppliedPromotions)	Transfer the promotions applied to a cart to a new order.
PromotionOrderResults	updatePromotions(Collection<PromotionGroupModel> promotionGroups, AbstractOrderModel order)	Update the promotions on the specified AbstractOrder object.
PromotionOrderResults	updatePromotions(Collection<PromotionGroupModel> promotionGroups, AbstractOrderModel order, boolean evaluateRestrictions, PromotionsManager.AutoApplyMode productPromotionMode, PromotionsManager.AutoApplyMode orderPromotionMode, Date date)	Update the promotions on the specified AbstractOrderModel object.

Method Details

getProductPromotions

List<ProductPromotionModel> getProductPromotions(Collection<PromotionGroupModel> promotionGroups,
 ProductModel product)

Get the ordered list of ProductPromotion instances that are related to the ProductModel specified.

Parameters:

promotionGroups - The promotion groups to evaluate

product - The product that the promotions are related to

Returns:

The list of ProductPromotion related to the ProductModel specified

getProductPromotions

List<ProductPromotionModel> getProductPromotions(Collection<PromotionGroupModel> promotionGroups,
 ProductModel product,
 boolean evaluateRestrictions,
 Date date)

Get the ordered list of ProductPromotion instances that are related to the ProductModel specified.

Parameters:

promotionGroups - The promotion groups to evaluate

product - The product that the promotions are related to

evaluateRestrictions - Flag, pass false to ignore any restrictions specified on the promotions, pass true to observe the restrictions.

date - The date to check for promotions, typically the current date

Returns:

The list of ProductPromotion related to the ProductModel specified

getOrderPromotions

List<OrderPromotionModel> getOrderPromotions(Collection<PromotionGroupModel> promotionGroups)

Get the ordered list of OrderPromotion instances.

Parameters:

promotionGroups - The promotion groups to evaluate

Returns:

The list of OrderPromotion

getOrderPromotions

List<OrderPromotionModel> getOrderPromotions(Collection<PromotionGroupModel> promotionGroups,
 Date date)

Get the ordered list of OrderPromotion instances.

Parameters:

promotionGroups - The promotion groups to evaluate

date - The date to check for promotions, typically the current date

Returns:

The list of OrderPromotion

getOrderPromotions

List<OrderPromotionModel> getOrderPromotions(Collection<PromotionGroupModel> promotionGroups,
 ProductModel product)

Get the ordered list of OrderPromotion instances.

Parameters:

promotionGroups - The promotion groups to evaluate

product - The product to pass to restrictions

Returns:

The list of OrderPromotion

getOrderPromotions

List<OrderPromotionModel> getOrderPromotions(Collection<PromotionGroupModel> promotionGroups,
 ProductModel product,
 Date date)

Get the ordered list of OrderPromotion instances.

Parameters:

promotionGroups - The promotion groups to evaluate

product - The product to pass to restrictions

date - The date to check for promotions, typically the current date

Returns:

The list of OrderPromotion

getOrderPromotions

List<OrderPromotionModel> getOrderPromotions(Collection<PromotionGroupModel> promotionGroups,
 boolean evaluateRestrictions)

Get the ordered list of OrderPromotion instances.

Parameters:

promotionGroups - The promotion groups to evaluate

evaluateRestrictions - Flag, pass false to ignore any restrictions specified on the promotions, pass true to observe the restrictions.

Returns:

The list of OrderPromotion

getOrderPromotions

List<OrderPromotionModel> getOrderPromotions(Collection<PromotionGroupModel> promotionGroups,
 boolean evaluateRestrictions,
 Date date)

Get the ordered list of OrderPromotion instances.

Parameters:

promotionGroups - The promotion groups to evaluate

evaluateRestrictions - Flag, pass false to ignore any restrictions specified on the promotions, pass true to observe the restrictions.

date - The date to check for promotions, typically the current date

Returns:

The list of OrderPromotion

getOrderPromotions

List<OrderPromotionModel> getOrderPromotions(Collection<PromotionGroupModel> promotionGroups,
 boolean evaluateRestrictions,
 ProductModel product)

Get the ordered list of OrderPromotion instances.

Parameters:

promotionGroups - The promotion groups to evaluate

evaluateRestrictions - Flag, pass false to ignore any restrictions specified on the promotions, pass true to observe the restrictions.

product - The product to pass to restrictions if evaluateRestrictions is true

Returns:

The list of OrderPromotion

getOrderPromotions

List<OrderPromotionModel> getOrderPromotions(Collection<PromotionGroupModel> promotionGroups,
 boolean evaluateRestrictions,
 ProductModel product,
 Date date)

Get the ordered list of OrderPromotion instances.

Parameters:

promotionGroups - The promotion groups to evaluate

evaluateRestrictions - Flag, pass false to ignore any restrictions specified on the promotions, pass true to observe the restrictions.

product - The product to pass to restrictions if evaluateRestrictions is true

date - The date to check for promotions, typically the current date

Returns:

The list of OrderPromotion

getAbstractProductPromotions

List<? extends AbstractPromotionModel> getAbstractProductPromotions(Collection<PromotionGroupModel> promotionGroups,
 ProductModel product)

Get the ordered list of AbstractPromotionModel instances that are related to the ProductModel specified.

Parameters:

promotionGroups - The promotion groups to evaluate

product - The product that the promotions are related to

Returns:

The list of AbstractPromotionModel related to the ProductModel specified

getAbstractProductPromotions

List<? extends AbstractPromotionModel> getAbstractProductPromotions(Collection<PromotionGroupModel> promotionGroups,
 ProductModel product,
 boolean evaluateRestrictions,
 Date date)

Get the ordered list of AbstractPromotionModel instances that are related to the ProductModel specified.

Parameters:

promotionGroups - The promotion groups to evaluate

product - The product that the promotions are related to

evaluateRestrictions - Flag, pass false to ignore any restrictions specified on the promotions, pass true to observe the restrictions.

date - The date to check for promotions, typically the current date

Returns:

The list of AbstractPromotionModel related to the ProductModel specified

updatePromotions

PromotionOrderResults updatePromotions(Collection<PromotionGroupModel> promotionGroups,
 AbstractOrderModel order)

Update the promotions on the specified AbstractOrder object.

This method will automatically apply all possible product promotional updates to the cart, but not apply order level promotions. Any previously applied order level promotions will remain applied. Promotions are evaluated at the current system time.

The promotion results are stored in the database and the same PromotionOrderResults can be obtained later by calling getPromotionResults(de.hybris.platform.core.model.order.AbstractOrderModel).

Parameters:

promotionGroups - The promotion groups to evaluate

order - The order object to update with the results of the promotions

Returns:

The promotion results

updatePromotions

PromotionOrderResults updatePromotions(Collection<PromotionGroupModel> promotionGroups,
 AbstractOrderModel order,
 boolean evaluateRestrictions,
 PromotionsManager.AutoApplyMode productPromotionMode,
 PromotionsManager.AutoApplyMode orderPromotionMode,
 Date date)

Update the promotions on the specified AbstractOrderModel object.

The resulting promotions can be retrieved later by calling getPromotionResults(de.hybris.platform.core.model.order.AbstractOrderModel). The order must be calculated before calling this method. updatePromotions(java.util.Collection<de.hybris.platform.promotions.model.PromotionGroupModel>, de.hybris.platform.core.model.order.AbstractOrderModel) must be called after calling AbstractOrder.recalculate() on the AbstractOrderModel. Where the PromotionsManager.AutoApplyMode is set to PromotionsManager.AutoApplyMode.KEEP_APPLIED the state of any previously applied PromotionResult is recorded and if it is still in the fired state (PromotionResult.isApplied()) after reevaluating the promotions it will be automatically reapplied.

The promotion results are stored in the database and the same PromotionOrderResults can be obtained later by calling getPromotionResults(de.hybris.platform.core.model.order.AbstractOrderModel). After this method is called, please call getModelService().refresh(order) or getModelService().save(order).

Parameters:

promotionGroups - The promotion groups to evaluate

order - The AbstractOrder object to update the promotions for

evaluateRestrictions - If true any promotion restrictions will be observed, if false all promotion restrictions are ignored

productPromotionMode - The auto apply mode. This determines whether this method applies any product promotional changes to line items or discounts to the overall amount

orderPromotionMode - The auto apply mode. This determines whether this method applies any order promotional changes to line items or discounts to the overall amount

date - The effective date for the promotions to check. Use this to to see the effects of promotions in the past or future.

Returns:

The promotion results

getPromotionResults

PromotionOrderResults getPromotionResults(AbstractOrderModel order)

Get the promotion results for the specified order.

These are the promotion results stored in the database for the specified order as generated by the last call to updatePromotions(java.util.Collection<de.hybris.platform.promotions.model.PromotionGroupModel>, de.hybris.platform.core.model.order.AbstractOrderModel) for the same order.

If any of the promotion results are invalid then they will be ignored.

Parameters:

order - The order to get the promotion results for

Returns:

The promotion results

getPromotionResults

PromotionOrderResults getPromotionResults(Collection<PromotionGroupModel> promotionGroups,
 AbstractOrderModel order,
 boolean evaluateRestrictions,
 PromotionsManager.AutoApplyMode productPromotionMode,
 PromotionsManager.AutoApplyMode orderPromotionMode,
 Date date)

Get the promotion results for the specified order.

These are the promotion results stored in the database for the specified order as generated by the last call to updatePromotions(java.util.Collection<de.hybris.platform.promotions.model.PromotionGroupModel>, de.hybris.platform.core.model.order.AbstractOrderModel) for the same order.

If any of the promotion results are invalid then this method will recalculate the promotions by calling updatePromotions(java.util.Collection<de.hybris.platform.promotions.model.PromotionGroupModel>, de.hybris.platform.core.model.order.AbstractOrderModel).

Parameters:

promotionGroups - The promotion groups to evaluate

order - The AbstractOrder object to get the promotions for

evaluateRestrictions - If true any promotion restrictions will be observed, if false all promotion restrictions are ignored

productPromotionMode - The auto apply mode. This determines whether this method applies any product promotional changes to line items or discounts to the overall amount

orderPromotionMode - The auto apply mode. This determines whether this method applies any order promotional changes to line items or discounts to the overall amount

date - The effective date for the promotions to check. Use this to to see the effects of promotions in the past or future.

Returns:

The promotion results

cleanupCart

void cleanupCart(CartModel cart)

Delete the the stored promotion results for a Cart.

Parameters:

cart - The Cart to delete the results for

transferPromotionsToOrder

void transferPromotionsToOrder(AbstractOrderModel source,
 OrderModel target,
 boolean onlyTransferAppliedPromotions)

Transfer the promotions applied to a cart to a new order. This is used when an order is created from a cart.

Parameters:

source - The cart that has promotions

target - The order that promotions should be applied to

onlyTransferAppliedPromotions - Flag to indicate that only applied promotions should be transfered. If false all promotion results will be transfered

getDefaultPromotionGroup

PromotionGroupModel getDefaultPromotionGroup()

Lookup the default promotion group created by the promotions extension.

Returns:

the default promotion group

getPromotionGroup

PromotionGroupModel getPromotionGroup(String identifier)

Lookup a promotion group with the given identifier.

Parameters:

identifier - identifier of the promotion group to look for

Returns:

the promotion group or null if no group with the given identifier is found

Throws:

IllegalArgumentException - if identifier is null

getRestrictions

Collection<AbstractPromotionRestrictionModel> getRestrictions(AbstractPromotionModel promotion)

Get the collection of AbstractPromotionRestrictionModel instances.

Parameters:

promotion - the promotion which restrictions should be returned

Returns:

A collection of AbstractPromotionRestrictionModel instances attached to this promotion.

getPromotionDescription

String getPromotionDescription(AbstractPromotionModel promotion)

Get the description of given promotion.

Parameters:

promotion - the promotion to get the description for

Returns:

String representing promotion description