Applying a Promotion to a Quote or an Order

When you use the Siebel REST API to apply a promotion to a quote or an order, the Siebel application takes the bundle promotion definition ID and adds an instance of the promotion, along with its default components, to a quote or to an order. We can also use this API to associate an existing line item to an existing promotion instance.

The following request applies a specific promotion to a quote or an order:

  • URI: http://ServerName:port/siebel/v1.0/service/Workflow Process Manager/RunProcess

  • HTTP Method: POST

  • Content-Type: application/json

  • Authorization: Basic

  • Request body:
    {
      "body": {
        "ProcessName": "ISS Promotion WS - ApplyProductPromotion - Order",
        "PricingMode": "Y",
        "EligibilityMode": "0",
        "Quantity": "1",
        "ProdPromId": "88-231OB",
        "Sync": "Y",
        "SiebelMessage": {
          "MessageId": "",
          "MessageType": "Integration Object",
          "IntObjectName": "PDS Order",
          "IntObjectFormat": "Siebel Hierarchical",
          "ListOfPDS Order": {
            "Header": {
              "Account": "James Parker",
              "Account Id": "88-3GVFAT",
              "Price List Id": "88-23AQ7",
              "Order Type": "Sales Order",
              "Order Number": "Sales_Order_1"
            }
          }
        }
      }
    }

For a description of the request message associated with this API, see the following table.

Name Description

Process Name

One of the following processes is required:

  • ISS Promotion WS - ApplyProductPromotion - Order

  • ISS Promotion WS - ApplyProductPromotion (This is the process name for Quote.)

ProdPromId

Required.

Promotion ID that is applied to the quote or order.

PricingMode

Optional. The default value is Y.

If the value set to Y, then the pricing is calculated for all line items in the in-memory document.

EligibilityMode

Optional. Valid values are 0, 1, or 2.

  • If set to 0, then the procedure is not run.

  • If set to 1, then the procedure is run, and all ineligible products are displayed with messages.

  • If set to 2, then the procedure is run, and ineligible products are not included in the pricing calculations.

    Note:

    This behavior is different from how other APIs behave where EligibilityMode is set to 2.

Quantity

Optional. The default value is 1.

Quantity of the promotion to be applied.

HeaderId

Optional, depending on usage. However, this is required if SiebelMessage is not provided.

Quote ID or Order ID.

Sync

Optional. The default value is N.

If set to Y, then an order or a quote is created or updated in the database.

ProdPromInstanceId

Optional.

Integration ID of the Promotion. If the promotion already exists in the document, and one more product needs to be added to the promotion instance, then this ID is passed.

LineItemId

Optional.

Line item ID of the product to which the promotion should be applied.

SiebelMessage

Optional, depending on usage. However, this is required if HeaderId is not provided.

PDS quote or PDS Order.

