You are here:
Get Quote Line Item Product and Attribute Details Invocable Action
Retrieve product and selected attribute details for all line items on a quote or for specified quote line items.
Required Editions
| Available in: Lightning Experience |
| Available in: Enterprise, Unlimited, and Developer Editions |
Available from the Salesforce REST Actions API, Flow Builder, and OmniStudio in API version 68.0 and later, this synchronous action retrieves quote line items with product and attribute details. Specify either a quote ID or a list of quote line item IDs.
Input Values
| Parameter | Required | Description | Data Type |
|---|---|---|---|
| quoteId | Conditional | The ID of the quote. Either quoteId or qliIds is required. Skip this if qliIds are provided. |
String |
| qliIds | Conditional | The quote line item IDs to retrieve. Either quoteId or qliIds is required. Skip this if quoteId is provided. |
List of Strings |
| fields | No | Additional quote line item fields to retrieve. The default fields are Id, Product2.ProductCode, Product2.Name, and AttributeSelectedValues__c. |
List of Strings |
| checkAsyncJobStatus | No | A Boolean value that indicates whether to check for running asynchronous jobs before retrieving data. The default value is true. |
Boolean |
Output Values
| Parameter | Description | Data Type |
|---|---|---|
| quoteLineItems | The quote line items with product and selected attribute details. | List of Strings |
| error | An error message if the details couldn't be retrieved. | String |
Usage
Use quoteId to retrieve details for the line items on a quote. Use qliIds to retrieve only selected quote line items.
Specify fields to return fields in addition to the default product and attribute fields.
The action returns its result synchronously.
Considerations
- Specify either
quoteIdorqliIds. - The running user must have access to the record.
- Business and validation failures are returned in
outputValues.error, even when the Actions API envelope containsisSuccess=true.
Example Input
{
"inputs": [
{
"quoteId": "0Q0XXXXXXXXXXXXXXX",
"fields": ["Quantity", "UnitPrice"]
}
]
}Example Output
[
{
"actionName": "vlocity_cmt__B2BCmexGetQLIPrdtDetailsInvocable",
"isSuccess": true,
"errors": null,
"outputValues": {
"quoteLineItems": [
{
"Id": "0QLXXXXXXXXXXXXXXX",
"Product2": { "ProductCode": "BROADBAND", "Name": "Business Broadband" },
"AttributeSelectedValues__c": "{\"SPEED\":\"1Gbps\"}"
}
],
"error": null
}
}
]Error Handling
Check outputValues.error to determine whether the action succeeded. Business and validation failures don't populate the Actions API errors array.
If neither identifier is supplied, the action returns:
You must specify a value for the quoteId or qliIds parameter.An access failure returns an error that directs the user to contact a Salesforce admin.
