getPriceCalculationSheets
Synopsis
ItemCalculationSheet* getPriceCalculationSheets(
SessionId ´ sessionId,
BItemId[] itemIds,
GetPriceCalculationSheetOptions options,
string ppName)
throws BasketServiceFault;
See also: ItemCalculationSheet, SessionId, BItemId, GetPriceCalculationSheetOptions, BasketServiceFault
The operation getPriceCalculationSheets is used to fetch multiple price calculation sheets using a single web service operation.
The operation determines a set of selected items based on parameters itemIds and options. It then attempts to get a price calculation sheet for each selected item.
In case of article items the price calculation sheet contains the calculation for this article item only. Otherwise, the price calculation sheet contains an aggregate calculation for the selected item and all sub-positions of the selected item.
For each produced price calculation sheet, the operation returns an ItemCalculationSheet element (in unspecified order), containing the item ID and the price calculation sheet.
The option viewId of ItemSelectionOptions is supported by this operation. If it contains the ID of a view then the behavior of the operation is changed as follows:
-
Item IDs passed with parameter
itemIdsare interpreted as IDs of items within this view. -
The options
parentItemsandsubItems, if set, affect the selection of additional view items, not basket items. -
One instance of type
ItemCalculationis returned for each selected view item. Theid-field contains the item ID of the view item. The calculation is constructed from the item calculations of all directly referenced basket items. -
Note that folder view items are mapped to basket folder items, but, at least with display mode
Sorted, the content of both folders does not necessarily consist of the same set of article items. So calculations returned for folder view items may not contain the result expected based on the view’s item structure. -
The values of options
wholeCompositeandsumUpCompositeare set totrueif the view uses merge modeCompact. -
The value of option
itemCondAmountPerUnitis set totruefor each returned group calculation that grouped a whole composite article or a set of identical composite articles. The client may explicitly set this option to ensure consistent behavior for ordinary articles and partial plannings or aggregates with sub-articles.