--- schema_version: "1" id: 41111f006314523fc4668fe5b317f98d505476211973a2eb2211081104c2c898 title: Asset collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/retail_api/sforce_api_objects_asset.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.retail_api.meta/retail_api/sforce_api_objects_asset.htm source_site: developer.salesforce.com content_type: documentation content_hash: 4a23defab539d77b0f90085542408a0bbca90588a6281424290cb0342813ed63 description: Standard and custom fields extend the standard Asset object in Consumer Goods Cloud to represent an item of commercial value, such as a product sold by your company or a competitor, that a customer has purchased. This object is available in API version 55.0 and later. --- # Asset Standard and custom fields extend the standard Asset object in Consumer Goods Cloud to represent an item of commercial value, such as a product sold by your company or a competitor, that a customer has purchased. This object is available in API version 55.0 and later. ## Supported Calls create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert() ## Fields ### AccountId - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: Required. ID of the Account related to the asset. Must be a valid account ID. This field is a relationship field. - **Relationship Name**: Account - **Relationship Type**: Lookup - **Refers To**: Account ### Address - **Type**: address - **Properties**: Filter, Nillable - **Description**: The compound form of the Asset address ### AssetLevel - **Type**: int - **Properties**: Filter, Group, Nillable, Sort - **Description**: Asset’s position in the asset hierarchy: Assets that have no parent or child assets, or that belong to a hierarchy have a level of 1 for the root asset. Child assets of the root asset have a level of 2, the children of level 2 assets have a level of 3, and so on. ![Note](https://developer.salesforce.com/docs/atlas.en-us.retail_api.meta/retail_api/images/icon_note.png) #### Note The asset level of assets created before the introduction of this field defaults to –1. After the asset record is updated, the asset level is calculated and automatically updated. ### AssetProvidedById - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: Account that provided the asset, typically a manufacturer. This field is a relationship field. - **Relationship Name**: AssetProvidedBy - **Relationship Type**: Lookup - **Refers To**: Account ### AssetServicedById - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: Account in charge of servicing the asset. This field is a relationship field. - **Relationship Name**: AssetServicedBy - **Relationship Type**: Lookup - **Refers To**: Account ### City - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: City in the address. ### ContactId - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: ID of the related contact record. This field is a relationship field. - **Relationship Name**: Contact - **Relationship Type**: Lookup - **Refers To**: Contact ### Country - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: Country in the address. ### CurrentAmount - **Type**: currency - **Properties**: Filter, Nillable, Sort - **Description**: Reserved for future use. Available when CPQ Plus, Salesforce Billing, or Subscription Management is enabled. ### CurrentLifecycleEndDate - **Type**: dateTime - **Properties**: Filter, Nillable, Sort - **Description**: End of the period shown as current. Auto-populated field inherited from the end date of the current asset state period. If the field is empty, as with an evergreen subscription, the Current Lifecycle End Date field is empty. ### CurrentMrr - **Type**: currency - **Properties**: Filter, Nillable, Sort - **Description**: Asset’s monthly recurring revenue during the current asset state period. Auto-populated field inherited from the monthly recurring revenue on the current asset state period. If no asset state period is current, the value is 0. Label is Current Monthly Recurring Revenue. ### CurrentQuantity - **Type**: double - **Properties**: Filter, Nillable, Sort - **Description**: Asset’s quantity during the current asset state period. Auto-populated field inherited from the quantity on the current asset state period. If no asset state period is current, the value is 0. ### Description - **Type**: textarea - **Properties**: Create, Nillable, Update - **Description**: Description of the asset. ### GeocodeAccuracy - **Type**: picklist - **Properties**: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update - **Description**: Shipping geocode accuracy: - **Possible values**: - Address - Block - City - County - ExtendedZip - NearAddress - Neighborhood - State - Street - Unknown - Zip ### HasLifecycleManagement - **Type**: boolean - **Properties**: Defaulted on create, Filter, Group, Sort - **Description**: Indicates whether this asset is lifecycle-managed (true) or not (false). After setting this value, the value can’t be changed. Auto-populated field. - **Default value**: false ### 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 the asset represents a product sold by a competitor (true) or not (false). - **Default value**: false ### IsInternal - **Type**: boolean - **Properties**: Create, Defaulted on create, Filter, Group, Sort, Update - **Description**: Indicates whether the asset is produced or used internally (true) or not (false). - **Default value**: false ### LastReferencedDate - **Type**: dateTime - **Properties**: Filter, Nillable, Sort - **Description**: Date and time that the asset was last modified. ### LastViewedDate - **Type**: dateTime - **Properties**: Filter, Nillable, Sort - **Description**: Date and time that the asset was last viewed. ### Latitude - **Type**: double - **Properties**: Create, Filter, Nillable, Sort, Update - **Description**: Latitude of the asset. ### LifecycleEndDate - **Type**: dateTime - **Properties**: Filter, Nillable, Sort - **Description**: End of the asset’s lifecycle. Auto-populated field inherited from the end date of the final asset state period. If the field is empty, as with an evergreen subscription, the lifecycle has no end date. This field is available when CPQ Plus, Salesforce Billing, or Subscription Management is enabled. ### LifecycleStartDate - **Type**: dateTime - **Properties**: Filter, Nillable, Sort - **Description**: Beginning of the asset’s lifecycle. Auto-populated field inherited from the start date of the earliest asset state period. This field can’t be edited. When a new asset action affects the start date of an asset state period, a new period is generated. This field is available when CPQ Plus, Salesforce Billing, or Subscription Management is enabled. ### LocationId - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: ID of the GPS coordinates of the asset. Relationship field. - **Relationship Name**: Location - **Relationship Type**: Lookup - **Refers To**: Location ### Longitude - **Type**: double - **Properties**: Create, Filter, Nillable, Sort, Update - **Description**: Asset’s location. Typically, this location is the place where the asset is stored, such as a warehouse or van. ### Name - **Type**: string - **Properties**: Create, Filter, Group, idLookup, Sort, Update - **Description**: Required. Name of the asset. ### OwnerId - **Type**: reference - **Properties**: Create, Defaulted on create, Filter, Group, Sort, Update - **Description**: Asset’s owner. By default, the asset owner is the user who created the asset record. This field is a relationship field. - **Relationship Name**: Owner - **Relationship Type**: Lookup - **Refers To**: User ### ParentId - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: Asset’s parent asset. This field is a relationship field. - **Relationship Name**: Parent - **Relationship Type**: Lookup - **Refers To**: Asset ### PostalCode - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: Postal code in the asset address. ### Price - **Type**: currency - **Properties**: Create, Filter, Nillable, Sort, Update - **Description**: Pricing information for an asset. ### Product2Id - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: Optional. ID of Product2 related to this asset. Must be a valid Product2 ID. This field is a relationship field. - **Relationship Name**: Product2 - **Relationship Type**: Lookup - **Refers To**: Product2 ### ProductCode - **Type**: string - **Properties**: Filter, Group, Nillable, Sort - **Description**: Product code of the related 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**: Asset quantity purchased or installed. ### RecordTypeId - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: ID of the record type. This field is a relationship field. - **Relationship Name**: RecordType - **Relationship Type**: Lookup - **Refers To**: RecordType ### 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, the asset’s root can be the same as the parent. This field is a relationship field. - **Relationship Name**: RootAsset - **Relationship Type**: Lookup - **Refers To**: Asset ### SerialNumber - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: Serial number of the asset. ### State - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: State in the asset address. ### Status - **Type**: picklist - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: Indicates asset’s status: Customizable picklist. - **Possible values**: - Active - Damaged - Inactive ### StockKeepingUnit - **Type**: string - **Properties**: Filter, Group, Nillable, Sort - **Description**: Stock keeping unit assigned to the related product. ### Street - **Type**: textarea - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: Street name in the asset address. ### TotalLifecycleAmount - **Type**: currency - **Properties**: Filter, Nillable, Sort - **Description**: Total amount of revenue for the asset, including revenue from each stage in the asset lifecycle. The field is available when CPQ Plus, Salesforce Billing, or Subscription Management is enabled. ### UsageEndDate - **Type**: date - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: End date or expiry date for asset use. ### cgcloud\_Asset\_Template\_\_c - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: References to the asset template. This field is a relationship field. - **Relationship Name**: cgcloud\_dev\_\_Asset\_Template\_\_r - **Relationship Type**: Lookup - **Refers To**: cgcloud\_dev\_\_Asset\_Template\_\_c ### cgcloud\_Asset\_Type\_\_c - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: Type of asset. This field is a relationship field. - **Relationship Name**: cgcloud\_dev\_\_Asset\_Type\_\_r - **Relationship Type**: Lookup - **Refers To**: Product2 ### cgcloud\_Brand\_\_c - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: References to the brand of the child product. ### cgcloud\_Description\_Language\_1\_\_c - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: Stores the description of language 1. ### cgcloud\_Description\_Language\_2\_\_c - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: Stores the description of language 2. ### cgcloud\_Description\_Language\_3\_\_c - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: Stores the description of language 3. ### cgcloud\_dev\_\_Description\_Language\_4\_\_c - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: Stores the description of language 4. ### cgcloud\_Description\_\_c - **Type**: string - **Properties**: Filter, Nillable, Sort - **Description**: Description based on the user-specified language. This field is a calculated field. - **Formula**: CASE($User.cgcloud\_dev\_\_Language\_Postfix\_\_c, "Language1", cgcloud\_dev\_\_Description\_Language\_1\_\_c, "Language2", BLANKVALUE(cgcloud\_dev\_\_Description\_Language\_2\_\_c,cgcloud\_dev\_\_Description\_Language\_1\_\_c), "Language3", BLANKVALUE(cgcloud\_dev\_\_Description\_Language\_3\_\_c,cgcloud\_dev\_\_Description\_Language\_1\_\_c), "Language4", BLANKVALUE(cgcloud\_dev\_\_Description\_Language\_4\_\_c,cgcloud\_dev\_\_Description\_Language\_1\_\_c), cgcloud\_dev\_\_Description\_Language\_1\_\_c) ### cgcloud\_ERP\_Asset\_Number\_\_c - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: Holds the asset number assigned by the ERP. ### cgcloud\_Manufacturer\_Serial\_Number\_\_c - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: Serial number given by the manufacturer. ### cgcloud\_Note\_\_c - **Type**: textarea - **Properties**: Create, Nillable, Update - **Description**: General note about the asset. ### cgcloud\_Ownership\_Type\_\_c - **Type**: picklist - **Properties**: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update - **Description**: Indicates the ownership type of the asset: - **Possible values**: - Leased - Owned ### cgcloud\_POS\_\_c - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: References to Point of Sale(POS). This field is a relationship field. - **Relationship Name**: cgcloud\_dev\_\_POS\_\_r - **Relationship Type**: Lookup - **Refers To**: cgcloud\_dev\_\_POS\_\_c ### cgcloud\_Production\_Year\_\_c - **Type**: double - **Properties**: Create, Filter, Nillable, Sort, Update - **Description**: Holds the production year of the asset. ### cgcloud\_Sales\_Org\_\_c - **Type**: picklist - **Properties**: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update - **Description**: Sales org of the template: - **Possible values**: - 0000 - 0001 - 0002 - 0003 ### cgcloud\_Service\_Phone\_Number\_\_c - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: Phone number from the service support of the asset. ### cgcloud\_Valid\_From\_\_c - **Type**: date - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: Date from which the asset is valid. ### cgcloud\_Valid\_Thru\_\_c - **Type**: date - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: Date until which the asset is valid. ## Associated Objects ### Associated Objects The Asset object has these related objects. If the API version isn’t specified, then the APIs are available in the same versions as the object. Otherwise, the APIs are available in the specified API version and later. - **[AssetChangeEvent](https://developer.salesforce.com/docs/atlas.en-us.retail_api.meta/retail_api/sforce_api_associated_objects_change_event.htm "A ChangeEvent object is available for each object that supports Change Data Capture. You can subscribe to a stream of change events using Change Data Capture to receive data tied to record changes in Salesforce. Changes include record creation, updates to an existing record, deletion of a record, and undeletion of a record. A change event isn’t a Salesforce object—it doesn’t support CRUD operations or queries. It’s included in the object reference so you can discover which Salesforce objects support change events.")**: Change events are available for the object. - **[AssetFeed](https://developer.salesforce.com/docs/atlas.en-us.retail_api.meta/retail_api/sforce_api_associated_objects_feed.htm "StandardObjectNameFeed is the model for all feed objects associated with standard objects. These objects represent the posts and feed-tracked changes of a standard object.")**: Feed tracking is available for the object. - **[AssetHistory](https://developer.salesforce.com/docs/atlas.en-us.retail_api.meta/retail_api/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object.")**: History is available for tracked fields of the object. - **[AssetOwnerSharingRule](https://developer.salesforce.com/docs/atlas.en-us.retail_api.meta/retail_api/sforce_api_associated_objects_ownersharingrule.htm "StandardObjectNameOwnerSharingRule is the model for all owner sharing rule objects associated with standard objects. These objects represent a rule for sharing a standard object with users other than the owner.")**: Sharing rules are available for the object. - **[AssetShare](https://developer.salesforce.com/docs/atlas.en-us.retail_api.meta/retail_api/sforce_api_associated_objects_share.htm "StandardObjectNameShare is the model for all share objects associated with standard objects. These objects represent a sharing entry on the standard object.")**: Sharing is available for the object.