Multiplicator

The Multiplicator option is responsible for adding the correct product quantity to the order cart.

The quantity must always be divisible by a multiplicity factor value, which can be set on multiple levels and is processed in turn in the following order:

Order	Object	Responsible Field	Description
1	Catalog Line Item or Promotion Line Item	Units Count Step	This field is checked first in these objects. If no records are found, the system uses the value in the Units Count Step field on the CT Price Book Line Item record.
2	Price Book Line Item	Units Count Step	The field stores the multiplicity step in the order cart must be divisible by the Units in Package value and also greater than that value. For example, if you set Units in Package to 5, the Units Count Step must be at least 10.
3	Product	Units in Package	The field stores the number of products in a package. This is the main value, which is always compared with the entered number during quantity calculation.

Order

Object

Responsible Field

Description

Catalog Line Item or Promotion Line Item

Units Count Step

This field is checked first in these objects. If no records are found, the system uses the value in the Units Count Step field on the CT Price Book Line Item record.

Price Book Line Item

Units Count Step

The field stores the multiplicity step in the order cart must be divisible by the Units in Package value and also greater than that value.

For example, if you set Units in Package to 5, the Units Count Step must be at least 10.

Product

Units in Package

The field stores the number of products in a package.

This is the main value, which is always compared with the entered number during quantity calculation.

Process Path

After a product is added to your order cart, the system checks if the Unit Count Step on Catalog Line Item or Promotion Line Item record exists and the value is greater than 0. The quantity of the product in the delivery, e.g., Delivery Line Item, must be divisible by the Units Count Step value. The quantity field is defined in the Delivery Line Item Mapping Setting.
If no value is found on the Catalog Line Item or Promotion Line Item record, the system checks the Units Count Step field on the CT Price Book Line Item record. The quantity of the product in the delivery, e.g., Delivery Line Item, must be divisible by the Units Count Step value on the CT Price Book Line Item record.
If no value is found on the CT Price Book Line Item record, the system checks the Units in Package field value on the corresponding Product record. The quantity of the product in the delivery, e.g., Delivery Line Item, must be divisible by the Units in Package value on the corresponding Product record.
If no value is found on any of the objects, the applied multiplicity factor is 1.

Important Notes

The Multiplicator logic is applied for each delivery separately.
For bundles with the quantity on Product Component records, the first step is omitted, as the Catalog Line Item or Promotion Line Item records are copied from the header and will be calculated equally for all components. The Multiplicator logic is not applied for bundles with header-dependent quantity, as the independent multiplier already exists on the Product Component records.
Multiplicator considers the minimum and maximum quantity per delivery, which is specified on a Product record.
Multiplicator logic is not applied for freebies.