Asset

Represents an item of commercial value owned by an Account or Contact, for example, a product previously sold and installed.

Supported Calls

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

Fields

Field Field Type Field Properties Description
AccountId reference Create

Filter

Nillable

Update

Required. ID of the Account associated with this asset. Must be a valid account ID. Required if ContactId is not specified. For information on IDs, seeID Field Type.
ContactId reference Create

Filter

Nillable

Update

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 string Create

Nillable

Update

Description of this asset.
InstallDate date Create

Filter

Nillable

Update

Date on which this asset was installed.
IsCompetitorProduct boolean Create

Defaulted on create

Filter

Update

Indicates whether this Asset represents a product sold by a competitor (true) or not (false). Default value is false. Label is Competitor Asset.
IsDelete boolean Defaulted on create

Filter

Indicates whether the object has been moved to the Recycle Bin (true) or not (false). Label is Deleted.
Name string Create

Filter

idLookup

Update

Required. Name of the asset. Label is Asset Name.
Price double Create

Filter

Nillable

Update

Price paid for this asset.
Product2Id reference Create

Filter

Nillable

Update

ID of the Product2 associated with this asset. Must be a valid Product2 ID. Optional.
PurchaseDate date Create

Filter

Nillable

Update

Date on which this asset was purchased.
Quantity double Create

Filter

Nillable

Update

Quantity purchased or installed.
SerialNumber string Create

Filter

Nillable

Update

Serial number for this asset.
Status picklist Create

Filter

Nillable

Update

Customizable picklist of values. The default picklist includes the following values:
  • Purchased
  • Shipped
  • Installed
  • Registered
  • Obsolete
UsageEndDate date Create

Filter

Nillable

Update

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.

See Also:
Standard and Custom Object Basics
© Copyright 2000-2008 salesforce.com, inc. All rights reserved.
Various trademarks held by their respective owners.