---
schema_version: "1"
id: 28ce02da47f54bb616cda571b824c12ee82dffe944834be1d0311bf34f8085f4
title: Multi-Transaction Service
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/industries/cme/guides/comms-t-multi-transaction-service.md
canonical_url: https://developer.salesforce.com/docs/industries/cme/guide/comms-t-multi-transaction-service.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 3d3230bbed4c086c8610c80c989ddcaad6958ebfdde5f23372da40b248cb567d
products:
  - Communications, Media, Energy and Utilities APIs (Managed Package)
  - Industries Developer Documentation
---
# Multi-Transaction Service

The Multi-Transaction Service (MTS) is integrated with the Digital Commerce Basket APIs to split Apex transactions into multiple transactions to avoid exceeding Salesforce Governor limits. Use its configuration settings to enable it:

- [MaxCPUTimePerTransaction](https://help.salesforce.com/s/articleView?id=ind.comms_t_cpq_configuration_settings_reference_148927.htm): Sets the maximum allowed CPU time per Apex transaction before the transaction is split.

- [MaxHeapSizePerTransaction](https://help.salesforce.com/s/articleView?id=ind.comms_t_cpq_configuration_settings_reference_148927.htm): Sets the maximum allowed heap size per Apex transaction before the transaction is split.

- [MTSEnabled](https://help.salesforce.com/s/articleView?id=ind.comms_t_cpq_configuration_settings_reference_148927.htm): Enables the Multi-Transaction Service.

- [NumberOfDMLPerTransaction](https://help.salesforce.com/s/articleView?id=ind.comms_t_cpq_configuration_settings_reference_148927.htm): Sets the maximum allowed data manipulation language (DML) statements per Apex transaction before the transaction is split.

- [NumberOfQueriesPerTransaction](https://help.salesforce.com/s/articleView?id=ind.comms_t_cpq_configuration_settings_reference_148927.htm): Sets the maximum allowed SOQL queries per Apex transaction before the transaction is split.

The MTS supports long-running transactions and returns a `multiTransactionKey` in the `nexttransaction` action. To proceed, call the API again with the `multitransactionKey` in the request payload as shown in the following example Add to Basket requests and responses with MTSEnabled set to true (the default).

**Example Requests and Responses**

Example Add to Basket Request

```nolang
POST
/services/apexrest/{namespace}/v3/catalogs/{catalog_code}/basket?contextKey=017d3c3f990567a3ce2ca3e60262ec90&context={"accountId":"0019P000024jKuZ"}&isloggedin=true

Body
{
  "offer": "TelcoResidential",
  "basketAction": "AddWithNoConfig"
}
```

Example Intermediate Response

```nolang
{
  "nexttransaction": {
    "rest": {
      "params": {
        "multiTransactionKey": "3d719d4a3b14cea4187ea9a5332cff0e",
        "method": "addWithNoConfig"
     }
    }
  }
}
```

Example Request to Pass the multiTransactionKey

```nolang
POST 
/services/apexrest/{namespace}/v3/catalogs/{catalog_code}/basket?contextKey=017d3c3f990567a3ce2ca3e60262ec90&context={"accountId":"0019P000024jKuZ"}&isloggedin=true

Body
{
  "offer": "TelcoResidential",
  "basketAction": "AddWithNoConfig",
  "multiTransactionKey": "3d719d4a3b14cea4187ea9a5332cff0e"
}

```

Example Response

This example is truncated.

```nolang
{
  "cartContextKey": "20933d86217050b8d3b15654aeceae30",
  "result": {
    "totals": {
      "EffectiveOneTimeTotal__c": 400,
      "EffectiveRecurringTotal__c": 200
    },
    "totalSize": 1,
    "records": [
      {
        "actions": {
          "deleteFromBasketAction": {
            "rest": {
              "params": {
                "basketAction": "deleteFromBasket",
                "lineItemKey": "533befb7d15a0a400f09c59ecaef21ee",
                "bundleContextKey": "533befb7d15a0a400f09c59ecaef21ee"
              },
              "link": "/v3/catalogs/vlocity_cmt/basket/20933d86217050b8d3b15654aeceae30?contextKey=017d3c3f990567a3ce2ca3e60262ec90&isloggedin=true",
              "method": "deleteFromBasketAction"
            }
          },
          "updateBasketAction": {
            "rest": {
              "params": {
                "basketAction": "updateBasket",
                "lineItemKey": "533befb7d15a0a400f09c59ecaef21ee",
                "bundleContextKey": "533befb7d15a0a400f09c59ecaef21ee"
              },
              "link": "/v3/catalogs/{catalog_code}/basket/20933d86217050b8d3b15654aeceae30?contextKey=017d3c3f990567a3ce2ca3e60262ec90&isloggedin=true",
              "method": "updateBasketAction"
            }
          }
        },
        "lineItemKey": "533befb7d15a0a400f09c59ecaef21ee",
        "bundleContextKey": "533befb7d15a0a400f09c59ecaef21ee",
        "displaySequence": -1,
        "Id": {
          "value": "8024P000001gdBNQAY",
          "previousValue": null,
          "originalValue": null,
          "messages": [],
          "label": "Order Product ID",
          "hidden": false,
          "fieldName": "Id",
          "editable": false,
          "dataType": "ID",
          "alternateValues": null,
          "actions": {}
        },
        "Pricebook2Id": "01s4P000002BoBuQAK",
        "Product2Id": "01t4P000007VDOkQAO",
        "ProductCode": "TelcoResidential",
        "UnitPrice": {
          "value": 0,
          "previousValue": null,
          "originalValue": null,
          "messages": [],
          "label": "Unit Price",
          "hidden": true,
          "fieldName": "UnitPrice",
          "editable": false,
          "dataType": "CURRENCY",
          "alternateValues": null,
          "actions": {}
        },
        "Name": "Telco Residential",
        "IsActive": true,
        "vlocity_cmt__RecurringPrice__c": 200,
        "Product2": {
          "attributes": {
            "type": "Product2",
            "url": "/services/data/v46.0/sobjects/Product2/01t4P000007VDOkQAO"
          },
          "Id": "01t4P000007VDOkQAO",
          "Name": "Telco Residential",
          "vlocity_cmt__IsConfigurable__c": false,
          "vlocity_cmt__Type__c": "None",
          "vlocity_cmt__SubType__c": "None",
          "vlocity_cmt__SellingStartDate__c": "2019-05-01T18:00:00.000+0000",
          "vlocity_cmt__SellingEndDate__c": "2019-09-30T18:00:00.000+0000",
          "vlocity_cmt__JSONAttribute__c": null
        },
        "CurrencyCode": "USD",
        "productId": "01t4P000007VDOkQAO",
        "defaultQuantity": 1,
        "minQuantity": 0,
        "maxQuantity": 99999,
        "groupMinQuantity": 0,
        "groupMaxQuantity": 99999,
        "sequenceNumber": 1,
        "productChildItemDefinition": {
          "attributes": {
            "type": "vlocity_cmt__ProductChildItem__c"
          },
          "Name": "Root PCI",
          "vlocity_cmt__IsVirtualItem__c": false,
          "vlocity_cmt__Quantity__c": 1,
          "vlocity_cmt__MaxQuantity__c": 99999,
          "vlocity_cmt__MinQuantity__c": 0,
          "vlocity_cmt__MaximumChildItemQuantity__c": 99999,
          "vlocity_cmt__MinimumChildItemQuantity__c": 0,
          "vlocity_cmt__IsOverride__c": false,
          "vlocity_cmt__ParentProductId__c": "01t4P000007VDOkQAO",
          "vlocity_cmt__ChildLineNumber__c": "1",
          "vlocity_cmt__SeqNumber__c": 1,
          "vlocity_cmt__CollapseHierarchy__c": false,
          "vlocity_cmt__IsRootProductChildItem__c": true,
          "vlocity_cmt__ParentProductId__r": {
            "attributes": {
              "type": "Product2",
              "url": "/services/data/v46.0/sobjects/Product2/01t4P000007VDOkQAO"
            },
            "Id": "01t4P000007VDOkQAO",
            "Name": "Telco Residential",
            "vlocity_cmt__SellingStartDate__c": "2019-05-01T18:00:00.000+0000",
            "vlocity_cmt__SellingEndDate__c": "2019-09-30T18:00:00.000+0000"
          }
        },
        "productHierarchyPath": "01t4P000007VDOkQAO",
        "name": "Telco Residential",
        "isVirtualItem": false,
        "lineNumber": "0001",
        "action": "Add",
        "hasChildren": true,
        "SellingPeriod": "Present",
        "itemType": "lineItem",
        "PricebookEntryId": {
          "value": "01u4P00000s2eZjQAI",
          "previousValue": null,
          "originalValue": null,
          "messages": [],
          "label": "Price Book Entry ID",
          "hidden": false,
          "fieldName": "PricebookEntryId",
          "editable": false,
          "dataType": "REFERENCE",
          "alternateValues": null,
          "actions": {}
        },
        "Quantity": {
          "value": 1,
          "previousValue": null,
          "originalValue": null,
          "messages": [],
          "label": "Quantity",
          "hidden": false,
          "fieldName": "Quantity",
          "editable": true,
          "dataType": "DOUBLE",
          "alternateValues": null,
          "actions": {}
        },
        "vlocity_cmt__OneTimeTotal__c": {
          "value": 400,
          "previousValue": null,
          "originalValue": null,
          "messages": [],
          "label": "One Time Total",
          "hidden": false,
          "fieldName": "vlocity_cmt__OneTimeTotal__c",
          "editable": false,
          "dataType": "CURRENCY",
          "alternateValues": null,
          "actions": {
            "adjustmentcodes": {
              "rest": {
                "params": {},
                "method": "GET",
                "link": "/services/apexrest/vlocity_cmt/v2/listsofvalues?listkeys=AdjustmentCodes&cartId=8014P0000022G0jQAE&id=8024P000001gdBNQAY&fields=vlocity_cmt__OneTimeTotal__c&PricingVariableCode=OT_STD_PRC_TOTAL"
              },
              "remote": {
                "params": {}
              },
              "client": {
                "records": [],
                "params": {}
              }
            },
            "pricedetail": {
              "rest": {
                "params": {},
                "method": "GET",
                "link": "/services/apexrest/vlocity_cmt/v2/cpq/carts/8014P0000022G0jQAE/items/8024P000001gdBNQAY/pricing?cartId=8014P0000022G0jQAE&id=8024P000001gdBNQAY&fields=vlocity_cmt__OneTimeTotal__c"
              },
              "remote": {
                "params": {}
              },
              "client": {
                "records": [],
                "params": {}
              }
            }
          }

        ...

        }
      }
    ]
  },
  "createCartAction": {
    "rest": {
      "params": {
        "cartContextKey": "20933d86217050b8d3b15654aeceae30"
      },
      "link": "/v3/carts",
      "method": "createCartAction"
    }
  },
  "errorCode": "INVOKE-200",
  "error": "OK"
}
```