Skip to main content
Planview Customer Success Center

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

SYMPTOMS:
When updating the time billing amount limit of the engagement via API 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:
Custom application sets the TimeAmountLimit but not the RejectTimeAmount or WarnTimeAmount flags.


RESOLUTION:
If a contract limit is set, the corresponding warn or reject flag must also be set to True.

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

Reject flags:
RejectAdditionalItemsAmount
RejectAllItemsAmount
RejectExpenseAmount
RejectExpenseQuantity
RejectFixedFeeAmount
RejectProductAmount
RejectProductQuantity
RejectRequestTimeAmount
RejectRequestTimeEffort
RejectTimeAmount
RejectTimeEffort

Warn flags:
WarnAdditionalItemsAmount
WarnAllItemsAmount
WarnExpenseAmount
WarnExpenseQuantity
WarnFixedFeeAmount
WarnProductAmount
WarnProductQuantity
WarnRequestTimeAmount
WarnRequestTimeEffort
WarnTimeAmount
WarnTimeEffort