--- title: Sales CRM Pricing API description: The Sales CRM Pricing API provides methods to calculate prices for transaction lines containing products.Terminate a session with a given ID that was established during a configurator session.Enables callers to compute the price of products specified in the request payload. The pricing settings included in the payload determine and control the execution flow of the Pricing Engine, such as whether to apply validations, adjustments, or rollups. locale: en-US canonical_url: https://www.servicenow.com/docs/r/api-reference/rest-apis/sales-crm-pricing-api.html release: brazil product: REST APIs classification: rest-apis topic_type: concept last_updated: "2026-09-10" reading_time_minutes: 51 breadcrumb: [REST API reference, API reference, API implementation and reference] --- # Sales CRM Pricing API The Sales CRM Pricing API provides methods to calculate prices for transaction lines containing products. The Sales CRM Pricing is used to calculate prices for transaction lines containing products. It also supports computing rollups at the transaction header level by aggregating values from all lines. In addition, the Pricing Engine can be used within a configurator to determine the price of products as they are selected or configured. The caller has flexibility through various controls to specify whether the engine should compute: - Prices only - Costs - Adjustments \(discounts, markup\) - Rollups at line and/or header level This API belongs to the sn\_csm\_pricing namespace and requires the \[sn\_csm\_pricing.pricing\_integrator\] role. Prerequisite: You need to set up a product offering that consists of these properties: - Required: - Product offering characteristics - Unit of measure - Price list - Price list lines - Attribute adjustments - Optional - Context variables - Rule matrices ## External ID support With external ID resolution, you can use your own identifiers or codes for selected reference fields instead of a ServiceNow sys\_id. For example, you might be integrating with other CRM or ERP systems that do not have a ServiceNow sys\_id for its objects. You can use external codes for the following reference fields, including but not limited to: - Product offering - Price list - Unit of measure **Note:** External ID resolution applies to REST API pricing requests only and does not affect UI-based flows. Pricing execution can use internal system IDs, external IDs, or a combination of both IDs in pricing requests as configured in the context variable mapping. Context variable configuration and mapping As an admin, before submitting a REST API pricing request, create the context variables that define the reference fields for external IDs or codes that are participating in external ID resolution. You also add the external IDs or codes to the reference tables called by pricing requests. For details on defining context variables, see [External ID support in Sales CRM Pricing API](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/order-management/external-ids-pricingapi.md). How external IDs work in pricing requests **Request intake** The caller sends a Pricing REST API request that can include: - External IDs or codes - ServiceNow sys\_ids - A combination of both Requests must include \(`"use_external_code": true`\) in the settings object to enable external code resolution. **Parent Topic:**[REST API reference](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-apis/api-rest.md) ## Sales CRM Pricing - DELETE - /api/sn\_csm\_pricing/v1/pricingengine/pricing\_context/\{pricing\_context\_id\} Terminate a session with a given ID that was established during a configurator session. ### URL format Versioned URL: `/api/sn_csm_pricing/v1/pricingengine/pricing_context/{pricing_context_id}` Default URL: `/api/sn_csm_pricing/pricingengine/pricing_context/{pricing_context_id}` ### Supported request parameters
Name Description
api\_version Optional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String
pricing\_context\_id ID from pricing engine request when scope is configurator.
|Name|Description| |----|-----------| |None| | |Name|Description| |----|-----------| |None| | ### Headers The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
Header Description
Accept Data format of the response body. Supported types: **application/json** or **application/xml**. Default: **application/json**
|Header|Description| |------|-----------| |status|Indicates the overall outcome of the requested operation.| |message|A human-readable message that provides more detail about the status. It is useful for logging or for displaying a confirmation to an end-user. In this case, it explicitly states that the deletion was successful.| |pricing\_context\_id|The unique of the resource that was affected by the operation. By returning the ID, the API confirms exactly which pricing context has been deleted, which helps prevent ambiguity.| ### Status codes The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md). |Status code|Description| |-----------|-----------| |200|Successful. The request was successfully processed.| ### Response body parameters \(JSON or XML\) |Name|Description| |----|-----------| |None|| ### cURL request ``` curl -i -X DELETE \ 'https://instance.servicenow.com/api/sn_csm_pricing/v1/pricingengine/pricing_context/{pricing_context_id}' \ --user 'username:password' ``` ## Sales CRM Pricing - POST /api/sn\_csm\_pricing/\{api\_version\}/pricingengine/computePrice Enables callers to compute the price of products specified in the request payload. The pricing settings included in the payload determine and control the execution flow of the Pricing Engine, such as whether to apply validations, adjustments, or rollups. ### URL format Versioned URL: `/api/sn_csm_pricing/{api_version}/pricingengine/computePrice` Default URL: `` ### Supported request parameters |Name|Description| |----|-----------| |None| | |Name|Description| |----|-----------| |None| |
Name Description
header Required. Contains transaction-level details, line items, currency, pricelist, and transaction date.Data type: Object ``` { "header": { "source_system": "String", "requesting_record_id": "String", "currency": "String", "lineItems": [Array], "pricelist": "String", "transaction_date": "String" } } ```
header.source\_system Required. The system initiating the request.Data type: String Example: `ServiceNow REST API`
header.requesting\_record\_id Required. Unique identifier for this request.Data type: String Example: `QT0001101`
header.currency Required. Currency code for pricing. Supports only ServiceNow currencies.Data type: String Example: `USD`
header.transaction\_date Required. The date and time of the transaction.Format: Format: glide\_date\_time value, such as `yyyy-MM-dd HH:mm:ss` Data type: datetime Example: `2023-12-18 23:37:11`
header.pricelist Required. The default pricelist ID to use for the transaction.Data type: String Example: `19d29513d0e63110f8770dbf976be122`
header.lineItems Required. Array of line-item objects detailing products, quantities, and pricing info.``` { "lineItems": [ { "line_id": "String", "pricelist": "String", "product_offering": "String", "periodicity": "String", "quantity": "String", "unit_of_measure": "String", "transaction_date": "String", "account_tier": "String", "selected": "Boolean", "top_product_offer": "String", "parent_product_offer": "String", "settings": {Object} } ] } ```
header.lineItems\[\].line\_id Required. Unique identifier for this line item.Data type: String Example: `CONNECTEDC1100`
header.lineItems\[\].pricelist Required. Pricelist ID for this line item.Data type: String Example: `19d29513d0e63110f8770dbf976be122`
header.lineItems\[\].product\_offering Required. Product offering ID for this line item.Data type: String Example: `db61dd9fd0a63110f8770dbf976be19c`
header.lineItems\[\].periodicity Identifies the frequency. Possible values are `monthly`, `annually`, or null/undefined.Data type: String Example: `monthly`
header.lineItems\[\].quantity Required. Quantity of the product.Data type: String Example: `1`
header.lineItems\[\].unit\_of\_measure Required. Unit of measure ID.Data type: String Example: `cb2795d553020110286eddeeff7b12ff`
header.lineItems\[\].transaction\_date Required. Date of the transaction specific to this line item.Format: glide\_date\_time value Data type: datetime Example: `2023-12-18 23:37:11`
header.lineItems\[\].account\_tier Optional account tier \(e.g., "gold"\) for pricing logic. If account\_tier is a context variable used in rule matrices.Data type: String
header.lineItems\[\].selected Indicates if the line item is selected in a configurator scenario. Only applicable for child lines in bundle.Data type: Boolean Example: `true`
header.lineItems\[\].top\_product\_offer Identifier for top-level product in a configuration bundle.Data type: String Example: `db61dd9fd0a63110f8770dbf976be19c`
header.lineItems\[\].parent\_product\_offer Identifier for the parent product in a bundle line item.Data type: String Example: `26d07c3211707110f877366201dea60c`
settings Required. Contains pricing engine settings and options.Data type: Object ``` { "settings": { "pricing_elements": "String", "disable_validation": boolean } } ```
settings.pricing\_elements Required. Comma-separated list of elements to return.Data type: String Example: `PRICE,COST,NET_PRICE,LINE_ROLLUPS,HEADER_ROLLUPS,ADJUSTMENTS`
settings.disable\_validation Whether to disable validation checks on request.Data type: Boolean Example: `true`
settings.config\_lines\_expanded Indicates if all the lines for bundle are sent on the request. At this moment, for configurator we expect all lines to be sent for every pricing call coming from configurator.Data type: Boolean Example: `true`
settings.scope Scope of pricing.Data type: String Example: `configurator`
settings.config\_top\_line\_identifier The line ID of the top-level product in configuration.Data type: String Example: `HOMEAUTOMA2000`
settings.use\_external\_code Indicates if the system performs external code lookup.Data type: Boolean Example: `true`
### Headers The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
Header Description
Accept Data format of the response body. Supported types: **application/json** or **application/xml**. Default: **application/json**
|Header|Description| |------|-----------| |None| | ### Status codes The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md). |Status code|Description| |-----------|-----------| |200|Successful. The request was successfully processed.| ### Response body parameters \(JSON or XML\)
Name Description
header.currency Currency code used in the pricing response. Similar to the one sent in the request.Data type: String Example: `USD`
header.costbook Identifier of the costbook used for pricing.Data type: String \(Sys\_id\)
header.lineItems Contains pricing details for each line item.Data type: Array<Object> ``` { "lineItems": [ { "line_id": "String", "status": "String", "currency": "String", "base_price": { "value": "String", "displayValue": "String" }, "list_price": { "value": "String", "displayValue": "String" }, "pricelist": "String", "quantity": "", "price_list_line": "String", "product_offering": "String", "one_time_price": { "value": "String", "displayValue": "String" }, "monthly_recurring_price": { "value": "String", "displayValue": "String" }, "annual_recurring_price": { "value": "String", "displayValue": "String" }, "unit_net_price": { "value": "String", "displayValue": "String" }, "cumulative_net_price": { "value": "String", "displayValue": "String" }, "cumulative_one_time_price": { "value": "String", "displayValue": "String" }, "cumulative_monthly_recurring_price": { "value": "String", "displayValue": "String" }, "cumulative_annual_recurring_price": { "value": "String", "displayValue": "String" }, "unit_adjustment": { "value": "String", "displayValue": "String" }, "term_month": { "value": Integer, "displayValue": Integer }, "cumulative_annual_recurring_price_v1": { "value": Integer, "displayValue": Integer }, "cumulative_monthly_recurring_price_v1": { "value": 0, "displayValue": 0 }, "total_recurring_price": { "value": "String", "displayValue": "String" }, "pricingAdjustments": [], "total_adjustment_amount": [] } ] } ```
header.lineItems\[\].line\_id Identifier of the line item.Data type: String Example: `CONNECTEDC1100`
header.lineItems\[\].status Status of the pricing calculation for the line item.Valid options: - Success - Failure Data type: String Example: `Success`
header.lineItems\[\].base\_price Base price before adjustments.Data type: Object ``` { "base_price": { "value": "String", "displayValue": "String" } } ```
header.lineItems\[\].list\_price List price which is base price and attribute adjustments included.Data type: Object ``` { "list_price": { "value": "String", "displayValue": "String" } } ```
header.lineItems\[\].pricelist Price list reference.Data type: String \(Sys\_id\)
header.lineItems\[\].quantity Quantity sent as part of request.Data type: String Example: `1`
header.lineItems\[\].price\_list\_line Price list line reference.Data type: String \(Sys\_id\) Example: `3e93e785d07a7910f8770dbf976be1ee`
header.lineItems\[\].product\_offering Product offering reference.Data type: String \(Sys\_id\) Example: `db61dd9fd0a63110f8770dbf976be19c`
header.lineItems\[\].one\_time\_price One-time price for the product, unit net price \* quantity.Data type: Object ``` { "one_time_price": { "value": "String", "displayValue": "String" } } ```
header.lineItems\[\].monthly\_recurring\_price Monthly recurring price for the product inclusive of all quantities.Data type: Object ``` { "monthly_recurring_price": { "value": Integer, "displayValue": Integer } } ```
header.lineItems\[\].annual\_recurring\_price Annual recurring price for the product inclusive of all quantities.Data type: Object ``` { "annual_recurring_price": { "value": "String", "displayValue": "String" } } ```
header.lineItems\[\].unit\_net\_price Net price per unit after auto adjustments.Data type: Object ``` { "unit_net_price": { "value": "String", "displayValue": "String" } } ```
header.lineItems\[\].cumulative\_net\_price \[One time price + \(Monthly Recurring price \* Term\)\] + \(if parent line\) sum of all CNP for immediate and grand child linesData type: Object ``` { "cumulative_net_price": { "value": "String", "displayValue": "String" } } ```
header.lineItems\[\].cumulative\_one\_time\_price For Child- One time price for the line item. For Parent line item - One time price for the line item + One time price for all child and grand child line items.Data type: Object ``` { "cumulative_one_time_price": { "value": "String", "displayValue": "String" } } ```
header.lineItems\[\].cumulative\_monthly\_recurring\_price If price method = recurring. Monthly Recurring price for the line + \(if parent line\) sum of all monthly recurring price of child lines.Data type: Object ``` { "cumulative_monthly_recurring_price": { "value": "String", "displayValue": "String" } } ```
header.lineItems\[\].cumulative\_annual\_recurring\_price If price method = recurring. Cumulative Monthly Recurring Price \* 12.Data type: Object ``` { "cumulative_annual_recurring_price": { "value": "String", "displayValue": "String" } } ```
header.lineItems\[\].unit\_adjustment Price adjustment applied per unit.Data type: Object ``` { "unit_adjustment": { "value": "String", "displayValue": "String" } } ```
header.lineItems\[\].term\_month Term duration in months.Data type: Object ``` { "term_month": { "value": Integer, "displayValue": Integer } } ```
header.lineItems\[\].cost Unit cost of the product.Data type: Object ``` { "cost": { "value": Integer, "displayValue": Integer } } ```
header.lineItems\[\].unit\_margin\_amount Profit margin amount per unit.Data type: Object ``` { "cost": { "value": Integer, "displayValue": Integer } } ```
header.lineItems\[\].unit\_margin\_percentage Profit margin percentage per unit.Data type: Object
header.lineItems\[\].one\_time\_cost One-time cost for the product inclusive of all quantities.Data type: Object
header.lineItems\[\].monthly\_recurring\_cost Monthly recurring cost for the product inclusive of all quantities.Data type: Object
header.lineItems\[\].cumulative\_one\_time\_cost For Child- One time cost for the line item. For Parent line item - One time cost for the line item + One time cost for all child and grand child line items.Data type: Object
header.lineItems\[\].cumulative\_monthly\_recurring\_cost If price method = recurring. Monthly Recurring cost for the line + \(if parent line\) sum of all monthly recurring cost of child lines.Data type: Object
header.lineItems\[\].cumulative\_net\_cost \[One time cost + \(Monthly Recurring cost \* Term\)\] + \(if parent line\) sum of all CNC for immediate and grand child linesData type: Object
header.lineItems\[\].cumulative\_margin\_percentage Overall margin percentage.Data type: Object
header.status Status of the overall pricing request.Valid options are: - Success - Failure - Partial Failure Data type: String Example: `Success`
header.total\_monthly\_recurring\_price Aggregated monthly recurring price.Data type: Object
header.total\_annual\_recurring\_price Aggregated annual recurring price.Data type: Object
header.total\_amount Total transaction amount.Data type: Object
header.total\_one\_time\_price Aggregated one-time price.Data type: Object
header.total\_one\_time\_cost Aggregated one-time cost.Data type: Object
header.total\_monthly\_cost Aggregated monthly cost.Data type: Object
header.total\_cost Total cost \(one-time + recurring\).Data type: Object
header.total\_one\_time\_margin Total margin from one-time charges.Data type: Object
header.total\_monthly\_margin Total margin from monthly charges.Data type: Object
header.total\_margin\_amount Total profit margin amount.Data type: Object
header.total\_one\_time\_margin\_percentage Margin percentage for one-time charges.Data type: Object
header.total\_monthly\_margin\_percentage Margin percentage for monthly charges.Data type: Object
header.total\_margin\_percentage Overall margin percentage.Data type: Object
settings.pricing\_elements Elements included in the pricing response \(PRICE, COST, NET\_PRICE, etc.\).Data type: String
settings.pricing\_context\_id Identifier for pricing session when scope is configurator.Data type: String
### Example usage These examples demonstrate basic usage, to include: - Calculating a price for a single product - Calculate prices for multiple products with header roll-ups - Initiate a product configuration session - Update a product configuration \(change a characteristic option\) ### Calculate price for a single product This example demonstrates a basic price calculation for a single product offering. The API is called with one line item, and the request specifies that the PRICE, COST,NET\_PRICE,LINE\_ROLLUPS,HEADER\_ROLLUPS and ADJUSTMENTS should be calculated and returned. This is a foundational request for getting the price of an individual item without any complex configurations or adjustments. Example: cURL request. ``` curl "https://instance.servicenow.com/api/sn_csm_pricing/v1/pricingengine/computePrice" \ --request POST \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --data '{ "header": { "source_system": "ServiceNow Headless API", "requesting_record_id": "QT0001101", "currency": "USD", "lineItems": [ { "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "db61dd9fd0a63110f8770dbf976be19c", "periodicity" : "", "quantity": "1", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "transaction_date": "2023-12-18 23:37:11", "line_id": "CONNECTEDC1100" } ], "pricelist": "19d29513d0e63110f8770dbf976be122", "transaction_date": "2023-12-18 23:37:11" }, "settings": { "pricing_elements": "PRICE,COST,NET_PRICE,LINE_ROLLUPS,HEADER_ROLLUPS,ADJUSTMENTS", "disable_validation": true } }' \ --user 'username:password' ``` ``` { "result": { "header": { "currency": "USD", "lineItems": [ { "line_id": "CONNECTEDC1100", "status": "Success", "currency": "USD", "base_price": { "value": "0.0000", "displayValue": "$0.00" }, "list_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "", "price_list_line": "3e93e785d07a7910f8770dbf976be1ee", "product_offering": "db61dd9fd0a63110f8770dbf976be19c", "one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_net_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_net_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_adjustment": { "value": "0.0000", "displayValue": "$0.00" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": 0, "displayValue": 0 }, "cumulative_monthly_recurring_price_v1": { "value": 0, "displayValue": 0 }, "total_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricingAdjustments": [], "total_adjustment_amount": [] } ], "status": "Success", "total_monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "total_monthly_recurring_price_v1": { "value": "0.0000", "displayValue": "$0.00" }, "total_annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "total_annual_recurring_price_v1": { "value": "0.0000", "displayValue": "$0.00" }, "total_amount": { "value": "0.0000", "displayValue": "$0.00" }, "total_amount_v1": { "value": "0.0000", "displayValue": "$0.00" }, "total_one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "total_one_time_cost": { "value": "0.0000", "displayValue": "$0.00" }, "total_monthly_cost": { "value": "0.0000", "displayValue": "$0.00" }, "total_cost": { "value": "0.0000", "displayValue": "$0.00" }, "total_one_time_margin": { "value": "0.0000", "displayValue": "$0.00" }, "total_monthly_margin": { "value": "0.0000", "displayValue": "$0.00" }, "total_margin_amount": { "value": "0.0000", "displayValue": "$0.00" }, "total_one_time_margin_percentage": { "value": "0.0000", "displayValue": "$0.00" }, "total_monthly_margin_percentage": { "value": "0.0000", "displayValue": "$0.00" }, "total_margin_percentage": { "value": "0.0000", "displayValue": "$0.00" } }, "settings": { "pricing_elements": "PRICE,COST,NET_PRICE,LINE_ROLLUPS,HEADER_ROLLUPS,ADJUSTMENTS" } } } ``` ### Calculate prices for multiple products with header roll-ups This example shows how to send a list of multiple, distinct products to be priced in a single transaction. A key difference in this request is the inclusion sending multiple products in same request. This instructs the pricing engine to calculate the individual price for each line item and to compute and return the aggregated totals for the entire request. Example: cURL request. ``` curl "https://instance.servicenow.com/api/sn_csm_pricing/v1/pricingengine/computePrice" \ --request POST \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --data '{ "header": { "source_system": "Test Source System", "requesting_record_id": "QT0001101", "currency": "USD", "lineItems": [ { "top_product_offer": "db61dd9fd0a63110f8770dbf976be19c", "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "db61dd9fd0a63110f8770dbf976be19c", "periodicity" : "", "quantity": "1", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "transaction_date": "2023-12-18 23:37:11", "line_id": "CONNECTEDC1000" }, { "top_product_offer": "9b61dd9fd0a63110f8770dbf976be1c6", "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "9b61dd9fd0a63110f8770dbf976be1c6", "periodicity" : "annually", "quantity": "1", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "transaction_date": "2023-12-18 23:37:11", "line_id": "AUTOCOLLIS1001" }, { "top_product_offer": "9361dd9fd0a63110f8770dbf976be1c4", "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "9361dd9fd0a63110f8770dbf976be1c4", "periodicity" : "annually", "quantity": "1", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "transaction_date": "2023-12-18 23:37:11", "line_id": "WIFIHOTSPOT1002" } ], "pricelist": "19d29513d0e63110f8770dbf976be122", "transaction_date": "2023-12-18 23:37:11" }, "settings": { "pricing_elements": "PRICE,COST,NET_PRICE,LINE_ROLLUPS,HEADER_ROLLUPS,ADJUSTMENTS", "disable_validation": true } }' \ --user 'username:password' ``` ``` { "result": { "header": { "currency": "USD", "lineItems": [ { "line_id": "CONNECTEDC1000", "status": "Success", "currency": "USD", "base_price": { "value": "0.0000", "displayValue": "$0.00" }, "list_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "1", "price_list_line": "3e93e785d07a7910f8770dbf976be1ee", "product_offering": "db61dd9fd0a63110f8770dbf976be19c", "top_product_offer": "db61dd9fd0a63110f8770dbf976be19c", "one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_net_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_net_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_adjustment": { "value": "0.0000", "displayValue": "$0.00" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_monthly_recurring_price_v1": { "value": "0.0000", "displayValue": "$0.00" }, "total_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricingAdjustments": [], "total_adjustment_amount": [] }, { "line_id": "AUTOCOLLIS1001", "status": "Success", "currency": "USD", "base_price": { "value": "250.0000", "displayValue": "$250.00" }, "list_price": { "value": "250.0000", "displayValue": "$250.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "1", "price_list_line": "4dc32f85d07a7910f8770dbf976be197", "product_offering": "9b61dd9fd0a63110f8770dbf976be1c6", "top_product_offer": "9b61dd9fd0a63110f8770dbf976be1c6", "one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "monthly_recurring_price": { "value": "20.8333", "displayValue": "$20.8333" }, "annual_recurring_price": { "value": "250.0000", "displayValue": "$250.00" }, "unit_net_price": { "value": "250.0000", "displayValue": "$250.00" }, "cumulative_net_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_monthly_recurring_price": { "value": "20.8333", "displayValue": "$20.8333" }, "cumulative_annual_recurring_price": { "value": "250.0000", "displayValue": "$250.00" }, "unit_adjustment": { "value": "0.0000", "displayValue": "$0.00" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": "250.0000", "displayValue": "$250.00" }, "cumulative_monthly_recurring_price_v1": { "value": "0.0000", "displayValue": "$0.00" }, "total_recurring_price": { "value": "250.0000", "displayValue": "$250.00" }, "pricingAdjustments": [], "total_adjustment_amount": [] }, { "line_id": "WIFIHOTSPOT1002", "status": "Success", "currency": "USD", "base_price": { "value": "100.0000", "displayValue": "$100.00" }, "list_price": { "value": "100.0000", "displayValue": "$100.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "1", "price_list_line": "3ff3ef85d07a7910f8770dbf976be1ea", "product_offering": "9361dd9fd0a63110f8770dbf976be1c4", "top_product_offer": "9361dd9fd0a63110f8770dbf976be1c4", "one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "monthly_recurring_price": { "value": "8.3333", "displayValue": "$8.3333" }, "annual_recurring_price": { "value": "100.0000", "displayValue": "$100.00" }, "unit_net_price": { "value": "100.0000", "displayValue": "$100.00" }, "cumulative_net_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_monthly_recurring_price": { "value": "8.3333", "displayValue": "$8.3333" }, "cumulative_annual_recurring_price": { "value": "100.0000", "displayValue": "$100.00" }, "unit_adjustment": { "value": "0.0000", "displayValue": "$0.00" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": "100.0000", "displayValue": "$100.00" }, "cumulative_monthly_recurring_price_v1": { "value": "0.0000", "displayValue": "$0.00" }, "total_recurring_price": { "value": "100.0000", "displayValue": "$100.00" }, "pricingAdjustments": [], "total_adjustment_amount": [] } ], "status": "Success", "total_monthly_recurring_price": { "value": "29.1666", "displayValue": "$29.1666" }, "total_monthly_recurring_price_v1": { "value": "0.0000", "displayValue": "$0.00" }, "total_annual_recurring_price": { "value": "350.0000", "displayValue": "$350.00" }, "total_annual_recurring_price_v1": { "value": "350.0000", "displayValue": "$350.00" }, "total_amount": { "value": "0.0000", "displayValue": "$0.00" }, "total_amount_v1": { "value": "350.0000", "displayValue": "$350.00" }, "total_one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "total_one_time_cost": { "value": "0.0000", "displayValue": "$0.00" }, "total_monthly_cost": { "value": "0.0000", "displayValue": "$0.00" }, "total_cost": { "value": "0.0000", "displayValue": "$0.00" }, "total_one_time_margin": { "value": "0.0000", "displayValue": "$0.00" }, "total_monthly_margin": { "value": "29.1666", "displayValue": "$29.1666" }, "total_margin_amount": { "value": "0.0000", "displayValue": "$0.00" }, "total_one_time_margin_percentage": { "value": "0.0000", "displayValue": "$0.00" }, "total_monthly_margin_percentage": { "value": "100.0000", "displayValue": "$100.00" }, "total_margin_percentage": { "value": "0.0000", "displayValue": "$0.00" } }, "settings": { "pricing_elements": "PRICE,COST,NET_PRICE,LINE_ROLLUPS,HEADER_ROLLUPS,ADJUSTMENTS" } } } ``` ### Initiate a product configuration session This example demonstrates how to start a stateful product configuration session. This is used for complex products that are sold as a bundle with multiple components and user-selectable options. By setting the scope to "configurator", we tell the pricing engine to create a persistent session. The engine processes the entire product hierarchy, calculates initial prices, and returns a unique pricing\_context\_id. **Important:** The unique `pricing_context_id` must be captured and sent in all subsequent requests for this configuration \(e.g., when changing a quantity or selecting an option\) to maintain the session's state. Example: cURL request. ``` curl "https://instance.servicenow.com/api/sn_csm_pricing/v1/pricingengine/computePrice" \ --request POST \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --data '{ "header": { "source_system": "ServiceNow Headless API", "requesting_record_id": "QT0001101", "currency": "USD", "lineItems": [ { "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "26d07c3211707110f877366201dea60c", "quantity": "1", "top_product_offer": "26d07c3211707110f877366201dea60c", "periodicity" : "", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "transaction_date": "2025-08-28 22:46:39", "selected": true, "line_id": "HOMEAUTOMA2000" }, { "parent_product_offer": "26d07c3211707110f877366201dea60c", "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "fe5d203e11307110f877366201dea631", "periodicity" : "", "quantity": "3", "top_product_offer": "26d07c3211707110f877366201dea60c", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "transaction_date": "2025-08-28 22:46:39", "selected": true, "line_id": "DOORSENSOR1001" }, { "parent_product_offer": "26d07c3211707110f877366201dea60c", "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "3f6111dfd0a63110f8770dbf976be149", "periodicity" : "", "quantity": "1", "top_product_offer": "26d07c3211707110f877366201dea60c", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "characteristics": [ { "characteristic": "4f31999fd0a63110f8770dbf976be178", "characteristic_option": "0b31999fd0a63110f8770dbf976be179" } ], "transaction_date": "2025-08-28 22:46:39", "selected": true, "line_id": "HOMEAUTOMA1002" }, { "parent_product_offer": "26d07c3211707110f877366201dea60c", "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "376111dfd0a63110f8770dbf976be140", "periodicity" : "monthly", "quantity": "1", "top_product_offer": "26d07c3211707110f877366201dea60c", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "transaction_date": "2025-08-28 22:46:39", "selected": true, "line_id": "BASICMONIT1003" }, { "parent_product_offer": "26d07c3211707110f877366201dea60c", "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "e2619d9fd0a63110f8770dbf976be1ec", "periodicity" : "monthly", "quantity": "1", "top_product_offer": "26d07c3211707110f877366201dea60c", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "transaction_date": "2025-08-28 22:46:39", "selected": true, "line_id": "PREMMONIT2004" }, { "parent_product_offer": "26d07c3211707110f877366201dea60c", "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "3b6111dfd0a63110f8770dbf976be147", "periodicity" : "monthly", "quantity": "1", "top_product_offer": "26d07c3211707110f877366201dea60c", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "transaction_date": "2025-08-28 22:46:39", "selected": true, "line_id": "ULTIMONIT1005" }, { "parent_product_offer": "26d07c3211707110f877366201dea60c", "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "1761dd9fd0a63110f8770dbf976be196", "periodicity" : "", "quantity": "1", "top_product_offer": "26d07c3211707110f877366201dea60c", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "transaction_date": "2025-08-28 22:46:39", "selected": true, "line_id": "INDOORCAM1006" }, { "parent_product_offer": "26d07c3211707110f877366201dea60c", "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "6f6111dfd0a63110f8770dbf976be100", "periodicity" : "", "quantity": "1", "top_product_offer": "26d07c3211707110f877366201dea60c", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "transaction_date": "2025-08-28 22:46:39", "selected": true, "line_id": "OUTCAMERA1007" }, { "parent_product_offer": "26d07c3211707110f877366201dea60c", "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "1b20347e11307110f877366201dea67f", "periodicity" : "", "quantity": "3", "top_product_offer": "26d07c3211707110f877366201dea60c", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "transaction_date": "2025-08-28 22:46:39", "selected": true, "line_id": "WINSENSOR1008" } ], "pricelist": "19d29513d0e63110f8770dbf976be122", "transaction_date": "2023-12-18 23:37:11" }, "settings": { "pricing_elements": "PRICE,COST,NET_PRICE,LINE_ROLLUPS,HEADER_ROLLUPS,ADJUSTMENTS", "disable_validation": true, "scope": "configurator", "config_top_line_identifier": "HOMEAUTOMA2000", "config_lines_expanded": false } }' \ --user 'username:password' ``` Example response: The following result shows that the request status is successful. ``` { "result": { "header": { "currency": "USD", "lineItems": [ { "line_id": "HOMEAUTOMA2000", "status": "Success", "currency": "USD", "base_price": { "value": "0.0000", "displayValue": "$0.00" }, "list_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "1", "price_list_line": "d6792b8dd07a7910f8770dbf976be1f8", "product_offering": "26d07c3211707110f877366201dea60c", "top_product_offer": "26d07c3211707110f877366201dea60c", "one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_net_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_net_price": { "value": "200.0000", "displayValue": "$200.00" }, "cumulative_one_time_price": { "value": "200.0000", "displayValue": "$200.00" }, "cumulative_monthly_recurring_price": { "value": "105.0000", "displayValue": "$105.00" }, "cumulative_annual_recurring_price": { "value": "1260.0000", "displayValue": "$1,260.00" }, "unit_adjustment": { "value": "0.0000", "displayValue": "$0.00" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_monthly_recurring_price_v1": { "value": "105.0000", "displayValue": "$105.00" }, "total_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricingAdjustments": [], "total_adjustment_amount": [] }, { "line_id": "DOORSENSOR1001", "status": "Success", "currency": "USD", "base_price": { "value": "10.0000", "displayValue": "$10.00" }, "list_price": { "value": "10.0000", "displayValue": "$10.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "3", "price_list_line": "2ec2a745d07a7910f8770dbf976be159", "product_offering": "fe5d203e11307110f877366201dea631", "parent_product_offer": "26d07c3211707110f877366201dea60c", "top_product_offer": "26d07c3211707110f877366201dea60c", "one_time_price": { "value": "24.0000", "displayValue": "$24.00" }, "monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_net_price": { "value": "8.0000", "displayValue": "$8.00" }, "cumulative_net_price": { "value": "24.0000", "displayValue": "$24.00" }, "cumulative_one_time_price": { "value": "24.0000", "displayValue": "$24.00" }, "cumulative_monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_adjustment": { "value": "-2.0000", "displayValue": "($2.00)" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": 0, "displayValue": 0 }, "cumulative_monthly_recurring_price_v1": { "value": 0, "displayValue": 0 }, "total_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricingAdjustments": [ { "adjustment_type": { "value": "a96c83d653dd91105c0eddeeff7b12d8", "displayValue": "MARKDOWN_PER" }, "adjustment_value": { "value": 20.0, "displayValue": "20" }, "adjustment_amount": { "value": -2.0, "displayValue": "($2.00)" }, "adjustment_amount_total": { "value": -6.0, "displayValue": "($6.00)" }, "adjustment_description": { "displayValue": "door sensor bundle discount" }, "adjustment_sequence_id": { "value": 1.0 }, "adjustment_matrix_type": { "displayValue": "Configuration Component Price Adjustment" }, "adjustment_basis": { "value": "prv_price_point" }, "price_point": { "value": "net_price" }, "pricing_plan_step": { "value": "97b61272ffe722101fb14ad013cb14d7" }, "running_price": { "value": 8.0, "displayValue": "$8.00" } } ], "total_adjustment_amount": [ { "pricePoint": "net_price", "value": -6.0, "displayValue": "($6.00)" } ] }, { "line_id": "HOMEAUTOMA1002", "status": "Success", "currency": "USD", "base_price": { "value": "100.0000", "displayValue": "$100.00" }, "list_price": { "value": "100.0000", "displayValue": "$100.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "1", "price_list_line": "fe912705d07a7910f8770dbf976be147", "product_offering": "3f6111dfd0a63110f8770dbf976be149", "parent_product_offer": "26d07c3211707110f877366201dea60c", "top_product_offer": "26d07c3211707110f877366201dea60c", "one_time_price": { "value": "80.0000", "displayValue": "$80.00" }, "monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_net_price": { "value": "80.0000", "displayValue": "$80.00" }, "cumulative_net_price": { "value": "80.0000", "displayValue": "$80.00" }, "cumulative_one_time_price": { "value": "80.0000", "displayValue": "$80.00" }, "cumulative_monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_adjustment": { "value": "-20.0000", "displayValue": "($20.00)" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": 0, "displayValue": 0 }, "cumulative_monthly_recurring_price_v1": { "value": 0, "displayValue": 0 }, "total_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricingAdjustments": [ { "adjustment_type": { "value": "a96c83d653dd91105c0eddeeff7b12d8", "displayValue": "MARKDOWN_PER" }, "adjustment_value": { "value": 20.0, "displayValue": "20" }, "adjustment_amount": { "value": -20.0, "displayValue": "($20.00)" }, "adjustment_amount_total": { "value": -20.0, "displayValue": "($20.00)" }, "adjustment_description": { "displayValue": "home automation hub bundle discount" }, "adjustment_sequence_id": { "value": 1.0 }, "adjustment_matrix_type": { "displayValue": "Configuration Component Price Adjustment" }, "adjustment_basis": { "value": "prv_price_point" }, "price_point": { "value": "net_price" }, "pricing_plan_step": { "value": "97b61272ffe722101fb14ad013cb14d7" }, "running_price": { "value": 80.0, "displayValue": "$80.00" } } ], "total_adjustment_amount": [ { "pricePoint": "net_price", "value": -20.0, "displayValue": "($20.00)" } ] }, { "line_id": "BASICMONIT1003", "status": "Success", "currency": "USD", "base_price": { "value": "30.0000", "displayValue": "$30.00" }, "list_price": { "value": "30.0000", "displayValue": "$30.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "1", "price_list_line": "bc53e785d07a7910f8770dbf976be1e7", "product_offering": "376111dfd0a63110f8770dbf976be140", "parent_product_offer": "26d07c3211707110f877366201dea60c", "top_product_offer": "26d07c3211707110f877366201dea60c", "one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "monthly_recurring_price": { "value": "25.0000", "displayValue": "$25.00" }, "annual_recurring_price": { "value": "300.0000", "displayValue": "$300.00" }, "unit_net_price": { "value": "25.0000", "displayValue": "$25.00" }, "cumulative_net_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_monthly_recurring_price": { "value": "25.0000", "displayValue": "$25.00" }, "cumulative_annual_recurring_price": { "value": "300.0000", "displayValue": "$300.00" }, "unit_adjustment": { "value": "-5.0000", "displayValue": "($5.00)" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": 0, "displayValue": 0 }, "cumulative_monthly_recurring_price_v1": { "value": "25.0000", "displayValue": "$25.00" }, "total_recurring_price": { "value": "25.0000", "displayValue": "$25.00" }, "pricingAdjustments": [ { "adjustment_type": { "value": "6e1c03d653dd91105c0eddeeff7b1232", "displayValue": "MARKDOWN_AMT" }, "adjustment_value": { "value": 5.0, "displayValue": "5" }, "adjustment_amount": { "value": -5.0, "displayValue": "($5.00)" }, "adjustment_amount_total": { "value": -5.0, "displayValue": "($5.00)" }, "adjustment_description": { "displayValue": "basic monitoring bundle discount" }, "adjustment_sequence_id": { "value": 1.0 }, "adjustment_matrix_type": { "displayValue": "Configuration Component Price Adjustment" }, "adjustment_basis": { "value": "prv_price_point" }, "price_point": { "value": "net_price" }, "pricing_plan_step": { "value": "97b61272ffe722101fb14ad013cb14d7" }, "running_price": { "value": 25.0, "displayValue": "$25.00" } } ], "total_adjustment_amount": [ { "pricePoint": "net_price", "value": -5.0, "displayValue": "($5.00)" } ] }, { "line_id": "PREMMONIT2004", "status": "Success", "currency": "USD", "base_price": { "value": "40.0000", "displayValue": "$40.00" }, "list_price": { "value": "40.0000", "displayValue": "$40.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "1", "price_list_line": "a663a785d07a7910f8770dbf976be115", "product_offering": "e2619d9fd0a63110f8770dbf976be1ec", "parent_product_offer": "26d07c3211707110f877366201dea60c", "top_product_offer": "26d07c3211707110f877366201dea60c", "one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "monthly_recurring_price": { "value": "35.0000", "displayValue": "$35.00" }, "annual_recurring_price": { "value": "420.0000", "displayValue": "$420.00" }, "unit_net_price": { "value": "35.0000", "displayValue": "$35.00" }, "cumulative_net_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_monthly_recurring_price": { "value": "35.0000", "displayValue": "$35.00" }, "cumulative_annual_recurring_price": { "value": "420.0000", "displayValue": "$420.00" }, "unit_adjustment": { "value": "-5.0000", "displayValue": "($5.00)" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": 0, "displayValue": 0 }, "cumulative_monthly_recurring_price_v1": { "value": "35.0000", "displayValue": "$35.00" }, "total_recurring_price": { "value": "35.0000", "displayValue": "$35.00" }, "pricingAdjustments": [ { "adjustment_type": { "value": "6e1c03d653dd91105c0eddeeff7b1232", "displayValue": "MARKDOWN_AMT" }, "adjustment_value": { "value": 5.0, "displayValue": "5" }, "adjustment_amount": { "value": -5.0, "displayValue": "($5.00)" }, "adjustment_amount_total": { "value": -5.0, "displayValue": "($5.00)" }, "adjustment_description": { "displayValue": "premium monitoring bundle discount" }, "adjustment_sequence_id": { "value": 1.0 }, "adjustment_matrix_type": { "displayValue": "Configuration Component Price Adjustment" }, "adjustment_basis": { "value": "prv_price_point" }, "price_point": { "value": "net_price" }, "pricing_plan_step": { "value": "97b61272ffe722101fb14ad013cb14d7" }, "running_price": { "value": 35.0, "displayValue": "$35.00" } } ], "total_adjustment_amount": [ { "pricePoint": "net_price", "value": -5.0, "displayValue": "($5.00)" } ] }, { "line_id": "ULTIMONIT1005", "status": "Success", "currency": "USD", "base_price": { "value": "50.0000", "displayValue": "$50.00" }, "list_price": { "value": "50.0000", "displayValue": "$50.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "1", "price_list_line": "72736f85d07a7910f8770dbf976be162", "product_offering": "3b6111dfd0a63110f8770dbf976be147", "parent_product_offer": "26d07c3211707110f877366201dea60c", "top_product_offer": "26d07c3211707110f877366201dea60c", "one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "monthly_recurring_price": { "value": "45.0000", "displayValue": "$45.00" }, "annual_recurring_price": { "value": "540.0000", "displayValue": "$540.00" }, "unit_net_price": { "value": "45.0000", "displayValue": "$45.00" }, "cumulative_net_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_monthly_recurring_price": { "value": "45.0000", "displayValue": "$45.00" }, "cumulative_annual_recurring_price": { "value": "540.0000", "displayValue": "$540.00" }, "unit_adjustment": { "value": "-5.0000", "displayValue": "($5.00)" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": 0, "displayValue": 0 }, "cumulative_monthly_recurring_price_v1": { "value": "45.0000", "displayValue": "$45.00" }, "total_recurring_price": { "value": "45.0000", "displayValue": "$45.00" }, "pricingAdjustments": [ { "adjustment_type": { "value": "6e1c03d653dd91105c0eddeeff7b1232", "displayValue": "MARKDOWN_AMT" }, "adjustment_value": { "value": 5.0, "displayValue": "5" }, "adjustment_amount": { "value": -5.0, "displayValue": "($5.00)" }, "adjustment_amount_total": { "value": -5.0, "displayValue": "($5.00)" }, "adjustment_description": { "displayValue": "ultimate monitoring bundle discount" }, "adjustment_sequence_id": { "value": 1.0 }, "adjustment_matrix_type": { "displayValue": "Configuration Component Price Adjustment" }, "adjustment_basis": { "value": "prv_price_point" }, "price_point": { "value": "net_price" }, "pricing_plan_step": { "value": "97b61272ffe722101fb14ad013cb14d7" }, "running_price": { "value": 45.0, "displayValue": "$45.00" } } ], "total_adjustment_amount": [ { "pricePoint": "net_price", "value": -5.0, "displayValue": "($5.00)" } ] }, { "line_id": "INDOORCAM1006", "status": "Success", "currency": "USD", "base_price": { "value": "35.0000", "displayValue": "$35.00" }, "list_price": { "value": "35.0000", "displayValue": "$35.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "1", "price_list_line": "81332f45d07a7910f8770dbf976be14e", "product_offering": "1761dd9fd0a63110f8770dbf976be196", "parent_product_offer": "26d07c3211707110f877366201dea60c", "top_product_offer": "26d07c3211707110f877366201dea60c", "one_time_price": { "value": "28.0000", "displayValue": "$28.00" }, "monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_net_price": { "value": "28.0000", "displayValue": "$28.00" }, "cumulative_net_price": { "value": "28.0000", "displayValue": "$28.00" }, "cumulative_one_time_price": { "value": "28.0000", "displayValue": "$28.00" }, "cumulative_monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_adjustment": { "value": "-7.0000", "displayValue": "($7.00)" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": 0, "displayValue": 0 }, "cumulative_monthly_recurring_price_v1": { "value": 0, "displayValue": 0 }, "total_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricingAdjustments": [ { "adjustment_type": { "value": "a96c83d653dd91105c0eddeeff7b12d8", "displayValue": "MARKDOWN_PER" }, "adjustment_value": { "value": 20.0, "displayValue": "20" }, "adjustment_amount": { "value": -7.0, "displayValue": "($7.00)" }, "adjustment_amount_total": { "value": -7.0, "displayValue": "($7.00)" }, "adjustment_description": { "displayValue": "indoor camera bundle discount" }, "adjustment_sequence_id": { "value": 1.0 }, "adjustment_matrix_type": { "displayValue": "Configuration Component Price Adjustment" }, "adjustment_basis": { "value": "prv_price_point" }, "price_point": { "value": "net_price" }, "pricing_plan_step": { "value": "97b61272ffe722101fb14ad013cb14d7" }, "running_price": { "value": 28.0, "displayValue": "$28.00" } } ], "total_adjustment_amount": [ { "pricePoint": "net_price", "value": -7.0, "displayValue": "($7.00)" } ] }, { "line_id": "OUTCAMERA1007", "status": "Success", "currency": "USD", "base_price": { "value": "40.0000", "displayValue": "$40.00" }, "list_price": { "value": "40.0000", "displayValue": "$40.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "1", "price_list_line": "9a136f45d07a7910f8770dbf976be1b4", "product_offering": "6f6111dfd0a63110f8770dbf976be100", "parent_product_offer": "26d07c3211707110f877366201dea60c", "top_product_offer": "26d07c3211707110f877366201dea60c", "one_time_price": { "value": "32.0000", "displayValue": "$32.00" }, "monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_net_price": { "value": "32.0000", "displayValue": "$32.00" }, "cumulative_net_price": { "value": "32.0000", "displayValue": "$32.00" }, "cumulative_one_time_price": { "value": "32.0000", "displayValue": "$32.00" }, "cumulative_monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_adjustment": { "value": "-8.0000", "displayValue": "($8.00)" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": 0, "displayValue": 0 }, "cumulative_monthly_recurring_price_v1": { "value": 0, "displayValue": 0 }, "total_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricingAdjustments": [ { "adjustment_type": { "value": "a96c83d653dd91105c0eddeeff7b12d8", "displayValue": "MARKDOWN_PER" }, "adjustment_value": { "value": 20.0, "displayValue": "20" }, "adjustment_amount": { "value": -8.0, "displayValue": "($8.00)" }, "adjustment_amount_total": { "value": -8.0, "displayValue": "($8.00)" }, "adjustment_description": { "displayValue": "outdoor camera bundle discount" }, "adjustment_sequence_id": { "value": 1.0 }, "adjustment_matrix_type": { "displayValue": "Configuration Component Price Adjustment" }, "adjustment_basis": { "value": "prv_price_point" }, "price_point": { "value": "net_price" }, "pricing_plan_step": { "value": "97b61272ffe722101fb14ad013cb14d7" }, "running_price": { "value": 32.0, "displayValue": "$32.00" } } ], "total_adjustment_amount": [ { "pricePoint": "net_price", "value": -8.0, "displayValue": "($8.00)" } ] }, { "line_id": "WINSENSOR1008", "status": "Success", "currency": "USD", "base_price": { "value": "15.0000", "displayValue": "$15.00" }, "list_price": { "value": "15.0000", "displayValue": "$15.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "3", "price_list_line": "91f26b45d07a7910f8770dbf976be19b", "product_offering": "1b20347e11307110f877366201dea67f", "parent_product_offer": "26d07c3211707110f877366201dea60c", "top_product_offer": "26d07c3211707110f877366201dea60c", "one_time_price": { "value": "36.0000", "displayValue": "$36.00" }, "monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_net_price": { "value": "12.0000", "displayValue": "$12.00" }, "cumulative_net_price": { "value": "36.0000", "displayValue": "$36.00" }, "cumulative_one_time_price": { "value": "36.0000", "displayValue": "$36.00" }, "cumulative_monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_adjustment": { "value": "-3.0000", "displayValue": "($3.00)" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": 0, "displayValue": 0 }, "cumulative_monthly_recurring_price_v1": { "value": 0, "displayValue": 0 }, "total_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricingAdjustments": [ { "adjustment_type": { "value": "a96c83d653dd91105c0eddeeff7b12d8", "displayValue": "MARKDOWN_PER" }, "adjustment_value": { "value": 20.0, "displayValue": "20" }, "adjustment_amount": { "value": -3.0, "displayValue": "($3.00)" }, "adjustment_amount_total": { "value": -9.0, "displayValue": "($9.00)" }, "adjustment_description": { "displayValue": "window sensor bundle discount" }, "adjustment_sequence_id": { "value": 1.0 }, "adjustment_matrix_type": { "displayValue": "Configuration Component Price Adjustment" }, "adjustment_basis": { "value": "prv_price_point" }, "price_point": { "value": "net_price" }, "pricing_plan_step": { "value": "97b61272ffe722101fb14ad013cb14d7" }, "running_price": { "value": 12.0, "displayValue": "$12.00" } } ], "total_adjustment_amount": [ { "pricePoint": "net_price", "value": -9.0, "displayValue": "($9.00)" } ] } ], "status": "Success", "total_monthly_recurring_price": { "value": "105.0000", "displayValue": "$105.00" }, "total_monthly_recurring_price_v1": { "value": "105.0000", "displayValue": "$105.00" }, "total_annual_recurring_price": { "value": "1260.0000", "displayValue": "$1,260.00" }, "total_annual_recurring_price_v1": { "value": "0.0000", "displayValue": "$0.00" }, "total_amount": { "value": "200.0000", "displayValue": "$200.00" }, "total_amount_v1": { "value": "305.0000", "displayValue": "$305.00" }, "total_one_time_price": { "value": "200.0000", "displayValue": "$200.00" }, "total_one_time_cost": { "value": "0.0000", "displayValue": "$0.00" }, "total_monthly_cost": { "value": "0.0000", "displayValue": "$0.00" }, "total_cost": { "value": "0.0000", "displayValue": "$0.00" }, "total_one_time_margin": { "value": "200.0000", "displayValue": "$200.00" }, "total_monthly_margin": { "value": "105.0000", "displayValue": "$105.00" }, "total_margin_amount": { "value": "200.0000", "displayValue": "$200.00" }, "total_one_time_margin_percentage": { "value": "100.0000", "displayValue": "$100.00" }, "total_monthly_margin_percentage": { "value": "100.0000", "displayValue": "$100.00" }, "total_margin_percentage": { "value": "100.0000", "displayValue": "$100.00" } }, "settings": { "pricing_context_id": "7049E245A667EABB226B16A2190FB92E", "pricing_elements": "PRICE,COST,NET_PRICE,LINE_ROLLUPS,HEADER_ROLLUPS,ADJUSTMENTS" } } } ``` ### Update a product configuration \(change a characteristic option\) This example demonstrates how to update an active product configuration session by changing a user-selectable option \(characteristic\). This is a common action in a product configurator, such as changing a color, size, or feature. Prerequisite: You need to include the `pricing_context_id` that is returned when initiating a [product configuration session](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-apis/sales-crm-pricing-api.md). This tells the pricing engine which session to update. Note: The lineItems array only needs to contain the specific item that is being modified, it is not necessary to send the entire product hierarchy again. Example: cURL request. ``` curl "https://instance.servicenow.com/api/sn_csm_pricing/v1/pricingengine/computePrice" \ --request POST \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --data '{ "header": { "source_system": "ServiceNow Headless API", "requesting_record_id": "QT0001101", "currency": "USD", "lineItems": [ { "parent_product_offer": "26d07c3211707110f877366201dea60c", "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "3f6111dfd0a63110f8770dbf976be149", "periodicity": "", "quantity": "1", "top_product_offer": "26d07c3211707110f877366201dea60c", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "characteristics": [ { "characteristic": "4f31999fd0a63110f8770dbf976be178", "characteristic_option": "8331999fd0a63110f8770dbf976be179" } ], "transaction_date": "2025-08-28 22:46:39", "selected": true, "line_id": "HOMEAUTOMA1002" } ], "pricelist": "19d29513d0e63110f8770dbf976be122", "transaction_date": "2023-12-18 23:37:11" }, "settings": { "pricing_elements": "PRICE,COST,NET_PRICE,LINE_ROLLUPS,HEADER_ROLLUPS,ADJUSTMENTS", "pricing_context_id": "7049E245A667EABB226B16A2190FB92E", "disable_validation": true, "scope": "configurator", "config_top_line_identifier": "HOMEAUTOMA2000", "config_lines_expanded": false } }' \ --user 'username:password' ``` ``` { "result": { "header": { "currency": "USD", "lineItems": [ { "line_id": "HOMEAUTOMA1002", "status": "Success", "currency": "USD", "base_price": { "value": "100.0000", "displayValue": "$100.00" }, "list_price": { "value": "120.0000", "displayValue": "$120.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "1", "price_list_line": "fe912705d07a7910f8770dbf976be147", "product_offering": "3f6111dfd0a63110f8770dbf976be149", "parent_product_offer": "26d07c3211707110f877366201dea60c", "top_product_offer": "26d07c3211707110f877366201dea60c", "one_time_price": { "value": "96.0000", "displayValue": "$96.00" }, "monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_net_price": { "value": "96.0000", "displayValue": "$96.00" }, "cumulative_net_price": { "value": "96.0000", "displayValue": "$96.00" }, "cumulative_one_time_price": { "value": "96.0000", "displayValue": "$96.00" }, "cumulative_monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_adjustment": { "value": "-24.0000", "displayValue": "($24.00)" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": 0, "displayValue": 0 }, "cumulative_monthly_recurring_price_v1": { "value": 0, "displayValue": 0 }, "total_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricingAdjustments": [ { "adjustment_type": { "value": "d88bc79653dd91105c0eddeeff7b12c1", "displayValue": "MARKUP_AMT" }, "adjustment_value": { "value": 20.0, "displayValue": "$20.00" }, "adjustment_amount": { "value": 20.0, "displayValue": "$20.00" }, "adjustment_amount_total": { "value": 20.0, "displayValue": "$20.00" }, "adjustment_description": { "displayValue": "Attribute Adjustments" }, "adjustment_sequence_id": { "value": 1.0 }, "adjustment_matrix_type": { "displayValue": null }, "adjustment_basis": { "value": null }, "price_point": { "value": "list_price" }, "pricing_plan_step": { "value": "8bb61272ffe722101fb14ad013cb149d" }, "running_price": { "value": 120.0, "displayValue": "$120.00" } }, { "adjustment_type": { "value": "a96c83d653dd91105c0eddeeff7b12d8", "displayValue": "MARKDOWN_PER" }, "adjustment_value": { "value": 20.0, "displayValue": "20" }, "adjustment_amount": { "value": -24.0, "displayValue": "($24.00)" }, "adjustment_amount_total": { "value": -24.0, "displayValue": "($24.00)" }, "adjustment_description": { "displayValue": "home automation hub bundle discount" }, "adjustment_sequence_id": { "value": 2.0 }, "adjustment_matrix_type": { "displayValue": "Configuration Component Price Adjustment" }, "adjustment_basis": { "value": "prv_price_point" }, "price_point": { "value": "net_price" }, "pricing_plan_step": { "value": "97b61272ffe722101fb14ad013cb14d7" }, "running_price": { "value": 96.0, "displayValue": "$96.00" } } ], "total_adjustment_amount": [ { "pricePoint": "list_price", "value": 20.0, "displayValue": "$20.00" }, { "pricePoint": "net_price", "value": -24.0, "displayValue": "($24.00)" } ] }, { "line_id": "HOMEAUTOMA2000", "status": "Success", "currency": "USD", "base_price": { "value": "0.0000", "displayValue": "$0.00" }, "list_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "1", "price_list_line": "d6792b8dd07a7910f8770dbf976be1f8", "product_offering": "26d07c3211707110f877366201dea60c", "top_product_offer": "26d07c3211707110f877366201dea60c", "one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_net_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_net_price": { "value": "216.0000", "displayValue": "$216.00" }, "cumulative_one_time_price": { "value": "216.0000", "displayValue": "$216.00" }, "cumulative_monthly_recurring_price": { "value": "105.0000", "displayValue": "$105.00" }, "cumulative_annual_recurring_price": { "value": "1260.0000", "displayValue": "$1,260.00" }, "unit_adjustment": { "value": "0.0000", "displayValue": "$0.00" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_monthly_recurring_price_v1": { "value": "105.0000", "displayValue": "$105.00" }, "total_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricingAdjustments": [], "total_adjustment_amount": [] } ], "status": "Success", "total_monthly_recurring_price": { "value": "105.0000", "displayValue": "$105.00" }, "total_monthly_recurring_price_v1": { "value": "105.0000", "displayValue": "$105.00" }, "total_annual_recurring_price": { "value": "1260.0000", "displayValue": "$1,260.00" }, "total_annual_recurring_price_v1": { "value": "0.0000", "displayValue": "$0.00" }, "total_amount": { "value": "216.0000", "displayValue": "$216.00" }, "total_amount_v1": { "value": "321.0000", "displayValue": "$321.00" }, "total_one_time_price": { "value": "216.0000", "displayValue": "$216.00" }, "total_one_time_cost": { "value": "0.0000", "displayValue": "$0.00" }, "total_monthly_cost": { "value": "0.0000", "displayValue": "$0.00" }, "total_cost": { "value": "0.0000", "displayValue": "$0.00" }, "total_one_time_margin": { "value": "216.0000", "displayValue": "$216.00" }, "total_monthly_margin": { "value": "105.0000", "displayValue": "$105.00" }, "total_margin_amount": { "value": "216.0000", "displayValue": "$216.00" }, "total_one_time_margin_percentage": { "value": "100.0000", "displayValue": "$100.00" }, "total_monthly_margin_percentage": { "value": "100.0000", "displayValue": "$100.00" }, "total_margin_percentage": { "value": "100.0000", "displayValue": "$100.00" } }, "settings": { "pricing_context_id": "7049E245A667EABB226B16A2190FB92E", "pricing_elements": "PRICE,COST,NET_PRICE,LINE_ROLLUPS,HEADER_ROLLUPS,ADJUSTMENTS" } } } ``` ### Update a product configuration \(deselect a product\) This example demonstrates how to update an active product configuration by deselecting or removing a product from the bundle. This is achieved by sending a request for the specific line item with its `selected` flag set to `false`. Just like in the previous use case, this request must include the correct `pricing_context_id` to ensure the change is applied to the correct session. The pricing engine will then recalculate all prices for the entire bundle with that item removed, which may affect overall discounts and roll-ups. Prerequisite: You need to include the `pricing_context_id` that is returned when initiating a [product configuration session](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-apis/sales-crm-pricing-api.md). This tells the pricing engine which session to update. Note: The lineItems array only needs to contain the specific item that is being modified, it is not necessary to send the entire product hierarchy again. Example: cURL request. ``` curl "https://instance.servicenow.com/api/sn_csm_pricing/v1/pricingengine/computePrice" \ --request POST \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --data '{ "header": { "source_system": "ServiceNow Headless API", "requesting_record_id": "QT0001101", "currency": "USD", "lineItems": [ { "parent_product_offer": "26d07c3211707110f877366201dea60c", "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "3b6111dfd0a63110f8770dbf976be147", "quantity": "1", "periodicity": "monthly", "top_product_offer": "26d07c3211707110f877366201dea60c", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "transaction_date": "2025-08-28 22:46:39", "selected": false, "line_id": "ULTIMONIT1005" } ], "pricelist": "19d29513d0e63110f8770dbf976be122", "costbook": "a3042cdce405c210f8773750028d6f72", "transaction_date": "2023-12-18 23:37:11" }, "settings": { "pricing_elements": "PRICE,COST,NET_PRICE,LINE_ROLLUPS,HEADER_ROLLUPS,ADJUSTMENTS", "pricing_context_id": "7049E245A667EABB226B16A2190FB92E", "disable_validation": true, "scope": "configurator", "config_top_line_identifier": "HOMEAUTOMA2000", "config_lines_expanded": false } }' \ --user 'username:password' ``` ``` { "result": { "header": { "currency": "USD", "costbook": "a3042cdce405c210f8773750028d6f72", "lineItems": [ { "line_id": "ULTIMONIT1005", "status": "Success", "currency": "USD", "base_price": { "value": "50.0000", "displayValue": "$50.00" }, "list_price": { "value": "50.0000", "displayValue": "$50.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "1", "price_list_line": "72736f85d07a7910f8770dbf976be162", "product_offering": "3b6111dfd0a63110f8770dbf976be147", "parent_product_offer": "26d07c3211707110f877366201dea60c", "top_product_offer": "26d07c3211707110f877366201dea60c", "one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "monthly_recurring_price": { "value": "50.0000", "displayValue": "$50.00" }, "annual_recurring_price": { "value": "600.0000", "displayValue": "$600.00" }, "unit_net_price": { "value": "50.0000", "displayValue": "$50.00" }, "cumulative_net_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_acv": { "value": "600.0000", "displayValue": "$600.00" }, "cumulative_one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_monthly_recurring_price": { "value": "50.0000", "displayValue": "$50.00" }, "cumulative_annual_recurring_price": { "value": "600.0000", "displayValue": "$600.00" }, "unit_adjustment": { "value": "0.0000", "displayValue": "$0.00" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": 0, "displayValue": 0 }, "cumulative_monthly_recurring_price_v1": { "value": "50.0000", "displayValue": "$50.00" }, "total_recurring_price": { "value": "50.0000", "displayValue": "$50.00" }, "total_new_amount": { "value": 0, "displayValue": null }, "total_upsell_downsell_amount": { "value": 0, "displayValue": null }, "total_renewal_amount": { "value": 0, "displayValue": null }, "pricingAdjustments": [], "total_adjustment_amount": [], "cost": { "value": "25.0000", "displayValue": "$25.00" }, "unit_margin_amount": { "value": "25.0000", "displayValue": "$25.00" }, "unit_margin_percentage": { "value": "50.0000", "displayValue": "50.0000" }, "one_time_cost": { "value": "0.0000", "displayValue": "$0.00" }, "monthly_recurring_cost": { "value": "25.0000", "displayValue": "$25.00" }, "cumulative_one_time_cost": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_monthly_recurring_cost": { "value": "25.0000", "displayValue": "$25.00" }, "cumulative_net_cost": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_margin_percentage": { "value": "0.0000", "displayValue": "$0.00" } }, { "line_id": "HOMEAUTOMA2000", "status": "Success", "currency": "USD", "base_price": { "value": "0.0000", "displayValue": "$0.00" }, "list_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "1", "price_list_line": "d6792b8dd07a7910f8770dbf976be1f8", "product_offering": "26d07c3211707110f877366201dea60c", "top_product_offer": "26d07c3211707110f877366201dea60c", "one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_net_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_net_price": { "value": "270.0000", "displayValue": "$270.00" }, "cumulative_acv": { "value": "270.0000", "displayValue": "$270.00" }, "cumulative_one_time_price": { "value": "270.0000", "displayValue": "$270.00" }, "cumulative_monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_adjustment": { "value": "0.0000", "displayValue": "$0.00" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_monthly_recurring_price_v1": { "value": "0.0000", "displayValue": "$0.00" }, "total_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "total_new_amount": { "value": "270.0000", "displayValue": "$270.00" }, "total_upsell_downsell_amount": { "value": 0, "displayValue": null }, "total_renewal_amount": { "value": "0.0000", "displayValue": "$0.00" }, "pricingAdjustments": [], "total_adjustment_amount": [], "cost": { "value": "0.0000", "displayValue": "$0.00" }, "unit_margin_amount": { "value": "0.0000", "displayValue": "$0.00" }, "unit_margin_percentage": { "value": "0.0000", "displayValue": "0.0000" }, "one_time_cost": { "value": "0.0000", "displayValue": "$0.00" }, "monthly_recurring_cost": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_one_time_cost": { "value": "130.0000", "displayValue": "$130.00" }, "cumulative_monthly_recurring_cost": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_net_cost": { "value": "130.0000", "displayValue": "$130.00" }, "cumulative_margin_percentage": { "value": "51.8519", "displayValue": "51.8519" } } ], "status": "Success", "total_monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "total_monthly_recurring_price_v1": { "value": "0.0000", "displayValue": "$0.00" }, "total_annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "total_annual_recurring_price_v1": { "value": "0.0000", "displayValue": "$0.00" }, "total_amount": { "value": "270.0000", "displayValue": "$270.00" }, "total_acv": { "value": "270.0000", "displayValue": "$270.00" }, "total_amount_v1": { "value": "270.0000", "displayValue": "$270.00" }, "total_one_time_price": { "value": "270.0000", "displayValue": "$270.00" }, "total_one_time_cost": { "value": "130.0000", "displayValue": "$130.00" }, "total_monthly_cost": { "value": "0.0000", "displayValue": "$0.00" }, "total_cost": { "value": "130.0000", "displayValue": "$130.00" }, "total_one_time_margin": { "value": "140.0000", "displayValue": "$140.00" }, "total_monthly_margin": { "value": "0.0000", "displayValue": "$0.00" }, "total_margin_amount": { "value": "140.0000", "displayValue": "$140.00" }, "total_one_time_margin_percentage": { "value": "51.8519", "displayValue": "$51.8519" }, "total_monthly_margin_percentage": { "value": "0.0000", "displayValue": "$0.00" }, "total_margin_percentage": { "value": "51.8519", "displayValue": "$51.8519" }, "total_upsell_downsell_amount": { "value": "0.0000", "displayValue": "$0.00" }, "total_renewal_amount": { "value": "0.0000", "displayValue": "$0.00" }, "total_new_amount": { "value": "270.0000", "displayValue": "$270.00" }, "total_new_amount_acv": { "value": "270.0000", "displayValue": "$270.00" } }, "settings": { "pricing_context_id": "7E362E4CEDC0C3F684D346ED7A83D47E", "pricing_elements": "PRICE,COST,NET_PRICE,LINE_ROLLUPS,HEADER_ROLLUPS,ADJUSTMENTS" } } } ``` ### Stateless Pricing for a Multi-Line transaction This example demonstrates how to price a complete, multi-line transaction in a single API call. The request includes a mix of standalone products and a product bundle. By including HEADER\_ROLLUPS in the pricing\_elements, the API will calculate the price for each individual line item and also return the aggregated grand total for the entire transaction in the header. Example: `"pricing_elements": "PRICE,COST,NET_PRICE,LINE_ROLLUPS,HEADER_ROLLUPS,ADJUSTMENTS"` Example: cURL request. ``` curl "https://instance.servicenow.com/api/sn_csm_pricing/v1/pricingengine/computePrice" \ --request POST \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --data '{ "header": { "source_system": "ServiceNow Headless API", "requesting_record_id": "QT0001101", "currency": "USD", "lineItems": [ { "top_product_offer": "db61dd9fd0a63110f8770dbf976be19c", "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "db61dd9fd0a63110f8770dbf976be19c", "periodicity" : "", "quantity": "1", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "transaction_date": "2023-12-18 23:37:11", "line_id": "CONNECTEDC1000" }, { "top_product_offer": "9b61dd9fd0a63110f8770dbf976be1c6", "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "9b61dd9fd0a63110f8770dbf976be1c6", "periodicity" : "annually", "quantity": "1", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "transaction_date": "2023-12-18 23:37:11", "line_id": "AUTOCOLLIS1001" }, { "top_product_offer": "9361dd9fd0a63110f8770dbf976be1c4", "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "9361dd9fd0a63110f8770dbf976be1c4", "periodicity" : "annually", "quantity": "1", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "transaction_date": "2023-12-18 23:37:11", "line_id": "WIFIHOTSPOT1002" }, { "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "26d07c3211707110f877366201dea60c", "quantity": "1", "top_product_offer": "26d07c3211707110f877366201dea60c", "periodicity" : "", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "transaction_date": "2025-08-28 22:46:39", "line_id": "HOMEAUTOMA2000" }, { "parent_product_offer": "26d07c3211707110f877366201dea60c", "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "fe5d203e11307110f877366201dea631", "periodicity" : "", "quantity": "3", "top_product_offer": "26d07c3211707110f877366201dea60c", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "transaction_date": "2025-08-28 22:46:39", "line_id": "DOORSENSOR1001" }, { "parent_product_offer": "26d07c3211707110f877366201dea60c", "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "3f6111dfd0a63110f8770dbf976be149", "periodicity" : "", "quantity": "1", "top_product_offer": "26d07c3211707110f877366201dea60c", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "characteristics": [ { "characteristic": "4f31999fd0a63110f8770dbf976be178", "characteristic_option": "0b31999fd0a63110f8770dbf976be179" } ], "transaction_date": "2025-08-28 22:46:39", "line_id": "HOMEAUTOMA1002" }, { "parent_product_offer": "26d07c3211707110f877366201dea60c", "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "376111dfd0a63110f8770dbf976be140", "periodicity" : "monthly", "quantity": "1", "top_product_offer": "26d07c3211707110f877366201dea60c", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "transaction_date": "2025-08-28 22:46:39", "line_id": "BASICMONIT1003" }, { "parent_product_offer": "26d07c3211707110f8770dbf976be122", "product_offering": "e2619d9fd0a63110f8770dbf976be1ec", "periodicity" : "monthly", "quantity": "1", "top_product_offer": "26d07c3211707110f877366201dea60c", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "transaction_date": "2025-08-28 22:46:39", "line_id": "PREMMONIT2004" }, { "parent_product_offer": "26d07c3211707110f877366201dea60c", "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "1761dd9fd0a63110f8770dbf976be196", "periodicity" : "", "quantity": "1", "top_product_offer": "26d07c3211707110f877366201dea60c", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "transaction_date": "2025-08-28 22:46:39", "line_id": "INDOORCAM1006" }, { "parent_product_offer": "26d07c3211707110f877366201dea60c", "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "6f6111dfd0a63110f8770dbf976be100", "periodicity" : "", "quantity": "1", "top_product_offer": "26d07c3211707110f877366201dea60c", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "transaction_date": "2025-08-28 22:46:39", "line_id": "OUTCAMERA1007" }, { "parent_product_offer": "26d07c3211707110f877366201dea60c", "pricelist": "19d29513d0e63110f8770dbf976be122", "product_offering": "1b20347e11307110f877366201dea67f", "periodicity" : "", "quantity": "3", "top_product_offer": "26d07c3211707110f877366201dea60c", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "transaction_date": "2025-08-28 22:46:39", "line_id": "WINSENSOR1008" } ], "pricelist": "19d29513d0e63110f8770dbf976be122", "transaction_date": "2023-12-18 23:37:11" }, "settings": { "pricing_elements": "PRICE,COST,NET_PRICE,LINE_ROLLUPS,HEADER_ROLLUPS,ADJUSTMENTS", "disable_validation": true } }' \ --user 'username:password' ``` ``` { "result": { "header": { "currency": "USD", "lineItems": [ { "line_id": "CONNECTEDC1000", "status": "Success", "currency": "USD", "base_price": { "value": "0.0000", "displayValue": "$0.00" }, "list_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "1", "price_list_line": "3e93e785d07a7910f8770dbf976be1ee", "product_offering": "db61dd9fd0a63110f8770dbf976be19c", "top_product_offer": "db61dd9fd0a63110f8770dbf976be19c", "one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_net_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_net_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_adjustment": { "value": "0.0000", "displayValue": "$0.00" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_monthly_recurring_price_v1": { "value": "0.0000", "displayValue": "$0.00" }, "total_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricingAdjustments": [], "total_adjustment_amount": [] }, { "line_id": "AUTOCOLLIS1001", "status": "Success", "currency": "USD", "base_price": { "value": "250.0000", "displayValue": "$250.00" }, "list_price": { "value": "250.0000", "displayValue": "$250.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "1", "price_list_line": "4dc32f85d07a7910f8770dbf976be197", "product_offering": "9b61dd9fd0a63110f8770dbf976be1c6", "top_product_offer": "9b61dd9fd0a63110f8770dbf976be1c6", "one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "monthly_recurring_price": { "value": "20.8333", "displayValue": "$20.8333" }, "annual_recurring_price": { "value": "250.0000", "displayValue": "$250.00" }, "unit_net_price": { "value": "250.0000", "displayValue": "$250.00" }, "cumulative_net_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_monthly_recurring_price": { "value": "20.8333", "displayValue": "$20.8333" }, "cumulative_annual_recurring_price": { "value": "250.0000", "displayValue": "$250.00" }, "unit_adjustment": { "value": "0.0000", "displayValue": "$0.00" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": "250.0000", "displayValue": "$250.00" }, "cumulative_monthly_recurring_price_v1": { "value": "0.0000", "displayValue": "$0.00" }, "total_recurring_price": { "value": "250.0000", "displayValue": "$250.00" }, "pricingAdjustments": [], "total_adjustment_amount": [] }, { "line_id": "WIFIHOTSPOT1002", "status": "Success", "currency": "USD", "base_price": { "value": "100.0000", "displayValue": "$100.00" }, "list_price": { "value": "100.0000", "displayValue": "$100.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "1", "price_list_line": "3ff3ef85d07a7910f8770dbf976be1ea", "product_offering": "9361dd9fd0a63110f8770dbf976be1c4", "top_product_offer": "9361dd9fd0a63110f8770dbf976be1c4", "one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "monthly_recurring_price": { "value": "8.3333", "displayValue": "$8.3333" }, "annual_recurring_price": { "value": "100.0000", "displayValue": "$100.00" }, "unit_net_price": { "value": "100.0000", "displayValue": "$100.00" }, "cumulative_net_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_monthly_recurring_price": { "value": "8.3333", "displayValue": "$8.3333" }, "cumulative_annual_recurring_price": { "value": "100.0000", "displayValue": "$100.00" }, "unit_adjustment": { "value": "0.0000", "displayValue": "$0.00" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": "100.0000", "displayValue": "$100.00" }, "cumulative_monthly_recurring_price_v1": { "value": "0.0000", "displayValue": "$0.00" }, "total_recurring_price": { "value": "100.0000", "displayValue": "$100.00" }, "pricingAdjustments": [], "total_adjustment_amount": [] }, { "line_id": "HOMEAUTOMA2000", "status": "Success", "currency": "USD", "base_price": { "value": "0.0000", "displayValue": "$0.00" }, "list_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "1", "price_list_line": "d6792b8dd07a7910f8770dbf976be1f8", "product_offering": "26d07c3211707110f877366201dea60c", "top_product_offer": "26d07c3211707110f877366201dea60c", "one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_net_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_net_price": { "value": "200.0000", "displayValue": "$200.00" }, "cumulative_one_time_price": { "value": "200.0000", "displayValue": "$200.00" }, "cumulative_monthly_recurring_price": { "value": "60.0000", "displayValue": "$60.00" }, "cumulative_annual_recurring_price": { "value": "720.0000", "displayValue": "$720.00" }, "unit_adjustment": { "value": "0.0000", "displayValue": "$0.00" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_monthly_recurring_price_v1": { "value": "60.0000", "displayValue": "$60.00" }, "total_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricingAdjustments": [], "total_adjustment_amount": [] }, { "line_id": "DOORSENSOR1001", "status": "Success", "currency": "USD", "base_price": { "value": "10.0000", "displayValue": "$10.00" }, "list_price": { "value": "10.0000", "displayValue": "$10.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "3", "price_list_line": "2ec2a745d07a7910f8770dbf976be159", "product_offering": "fe5d203e11307110f877366201dea631", "parent_product_offer": "26d07c3211707110f877366201dea60c", "top_product_offer": "26d07c3211707110f877366201dea60c", "one_time_price": { "value": "24.0000", "displayValue": "$24.00" }, "monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_net_price": { "value": "8.0000", "displayValue": "$8.00" }, "cumulative_net_price": { "value": "24.0000", "displayValue": "$24.00" }, "cumulative_one_time_price": { "value": "24.0000", "displayValue": "$24.00" }, "cumulative_monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_adjustment": { "value": "-2.0000", "displayValue": "($2.00)" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": 0, "displayValue": 0 }, "cumulative_monthly_recurring_price_v1": { "value": 0, "displayValue": 0 }, "total_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricingAdjustments": [ { "adjustment_type": { "value": "a96c83d653dd91105c0eddeeff7b12d8", "displayValue": "MARKDOWN_PER" }, "adjustment_value": { "value": 20.0, "displayValue": "20" }, "adjustment_amount": { "value": -2.0, "displayValue": "($2.00)" }, "adjustment_amount_total": { "value": -6.0, "displayValue": "($6.00)" }, "adjustment_description": { "displayValue": "door sensor bundle discount" }, "adjustment_sequence_id": { "value": 1.0 }, "adjustment_matrix_type": { "displayValue": "Configuration Component Price Adjustment" }, "adjustment_basis": { "value": "prv_price_point" }, "price_point": { "value": "net_price" }, "pricing_plan_step": { "value": "97b61272ffe722101fb14ad013cb14d7" }, "running_price": { "value": 8.0, "displayValue": "$8.00" } } ], "total_adjustment_amount": [ { "pricePoint": "net_price", "value": -6.0, "displayValue": "($6.00)" } ] }, { "line_id": "HOMEAUTOMA1002", "status": "Success", "currency": "USD", "base_price": { "value": "100.0000", "displayValue": "$100.00" }, "list_price": { "value": "100.0000", "displayValue": "$100.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "1", "price_list_line": "fe912705d07a7910f8770dbf976be147", "product_offering": "3f6111dfd0a63110f8770dbf976be149", "parent_product_offer": "26d07c3211707110f877366201dea60c", "top_product_offer": "26d07c3211707110f877366201dea60c", "one_time_price": { "value": "80.0000", "displayValue": "$80.00" }, "monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_net_price": { "value": "80.0000", "displayValue": "$80.00" }, "cumulative_net_price": { "value": "80.0000", "displayValue": "$80.00" }, "cumulative_one_time_price": { "value": "80.0000", "displayValue": "$80.00" }, "cumulative_monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_adjustment": { "value": "-20.0000", "displayValue": "($20.00)" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": 0, "displayValue": 0 }, "cumulative_monthly_recurring_price_v1": { "value": 0, "displayValue": 0 }, "total_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricingAdjustments": [ { "adjustment_type": { "value": "a96c83d653dd91105c0eddeeff7b12d8", "displayValue": "MARKDOWN_PER" }, "adjustment_value": { "value": 20.0, "displayValue": "20" }, "adjustment_amount": { "value": -20.0, "displayValue": "($20.00)" }, "adjustment_amount_total": { "value": -20.0, "displayValue": "($20.00)" }, "adjustment_description": { "displayValue": "home automation hub bundle discount" }, "adjustment_sequence_id": { "value": 1.0 }, "adjustment_matrix_type": { "displayValue": "Configuration Component Price Adjustment" }, "adjustment_basis": { "value": "prv_price_point" }, "price_point": { "value": "net_price" }, "pricing_plan_step": { "value": "97b61272ffe722101fb14ad013cb14d7" }, "running_price": { "value": 80.0, "displayValue": "$80.00" } } ], "total_adjustment_amount": [ { "pricePoint": "net_price", "value": -20.0, "displayValue": "($20.00)" } ] }, { "line_id": "BASICMONIT1003", "status": "Success", "currency": "USD", "base_price": { "value": "30.0000", "displayValue": "$30.00" }, "list_price": { "value": "30.0000", "displayValue": "$30.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "1", "price_list_line": "bc53e785d07a7910f8770dbf976be1e7", "product_offering": "376111dfd0a63110f8770dbf976be140", "parent_product_offer": "26d07c3211707110f877366201dea60c", "top_product_offer": "26d07c3211707110f877366201dea60c", "one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "monthly_recurring_price": { "value": "25.0000", "displayValue": "$25.00" }, "annual_recurring_price": { "value": "300.0000", "displayValue": "$300.00" }, "unit_net_price": { "value": "25.0000", "displayValue": "$25.00" }, "cumulative_net_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_monthly_recurring_price": { "value": "25.0000", "displayValue": "$25.00" }, "cumulative_annual_recurring_price": { "value": "300.0000", "displayValue": "$300.00" }, "unit_adjustment": { "value": "-5.0000", "displayValue": "($5.00)" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": 0, "displayValue": 0 }, "cumulative_monthly_recurring_price_v1": { "value": "25.0000", "displayValue": "$25.00" }, "total_recurring_price": { "value": "25.0000", "displayValue": "$25.00" }, "pricingAdjustments": [ { "adjustment_type": { "value": "6e1c03d653dd91105c0eddeeff7b1232", "displayValue": "MARKDOWN_AMT" }, "adjustment_value": { "value": 5.0, "displayValue": "5" }, "adjustment_amount": { "value": -5.0, "displayValue": "($5.00)" }, "adjustment_amount_total": { "value": -5.0, "displayValue": "($5.00)" }, "adjustment_description": { "displayValue": "basic monitoring bundle discount" }, "adjustment_sequence_id": { "value": 1.0 }, "adjustment_matrix_type": { "displayValue": "Configuration Component Price Adjustment" }, "adjustment_basis": { "value": "prv_price_point" }, "price_point": { "value": "net_price" }, "pricing_plan_step": { "value": "97b61272ffe722101fb14ad013cb14d7" }, "running_price": { "value": 25.0, "displayValue": "$25.00" } } ], "total_adjustment_amount": [ { "pricePoint": "net_price", "value": -5.0, "displayValue": "($5.00)" } ] }, { "line_id": "PREMMONIT2004", "status": "Success", "currency": "USD", "base_price": { "value": "40.0000", "displayValue": "$40.00" }, "list_price": { "value": "40.0000", "displayValue": "$40.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "1", "price_list_line": "a663a785d07a7910f8770dbf976be115", "product_offering": "e2619d9fd0a63110f8770dbf976be1ec", "parent_product_offer": "26d07c3211707110f877366201dea60c", "top_product_offer": "26d07c3211707110f877366201dea60c", "one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "monthly_recurring_price": { "value": "35.0000", "displayValue": "$35.00" }, "annual_recurring_price": { "value": "420.0000", "displayValue": "$420.00" }, "unit_net_price": { "value": "35.0000", "displayValue": "$35.00" }, "cumulative_net_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_monthly_recurring_price": { "value": "35.0000", "displayValue": "$35.00" }, "cumulative_annual_recurring_price": { "value": "420.0000", "displayValue": "$420.00" }, "unit_adjustment": { "value": "-5.0000", "displayValue": "($5.00)" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": 0, "displayValue": 0 }, "cumulative_monthly_recurring_price_v1": { "value": "35.0000", "displayValue": "$35.00" }, "total_recurring_price": { "value": "35.0000", "displayValue": "$35.00" }, "pricingAdjustments": [ { "adjustment_type": { "value": "6e1c03d653dd91105c0eddeeff7b1232", "displayValue": "MARKDOWN_AMT" }, "adjustment_value": { "value": 5.0, "displayValue": "5" }, "adjustment_amount": { "value": -5.0, "displayValue": "($5.00)" }, "adjustment_amount_total": { "value": -5.0, "displayValue": "($5.00)" }, "adjustment_description": { "displayValue": "premium monitoring bundle discount" }, "adjustment_sequence_id": { "value": 1.0 }, "adjustment_matrix_type": { "displayValue": "Configuration Component Price Adjustment" }, "adjustment_basis": { "value": "prv_price_point" }, "price_point": { "value": "net_price" }, "pricing_plan_step": { "value": "97b61272ffe722101fb14ad013cb14d7" }, "running_price": { "value": 35.0, "displayValue": "$35.00" } } ], "total_adjustment_amount": [ { "pricePoint": "net_price", "value": -5.0, "displayValue": "($5.00)" } ] }, { "line_id": "INDOORCAM1006", "status": "Success", "currency": "USD", "base_price": { "value": "35.0000", "displayValue": "$35.00" }, "list_price": { "value": "35.0000", "displayValue": "$35.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "1", "price_list_line": "81332f45d07a7910f8770dbf976be14e", "product_offering": "1761dd9fd0a63110f8770dbf976be196", "parent_product_offer": "26d07c3211707110f877366201dea60c", "top_product_offer": "26d07c3211707110f877366201dea60c", "one_time_price": { "value": "28.0000", "displayValue": "$28.00" }, "monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_net_price": { "value": "28.0000", "displayValue": "$28.00" }, "cumulative_net_price": { "value": "28.0000", "displayValue": "$28.00" }, "cumulative_one_time_price": { "value": "28.0000", "displayValue": "$28.00" }, "cumulative_monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_adjustment": { "value": "-7.0000", "displayValue": "($7.00)" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": 0, "displayValue": 0 }, "cumulative_monthly_recurring_price_v1": { "value": 0, "displayValue": 0 }, "total_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricingAdjustments": [ { "adjustment_type": { "value": "a96c83d653dd91105c0eddeeff7b12d8", "displayValue": "MARKDOWN_PER" }, "adjustment_value": { "value": 20.0, "displayValue": "20" }, "adjustment_amount": { "value": -7.0, "displayValue": "($7.00)" }, "adjustment_amount_total": { "value": -7.0, "displayValue": "($7.00)" }, "adjustment_description": { "displayValue": "indoor camera bundle discount" }, "adjustment_sequence_id": { "value": 1.0 }, "adjustment_matrix_type": { "displayValue": "Configuration Component Price Adjustment" }, "adjustment_basis": { "value": "prv_price_point" }, "price_point": { "value": "net_price" }, "pricing_plan_step": { "value": "97b61272ffe722101fb14ad013cb14d7" }, "running_price": { "value": 28.0, "displayValue": "$28.00" } } ], "total_adjustment_amount": [ { "pricePoint": "net_price", "value": -7.0, "displayValue": "($7.00)" } ] }, { "line_id": "OUTCAMERA1007", "status": "Success", "currency": "USD", "base_price": { "value": "40.0000", "displayValue": "$40.00" }, "list_price": { "value": "40.0000", "displayValue": "$40.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "1", "price_list_line": "9a136f45d07a7910f8770dbf976be1b4", "product_offering": "6f6111dfd0a63110f8770dbf976be100", "parent_product_offer": "26d07c3211707110f877366201dea60c", "top_product_offer": "26d07c3211707110f877366201dea60c", "one_time_price": { "value": "32.0000", "displayValue": "$32.00" }, "monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_net_price": { "value": "32.0000", "displayValue": "$32.00" }, "cumulative_net_price": { "value": "32.0000", "displayValue": "$32.00" }, "cumulative_one_time_price": { "value": "32.0000", "displayValue": "$32.00" }, "cumulative_monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_adjustment": { "value": "-8.0000", "displayValue": "($8.00)" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": 0, "displayValue": 0 }, "cumulative_monthly_recurring_price_v1": { "value": 0, "displayValue": 0 }, "total_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricingAdjustments": [ { "adjustment_type": { "value": "a96c83d653dd91105c0eddeeff7b12d8", "displayValue": "MARKDOWN_PER" }, "adjustment_value": { "value": 20.0, "displayValue": "20" }, "adjustment_amount": { "value": -8.0, "displayValue": "($8.00)" }, "adjustment_amount_total": { "value": -8.0, "displayValue": "($8.00)" }, "adjustment_description": { "displayValue": "outdoor camera bundle discount" }, "adjustment_sequence_id": { "value": 1.0 }, "adjustment_matrix_type": { "displayValue": "Configuration Component Price Adjustment" }, "adjustment_basis": { "value": "prv_price_point" }, "price_point": { "value": "net_price" }, "pricing_plan_step": { "value": "97b61272ffe722101fb14ad013cb14d7" }, "running_price": { "value": 32.0, "displayValue": "$32.00" } } ], "total_adjustment_amount": [ { "pricePoint": "net_price", "value": -8.0, "displayValue": "($8.00)" } ] }, { "line_id": "WINSENSOR1008", "status": "Success", "currency": "USD", "base_price": { "value": "15.0000", "displayValue": "$15.00" }, "list_price": { "value": "15.0000", "displayValue": "$15.00" }, "pricelist": "19d29513d0e63110f8770dbf976be122", "quantity": "3", "price_list_line": "91f26b45d07a7910f8770dbf976be19b", "product_offering": "1b20347e11307110f877366201dea67f", "parent_product_offer": "26d07c3211707110f877366201dea60c", "top_product_offer": "26d07c3211707110f877366201dea60c", "one_time_price": { "value": "36.0000", "displayValue": "$36.00" }, "monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_net_price": { "value": "12.0000", "displayValue": "$12.00" }, "cumulative_net_price": { "value": "36.0000", "displayValue": "$36.00" }, "cumulative_one_time_price": { "value": "36.0000", "displayValue": "$36.00" }, "cumulative_monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_adjustment": { "value": "-3.0000", "displayValue": "($3.00)" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": 0, "displayValue": 0 }, "cumulative_monthly_recurring_price_v1": { "value": 0, "displayValue": 0 }, "total_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricingAdjustments": [ { "adjustment_type": { "value": "a96c83d653dd91105c0eddeeff7b12d8", "displayValue": "MARKDOWN_PER" }, "adjustment_value": { "value": 20.0, "displayValue": "20" }, "adjustment_amount": { "value": -3.0, "displayValue": "($3.00)" }, "adjustment_amount_total": { "value": -9.0, "displayValue": "($9.00)" }, "adjustment_description": { "displayValue": "window sensor bundle discount" }, "adjustment_sequence_id": { "value": 1.0 }, "adjustment_matrix_type": { "displayValue": "Configuration Component Price Adjustment" }, "adjustment_basis": { "value": "prv_price_point" }, "price_point": { "value": "net_price" }, "pricing_plan_step": { "value": "97b61272ffe722101fb14ad013cb14d7" }, "running_price": { "value": 12.0, "displayValue": "$12.00" } } ], "total_adjustment_amount": [ { "pricePoint": "net_price", "value": -9.0, "displayValue": "($9.00)" } ] } ], "status": "Success", "total_monthly_recurring_price": { "value": "89.1666", "displayValue": "$89.1666" }, "total_monthly_recurring_price_v1": { "value": "60.0000", "displayValue": "$60.00" }, "total_annual_recurring_price": { "value": "1070.0000", "displayValue": "$1,070.00" }, "total_annual_recurring_price_v1": { "value": "350.0000", "displayValue": "$350.00" }, "total_amount": { "value": "200.0000", "displayValue": "$200.00" }, "total_amount_v1": { "value": "610.0000", "displayValue": "$610.00" }, "total_one_time_price": { "value": "200.0000", "displayValue": "$200.00" }, "total_one_time_cost": { "value": "0.0000", "displayValue": "$0.00" }, "total_monthly_cost": { "value": "0.0000", "displayValue": "$0.00" }, "total_cost": { "value": "0.0000", "displayValue": "$0.00" }, "total_one_time_margin": { "value": "200.0000", "displayValue": "$200.00" }, "total_monthly_margin": { "value": "89.1666", "displayValue": "$89.1666" }, "total_margin_amount": { "value": "200.0000", "displayValue": "$200.00" }, "total_one_time_margin_percentage": { "value": "100.0000", "displayValue": "$100.00" }, "total_monthly_margin_percentage": { "value": "100.0000", "displayValue": "$100.00" }, "total_margin_percentage": { "value": "100.0000", "displayValue": "$100.00" } }, "settings": { "pricing_elements": "PRICE,COST,NET_PRICE,LINE_ROLLUPS,HEADER_ROLLUPS,ADJUSTMENTS" } } } ``` ### External ID resolution This example shows setting the external ID resolution feature to true while setting the `pricelist` and `product_offering` to a custom-mapped variable called `DOORSENSOR1`. Example: - `"use_external_code": true`: Enables external code resolution - `"pricelist": "DOORSENSOR1"`: Value maps to a custom context variable for the price - `"product_offering": "DOORSENSOR1"`: Value maps to a custom context variable for the product Example: cURL request. ``` curl "https://instance.servicenow.com/api/sn_csm_pricing/v1/pricingengine/computePrice" \ --request POST \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --data '{ "header": { "source_system": "ServiceNow Headless API", "requesting_record_id": "QT0001101", "currency": "USD", "lineItems": [ { "pricelist": "DOORSENSOR1", "product_offering": "DOORSENSOR1", "periodicity" : "", "quantity": "1", "unit_of_measure": "cb2795d553020110286eddeeff7b12ff", "transaction_date": "2023-12-18 23:37:11", "line_id": "CONNECTEDC1100" } ], "pricelist": "19d29513d0e63110f8770dbf976be122", "transaction_date": "2023-12-18 23:37:11" }, "settings": { "pricing_elements": "PRICE,COST,NET_PRICE,LINE_ROLLUPS,HEADER_ROLLUPS,ADJUSTMENTS", "disable_validation": true, "use_external_code": true } }' \ --user 'username:password' ``` ``` { "result": { "header": { "currency": "USD", "lineItems": [ { "line_id": "CONNECTEDC1100", "status": "Success", "currency": "USD", "base_price": { "value": "0.0000", "displayValue": "$0.00" }, "list_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricelist": "DOORSENSOR1", "quantity": "", "price_list_line": "3e93e785d07a7910f8770dbf976be1ee", "product_offering": "DOORSENSOR1", "one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_net_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_net_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "cumulative_annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "unit_adjustment": { "value": "0.0000", "displayValue": "$0.00" }, "term_month": { "value": 0, "displayValue": 0 }, "cumulative_annual_recurring_price_v1": { "value": 0, "displayValue": 0 }, "cumulative_monthly_recurring_price_v1": { "value": 0, "displayValue": 0 }, "total_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "pricingAdjustments": [], "total_adjustment_amount": [] } ], "status": "Success", "total_monthly_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "total_monthly_recurring_price_v1": { "value": "0.0000", "displayValue": "$0.00" }, "total_annual_recurring_price": { "value": "0.0000", "displayValue": "$0.00" }, "total_annual_recurring_price_v1": { "value": "0.0000", "displayValue": "$0.00" }, "total_amount": { "value": "0.0000", "displayValue": "$0.00" }, "total_amount_v1": { "value": "0.0000", "displayValue": "$0.00" }, "total_one_time_price": { "value": "0.0000", "displayValue": "$0.00" }, "total_one_time_cost": { "value": "0.0000", "displayValue": "$0.00" }, "total_monthly_cost": { "value": "0.0000", "displayValue": "$0.00" }, "total_cost": { "value": "0.0000", "displayValue": "$0.00" }, "total_one_time_margin": { "value": "0.0000", "displayValue": "$0.00" }, "total_monthly_margin": { "value": "0.0000", "displayValue": "$0.00" }, "total_margin_amount": { "value": "0.0000", "displayValue": "$0.00" }, "total_one_time_margin_percentage": { "value": "0.0000", "displayValue": "$0.00" }, "total_monthly_margin_percentage": { "value": "0.0000", "displayValue": "$0.00" }, "total_margin_percentage": { "value": "0.0000", "displayValue": "$0.00" } }, "settings": { "pricing_elements": "PRICE,COST,NET_PRICE,LINE_ROLLUPS,HEADER_ROLLUPS,ADJUSTMENTS", "use_external_code": true } } } ```