adjustCalculationLineValue
Synopsis
void adjustCalculationLineAmount(
string sessionId,
string[] itemIds,
string ppName,
int level,
int counter,
decimal value,
string currency,
CondGroupSelectionOptions options
)
See also: CondGroupSelectionOptions
The primary purpose of these operations is to adjust margin values and amounts, but they can also be used to set condition amounts and adjust condition values.
Parameters ‘sessionId’, ‘itemIds’, ‘ppName’ and ‘options’ are interpreted the same way as by ‘setConditionAmount()’.
Parameters ‘level’ and ‘counter’ must specify a line of the item, aggregate (group/set-article) or document calculation specified by parameters ‘itemIds’ and ‘ppName’. (Other than ‘setConditionAmount()’, these operations do not allow use of -1 as counter in cases where the specification of the level alone would be sufficient to uniquely identify a calculation line.)
Both ‘value’ and ‘currency’ must be specified. The currency must be either an ISO 4217 currency code, ‘%’, or an empty string. An empty string is usually replaced by the document currency, unless the operation is adjustCalculationLineAmount() and the subtotals/conditions calculation rule is ‘Percent’ (in which case it is replaced by ‘%’) or ‘Invalid’ (in which case the operation terminates abnormally).
The current implementation does not allow the use of currencies other than the document currency (or the empty string) unless ‘adjustCalculationLineAmount()’ is used for a condition line.