Skip to main content

Syncing Orders from Salesforce CPQ: Common Use Cases


Syncing Orders from Salesforce CPQ: Common Use Cases

The following outlines common use cases for syncing orders from Salesforce CPQ. However, these scenarios are not limited to the ones mentioned below.

New Order

  • When synchronizing a fresh order, you can include multiple order products.
  • The Flexible Billing Attribute in Zuora enables the syncing of additional features like Invoice Owner, Subscription Owner, Bill to Contact, and Ship to Contact. Refer to Advanced Configuration and Data Management to setup these fields in your salesforce account.
  • If multicurrency is enabled in Zuora, the connector will set the currency on the orders in your Zuora order, else it would be defaulted from the Zuora Account.


Cancel Subscriptions

  • When the amendment quote line editor quantity is set to 0, the associated Salesforce order product is marked as Cancel.
  • The Zuora subscription is marked as canceled with a cancellation date, and the trigger dates are set to the amended order’s effective date from Salesforce.


Quantity Update

When the quantity is altered on the amendment quote line editor (excluding a change to 0) with no price adjustment, the subscription in Zuora is updated to reflect the new quantity.



  • When the renewal order is synced in Salesforce, it triggers the subscription renewal in Zuora. The subscription start and end dates in Salesforce determine the renewal term.
  • Support for renewal price lifts can be achieved by directly updating the price against the corresponding quote line.


Adding a New Product

When a new product is added during an amendment, it generates a new subscription in Salesforce that is automatically synced as a new subscription in Zuora.

Price Updates

  • Salesforce does not support price updates on the existing quote line; instead, it uses the debook and rebook approach. This involves adjusting the quantity of the quote line with the old price to 0 and generating a new quote line with the updated price. Essentially, this process combines a "cancel + new" action, resulting in the creation of a cancellation order product and a new order product in Salesforce.
  • The connector replicates the Salesforce behavior by applying the same logic of canceling and creating a new subscription.

Amendments and Renewal Guidelines

Salesforce and Zuora have different approaches to managing amendments and renewals. The connector adheres to Zuora’s best practices for streamlined downstream processes. Refer to Salesforce CPQ Amend Contracts for guidance on creating amendments in Salesforce.

For successful syncing of amendments, adhere to the following guidelines:

  • Ensure that the original order in Salesforce CPQ is synced to Zuora before trying to sync the amendment order. For instance, check Salesforce CPQ original order with subscription S-000001 and Order Product ID = XXXX0001 has been synced, before syncing amendment order.
  • When syncing the amendment order, ensure that each order product contains the Revised Order Product that points to the original order product, in this case, XXXX0001.
  • If the subscription in Zuora has been manually altered at any point, ensure that the Externally Managed Plan ID in the original subscription rate plan in Zuora still contains the Revised Order Product ID that is on the amendment order product. That is, subscription S–000001 in Zuora must have an Externally Managed Plan ID set as XXXX0001 on the rate plan. This linking is crucial for the connector to identify the original subscription in Zuora before making amendments to it.