LinearHandling

The LinearHandling component, which usually appears in the Handling Stage of an order processing pipeline, sets order._handling_total on the order form by multiplying a rate times the sum of a specified field on the order form.

• Key. (Read-only) The name of a property on the order form used to specify handling method. The value of this property is compared to the string specified in the Method field to determine whether to apply the handling charge to the order.
• Apply when. Specifies when to apply the handling charge.
  • Equal to Method. Specifies that the handling charge if the value of the property specified for Key is the same as the string specified in the Method field.
  • Has Any Value. Specifies that the handling charge will be applied when the value of the property specified for Key has any value on the order form. If you select this option, the Method field should be left blank.
  • Always. Specifies that the handling charge is always applied to the order.
• Method. If Equal to Method is selected, specifies a string that the component compares with the value of shipping_method on the order form to determine whether to apply the handling charge to the order. The handling charge will be applied only if there is an exact match.
• Basis Item Key. Specifies the property of the item that is used to compute the handling charge. The LinearHandling component computes the charge by multiplying the value specified for Rate by the sum of the property specified for Basis Item Key. For example, you might base the linear handling charge on the quantity of the items, and the Basis Item Key might be sum.quantity. If the order contains two items, one item with a quantity of four and the other item with a quantity of two, then the basis sum is six. The component multiplies the value specified for Rate by six. See Specifying the Basis Item Key.
• Rate. Specifies an integer value that the component multiplies by the value of the item property specified in Basis Item Key to obtain the handling charge to apply to the order.

Related Topics

• Component Coordination
• Specifying the Basis Item Key