ShippingDiscountAdjust

_currency_lcid

Order

Optional (required only if the _currency_decimal_places key is not set, otherwise it is ignored). Describes a locale (LCID) to use to retrieve the number of currency decimal places.

Type: Integer (VT_I4)

_orderlevel_discounts_detail

Order

Optional (if this key does not exist in the OrderForm, or if the shipping_discount key of this dictionary does not exist, the _cy_shipping_discounts_total value is set to zero, and no other action is taken). A dictionary that maps special offer types to a list of order level discounts that applies for that special offer type. The SimpleList object under the shipping_discount special offer type key is used.

Each element is a dictionary. The exact format of the dictionary depends on whether the element represents a combination of percentage-off discounts of the same priority, or a single discount.

The following are the dictionary entries if the element represents a single discount:

• discount_id: Integer (VT_I4)

• discount_timestamp: Last_modified timestamp of the discount (VT_DATE)

• discount_name: Discount name (VT_BSTR)

The following are the dictionary entries if the element represents a combined percentage-off discount:

• discounts_combined: SimpleList object that describes each of the discounts that were combined. Each element in this list is a Dictionary with the following keys:

  • discount_id: Integer (VT_I4)

  • cy_discount_percentage: Value (VT_CY)

  • discount_timestamp: Llast_modified tiemestamp of the discount (VT_DATE)

  • discount_name: Discount name (VT_BSTR)

The following are the dictionary entries that exist in both cases:

• discount_priority: Priority (rank)

• discount_type: 1=Currency; 2=Percentage (VT_I4)

• cy_discount_value: Currency or Percentage value (VT_CY). If the element represents a combined percentage-off discount, this is the total percentage.

The order the elements appear in the list is significant, because it is the order that the OrderDiscount pipeline component has determined they should be applied.

Type: Currency (VT_CY)

Note:

This is the list that is used by the OrderDiscount pipeline component to specify to other pipeline components the complete list of order level discounts that should be applied to the basket.

_cy_shipping_discounts_total

Always written (if no shipping discounts apply, this is set to zero). Sum of all shipping discounts applied to the order.

Type: Currency (VT_CY)

shipments._cy_shipping_total

Not always written (modified only if one or more shipping discounts apply). The total amount of shipping charges for the shipment after shipping discounts have been applied.

Type: Currency (VT_CY)

shipments._shipping_discounts_applied

Not always written (only written if one or more shipping discounts apply to the shipment). A SimpeList of dictionaries where each dictionary contains information about a shipping discount that was applied to this shipment. The order of the list is significant and represents the order in which the discounts were applied to the shipment.

The dictionary contains the following elements for each discount:

• discount_id: Campaign item ID (VT_I4)

• discount_priority: Discount priority (rank) (VT_I4)

• discount_timestamp: Last-modified timestamp of the discount (VT_DATE)

• cy_discount_amount: How much was actually taken off the item (VT_CY)

• discount_type: 1=Currency Value; 2=Percentage (VT_I4)

• cy_discount_value: Currency value or percentage value (VT_CY)\

• discount_name: Discount name (VT_BSTR)

Type: Dictionary (VT_DISPATCH)