The resource used to view a single consolidated asset.

get

/crmRestApi/resources/11.13.18.05/consolidatedAssets/{AssetGroupId}

Request

Path Parameters
  • The value of this parameter could be a hash of the key that is used to uniquely identify the resource item. The client should not generate the hash key value. Instead, the client should query on the collection resource with a filter to navigate to a specific resource item. For example: products?q=InventoryItemId=
Query Parameters
  • This parameter specifies dependencies which are fields that are set before and rolled back after generating the response. Generally they are used to preview the effects of an attribute change. The fields specified in this parameter are always set in the resource instance in question. When a child resource collection is requested and the parameter is set, the fields will be set in the parent resource instance before generating the resource collection payload. The value of this query parameter is a set of dependency fields. Example: dependency=ProductId=2

    Format: <attr1>=<val1>,<attr2>=<value2>
  • When this parameter is provided, the specified children are included in the resource payload (instead of just a link). The value of this query parameter is "all" or "". More than one child can be specified using comma as a separator. Example: ?expand=Employees,Localizations. Nested children can also be provided following the format "Child.NestedChild" (Example: ?expand=Employees.Managers). If a nested child is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?expand=Employees.Managers" is the same as "?expand=Employees,Employees.Managers" (which will expand Employees and Managers).
  • This parameter filters the resource fields. Only the specified fields are returned, which means that if no fields are specified, no fields are returned (useful to get only the links). If an indirect child resource is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?fields=Employees.Managers:Empname" is the same as "?fields=;Employees:;Employees.Managers:Empname" (which will only return the "Empname" field for Managers). the value of this query parameter is a list of resource fields. The attribute can be a direct (Example: Employees) or indirect (Example: Employees.Managers) child. It cannot be combined with expand query parameter. If both are provided, only fields will be considered.

    Format: ?fields=Attribute1,Attribute2

    Format for fields in child resource: ?fields=Accessor1:Attribute1,Attribute2
  • This parameter can be used to show only certain links while accessing a singular resource or a resource collection. The parameter value format is a comma-separated list of : <link_relation>

    Example:
    self,canonical
  • The resource item payload will be filtered in order to contain only data (no links section, for example).
Header Parameters
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.

There's no request body for this operation.

