Get Details of Product

For all disqualified promotions or products, get a message about which rule conditions failed. Return information about why a product or promotion was disqualified.

1GET /v2/cpq/carts/{cart_ID}/products/{pricebook_entry_ID}?include=qualifications&ruleType=Qualification

1GET v2/cpq/carts/{cart_ID}/promotions/{promotion_ID}?include=qualifications&ruleType=Qualification

This API supports the guest user enhancements that Salesforce introduced with the Winter ‘21 release. To encrypt and decrypt data for guest users, use the UserSecurity class with this API. See Guest User Technical Details.

For additional information, see UserSecurity Class and CPQ and Digital Commerce Changes for Guest Users.

Remote Method

1getRuleMessages

REST Handler

1APIProductsCartsCpqV2

Apex Remote Service

1CpqAppHandler

Apex Remote Input Map

1{
2  methodName: getRuleMessages
3  ruleEvaluationInput: null
4  ruleType: Qualification
5  include: qualifications
6  id: <pricebookentryId/promotionId>
7  cartId:<cartId>
8}

Package

Communications (vlocity_cmt)

API Parameters and Response Format

For API parameter names and descriptions, see Cart-Based API Swagger Reference.

Resource Information

Response Format	JSON
Resource URL	`/services/apexrest/{namespace}/v2/cpq/carts/801f4000000kCNPAA2/products/01uf4000000sMtjAAE?include=qualifications&ruleType=Qualification`
Resource URL	`/services/apexrest/{namespace}/v2/cpq/carts/801f4000000kCNPAA2/promotions/a2ff4000000LUCDAA4?include=qualifications&ruleType=Qualification`

Example Request

1GET
2/services/apexrest/vlocity_cmt/v2/cpq/carts/801f4000000kCNPAA2/products/01uf4000000sMtjAAE?include=qualifications&ruleType=Qualification

Example Response

1{
2   "totalSize": 1,
3   "messages": [],
4   "records": [{
5      "messages": [],
6      "displaySequence": -1,
7      "id": "01uf4000000sMtjAAE",
8      "name": "TestProd-2",
9      "product2id": "01tf4000000YyZyAAK",
10      "product2.description": "TestProd-2",
11      "qualifications": {
12         "totalSize": 1,
13         "messages": [],
14         "records": [{
15            "messages": [{
16               "severity": "WARN",
17               "messageId": null,
18               "message": "ruleset: accName is not acc-4",
19               "code": "207",
20               "bundleId": null,
21               "actions": {}
22            }],
23            "displaySequence": -1,
24            "name": "Ruleset-5",
25            "type": "ruleset",
26            "qualifications": {
27               "totalSize": 1,
28               "messages": [],
29               "records": [{
30                  "messages": [{
31                     "severity": "WARN",
32                     "messageId": null,
33                     "message": "accountName is not acc-4",
34                     "code": "207",
35                     "bundleId": null,
36                     "actions": {}
37                  }],
38                  "displaySequence": -1,
39                  "name": "accountName is acc-4",
40                  "code": "accountName is acc-4",
41                  "type": "rule",
42                  "qualifications": {
43                     "totalSize": 2,
44                     "messages": [],
45                     "records": [{
46                        "messages": [{
47                           "severity": "WARN",
48                           "messageId": null,
49                           "message": "rsCond: accName is not acc-4",
50                           "code": "301",
51                           "bundleId": null,
52                           "actions": {}
53                        }],
54                        "displaySequence": -1,
55                        "code": "accountName is acc-4-con-1",
56                        "type": "rulecondition"
57                     }, {
58                        "messages": [{
59                           "severity": "WARN",
60                           "messageId": null,
61                           "message": "channel is not web",
62                           "code": "301",
63                           "bundleId": null,
64                           "actions": {}
65                        }],
66                        "displaySequence": -1,
67                        "code": "cod-2-1-1",
68                        "type": "rulecondition"
69                     }]
70                  }
71               }]
72            }
73         }]
74      }
75   }]
76}