Here are the response details for a successful request:

  • HTTP Code: 200

  • Content-Type: application/json

  • Response body:
    {
      "Error Code": "",
      "matchrequestformat": "y",
      "Non Orderable Error": "",
      "Error Message": "",
      "Integration Object Name": "PDS Order",
      "uniformresponse": "y",
      "SiebelMessage": {
        "IntObjectFormat": "Siebel Hierarchical",
        "MessageId": "88-ATUEE",
        "IntObjectName": "PDS Order",
        "MessageType": "Integration Object",
        "ListOfPDS Order": {
          "Header": [
            {
              "MRC Total": "50",
              "Compound Product Number": "88-3GVCQG",
              "Mod Id": "0",
              "Discount": "",
              "Street Address": "",
              "Due Date": "08/07/2025 00:00:00",
              "Opty Id": "",
              "Conflict Id": "0",
              "Billing Account Id": "88-3GVFAT",
              "Country": "",
              "Service Account Id": "88-3GVFAT",
              "Updated": "08/06/2025 23:04:50",
              "Ship To Account Id": "88-3GVFAT",
              "Comments": "",
              "Order Number": "Sales_Order_1",
              "Revision": "1",
              "State": "",
              "Ship To Address Id": "",
              "Account Type": "Customer",
              "Integration Id": "88-3GVCQG",
              "Price List Id": "88-23AQ7",
              "Status": "Pending",
              "Billing Profile Id": "",
              "Billing Profile Name": "",
              "Account": "James Parker",
              "Order Type": "Sales Order",
              "Id": "88-3GVCQG",
              "Postal Code": "",
              "Created": "08/06/2025 23:04:50",
              "Contact Id": "",
              "Account Location": "",
              "Account Id": "88-3GVFAT",
              "NRC Total": "153.29486",
              "Currency Code": "USD",
              "City": "",
              "ListOfLine Item": {
                "Line Item": [
                  {
                    "Discount Source": "Manual",
                    "Discount": "",
                    "Volume Upsell Item Id": "",
                    "Due Date": "08/07/2025 00:00:00",
                    "Ship To - City": "",
                    "Current Price": "49",
                    "Extended Quantity Requested": "1",
                    "Max Price": "",
                    "Rollup Amount": "0",
                    "MRC CxTotal": "0",
                    "Post Pick CD": "",
                    "Net Price": "49",
                    "Port Item Id": "",
                    "Discount Percent": "",
                    "Service Length UoM": "",
                    "Previous Asset Status": "",
                    "Class Id": "",
                    "Effective To": "",
                    "Base Price": "49",
                    "Pre Pick CD": "N",
                    "Prod Prom Rule Id": "",
                    "Asset Integration Id": "88-3GVCPJ",
                    "Parent Id": "",
                    "Ship To - Address 2": "",
                    "Ship To - State": "",
                    "Prod Item Id": "",
                    "Need Refresh": "Y",
                    "Ship To - Zip": "",
                    "Exclude Pricing Flag": "N",
                    "Action Code": "Add",
                    "Service Price Method": "",
                    "Effective From": "",
                    "Unit of Measure": "",
                    "Eligibility Reason": "",
                    "Ship To - Address": "",
                    "Price List Id": "",
                    "Pricing Adjustment Amount": "0",
                    "Mod Id": "0",
                    "Rollup Item Price": "49",
                    "Promotion MRC Total": "50",
                    "Service Id": "",
                    "NRC CxTotal": "49",
                    "Service Length": "",
                    "Account Id": "88-3GVFAT",
                    "Volume Discount Item Id": "",
                    "Conflict Id": "0",
                    "Adjusted List Price": "49",
                    "Currency Code": "USD",
                    "List Price": "49",
                    "Root Id": "88-3GVCQJ",
                    "Product Type": "Service",
                    "Item Price List Id": "",
                    "Root Product Id": "88-231OB",
                    "Line Number": "1",
                    "Billing Account Id": "88-3GVFAT",
                    "Volume Upsell Item": "",
                    "Product Def Type Code": "None",
                    "Product Type Code": "Promotion",
                    "Discount Amount": "",
                    "Promotion MRC Start Total": "34",
                    "Updated": "08/06/2025 23:04:50",
                    "Billing Profile Name": "",
                    "Prod Prom Type": "Bundled Promotions",
                    "Price Type": "One-Time",
                    "Min Price": "",
                    "Volume Upsell Message": "",
                    "Previous Net Price": "",
                    "Smart Part Number": "",
                    "Prod Prom Name": "",
                    "Prod Prom Instance Id": "",
                    "Volume Discount Id": "",
                    "Eligibility Status": "",
                    "Related Asset Integration Id": "",
                    "Quantity": "1",
                    "Original List Price": "49",
                    "Forcastable Flag": "",
                    "Id": "88-3GVCQJ",
                    "Root Asset Integration Id": "88-3GVCPJ",
                    "Cfg State Code": "New Item",
                    "Ship To Address Id": "",
                    "Integration Id": "88-3GVCPK",
                    "Service Price Percent": "",
                    "Type": "",
                    "Product Line Id": "No Match Row Id",
                    "Service Account Id": "88-3GVFAT",
                    "Billing Profile Id": "",
                    "Prod Prom Id": "",
                    "Created": "08/06/2025 23:04:50",
                    "Name": "Millennium Max 500 Package",
                    "Promotion NRC Total": "153.29486",
                    "Unit Price": "",
                    "Prod Prom Source Id": "",
                    "Cfg Type": "eConfigurator",
                    "Has Generics Flag": "",
                    "Volume Discount Item": "",
                    "Product Structure Type": "None",
                    "Exchange Date": "",
                    "Promotion NRC Start Total": "317",
                    "Configuration Model Id": "88-231OB",
                    "Asset Status": "Active",
                    "Pricing Comments": "",
                    "Header Discount Amount": "",
                    "Inclusive Eligibility Flag": "N",
                    "Product Id": "88-231OB",
                    "Ship To - Country": "",
                    "Cost": ""
                  },
                  {
                    "Discount Source": "Manual",
                    "Discount": "",
                    "Volume Upsell Item Id": "",
                    "Due Date": "08/07/2025 00:00:00",
                    "Ship To - City": "",
                    "Current Price": "29.8",
                    "Extended Quantity Requested": "1",
                    "Max Price": "",
                    "Rollup Amount": "10",
                    "MRC CxTotal": "0",
                    "Post Pick CD": "",
                    "Net Price": "29.8",
                    "Port Item Id": "",
                    "Discount Percent": "",
                    "Service Length UoM": "",
                    "Previous Asset Status": "",
                    "Class Id": "",
                    "Effective To": "",
                    "Base Price": "149",
                    "Pre Pick CD": "N",
                    "Prod Prom Rule Id": "88-255KL",
                    "Asset Integration Id": "88-3GVCQK",
                    "Parent Id": "",
                    "Ship To - Address 2": "",
                    "Ship To - State": "",
                    "Prod Item Id": "",
                    "Need Refresh": "Y",
                    "Ship To - Zip": "",
                    "Exclude Pricing Flag": "N",
                    "Action Code": "Add",
                    "Service Price Method": "",
                    "Effective From": "",
                    "Unit of Measure": "",
                    "Eligibility Reason": "",
                    "Ship To - Address": "",
                    "Price List Id": "",
                    "Pricing Adjustment Amount": "119.2",
                    "Mod Id": "0",
                    "Rollup Item Price": "159",
                    "Promotion MRC Total": "",
                    "Service Id": "",
                    "NRC CxTotal": "39.8",
                    "Service Length": "",
                    "Account Id": "88-3GVFAT",
                    "Volume Discount Item Id": "",
                    "Conflict Id": "0",
                    "Adjusted List Price": "149",
                    "Currency Code": "USD",
                    "List Price": "149",
                    "Root Id": "88-3GVCQK",
                    "Product Type": "Device",
                    "Item Price List Id": "",
                    "Root Product Id": "88-231F2",
                    "Line Number": "2",
                    "Billing Account Id": "88-3GVFAT",
                    "Volume Upsell Item": "",
                    "Product Def Type Code": "Customizable",
                    "Product Type Code": "Product",
                    "Discount Amount": "",
                    "Promotion MRC Start Total": "",
                    "Updated": "08/06/2025 23:04:50",
                    "Billing Profile Name": "",
                    "Prod Prom Type": "",
                    "Price Type": "One-Time",
                    "Min Price": "",
                    "Volume Upsell Message": "",
                    "Previous Net Price": "",
                    "Smart Part Number": "",
                    "Prod Prom Name": "Millennium Max 500 Package",
                    "Prod Prom Instance Id": "88-3GVCPJ",
                    "Volume Discount Id": "",
                    "Eligibility Status": "",
                    "Related Asset Integration Id": "",
                    "Quantity": "1",
                    "Original List Price": "149",
                    "Forcastable Flag": "",
                    "Id": "88-3GVCQK",
                    "Root Asset Integration Id": "88-3GVCQK",
                    "Cfg State Code": "New Item",
                    "Ship To Address Id": "",
                    "Integration Id": "88-3GVCPQ",
                    "Service Price Percent": "",
                    "Type": "",
                    "Product Line Id": "88-231FE",
                    "Service Account Id": "88-3GVFAT",
                    "Billing Profile Id": "",
                    "Prod Prom Id": "88-231OB",
                    "Created": "08/06/2025 23:04:50",
                    "Name": "Daytech 300",
                    "Promotion NRC Total": "",
                    "Unit Price": "",
                    "Prod Prom Source Id": "",
                    "Cfg Type": "eConfigurator",
                    "Has Generics Flag": "",
                    "Volume Discount Item": "",
                    "Product Structure Type": "Customizable",
                    "Exchange Date": "",
                    "Promotion NRC Start Total": "",
                    "Configuration Model Id": "88-231F2",
                    "Asset Status": "Active",
                    "Pricing Comments": "",
                    "Header Discount Amount": "",
                    "Inclusive Eligibility Flag": "N",
                    "Product Id": "88-231F2",
                    "Ship To - Country": "",
                    "Cost": "",
                    "Line Item": [
                      {
                        "Discount Source": "Manual",
                        "Discount": "",
                        "Volume Upsell Item Id": "",
                        "Due Date": "08/07/2025 00:00:00",
                        "Ship To - City": "",
                        "Current Price": "5",
                        "Extended Quantity Requested": "1",
                        "Max Price": "",
                        "Rollup Amount": "0",
                        "MRC CxTotal": "",
                        "Post Pick CD": "",
                        "Net Price": "5",
                        "Port Item Id": "88-23AGS",
                        "Discount Percent": "",
                        "Service Length UoM": "",
                        "Previous Asset Status": "",
                        "Class Id": "",
                        "Effective To": "",
                        "Base Price": "5",
                        "Pre Pick CD": "N",
                        "Prod Prom Rule Id": "",
                        "Asset Integration Id": "88-3GVCQL",
                        "Parent Id": "88-3GVCQK",
                        "Ship To - Address 2": "",
                        "Ship To - State": "",
                        "Prod Item Id": "88-23AGS",
                        "Need Refresh": "Y",
                        "Ship To - Zip": "",
                        "Exclude Pricing Flag": "N",
                        "Action Code": "Add",
                        "Service Price Method": "",
                        "Effective From": "",
                        "Unit of Measure": "",
                        "Eligibility Reason": "",
                        "Ship To - Address": "",
                        "Price List Id": "",
                        "Pricing Adjustment Amount": "0",
                        "Mod Id": "0",
                        "Rollup Item Price": "5",
                        "Promotion MRC Total": "",
                        "Service Id": "",
                        "NRC CxTotal": "",
                        "Service Length": "",
                        "Account Id": "88-3GVFAT",
                        "Volume Discount Item Id": "",
                        "Conflict Id": "0",
                        "Adjusted List Price": "5",
                        "Currency Code": "USD",
                        "List Price": "5",
                        "Root Id": "88-3GVCQK",
                        "Product Type": "",
                        "Item Price List Id": "",
                        "Root Product Id": "88-231F2",
                        "Line Number": "3",
                        "Billing Account Id": "88-3GVFAT",
                        "Volume Upsell Item": "",
                        "Product Def Type Code": "None",
                        "Product Type Code": "Product",
                        "Discount Amount": "",
                        "Promotion MRC Start Total": "",
                        "Updated": "08/06/2025 23:04:50",
                        "Billing Profile Name": "",
                        "Prod Prom Type": "",
                        "Price Type": "One-Time",
                        "Min Price": "",
                        "Volume Upsell Message": "",
                        "Previous Net Price": "",
                        "Smart Part Number": "",
                        "Prod Prom Name": "",
                        "Prod Prom Instance Id": "",
                        "Volume Discount Id": "",
                        "Eligibility Status": "",
                        "Related Asset Integration Id": "",
                        "Quantity": "1",
                        "Original List Price": "5",
                        "Forcastable Flag": "",
                        "Id": "88-3GVCQL",
                        "Root Asset Integration Id": "88-3GVCQK",
                        "Cfg State Code": "Engine Picked Item",
                        "Ship To Address Id": "",
                        "Integration Id": "88-3GVCPR",
                        "Service Price Percent": "",
                        "Type": "",
                        "Product Line Id": "No Match Row Id",
                        "Service Account Id": "88-3GVFAT",
                        "Billing Profile Id": "",
                        "Prod Prom Id": "",
                        "Created": "08/06/2025 23:04:50",
                        "Name": "Battery",
                        "Promotion NRC Total": "",
                        "Unit Price": "",
                        "Prod Prom Source Id": "",
                        "Cfg Type": "",
                        "Has Generics Flag": "",
                        "Volume Discount Item": "",
                        "Product Structure Type": "None",
                        "Exchange Date": "",
                        "Promotion NRC Start Total": "",
                        "Configuration Model Id": "88-231DT",
                        "Asset Status": "Active",
                        "Pricing Comments": "",
                        "Header Discount Amount": "",
                        "Inclusive Eligibility Flag": "N",
                        "Product Id": "88-231DT",
                        "Ship To - Country": "",
                        "Cost": ""
                      },
                      {
                        "Discount Source": "Manual",
                        "Discount": "",
                        "Volume Upsell Item Id": "",
                        "Due Date": "08/07/2025 00:00:00",
                        "Ship To - City": "",
                        "Current Price": "5",
                        "Extended Quantity Requested": "1",
                        "Max Price": "",
                        "Rollup Amount": "0",
                        "MRC CxTotal": "",
                        "Post Pick CD": "",
                        "Net Price": "5",
                        "Port Item Id": "88-23AGU",
                        "Discount Percent": "",
                        "Service Length UoM": "",
                        "Previous Asset Status": "",
                        "Class Id": "",
                        "Effective To": "",
                        "Base Price": "5",
                        "Pre Pick CD": "N",
                        "Prod Prom Rule Id": "",
                        "Asset Integration Id": "88-3GVCQM",
                        "Parent Id": "88-3GVCQK",
                        "Ship To - Address 2": "",
                        "Ship To - State": "",
                        "Prod Item Id": "88-23AGU",
                        "Need Refresh": "Y",
                        "Ship To - Zip": "",
                        "Exclude Pricing Flag": "N",
                        "Action Code": "Add",
                        "Service Price Method": "",
                        "Effective From": "",
                        "Unit of Measure": "Each",
                        "Eligibility Reason": "",
                        "Ship To - Address": "",
                        "Price List Id": "",
                        "Pricing Adjustment Amount": "0",
                        "Mod Id": "0",
                        "Rollup Item Price": "5",
                        "Promotion MRC Total": "",
                        "Service Id": "",
                        "NRC CxTotal": "",
                        "Service Length": "",
                        "Account Id": "88-3GVFAT",
                        "Volume Discount Item Id": "",
                        "Conflict Id": "0",
                        "Adjusted List Price": "5",
                        "Currency Code": "USD",
                        "List Price": "5",
                        "Root Id": "88-3GVCQK",
                        "Product Type": "",
                        "Item Price List Id": "",
                        "Root Product Id": "88-231F2",
                        "Line Number": "4",
                        "Billing Account Id": "88-3GVFAT",
                        "Volume Upsell Item": "",
                        "Product Def Type Code": "None",
                        "Product Type Code": "Product",
                        "Discount Amount": "",
                        "Promotion MRC Start Total": "",
                        "Updated": "08/06/2025 23:04:50",
                        "Billing Profile Name": "",
                        "Prod Prom Type": "",
                        "Price Type": "One-Time",
                        "Min Price": "",
                        "Volume Upsell Message": "",
                        "Previous Net Price": "",
                        "Smart Part Number": "",
                        "Prod Prom Name": "",
                        "Prod Prom Instance Id": "",
                        "Volume Discount Id": "",
                        "Eligibility Status": "",
                        "Related Asset Integration Id": "",
                        "Quantity": "1",
                        "Original List Price": "5",
                        "Forcastable Flag": "",
                        "Id": "88-3GVCQM",
                        "Root Asset Integration Id": "88-3GVCQK",
                        "Cfg State Code": "Engine Picked Item",
                        "Ship To Address Id": "",
                        "Integration Id": "88-3GVCPS",
                        "Service Price Percent": "",
                        "Type": "",
                        "Product Line Id": "No Match Row Id",
                        "Service Account Id": "88-3GVFAT",
                        "Billing Profile Id": "",
                        "Prod Prom Id": "",
                        "Created": "08/06/2025 23:04:50",
                        "Name": "Charger",
                        "Promotion NRC Total": "",
                        "Unit Price": "",
                        "Prod Prom Source Id": "",
                        "Cfg Type": "",
                        "Has Generics Flag": "",
                        "Volume Discount Item": "",
                        "Product Structure Type": "None",
                        "Exchange Date": "",
                        "Promotion NRC Start Total": "",
                        "Configuration Model Id": "3SIA-2MOYY",
                        "Asset Status": "Active",
                        "Pricing Comments": "",
                        "Header Discount Amount": "",
                        "Inclusive Eligibility Flag": "N",
                        "Product Id": "3SIA-2MOYY",
                        "Ship To - Country": "",
                        "Cost": ""
                      }
                    ]
                  },
                  {
                    "Discount Source": "Manual",
                    "Discount": "",
                    "Volume Upsell Item Id": "",
                    "Due Date": "08/07/2025 00:00:00",
                    "Ship To - City": "",
                    "Current Price": "50",
                    "Extended Quantity Requested": "1",
                    "Max Price": "",
                    "Rollup Amount": "9.99486",
                    "MRC CxTotal": "50",
                    "Post Pick CD": "",
                    "Net Price": "50",
                    "Port Item Id": "",
                    "Discount Percent": "",
                    "Service Length UoM": "",
                    "Previous Asset Status": "",
                    "Class Id": "",
                    "Effective To": "",
                    "Base Price": "34",
                    "Pre Pick CD": "N",
                    "Prod Prom Rule Id": "88-231OM",
                    "Asset Integration Id": "88-3GVCQN",
                    "Parent Id": "",
                    "Ship To - Address 2": "",
                    "Ship To - State": "",
                    "Prod Item Id": "",
                    "Need Refresh": "Y",
                    "Ship To - Zip": "",
                    "Exclude Pricing Flag": "N",
                    "Action Code": "Add",
                    "Service Price Method": "",
                    "Effective From": "",
                    "Unit of Measure": "Per Month",
                    "Eligibility Reason": "",
                    "Ship To - Address": "",
                    "Price List Id": "",
                    "Pricing Adjustment Amount": "-16",
                    "Mod Id": "0",
                    "Rollup Item Price": "43.99486",
                    "Promotion MRC Total": "",
                    "Service Id": "",
                    "NRC CxTotal": "9.99486",
                    "Service Length": "",
                    "Account Id": "88-3GVFAT",
                    "Volume Discount Item Id": "",
                    "Conflict Id": "0",
                    "Adjusted List Price": "34",
                    "Currency Code": "USD",
                    "List Price": "34",
                    "Root Id": "88-3GVCQN",
                    "Product Type": "Service",
                    "Item Price List Id": "",
                    "Root Product Id": "88-231H5",
                    "Line Number": "5",
                    "Billing Account Id": "88-3GVFAT",
                    "Volume Upsell Item": "",
                    "Product Def Type Code": "Customizable",
                    "Product Type Code": "Product",
                    "Discount Amount": "",
                    "Promotion MRC Start Total": "",
                    "Updated": "08/06/2025 23:04:50",
                    "Billing Profile Name": "",
                    "Prod Prom Type": "",
                    "Price Type": "Recurring",
                    "Min Price": "",
                    "Volume Upsell Message": "",
                    "Previous Net Price": "",
                    "Smart Part Number": "",
                    "Prod Prom Name": "Millennium Max 500 Package",
                    "Prod Prom Instance Id": "88-3GVCPJ",
                    "Volume Discount Id": "",
                    "Eligibility Status": "",
                    "Related Asset Integration Id": "",
                    "Quantity": "1",
                    "Original List Price": "34",
                    "Forcastable Flag": "",
                    "Id": "88-3GVCQN",
                    "Root Asset Integration Id": "88-3GVCQN",
                    "Cfg State Code": "New Item",
                    "Ship To Address Id": "",
                    "Integration Id": "88-3GVCPW",
                    "Service Price Percent": "",
                    "Type": "",
                    "Product Line Id": "88-23AME",
                    "Service Account Id": "88-3GVFAT",
                    "Billing Profile Id": "",
                    "Prod Prom Id": "88-231OB",
                    "Created": "08/06/2025 23:04:50",
                    "Name": "Wireless Service",
                    "Promotion NRC Total": "",
                    "Unit Price": "",
                    "Prod Prom Source Id": "",
                    "Cfg Type": "eConfigurator",
                    "Has Generics Flag": "",
                    "Volume Discount Item": "",
                    "Product Structure Type": "Customizable",
                    "Exchange Date": "",
                    "Promotion NRC Start Total": "",
                    "Configuration Model Id": "88-231H5",
                    "Asset Status": "Active",
                    "Pricing Comments": "",
                    "Header Discount Amount": "",
                    "Inclusive Eligibility Flag": "N",
                    "Product Id": "88-231H5",
                    "Ship To - Country": "",
                    "Cost": "",
                    "Line Item": [
                      {
                        "Discount Source": "Manual",
                        "Discount": "",
                        "Volume Upsell Item Id": "",
                        "Due Date": "08/07/2025 00:00:00",
                        "Ship To - City": "",
                        "Current Price": "9.99486",
                        "Extended Quantity Requested": "1",
                        "Max Price": "",
                        "Rollup Amount": "0",
                        "MRC CxTotal": "",
                        "Post Pick CD": "",
                        "Net Price": "9.99486",
                        "Port Item Id": "88-231HY",
                        "Discount Percent": "",
                        "Service Length UoM": "",
                        "Previous Asset Status": "",
                        "Class Id": "3SIA-2KY0S",
                        "Effective To": "",
                        "Base Price": "10",
                        "Pre Pick CD": "N",
                        "Prod Prom Rule Id": "88-1XK5DN",
                        "Asset Integration Id": "88-3GVCQO",
                        "Parent Id": "88-3GVCQN",
                        "Ship To - Address 2": "",
                        "Ship To - State": "",
                        "Prod Item Id": "88-231JV",
                        "Need Refresh": "Y",
                        "Ship To - Zip": "",
                        "Exclude Pricing Flag": "N",
                        "Action Code": "Add",
                        "Service Price Method": "",
                        "Effective From": "",
                        "Unit of Measure": "",
                        "Eligibility Reason": "",
                        "Ship To - Address": "",
                        "Price List Id": "",
                        "Pricing Adjustment Amount": ".00514",
                        "Mod Id": "0",
                        "Rollup Item Price": "10",
                        "Promotion MRC Total": "",
                        "Service Id": "",
                        "NRC CxTotal": "",
                        "Service Length": "",
                        "Account Id": "88-3GVFAT",
                        "Volume Discount Item Id": "1SIA-A1EJ",
                        "Conflict Id": "0",
                        "Adjusted List Price": "10",
                        "Currency Code": "USD",
                        "List Price": "10",
                        "Root Id": "88-3GVCQN",
                        "Product Type": "",
                        "Item Price List Id": "",
                        "Root Product Id": "88-231H5",
                        "Line Number": "6",
                        "Billing Account Id": "88-3GVFAT",
                        "Volume Upsell Item": "",
                        "Product Def Type Code": "None",
                        "Product Type Code": "Product",
                        "Discount Amount": "",
                        "Promotion MRC Start Total": "",
                        "Updated": "08/06/2025 23:04:50",
                        "Billing Profile Name": "",
                        "Prod Prom Type": "",
                        "Price Type": "One-Time",
                        "Min Price": "",
                        "Volume Upsell Message": "",
                        "Previous Net Price": "",
                        "Smart Part Number": "",
                        "Prod Prom Name": "",
                        "Prod Prom Instance Id": "",
                        "Volume Discount Id": "",
                        "Eligibility Status": "",
                        "Related Asset Integration Id": "",
                        "Quantity": "1",
                        "Original List Price": "10",
                        "Forcastable Flag": "",
                        "Id": "88-3GVCQO",
                        "Root Asset Integration Id": "88-3GVCQN",
                        "Cfg State Code": "Engine Picked Item",
                        "Ship To Address Id": "",
                        "Integration Id": "88-3GVCPX",
                        "Service Price Percent": "",
                        "Type": "",
                        "Product Line Id": "No Match Row Id",
                        "Service Account Id": "88-3GVFAT",
                        "Billing Profile Id": "",
                        "Prod Prom Id": "",
                        "Created": "08/06/2025 23:04:50",
                        "Name": "1000 Text Messages/month",
                        "Promotion NRC Total": "",
                        "Unit Price": "",
                        "Prod Prom Source Id": "",
                        "Cfg Type": "",
                        "Has Generics Flag": "",
                        "Volume Discount Item": "1SIA-A1EJ",
                        "Product Structure Type": "None",
                        "Exchange Date": "",
                        "Promotion NRC Start Total": "",
                        "Configuration Model Id": "88-231FV",
                        "Asset Status": "Active",
                        "Pricing Comments": "",
                        "Header Discount Amount": "",
                        "Inclusive Eligibility Flag": "N",
                        "Product Id": "88-231FV",
                        "Ship To - Country": "",
                        "Cost": ""
                      }
                    ]
                  },
                  {
                    "Discount Source": "Manual",
                    "Discount": "",
                    "Volume Upsell Item Id": "",
                    "Due Date": "08/07/2025 00:00:00",
                    "Ship To - City": "",
                    "Current Price": "44.5",
                    "Extended Quantity Requested": "1",
                    "Max Price": "",
                    "Rollup Amount": "10",
                    "MRC CxTotal": "0",
                    "Post Pick CD": "",
                    "Net Price": "44.5",
                    "Port Item Id": "",
                    "Discount Percent": "",
                    "Service Length UoM": "",
                    "Previous Asset Status": "",
                    "Class Id": "",
                    "Effective To": "",
                    "Base Price": "89",
                    "Pre Pick CD": "N",
                    "Prod Prom Rule Id": "88-1XK5DV",
                    "Asset Integration Id": "88-3GVCQP",
                    "Parent Id": "",
                    "Ship To - Address 2": "",
                    "Ship To - State": "",
                    "Prod Item Id": "",
                    "Need Refresh": "Y",
                    "Ship To - Zip": "",
                    "Exclude Pricing Flag": "N",
                    "Action Code": "Add",
                    "Service Price Method": "",
                    "Effective From": "",
                    "Unit of Measure": "",
                    "Eligibility Reason": "",
                    "Ship To - Address": "",
                    "Price List Id": "",
                    "Pricing Adjustment Amount": "44.5",
                    "Mod Id": "0",
                    "Rollup Item Price": "99",
                    "Promotion MRC Total": "",
                    "Service Id": "",
                    "NRC CxTotal": "54.5",
                    "Service Length": "",
                    "Account Id": "88-3GVFAT",
                    "Volume Discount Item Id": "",
                    "Conflict Id": "0",
                    "Adjusted List Price": "89",
                    "Currency Code": "USD",
                    "List Price": "89",
                    "Root Id": "88-3GVCQP",
                    "Product Type": "Device",
                    "Item Price List Id": "",
                    "Root Product Id": "88-231ES",
                    "Line Number": "7",
                    "Billing Account Id": "88-3GVFAT",
                    "Volume Upsell Item": "",
                    "Product Def Type Code": "Customizable",
                    "Product Type Code": "Product",
                    "Discount Amount": "",
                    "Promotion MRC Start Total": "",
                    "Updated": "08/06/2025 23:04:50",
                    "Billing Profile Name": "",
                    "Prod Prom Type": "",
                    "Price Type": "One-Time",
                    "Min Price": "",
                    "Volume Upsell Message": "",
                    "Previous Net Price": "",
                    "Smart Part Number": "",
                    "Prod Prom Name": "Millennium Max 500 Package",
                    "Prod Prom Instance Id": "88-3GVCPJ",
                    "Volume Discount Id": "",
                    "Eligibility Status": "",
                    "Related Asset Integration Id": "",
                    "Quantity": "1",
                    "Original List Price": "89",
                    "Forcastable Flag": "",
                    "Id": "88-3GVCQP",
                    "Root Asset Integration Id": "88-3GVCQP",
                    "Cfg State Code": "New Item",
                    "Ship To Address Id": "",
                    "Integration Id": "88-3GVCQ1",
                    "Service Price Percent": "",
                    "Type": "",
                    "Product Line Id": "88-231FE",
                    "Service Account Id": "88-3GVFAT",
                    "Billing Profile Id": "",
                    "Prod Prom Id": "88-231OB",
                    "Created": "08/06/2025 23:04:50",
                    "Name": "Daytech 200",
                    "Promotion NRC Total": "",
                    "Unit Price": "",
                    "Prod Prom Source Id": "",
                    "Cfg Type": "eConfigurator",
                    "Has Generics Flag": "",
                    "Volume Discount Item": "",
                    "Product Structure Type": "Customizable",
                    "Exchange Date": "",
                    "Promotion NRC Start Total": "",
                    "Configuration Model Id": "88-231ES",
                    "Asset Status": "Active",
                    "Pricing Comments": "",
                    "Header Discount Amount": "",
                    "Inclusive Eligibility Flag": "N",
                    "Product Id": "88-231ES",
                    "Ship To - Country": "",
                    "Cost": "",
                    "Line Item": [
                      {
                        "Discount Source": "Manual",
                        "Discount": "",
                        "Volume Upsell Item Id": "",
                        "Due Date": "08/07/2025 00:00:00",
                        "Ship To - City": "",
                        "Current Price": "5",
                        "Extended Quantity Requested": "1",
                        "Max Price": "",
                        "Rollup Amount": "0",
                        "MRC CxTotal": "",
                        "Post Pick CD": "",
                        "Net Price": "5",
                        "Port Item Id": "88-23AIW",
                        "Discount Percent": "",
                        "Service Length UoM": "",
                        "Previous Asset Status": "",
                        "Class Id": "",
                        "Effective To": "",
                        "Base Price": "5",
                        "Pre Pick CD": "N",
                        "Prod Prom Rule Id": "",
                        "Asset Integration Id": "88-3GVCQQ",
                        "Parent Id": "88-3GVCQP",
                        "Ship To - Address 2": "",
                        "Ship To - State": "",
                        "Prod Item Id": "88-23AIW",
                        "Need Refresh": "Y",
                        "Ship To - Zip": "",
                        "Exclude Pricing Flag": "N",
                        "Action Code": "Add",
                        "Service Price Method": "",
                        "Effective From": "",
                        "Unit of Measure": "",
                        "Eligibility Reason": "",
                        "Ship To - Address": "",
                        "Price List Id": "",
                        "Pricing Adjustment Amount": "0",
                        "Mod Id": "0",
                        "Rollup Item Price": "5",
                        "Promotion MRC Total": "",
                        "Service Id": "",
                        "NRC CxTotal": "",
                        "Service Length": "",
                        "Account Id": "88-3GVFAT",
                        "Volume Discount Item Id": "",
                        "Conflict Id": "0",
                        "Adjusted List Price": "5",
                        "Currency Code": "USD",
                        "List Price": "5",
                        "Root Id": "88-3GVCQP",
                        "Product Type": "",
                        "Item Price List Id": "",
                        "Root Product Id": "88-231ES",
                        "Line Number": "8",
                        "Billing Account Id": "88-3GVFAT",
                        "Volume Upsell Item": "",
                        "Product Def Type Code": "None",
                        "Product Type Code": "Product",
                        "Discount Amount": "",
                        "Promotion MRC Start Total": "",
                        "Updated": "08/06/2025 23:04:50",
                        "Billing Profile Name": "",
                        "Prod Prom Type": "",
                        "Price Type": "One-Time",
                        "Min Price": "",
                        "Volume Upsell Message": "",
                        "Previous Net Price": "",
                        "Smart Part Number": "",
                        "Prod Prom Name": "",
                        "Prod Prom Instance Id": "",
                        "Volume Discount Id": "",
                        "Eligibility Status": "",
                        "Related Asset Integration Id": "",
                        "Quantity": "1",
                        "Original List Price": "5",
                        "Forcastable Flag": "",
                        "Id": "88-3GVCQQ",
                        "Root Asset Integration Id": "88-3GVCQP",
                        "Cfg State Code": "Engine Picked Item",
                        "Ship To Address Id": "",
                        "Integration Id": "88-3GVCQ2",
                        "Service Price Percent": "",
                        "Type": "",
                        "Product Line Id": "No Match Row Id",
                        "Service Account Id": "88-3GVFAT",
                        "Billing Profile Id": "",
                        "Prod Prom Id": "",
                        "Created": "08/06/2025 23:04:50",
                        "Name": "Battery",
                        "Promotion NRC Total": "",
                        "Unit Price": "",
                        "Prod Prom Source Id": "",
                        "Cfg Type": "",
                        "Has Generics Flag": "",
                        "Volume Discount Item": "",
                        "Product Structure Type": "None",
                        "Exchange Date": "",
                        "Promotion NRC Start Total": "",
                        "Configuration Model Id": "88-231DT",
                        "Asset Status": "Active",
                        "Pricing Comments": "",
                        "Header Discount Amount": "",
                        "Inclusive Eligibility Flag": "N",
                        "Product Id": "88-231DT",
                        "Ship To - Country": "",
                        "Cost": ""
                      },
                      {
                        "Discount Source": "Manual",
                        "Discount": "",
                        "Volume Upsell Item Id": "",
                        "Due Date": "08/07/2025 00:00:00",
                        "Ship To - City": "",
                        "Current Price": "5",
                        "Extended Quantity Requested": "1",
                        "Max Price": "",
                        "Rollup Amount": "0",
                        "MRC CxTotal": "",
                        "Post Pick CD": "",
                        "Net Price": "5",
                        "Port Item Id": "88-23AIY",
                        "Discount Percent": "",
                        "Service Length UoM": "",
                        "Previous Asset Status": "",
                        "Class Id": "",
                        "Effective To": "",
                        "Base Price": "5",
                        "Pre Pick CD": "N",
                        "Prod Prom Rule Id": "",
                        "Asset Integration Id": "88-3GVCQR",
                        "Parent Id": "88-3GVCQP",
                        "Ship To - Address 2": "",
                        "Ship To - State": "",
                        "Prod Item Id": "88-23AIY",
                        "Need Refresh": "Y",
                        "Ship To - Zip": "",
                        "Exclude Pricing Flag": "N",
                        "Action Code": "Add",
                        "Service Price Method": "",
                        "Effective From": "",
                        "Unit of Measure": "Each",
                        "Eligibility Reason": "",
                        "Ship To - Address": "",
                        "Price List Id": "",
                        "Pricing Adjustment Amount": "0",
                        "Mod Id": "0",
                        "Rollup Item Price": "5",
                        "Promotion MRC Total": "",
                        "Service Id": "",
                        "NRC CxTotal": "",
                        "Service Length": "",
                        "Account Id": "88-3GVFAT",
                        "Volume Discount Item Id": "",
                        "Conflict Id": "0",
                        "Adjusted List Price": "5",
                        "Currency Code": "USD",
                        "List Price": "5",
                        "Root Id": "88-3GVCQP",
                        "Product Type": "",
                        "Item Price List Id": "",
                        "Root Product Id": "88-231ES",
                        "Line Number": "9",
                        "Billing Account Id": "88-3GVFAT",
                        "Volume Upsell Item": "",
                        "Product Def Type Code": "None",
                        "Product Type Code": "Product",
                        "Discount Amount": "",
                        "Promotion MRC Start Total": "",
                        "Updated": "08/06/2025 23:04:50",
                        "Billing Profile Name": "",
                        "Prod Prom Type": "",
                        "Price Type": "One-Time",
                        "Min Price": "",
                        "Volume Upsell Message": "",
                        "Previous Net Price": "",
                        "Smart Part Number": "",
                        "Prod Prom Name": "",
                        "Prod Prom Instance Id": "",
                        "Volume Discount Id": "",
                        "Eligibility Status": "",
                        "Related Asset Integration Id": "",
                        "Quantity": "1",
                        "Original List Price": "5",
                        "Forcastable Flag": "",
                        "Id": "88-3GVCQR",
                        "Root Asset Integration Id": "88-3GVCQP",
                        "Cfg State Code": "Engine Picked Item",
                        "Ship To Address Id": "",
                        "Integration Id": "88-3GVCQ3",
                        "Service Price Percent": "",
                        "Type": "",
                        "Product Line Id": "No Match Row Id",
                        "Service Account Id": "88-3GVFAT",
                        "Billing Profile Id": "",
                        "Prod Prom Id": "",
                        "Created": "08/06/2025 23:04:50",
                        "Name": "Charger",
                        "Promotion NRC Total": "",
                        "Unit Price": "",
                        "Prod Prom Source Id": "",
                        "Cfg Type": "",
                        "Has Generics Flag": "",
                        "Volume Discount Item": "",
                        "Product Structure Type": "None",
                        "Exchange Date": "",
                        "Promotion NRC Start Total": "",
                        "Configuration Model Id": "3SIA-2MOYY",
                        "Asset Status": "Active",
                        "Pricing Comments": "",
                        "Header Discount Amount": "",
                        "Inclusive Eligibility Flag": "N",
                        "Product Id": "3SIA-2MOYY",
                        "Ship To - Country": "",
                        "Cost": ""
                      }
                    ]
                  }
                ]
              }
            }
          ]
        }
      }
    }

Get Promotion Price Totals

Following 4 fields in the output have the calculated value for Promotion MRC and NRC totals at the Promotion level.

  • Promotion MRC Start Total: Represents the total monthly recurring start price for a specific promotion instance within a quote, order, or asset.
  • Promotion NRC Start Total: Represents the total non-recurring start price for a specific promotion instance within a quote, order, or asset.
  • Promotion MRC Total: Represents the total monthly recurring charges for a specific promotion instance within a quote, order, or asset.
  • Promotion NRC Total: Represents the total non-recurring charges for a specific promotion instance within a quote, order, or asset.
Note: These fields are applicable only for promotion line items and will remain blank for non-promotion line items.