Package org.broadleafcommerce.core.pricing.service

Interface FulfillmentPricingService

All Known Implementing Classes:

FulfillmentPricingServiceImpl

public interface FulfillmentPricingService

This service can be used in a couple of different ways. First, this is used in the pricing workflow and specifically FulfillmentGroupMerchandiseTotalActivity to calculate costs for FulfillmentGroups in an Order. This can also be injected in a controller to provide estimations for various FulfillmentOptions to display to the user before an option is actually selected.

Author:

Phillip Verheyden

Method Summary

Modifier and Type	Method	Description
FulfillmentGroup	calculateCostForFulfillmentGroup(FulfillmentGroup fulfillmentGroup)	Called during the Pricing workflow to determine the cost for the FulfillmentGroup.
FulfillmentEstimationResponse	estimateCostForFulfillmentGroup(FulfillmentGroup fulfillmentGroup, Set<FulfillmentOption> options)	This provides an estimation for a FulfillmentGroup with a FulfillmentOption.
List<FulfillmentPricingProvider>	getProviders()

Method Details

calculateCostForFulfillmentGroup

FulfillmentGroup calculateCostForFulfillmentGroup(FulfillmentGroup fulfillmentGroup)
                                           throws FulfillmentPriceException

Called during the Pricing workflow to determine the cost for the FulfillmentGroup. This will loop through #getProcessors() and call FulfillmentPricingProvider.calculateCostForFulfillmentGroup(FulfillmentGroup) on the first processor that returns true from FulfillmentPricingProvider#canCalculateCostForFulfillmentGroup(FulfillmentGroup)

Parameters:

fulfillmentGroup -

Returns:

the updated fulfillmentGroup with its shippingPrice set

Throws:

FulfillmentPriceException - if fulfillmentGroup does not have a FulfillmentOption associated to it or if there was no processor found to calculate costs for fulfillmentGroup

estimateCostForFulfillmentGroup

FulfillmentEstimationResponse estimateCostForFulfillmentGroup(FulfillmentGroup fulfillmentGroup,
 Set<FulfillmentOption> options)
                                                       throws FulfillmentPriceException

This provides an estimation for a FulfillmentGroup with a FulfillmentOption. The main use case for this method is in a view cart controller that wants to provide estimations for different FulfillmentOptions before the user actually selects one. This uses getProviders() to allow third-party integrations to respond to estimations, and returns the first processor that returns true from FulfillmentPricingProvider.canCalculateCostForFulfillmentGroup(FulfillmentGroup, FulfillmentOption).

Parameters:

fulfillmentGroup -

options -

Returns:

the price estimation for a particular FulfillmentGroup with a candidate FulfillmentOption

Throws:

FulfillmentPriceException - if no processor was found to estimate costs for fulfillmentGroup with the given option

getProviders

List<FulfillmentPricingProvider> getProviders()