The system watches for the price of an order to change at the order subtotal level (that is, the sum of the item prices has changed due to a change in item quantities and/or the addition or deletion of items). You can use the optional parameters within this element, such as the new order price, to further define the type of order to watch for. Note that, depending on the pricing operation that was performed on the order, the new order price reflects either the order subtotal (that is, no shipping or tax costs) or the order total.
Technical note: This element is triggered when the ScenarioManager
receives a PriceChanged
message sent by the PricingTools
object (class atg.commerce.pricing.PricingTools
). PricingTools
sends this message if the PricingTools.generatePriceChangedEvents
property is true and if, when the order is repriced, the order’s subtotal price is found to have changed. Note that, depending on the pricing operation that was performed on the order, the total in the OrderPriceInfo
object that is contained in the PriceChanged
message reflects either the order subtotal or the order total. For more information, see the Using and Extending Pricing Services chapter of the ATG Commerce Programming Guide.
You can extend PricingTools.createPriceChangedEvent
to respond to more object types than just the order (such as items or shipping groups) and set the PriceChangeType
to one of the given choices (these are static constants in the PriceChanged
class).