Back to Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Body ()
Root Schema : consolidatedAssets-item-response
Type: object
Show Source
  • Title: Account Address
    Read Only: true
    Maximum Length: 429
    Customer Account Site Address
  • Title: Account ID
    Read Only: true
    Customer account identifier from Installed Base assets or Subscription Management product source data.
  • Title: Account Name
    Read Only: true
    Maximum Length: 900
    Customer account name from Installed Base assets or Subscription Management product source data.
  • Title: Account Number
    Read Only: true
    Maximum Length: 30
    Bill-to customer account number from Installed Base assets or Subscription Management product source data.
  • Title: Asset Count
    Read Only: true
    Number of active serialized asset rows represented by this asset group. Derived by counting nondeleted rows in CPQ_SERIALIZED_ASSETS.
  • Title: End Date
    Read Only: true
    Derived asset start date used by CPQ views for filtering and display.
  • Title: Start Date
    Read Only: true
    Derived asset end date used by CPQ views for filtering and display.
  • Title: Asset Group ID
    Read Only: true
    Asset group identifier from the source sold asset group for this row.
  • Title: Asset Group Number
    Read Only: true
    Maximum Length: 80
    Asset group identifier from the source sold asset group for this row.
  • Title: Asset Number
    Read Only: true
    Maximum Length: 80
    User-visible Installed Base asset number copied from the source asset.
  • Title: Asset Product Type
    Read Only: true
    Maximum Length: 30
    Serialized asset bucket derived from the sales product type for routing and display.
  • Title: Bill-to Account ID
    Read Only: true
    Bill-to customer account identifier from Installed Base assets for goods or Subscription Management product for subscriptions.
  • Title: Bill-to Account Name
    Read Only: true
    Maximum Length: 240
    Bill-to customer account name from Installed Base assets or Subscription Management product source data.
  • Title: Bill-to Account Number
    Read Only: true
    Maximum Length: 30
    Bill-to customer account number from Installed Base assets or Subscription Management product source data.
  • Title: Bill-to Account Site
    Read Only: true
    Maximum Length: 429
    Bill-to party site address from Installed Base assets or derived from bill-to site use.
  • Title: Bill-to Account Site ID
    Read Only: true
    Customer Account Site ID
  • Title: Bill-to Contact ID
    Read Only: true
    Bill-to contact number from Installed Base assets for goods or Subscription Management for subscriptions.
  • Title: Bill-to Contact Name
    Read Only: true
    Maximum Length: 900
    Bill-to contact name from Installed Base assets for goods or Subscription Management product for subscriptions.
  • Title: Bill-to Contact Number
    Read Only: true
    Maximum Length: 30
    Bill-to contact number from Installed Base assets for goods or Subscription Management for subscriptions.
  • Title: Bill-to Party ID
    Read Only: true
    Bill-to party identifier from Installed Base assets for goods or Subscription Management product for subscriptions.
  • Title: Bill-to Party Name
    Read Only: true
    Maximum Length: 900
    Bill-to party name from Installed Base assets for goods or Subscription Management product for subscriptions.
  • Title: Bill-to Party Number
    Read Only: true
    Maximum Length: 30
    Bill-to party number from Installed Base assets for goods or Subscription Management product for subscriptions.
  • Title: Bill-to Party Site
    Read Only: true
    Maximum Length: 429
    Bill-to party site address from Installed Base assets or derived from bill-to site use.
  • Title: Bill-to Party Site ID
    Read Only: true
    Bill-to party site identifier from Installed Base assets or derived from bill-to site use.
  • Title: Bill-to Site Use ID
    Read Only: true
    Bill-to customer site use identifier from Installed Base assets or Subscription Management product source data.
  • Title: Structure Item Type
    Read Only: true
    Bill of material item type copied from Product Information Management.
  • Title: Structure Item Type Label
    Read Only: true
    Maximum Length: 30
    Display label derived from the bill of material item type value.
  • Title: Closed Date
    Read Only: true
    Closed date copied from the Subscription Management product for lifecycle handling.
  • Title: Configuration Header ID
    Read Only: true
    Configuration header identifier preferred from the asset group or otherwise from the Installed Base asset.
  • Title: Configuration Revision Number
    Read Only: true
    Configuration revision number preferred from the asset group or otherwise from the Installed Base asset.
  • Title: Configurator Path
    Read Only: true
    Maximum Length: 2000
    Configurator path preferred from asset group and otherwise from Installed Base asset.
  • Title: Covered Item Asset Group ID
    Read Only: true
    Asset group identifier for the item covered by the Subscription Management product.
  • Title: Currency
    Read Only: true
    Maximum Length: 80
    Currency code from the Installed Base asset for goods or Subscription Management product for subscriptions.
  • Title: Currency Code
    Read Only: true
    Maximum Length: 15
    Currency code from the Installed Base asset for goods or Subscription Management product for subscriptions.
  • Title: Current Address
    Read Only: true
    Maximum Length: 429
    Current address of the asset.
  • Title: Current Object Version Number Matching
    Read Only: true
    Maximum Length: 1
    Indicator specifying whether the Installed Base, Subscription Management, and Group Object Version Numbers match. Reads True if the Installed Base Subscription Management and Group Object Version Numbers are the same as in the CPQ read model tables.
  • Title: Customer ID
    Read Only: true
    Sold-to party identifier copied from the Installed Base customer party.
  • Title: Customer Name
    Read Only: true
    Maximum Length: 900
    Sold-to party name copied from the Installed Base customer party.
  • Title: Customer Number
    Read Only: true
    Maximum Length: 30
    Sold-to party number copied from the Installed Base customer party.
  • Title: Fulfillment Line ID
    Read Only: true
    Fulfillment line identifier associated with the source asset group or asset.
  • Title: Asset Group End Date
    Read Only: true
    End date copied from the source sold asset group.
  • Title: Asset Group Start Date
    Read Only: true
    Start date copied from the source sold asset group.
  • Title: Has Asset Children
    Read Only: true
    Maximum Length: 1
    Indicates whether this asset has at least one active child asset relationship.
  • Title: Has Associated Assets
    Read Only: true
    Maximum Length: 1
    Indicates whether this subscription row has associated assets under the product.
  • Title: Has Associations
    Read Only: true
    Maximum Length: 1
    Indicates whether this asset is associated with at least one subscription product.
  • Title: Has Coverages
    Read Only: true
    Maximum Length: 1
    Indicates whether this asset is covered by at least one subscription coverage product.
  • Title: Has Covered Levels
    Read Only: true
    Maximum Length: 1
    Indicates whether this coverage row has covered levels under the subscription product.
  • Title: Has Future Asset
    Read Only: true
    Maximum Length: 1
    Indicates whether this read-model row has a future-dated asset state from a renewal or amendment.
  • Title: Installed Base End Date
    Read Only: true
    Customer asset end date copied from the Installed Base asset.
  • Title: Installed Base Start Date
    Read Only: true
    Customer asset start date copied from the Installed Base asset.
  • Title: Asset Status
    Read Only: true
    Maximum Length: 80
    Operational status code copied from the Installed Base asset.
  • Title: Asset Status Code
    Read Only: true
    Maximum Length: 30
    Operational status code copied from the Installed Base asset.
  • Title: Inactive
    Read Only: true
    Maximum Length: 1
    Indicates whether the read-model row is inactive because it no longer qualifies.
  • Title: Item Description
    Read Only: true
    Maximum Length: 240
    Product item number copied from Product Information Management for display and search.
  • Title: Item Number
    Read Only: true
    Inventory item identifier copied from the Installed Base asset.
  • Title: Item
    Read Only: true
    Maximum Length: 300
    Product item number copied from Product Information Management for display and search.
  • Title: Organization ID
    Read Only: true
    Item organization identifier used with item ID for Product Master joins.
  • Title: Item Organization Name
    Read Only: true
    Maximum Length: 240
    Item organization identifier used with item ID for Product Master joins.
  • Title: Item Type
    Read Only: true
    Maximum Length: 30
    Product item type copied from Product Information Management.
  • Title: Last Update Date
    Read Only: true
    Who column that indicates the date and time of the last update of the row.
  • Title: Legal Entity ID
    Read Only: true
    Legal entity identifier copied from the Subscription Management header.
  • Title: Legal Entity Name
    Read Only: true
    Maximum Length: 240
    Legal entity identifier copied from the Subscription Management header.
  • Links
  • Title: Object Version Number
    Read Only: true
    Used to implement optimistic locking. This number is incremented every time that the row is updated. The number is compared at the start and end of a transaction to detect whether another session has updated the row since it was queried.
  • Title: Subscription End Date
    Read Only: true
    End date copied from the Subscription Management product for lineage and reconciliation.
  • Title: Subscription Start Date
    Read Only: true
    Start date copied from the Subscription Management product for lineage and reconciliation.
  • Title: Subscription Status
    Read Only: true
    Maximum Length: 30
    Lifecycle status copied from the Subscription Management product.
  • Title: Subscription Status Code
    Read Only: true
    Maximum Length: 30
    Lifecycle status copied from the Subscription Management product.
  • Title: Parent Asset Group ID
    Read Only: true
    Parent asset group identifier derived from asset hierarchy and configuration context.
  • Title: Parent Asset ID
    Read Only: true
    Immediate parent Installed Base asset derived from active asset relationships.
  • Title: Quantity
    Read Only: true
    Product Instance Quantity copied from the Installed Base asset.
  • Title: Representative Asset ID
    Read Only: true
    Asset identifier selected as the representative serialized asset for the group. Used by the consolidated view to join back to CPQ_SERIALIZED_ASSETS for descriptive fields.
  • Title: Root Asset Group ID
    Read Only: true
    Root asset group identifier derived from hierarchy and configuration context.
  • Title: Root Asset ID
    Read Only: true
    Root Installed Base asset derived from active asset relationships or set to self.
  • Title: Sales Order ID
    Read Only: true
    Sales order header identifier from Installed Base assets or Subscription Management product source data.
  • Title: Sales Order Line ID
    Read Only: true
    Sales order line identifier from Installed Base assets for goods or Subscription Management product for subscriptions.
  • Title: Sales Order Line Number
    Read Only: true
    Maximum Length: 100
    User-facing source sales order line number from Installed Base assets or Subscription Management product source data.
  • Title: Sales Order Number
    Read Only: true
    Maximum Length: 200
    User-facing source sales order number from Installed Base assets or Subscription Management product source data.
  • Title: Sales Order Source System
    Read Only: true
    Maximum Length: 30
    Source system code for the sales order captured on the Installed Base asset.
  • Title: Sales Product Type
    Read Only: true
    Maximum Length: 30
    Product sales classification copied from Product Information Management.
  • Title: Sales Product Type Code
    Read Only: true
    Maximum Length: 30
    Product sales classification copied from Product Information Management.
  • Title: Serial Number
    Read Only: true
    Maximum Length: 80
    Serial number copied from the source Installed Base asset when available.
  • Title: Ship-to Party ID
    Read Only: true
    Ship-to party identifier from Installed Base assets for goods or Subscription Management product for subscriptions.
  • Title: Ship-to Party Name
    Read Only: true
    Maximum Length: 900
    Ship-to party name from Installed Base assets for goods or Subscription Management product for subscriptions.
  • Title: Ship-to Party Number
    Read Only: true
    Maximum Length: 30
    Ship-to party number from Installed Base assets for goods or Subscription Management product for subscriptions.
  • Title: Ship-to Party Site
    Read Only: true
    Maximum Length: 429
    Ship-to party site address from Installed Base assets for goods or Subscription Management product for subscriptions.
  • Title: Ship-to Party Site ID
    Read Only: true
    Ship-to party site identifier from Installed Base assets or Subscription Management product source data.
  • Title: Sold-by Business Unit ID
    Read Only: true
    Business unit identifier that sold the asset or subscription.
  • Title: Sold-by Business Unit Name
    Read Only: true
    Maximum Length: 240
    Business unit identifier that sold the asset or subscription.
  • Title: Subscription ID
    Read Only: true
    Subscription header identifier copied from the subscription header.
  • Title: Subscription Number
    Read Only: true
    Maximum Length: 120
    Subscription number copied from the subscription header for subscription rows.
  • Title: Subscription Product ID
    Read Only: true
    Subscription Management identifier used to join asset group rows to Subscription Management products.
  • Title: Subscription Product PUID
    Read Only: true
    Maximum Length: 120
    Public unique identifier copied from Subscription Management.
  • Title: Suspended Date
    Read Only: true
    Suspended date copied from Subscription Management for lifecycle handling.
  • Title: UOM
    Read Only: true
    Maximum Length: 80
    Unit of measure code copied from the Installed Base asset.
  • Title: UOM Code
    Read Only: true
    Maximum Length: 3
    Unit of measure code copied from the Installed Base asset.
Back to Top