Contract

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

Supported Calls

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

Fields

Field	Details
AccountId	Type reference Properties Create, Filter, Group, Sort,Update Description Required. ID of the Account associated with this contract. This is a relationship field. Relationship Name Account Relationship Type Lookup Refers To Account
ActivatedById	Type reference Properties Filter, Group, Nillable, Sort,Update Description ID of the User who activated this contract. This is a relationship field. Relationship Name ActivatedBy Relationship Type Lookup Refers To User
ActivatedDate	Type dateTime Properties Filter, Nillable, Sort, Update Description Date and time when this contract was activated.
BillingAddress	Type address Properties Filter, Nillable Description The compound form of the billing address. Read-only. See Address Compound Fields for details on compound address fields.
BillingCity	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Details for the billing address. Maximum size is 40 characters.
BillingCountry	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Details for the billing address of this account. Maximum size is 80 characters.
BillingCountryCode	Type picklist Properties Create, Filter, Group, Nillable, Sort, Update Description The ISO country code for the contract’s billing address.
BillingGeocodeAccuracy	Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The accuracy of the geocode for the billing address. Possible values are: `Address` `Block` `City` `County` `ExtendedZip` `NearAddress` `Neighborhood` `State` `Street` `Unknown` `Zip`
BillingLatitude	Type double Properties Create, Filter, Nillable, Sort, Update Description Used with BillingLongitude to specify the precise geolocation of a billing address. Acceptable values are numbers between –90 and 90 with up to 15 decimal places.
BillingLongitude	Type double Properties Create, Filter, Nillable, Sort, Update Description Used with BillingLatitude to specify the precise geolocation of a billing address. Acceptable values are numbers between –180 and 180 with up to 15 decimal places.
BillingPostalCode	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Details for the billing address of this account. Maximum size is 20 characters.
BillingState	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Details for the billing address. Maximum size is 80 characters.
BillingStateCode	Type picklist Properties Create, Filter, Group, Nillable, Sort, Update Description The ISO state code for the contract’s billing address.
BillingStreet	Type textarea Properties Create, Filter, Group, Nillable, Sort, Update Description Street address for the billing address.
CompanySignedDate	Type date Properties Create, Filter, Group, Nillable, Sort, Update Description Date on which the contract was signed by your organization.
CompanySignedId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description ID of the User who signed the contract. This is a relationship field. Relationship Name CompanySigned Relationship Type Lookup Refers To User
ContractNumber	Type string Properties Autonumber, Defaulted on create, Filter, idLookup, Sort Description Number of the contract.
ContractTerm	Type int Properties Create, Filter, Group, Nillable, Sort, Update Description Number of months that the contract is valid.
CustomerSignedDate	Type date Properties Create, Filter, Group, Nillable, Sort, Update Description Date on which the customer signed the contract.
CustomerSignedId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description ID of the Contact who signed this contract. This is a relationship field. Relationship Name CustomerSigned Relationship Type Lookup Refers To Contact
CustomerSignedTitle	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Title of the customer who signed the contract.
Description	Type textarea Properties Create, Nillable, Update Description Description of the contract.
EndDate	Type date Properties Filter, Group, Nillable, Sort, Description Read-only. Calculated end date of the contract. This value is calculated by adding the ContractTerm to the StartDate.
IsDeleted	Type boolean Properties Defaulted on create, Filter Description Indicates whether the object has been moved to the Recycle Bin (`true`) or not (`false`). Label is Deleted.
LastActivityDate	Type date Properties Filter, Group, Nillable, Sort Description 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	Type dateTime Properties Filter, Nillable, Sort Description Last date the contract was approved.
LastReferencedDate	Type datetime Properties Filter, Nillable, Sort Description The timestamp when the current user last accessed this record, a record related to this record, or a list view.
LastViewedDate	Type datetime Properties Filter, Nillable, Sort Description The timestamp when the current user last viewed this record or list view. If this value is null, the user might have only accessed this record or list view (LastReferencedDate) but not viewed it.
OwnerExpirationNotice	Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description 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	Type reference Properties Create, Defaulted on create, Filter, Group, Sort, Update Description ID of the user who owns the contract. This is a relationship field. Relationship Name Owner Relationship Type Lookup Refers To User
Pricebook2Id	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description ID of the pricebook, if any, associated with this contract.
RecordTypeId	Type reference Properties Create, Filter, Nillable, Update Description ID of the record type assigned to this object.
ShippingAddress	Type address Properties Filter, Nillable Description The compound form of the shipping address. Read-only. See Address Compound Fields for details on compound address fields.
ShippingCity	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Details of the shipping address. City maximum size is 40 characters.
ShippingCountry	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Details of the shipping address. Country maximum size is 80 characters.
ShippingCountryCode	Type picklist Properties Create, Filter, Group, Nillable, Sort, Update Description The ISO country code for the contract’s shipping address.
ShippingLatitude	Type double Properties Create, Filter, Nillable, Sort, Update Description Used with ShippingLongitude to specify the precise geolocation of a shipping address. Acceptable values are numbers between –90 and 90 with up to 15 decimal places.
ShippingLongitude	Type double Properties Create, Filter, Nillable, Sort, Update Description Used with ShippingLatitude to specify the precise geolocation of an address. Acceptable values are numbers between –180 and 180 with up to 15 decimal places.
ShippingPostalCode	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Details of the shipping address. Postal code maximum size is 20 characters.
ShippingState	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Details of the shipping address. State maximum size is 80 characters.
ShippingStateCode	Type picklist Properties Create, Filter, Group, Nillable, Sort, Update Description The ISO state code for the contract’s shipping address.
ShippingStreet	Type textarea Properties Create, Filter, Group, Nillable, Sort, Update Description The street address of the shipping address. Maximum of 255 characters.
SpecialTerms	Type textarea Properties Create, Filter, Nillable, Sort, Update Description Special terms that apply to the contract.
StartDate	Type date Properties Create, Filter, Group, Nillable, Sort,Update Description Start date for this contract. Label is Contract Start Date.
Status	Type picklist Properties Create, Defaulted on create, Filter, Group, Restricted picklist, Sort, Update Description 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	Type picklist Properties Filter, Group, Restricted picklist, Sort Description The status category for the contract. A contract can be Draft, InApproval, or Activated. Label is Status Category.

Usage

The Contract object represents a business agreement.

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 updating it and setting the value in its Status field to Activated; however, the Status field is the only field you can update when activating the Contract.

Once a Contract has been activated, your client application can't 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.

Associated Objects

This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later.

AccountChangeEvent (API version 46.0): Change events are available for the object.
ContractFeed (API version 18.0): Feed tracking is available for the object.
ContractHistory: History is available for tracked fields of the object.

Object Reference for the Salesforce Platform

Contract

Supported Calls

Fields

Usage

Associated Objects

See Also