Activate Orders feature
Learn how to activate the Orders feature by completing training, upgrading Zuora Quotes, and verifying integrations.
- Complete the Zuora University training Zuora Orders: An Introduction and Orders Harmonization. This training introduces you to Orders Harmonization, Orders, Order Metrics, and other related features. To take this training:
-
Visit Zuora University .
-
Enter your Access Code: zuorderupgrade18
-
Enter all other information and click "Sign Up".
-
- Upgrade your Zuora Quotes to the latest version assuming you have assessed any customization related issues. See Upgrade Zuora Quotes.
- Submit a request at Zuora Global Support to activate Orders in your API Sandbox tenant. Your support agent will help you check the most common prerequisites for Orders based on the Limitations in Orders. If applicable, use the workarounds as listed in the table below:
a
Account level discounts
Account level discounts are not available with Order Metrics.
A workaround is to use Subscription level discounts instead of Account level discounts if you have this business requirement.
You can still perform the following Amendments for Subscriptions under an Account with an account level discount applied.
However, no order metrics will be generated until those subscriptions with Account level discounts are removed:
-
Create Subscription (without an account level discount)
-
Add Product (without an account level discount)
-
Update
-
Remove
-
T&Cs
-
Cancellation
-
Renew
-
Suspend / Resume
Ideally before enabling Orders, remove all subscriptions with Account level discounts completely.
b
Draft/Pending subscriptions and amendments
You can create Draft/Pending subscriptions, but these pending Subscriptions and Amendments are not migrated and Order Metrics are not generated until all activation dates are provided.
Before enabling Order Metrics, you should ideally activate or delete all draft and pending subscriptions, though metrics will be generated once activated after enablement.
-
- Verify your integrations with Zuora and check whether Subscribe/Amend APIs are used. If so, migrate your integrations to use the Orders REST APIs. See Orders API Migration Guidance.
- Check the subscription setting of your tenant on Calculate Tax for TCB and ELP Metrics?. If your setting is Yes, Zuora calls the tax engine to populate the Tax fields for TCB metrics during the Orders migration. Zuora recommends that you configure the setting to No before migrating to Orders. Note that the Order ELP feature is only available to the existing Orders customers who already have access to the feature.
- Check whether Subscribe/Amend APIs are used in your Order Builder integration code if your Salesforce org has used Order Builder in Zuora 360. If yes, migrate your integrations to use the Orders REST APIs.
- Verify your Zuora Quotes customizations and check for any usage of the Billing Total, Subtotal, Tax, or Discount fields at Quote Rate Plan Charge or Quote Charge Summary level. As these fields are no longer populated OOTB with Orders, Zuora recommends customization to calculate these fields in conjunction with the Invoice Item Global Methods for any custom Quote PDF presentation requirements such as for Ramp Deals. For non Ramp Deal Quotes, it is advised to consider using the new TCB fields (for example, Delta TCB, Delta TCB Tax, Delta Discount TCB).
- Verify your Zuora Quotes customizations and check whether there is any customization populating forecasting or approval processes. Since the metrics returned by Orders are different, you should change your customization accordingly if needed.
With Orders activated, when non-ramp update quotes or remove amendment quotes are created in Zuora Quotes, the subscription start date is taken as the contract effective date instead of the quote start date. You must change your customization accordingly if needed.
New Orders Notifications are activated for Orders. For any subscription creation or amendment created through Subscribe and Amend APIs, the existing Zuora Billing notifications configured in your tenant will continue to work. However, since for every subscription creation and amendment, if you configure Orders notifications then both order related notifications and amendment notifications are triggered. Zuora recommends that you configure only the Orders notifications and turn off the existing Amendment related notifications if you do not want duplicate notifications.
- Consider refactoring these queries or transformations to use Orders if your tenant has any data queries (for example, AQuA) or third party data warehouse transformations that depend on amendment data.
- Review your Revenue Recognition processes to determine any impacts or any improvements needed since the new data sources can be leveraged by your Revenue Recognition integration (especially for ASC 606 or IFRS 15).
- Verify any existing in-flight quotes in your Zuora Quotes implementation. Any existing quotes can be sent to Zuora successfully after you activate Orders (assuming you upgraded from a relatively recent Quotes version such as 8.x). However, if you try to preview Metrics on an existing quote that was created prior to the Orders upgrade, an error may occur. Zuora recommends that you re-create the quote in this case. Your support agent then activates Orders in your API Sandbox tenant. You do not need to take any action in this step. Now your API Sandbox tenant has Orders activated. You should test in your tenant with dummy data. Zuora recommends that you run the use cases in Order API Migration Guidance.
- Submit a request at Zuora Global Support to activate Orders in your Production Copy Environment (PCE) tenant if you have purchased one. Note: The Reporting UI and Orders UI are not available in PCE tenants, but data source exports are available. As for the API Sandbox tenant, your support agent helps you check the limitation checklist for your PCE tenant. Use the same workarounds listed in the table in step 4. Your support agent then activates Orders in your PCE tenant. You do not need to take any action in this step. Your PCE tenant now has Orders activated. You should test your PCE tenant with production copy data prior to enabling in Production.