CPQ Quote calculation error 'unable to obtain exclusive access to this record or 1 records'

The error message "unable to obtain exclusive access to this record or 1 records:" indicates that a process was attempting to obtain a lock on a record for 10 seconds before eventually quitting the process with an error message indicating that the record is unavailable. If one long-running process or too many short-lived processes are attempting to interact with a record at the same time, this can cause the exclusive access error to occur.

The most common cause of this error message when seen in Salesforce CPQ is when there are multiple calculations on a single Quote queued from a single transaction. These calculations will take approximately the same amount of time to process on the Heroku service. As a result, they will attempt to write back to the Quote record at the same time. This creates the potential for one or more of the processes to be prevented from locking the Quote for an attempted update.

When encountering this error message, admins should examine the following areas to determine if it is possible to reduce any inserts or updates occurring on either the Quote or Quote Line object. Any reductions in updates will result in reduced calculation processes running. Thus, there will be reduced chance of incurring the error message.

• Custom Apex Classes/Triggers - Any DML statement against a Quote Line will cause a new calculation to be queued. Any DML statement against a Quote in which one of the Calculating fields has been altered will cause a new calculation to be queued. Examine debug logs to determine if there are multiple DML statements against these objects occurring in custom Apex code. Attempt to change logic to use a single DML whenever possible.
• Workflow Rules, Flows, and Process Builders - Any field Updates against the Quote Calculating Fields or ANY field on the Quote Line will cause a calculation to be queued. Using the "Recursion" setting on Process Builders or the "Re-evaluate Workflow Rules after Field Change" setting on Workflow Rules can also cause extra field updates leading to extra calculations. Due to risk for record locking errors and other Apex limits, it is advised to avoid using Workflow Rules, Flows, and Process Builders on the Quote and Quote Line objects.

• Non-CPQ Managed Packages – Similar to custom Apex, a non-CPQ managed package may contain logic that triggers additional DML operations, workflow rules, Process Builder processes, flows, or other automation on CPQ objects, resulting in extra calculations. Review the debug logs to identify where DML operations are occurring. Even if the managed package's execution details are hidden, the corresponding DML statements will still appear in the debug logs.