Asset

Represents an item of commercial value, such as a product sold by your company or a competitor, that a customer has purchased and installed.

Supported Calls

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

Fields

Field	Details
AccountId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description (Required) ID of the Account associated with this asset. Must be a valid account ID. Required if ContactId is not specified.
ContactId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description Required if AccountId is not specified. ID of the Contact associated with this asset. Must be a valid contact ID that has an account parent (but does not need to match the asset’s AccountId).
Description	Type textarea Properties Create, Nillable, Update Description Description of the asset.
InstallDate	Type date Properties Create, Filter, Group, Nillable, Sort, Update Description Date when the asset was installed.
IsCompetitorProduct	Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether this Asset represents a product sold by a competitor (`true`) or not (`false`). Default value is `false`. Its UI label is Competitor Asset.
LastReferencedDate	Type dateTime Properties Filter, Nillable, Sort Description The date and time that the asset was last modified. Its UI label is Last Modified Date.
LastViewedDate	Type dateTime Properties Filter, Nillable, Sort Description The date and time that the asset was last viewed.
Name	Type string Properties Create, Filter, Group, Sort, Update Description (Required) Name of the asset. Label is Asset Name.
OwnerId	Type reference Properties Create, Defaulted on create, Filter, Group, Sort, Update Description The asset’s owner. By default, the asset owner is the user who created the asset record. As of Spring ’15, the OwnerId field is used for access control when the Asset object’s sharing setting is Private, Public Read-Only, or Public Read/Write. If the Asset object’s sharing setting is Controlled by Parent, the OwnerId field has no effect on access control, because the parent account’s settings control access to the asset. Its UI label is Asset Owner.
ParentId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The asset’s parent asset. Its UI label is Parent Asset.
Price	Type currency Properties Create, Filter, Nillable, Sort, Update Description Price paid for this asset.
Product2Id	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description (Optional) ID of the Product2 associated with this asset. Must be a valid Product2 ID. Its UI label is Product.
PurchaseDate	Type date Properties Create, Filter, Group, Nillable, Sort, Update Description Date on which this asset was purchased.
Quantity	Type double Properties Create, Filter, Nillable, Sort, Update Description Quantity purchased or installed.
RootAssetId	Type reference Properties Filter, Group, Nillable, Sort Description (Read only) The top-level asset in an asset hierarchy. Depending on where an asset lies in the hierarchy, its root could be the same as its parent. Its UI label is Root Asset.
SerialNumber	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Serial number for this asset.
Status	Type picklist Properties Create, Filter, Group, Nillable, Sort, Update Description Customizable picklist of values. The default picklist includes the following values: `Purchased` `Shipped` `Installed` `Registered` `Obsolete`
UsageEndDate	Type date Properties Create, Filter, Group, Nillable, Sort, Update Description Date when usage for this asset ends or expires.

Usage

Use this object to track assets previously sold into customer accounts. With asset tracking, a client application can quickly determine which products were previously sold or are currently installed at a specific account.

For example, your organization might want to renew and up-sell opportunities on products sold in the past. Similarly, your organization might want to track competitive products that exist in a customer environment that could potentially be replaced or swapped out.

Asset tracking is also useful for product support, providing detailed information to assist with product-specific support issues. For example, the PurchaseDate or SerialNumber could indicate whether a given product has certain maintenance requirements, including product recalls. Similarly, the UsageEndDate might indicate when the asset was removed from service or when a license or warranty expires.

If an application creates a new Asset record, it must at least specify a Name and either an AccountId, ContactId, or both.

Object Reference for Salesforce and Force.com

Asset

Supported Calls

Fields

Usage

See Also: