Skip to content
pCon.configurator onlineDocumentation
Esc
↑↓navigate↵open⌘Jpreview
On this page

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 itemIds are interpreted as IDs of items within this view.

  • The options parentItems and subItems, if set, affect the selection of additional view items, not basket items.

  • One instance of type ItemCalculation is returned for each selected view item. The id-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 wholeComposite and sumUpComposite are set to true if the view uses merge mode Compact.

  • The value of option itemCondAmountPerUnit is set to true for 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.