SetStateContract Message (CrmService)
.gif "banner art") |
[Applies to: Microsoft Dynamics CRM 4.0]
Find the latest SDK documentation: CRM 2015 SDK
| Works for all deployment types | Works online and offline |
Sets the state of a contract.
The relevant classes are specified in the following table.
| Type | Class |
| Request | SetStateContractRequest |
| Response | SetStateContractResponse |
| Entity | contract |
Remarks
To use this message, pass an instance of the SetStateContractRequest class as the request parameter in the Execute method.
The possible states are defined in the ContractState enumeration. To perform this action, the caller must have access rights on the entity instance specified in the request class. For a list of required privileges, see SetState Privileges.
This message updates the contract entity properties statuscode and statecode.
To set the state of a contract to Invoiced, the following must be true:
- The properties billtoaddress and serviceaddress must contain values.
- The properties customerid and billingcustomerid must contain values.
- The contract must have line items. This means that there is at least one contractdetail instance for this contractid.
Example
For an example of how to use this message, see SetStateAccount.
See Also
Concepts
Reference