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).