IEditSessionAddOrderModifierItem(Guid, Int32, IProduct, IProductGroup, IOrderStub, IOrderProductItemStub, NullableInt32, NullableDecimal) Method

INewOrderModifierItemStub AddOrderModifierItem(
	Guid id,
	int amount,
	IProduct modifier,
	IProductGroup parentGroup,
	IOrderStub order,
	IOrderProductItemStub productItem,
	int? payableAmount = null,
	decimal? predefinedPrice = null
)

Parameters

id  Guid

Unique identifier of the new order item modifier. MUST be unique not only for the order item or order, but for the whole system. Therefore it must be taken from some synchronization operation or generated with Guid.NewGuid().

amount  Int32

Amount of the modifier. Can be from 1 to 999.

modifier  IProduct

Assortment position for modifier. Must be accessible through IOrderProductItem.AvailableSimpleModifiers collection or one of the IOrderProductItem.AvailableGroupModifiers child collections.

parentGroup  IProductGroup

Assortment position group for modifier. Must be specified if new modifier will be part of the group modifier. Otherwise null. Group modifier must be chosen from IOrderProductItem.AvailableGroupModifiers

order  IOrderStub

Order to which modifier will be added

productItem  IOrderProductItemStub

Order item to which modifier will be added.

payableAmount  NullableInt32  (Optional)

Custom payable amount. Leave it null to use default logic or set custom value to override default logic. Payable part of the amount must be between zero (which means that whole modifier is free of charge) and amount (which means that whole modifier is payable).

predefinedPrice  NullableDecimal  (Optional)

Predefined fixed price of the modifier, allows to use external quotation instead of default price list. null means default price.

Return Value

Reference