ContractRoleCost
IMPORTANT The SOAP API entered a limited enhancement phase in Q4 2020. Access to version 1.6 will be deactivated.
This entity describes a per hour cost for labor that is set at the contract level. This cost overrides a resource's Admin level internal cost rate for time entries posted against the contract. Time entry dates must fall within the active dates of the contract. The cost rate is associated with a resource and a role.
Entity details
You can also retrieve this information with the Web Services API call The getEntityInfo() SOAP API call.
Entity Name: | ContractRoleCost |
Can Create: | |
Can Update: | |
Can Query: | |
Can Delete: | |
Can Have UDFs: |
Conditions and requirements
- Resources with security levels that specify limited or no contract visibility cannot create, update, or query this entity.
- RoleID must reference a Role that is associated, via Department or Queue, with the Resource referenced by ResourceID.
- ContractRoleCost can only be applied to time entries with a create date that falls within the start and end dates of the Contract referenced by ContractID.
Field definitions
The following table describes the standard Autotask field objects for this entity.
- To retrieve more detailed information specific to a particular Autotask implementation, use the Web Services API call The getFieldInfo() SOAP API call.
- For information on entity UDFs, use getUDFInfo().
- For String datatypes, the number in parentheses ( ) indicates the maximum number of characters allowed.
- LT indicates Local Term.
For more information about fields marked as picklists, review our Understanding picklists article.
Field Name | Label | Datatype | Read Only | Is Required | Reference Name | Picklist |
---|---|---|---|---|---|---|
ContractID | Contract ID | integer | Contract | |||
id | id | long | ||||
Rate | Cost | double | ||||
ResourceID | Resource ID | integer | Resource | |||
RoleID | Role ID | integer | Role |