You can request specific nodes in the response from the following Digital Commerce APIs by creating a DataRaptor interface, a DataRaptor transformer, and a post hook for the API response handler.
AssetToBasket
BasketOperations
ConfigureOffer
GetOffers
GetOfferDetails
You will need to specify the nodes you want to include in the API response. Specifying specific nodes in the API call reduces the verbosity of the API response, thereby decreasing overhead and bandwidth requirements.
The following example instructions use the GetOffers API and specify the offers:offerType, offers:priceResult:UnitPrice, and offers:ProductCode nodes in the response.
To reduce the size of Digital Commerce API responses:
Go to the Vlocity DataRaptor tab in your org and click New.
In the Create Vlocity DataRaptor Interface window, enter a unique name for the DataRaptor interface, such as OffersTransformer.
From the Interface Type list, select Transform.
From the Input Type and Output Type lists, select JSON and click Save. The DataRaptor transformer is displayed on the Vlocity DataRaptor Interface page.
Click + to add input and output JSON paths (nodes).
In Input JSON Path and Output JSON Path, enter a valid JSON path from the API’s response, such as offers:offerType.
From the Output Data Type list, select the data type for the node, such as String.
Click Save and then click + to add more nodes as needed.
Use sample input to test the DataRaptor transformer. The following sample input to GetOffers should return a transformed response similar to the following example output.
Sample GetOffers input:
1{
2 "contextKey": "b50d669c29ef610a5b9ba6b4cd734258",
3 "offers": [
4 {
5 "addtocart": {
6 "rest": {
7 "params": {
8 "basketAction": "AddWithNoConfig",
9 "offer": "accessories"
10 },
11 "link": "v3/catalogs/mobiles/basket",
12 "method": "POST"
13 }
14 },
15 "offerDetailsAction": {
16 "rest": {
17 "params": {},
18 "method": "GET",
19 "link": "/v3/catalogs/mobiles/offers/accessories"
20 },
21 "remote": {
22 "params": {}
23 },
24 "client": {
25 "records": [],
26 "params": {}
27 }
28 },
29 "Name": "accessories",
30 "Description": "accessories",
31 "ProductCode": "accessories",
32 "Attachments": null,
33 "offerType": "Product"
34 },
35 {
36 "addtocart": {
37 "rest": {
38 "params": {
39 "basketAction": "AddWithNoConfig",
40 "offer": "FastCharger"
41 },
42 "link": "v3/catalogs/mobiles/basket",
43 "method": "POST"
44 }
45 },
46 "offerDetailsAction": {
47 "rest": {
48 "params": {},
49 "method": "GET",
50 "link": "/v3/catalogs/mobiles/offers/FastCharger"
51 },
52 "remote": {
53 "params": {}
54 },
55 "client": {
56 "records": [],
57 "params": {}
58 }
59 },
60 "priceResult": [
61 {
62 "adjustments": [],
63 "overrides": [],
64 "chargeamount": 10,
65 "baseamount": 10,
66 "Amount__c": 10,
67 "IsVirtualPrice__c": false,
68 "IsBasePrice__c": true,
69 "effectiveuntildatespec": null,
70 "effectivefromdatespec": null,
71 "SubType__c": "Standard",
72 "Type__c": "Price",
73 "RecurringFrequency__c": null,
74 "ChargeType__c": "One-time",
75 "DisplayText__c": "fc",
76 "UnitPrice": 10
77 }
78 ],
79 "Name": "FastCharger",
80 "Description": "FastCharger",
81 "ProductCode": "FastCharger",
82 "Attachments": null,
83 "offerType": "Product"
84 },
85 {
86 "addtocart": {
87 "rest": {
88 "params": {
89 "basketAction": "AddWithNoConfig",
90 "offer": "S10"
91 },
92 "link": "v3/catalogs/mobiles/basket",
93 "method": "POST"
94 }
95 },
96 "offerDetailsAction": {
97 "rest": {
98 "params": {},
99 "method": "GET",
100 "link": "/v3/catalogs/mobiles/offers/S10"
101 },
102 "remote": {
103 "params": {}
104 },
105 "client": {
106 "records": [],
107 "params": {}
108 }
109 },
110 "priceResult": [
111 {
112 "adjustments": [],
113 "overrides": [],
114 "chargeamount": 500,
115 "baseamount": 500,
116 "Amount__c": 500,
117 "IsVirtualPrice__c": false,
118 "IsBasePrice__c": true,
119 "effectiveuntildatespec": null,
120 "effectivefromdatespec": null,
121 "SubType__c": "Standard",
122 "Type__c": "Price",
123 "RecurringFrequency__c": null,
124 "ChargeType__c": "One-time",
125 "DisplayText__c": "one time base",
126 "UnitPrice": 500
127 },
128 {
129 "adjustments": [],
130 "overrides": [],
131 "chargeamount": 50,
132 "baseamount": 50,
133 "Amount__c": 50,
134 "IsVirtualPrice__c": false,
135 "IsBasePrice__c": true,
136 "effectiveuntildatespec": null,
137 "effectivefromdatespec": null,
138 "SubType__c": "Standard",
139 "Type__c": "Price",
140 "RecurringFrequency__c": "Monthly",
141 "ChargeType__c": "Recurring",
142 "DisplayText__c": "s10 rec base"
143 }
144 ],
145 "Name": "S10",
146 "Description": "S10",
147 "ProductCode": "S10",
148 "Attachments": null,
149 "offerType": "Product"
150 }
151 ],
152 "errorCode": "INVOKE-200",
153 "error": "OK"
154}Expected reduced output:
1{
2 "offers": [
3 {
4 "offerType": "Product",
5 "ProductCode": "accessories"
6 },
7 {
8 "offerType": "Product",
9 "ProductCode": "FastCharger",
10 "UnitPrice": 10
11 },
12 {
13 "offerType": "Product",
14 "ProductCode": "S10",
15 "UnitPrice": 500
16 }
17 ]
18}Create a post hook for the response handler to transform responses from getOffers.
Sample post hook:
1Object offers = output.get('offers');
2Map<String, Object> bodyData = new Map<String, Object> {
3'bulkUpload' => false,
4'bundleName' => 'OffersTransformer', //name of the transformer
5'debug' => false,
6'objectList' => new List<Object> { output }
7};
8Map<String, Object> re = (Map<String, Object>)DRGlobal.processPost(bodyData);
9Map<String, Object> resultsData = (Map<String, Object>)re.get('returnResultsData');
10output.put('offers', resultsData.get('offers'));
j