Contract

Represents a contract (a business agreement) associated with an Account.

Supported Calls

create(), update(), delete(), query(), search(), retrieve(), getDeleted(), getUpdated(), describeLayout(), describeSObjects(), upsert()

Fields

Field	Field Type	Field Properties	Description
AccountId	reference	Create Filter Update	Required. ID of the Account associated with this contract. For information on IDs, see ID Field Type.
ActivatedById	reference	Filter Nillable	ID of the User who activated this contract.
ActivatedDate	dateTime	Filter Nillable	Date and time when this contract was activated.
BillingCity BillingCountry BillingPostalCode BillingState	string	Create Filter Nillable Update	Details for the billing address.
BillingStreet	textarea	Create Filter Nillable Update	Street address for the billing address.
CompanySignedDate	date	Create Filter Nillable Update	Date on which the contract was signed by your organization.
CompanySignedId	reference	Create Filter Nillable Update	ID of the User who signed the contract.
ContractNumber	string	Autonumber Defaulted on create Filter	Number of the contract.
ContractTerm	int	Create Filter Nillable Update	Number of months that the contract is valid.
CustomerSignedDate	date	Create Filter Nillable Update	Date on which the customer signed the contract.
CustomerSignedId	reference	Create Filter Nillable Update	ID of the Contact who signed this contract.
CustomerSignedTitle	string	Create Filter Nillable Update	Title of the customer who signed the contract.
Description	textarea	Create Nillable Update	Description of the contract.
EndDate	date	Filter Nillable	Read-only. Calculated end date of the contract. This value is calculated by adding the ContractTerm to the StartDate.
IsDeleted	boolean	Defaulted on create Filter	Indicates whether the object has been moved to the Recycle Bin (`true`) or not (`false`). Label is Deleted.
LastActivityDate	date	Filter Nillable	Value is one of the following, whichever is the most recent: Due date of the most recent event logged against the record. Due date of the most recently closed task associated with the record.
LastApprovedDate	dateTime	Filter Nillable	Last date the contract was approved.
OwnerExpirationNotice	picklist	Create Filter Nillable Restricted picklist Update	Number of days ahead of the contract end date (15, 30, 45, 60, 90, and 120). Used to notify the owner in advance that the contract is ending.
OwnerId	reference	Create Defaulted on create Filter Nillable Update	ID of the user who owns the contract.
Pricebook2Id	reference	Create Filter Nillable Update	ID of the pricebook, if any, associated with this contract.
ShippingCity ShippingCountry ShippingPostalCode ShippingState	string	Create Filter Nillable Update	Details for the shipping address.
ShippingStreet	textarea	Create Filter Nillable Update	Street address for the shipping address.
SpecialTerms	textarea	Create Filter Nillable Update	Special terms that apply to the contract.
StartDate	date	Create Filter Nillable Update	Start date for this contract. Label is Contract Start Date.
Status	picklist	Create Defaulted on create Filter Update	The picklist of values that indicate order status. Each value is within one of two status categories defined in StatusCode. For example, the status picklist may contain: Ready to Ship, Shipped, Received as values within the Activated StatusCode.
StatusCode	picklist	Filter Restricted picklist	The status category for the order. An order can be either Draft, InApproval, or Activated. Label is Status Category.

Usage

The Contract object represents a business agreement. Client applications can use the API to create(), update(), query(), and retrieve() contracts.

The Status field specifies the current state of a contract. Status strings (defined in the ContractStatus object) represent its current state (Draft, InApproval, or Activated).

Client applications must initially create() a Contract in a non-Activated state. Client applications can subsequently activate a Contract by calling update() and setting the value in its Status field to Activated; however, the Status field is the only field that the client application can set in the update() call when activating the Contract.

Once a Contract has been activated, your client application cannot change its status; however, prior to activation, your client application can change the status value from Draft to InApproval via the API. Also, your client application can delete() contracts whose status is Draft or InApproval but not when a contract status is Activated.

Client applications can use the API to create(), update(), delete(), and query() any Attachment associated with a contract.