Skip to main content
Planview Customer Success Center

APIEngagement.Update() method fails with error when clearing contract limits

SYMPTOMS:
When clearing out the time billing amount limit of the engagement via API using the code below:

apiEngagement.TimeAmountLimit = null;
apiEngagement.WarnTimeAmount = false;

the following error occurs:

ERROR/WARNING MESSAGES:
2:12:22 AM Level2: Error: ErrNo=-17; Message=Business rule exception. You must select both [Reject] and [Contract limit for time billing amount] before you can enter a limit value. -868:
2:12:22 AM Level2: Error: Number= -9 Message= Unknown error. Update Engagement failed.
2:12:22 AM Level1: Log for this source is end.

REASON:
This behaviour has been acknowledged as a defect and will be fixed in a future release of Changepoint


ALTERNATIVE:
As an alternative set the limit to a high value, e.g. 999 999 999 999 999.0, and leave the warn/reject flag intact. Such a high enough billing amount for time will not trigger any warning.

Contract Limit properties:
AdditionalItemsAmountLimit
AllItemsAmountLimit
ExpenseAmountLimit
ExpenseQuantityLimit
FixedFeeAmountLimit
ProductAmountLimit
ProductQuantityLimit
RequestTimeAmount
RequestTimeEffort
TimeAmount
TimeEffort