Newer Version Available

This content describes an older version of this product. View Latest

Configurator Input

Input representation of the request to modify the product configuration.
JSON example
This example shows a sample to initiate a context based on a transaction ID.
1"configurationRequest": {
2    "transactionLineId": "0QLDE000000IBXw4AO",
3    "transactionId": "0Q0xx0000000001GAA",
4    "correlationId": "c95246d4-102c-4ecd-a263-f74ac525d1e5",
5    "configuratorOptions": {
6        "executePricing": true,
7        "returnProductCatalogData": true
8    },
9    "qualificationContext": {
10        "accountId": "001xx0000000001AAA",
11        "contactId": "003xx00000000D7AAI"
12    }
13}
This example shows a sample to add, update, or delete a node in an existing context.
1{
2    "transactionLineId": "0QLDE000000IBXw4AO",
3    "transactionId": "0Q0DE000000ISHJs81",
4    "correlationId": "c95246d4-102c-4ecd-a263-f74ac525d1e5",
5    "configuratorOptions": {
6        "executePricing": true,
7        "returnProductCatalogData": true,
8        "qualifyAllProductsInTransaction": true,
9        "validateProductCatalog": true,
10        "validateAmendRenewCancel": true,
11        "executeConfigurationRules": true,
12        "addDefaultConfiguration": true
13    },
14    "contextResponseType": "Full",
15    "qualificationContext": {
16        "accountId": "001xx0000000001AAA",
17        "contactId": "003xx00000000D7AAI"
18    },
19    "transactionContextId": "008d27d7-e004-4906-a949-ee7d7c323c77",
20    "addedNodes": [
21        {
22            "path": ["0Q0DE000000ISHJs81", "sti2_id"],
23            "addedObject": {
24                "id": "ref_sti2_id",
25                "SalesTransactionSource": "sti2_id",
26                "PricebookEntry": "01uxx0000000001AAA",
27                "ProductSellingModel": "0jPxx0000000001AAA",
28                "businessObjectType": "QuoteLineItem",
29                "Quantity": 10,
30                "UnitPrice": 2.0,
31                "Product": "01txx0000000001AAA"
32            }
33        },
34        {
35            "path": ["0Q0DE000000ISHJs81", "ref_sti2_id","ref_stir1_id"],
36            "addedObject": {
37                "id": "ref_stir1_id",
38                "businessObjectType": "QuoteLineItemRelationship",
39                "MainItem": "0QLDE000000IBXw4AO",
40                "AssociatedItem": "ref_sti2_id",
41                "ProductRelatedComponent": "0dSxx0000000001AAA",
42                "ProductRelationshipType": "0yoxx0000000001AAA",
43                "AssociatedItemPricing": "IncludedInBundlePrice"
44                
45            }
46        }
47    ],
48    "updatedNodes": [
49        {
50            "path": ["0Q0DE000000ISHJs81", "0QLDE000000IBXw4AO"],
51            "updatedAttributes": {
52                "Quantity": 5
53            }
54        }
55    ],
56    "deletedNodes": [
57        {
58            "path": ["0Q0DE000000ISHJs81", "0QLDE000000IBXw4AO"]
59        }
60    ]
61}
Properties
Name Type Description Required or Optional Available Version
added​Nodes Configurator Added Node Input[] List of added context nodes that’s passed to the product configurator. Optional 60.0
configurator​Options Configurator Options Input[] Options to pass to the configurator. Optional 60.0
context​ResponseType String

Specifies the type of transaction context response. Valid values are:

  • Delta—Returns the sales transaction items that are added or updated.
  • Full—Returns all sales transaction items in a transaction.
  • None—Returns empty transaction context response.
  • Product—Returns the sales transaction items related to the product that's being configured.
Required for large sales transactions with more than 1000 line items and less than 15K line items. 65.0
correlation​Id String ID that’s specified for traceability of logs. Optional 60.0
deleted​Nodes Configurator Deleted Node Input[] List of deleted context nodes that’s passed to the product configurator. Optional 60.0
qualification​Context User Context Input[] Details such as account ID, contact ID, and context ID that are used for executing qualification rules. Optional 60.0
transaction​ContextId String ID of the transaction context. Optional 60.0
transaction​Id String ID of the sales transaction that’s being configured such as a quote or an order. Required 60.0
transaction​LineId String ID of the top-level line item that’s being configured. Optional 60.0
updated​Nodes Configurator Updated Node Input[] List of updated context nodes that’s passed to the product configurator. Optional 60.0