Orders Migration Guidance

Knowledge Center > Subscriptions > Orders > Orders Migration Guidance

Orders Migration Guidance

The migration to full Orders is in Limited Availability. We are actively soliciting feedback from a small set of early adopters before releasing as generally available.

This article describes the processes, prerequisites, and workarounds for enabling and upgrading to Order Metrics and Orders. For information on Orders API migration, see Orders API Migration Guidance. For information on Order Metrics and Orders Limitations, see Known Limitations in Orders and Order Metrics.

Orders Enablement Timeline

When the Order Metrics or Orders feature is enabled in your Zuora tenant, your historic Amendment data is automatically migrated with zero downtime and you can continue normal business operations. Based on historical data, about 500K to 1M subscriptions can be migrated per day. However, the actual migration time depends on the subscription size: the number of products and charges in a subscription, and so on. If you have a large number of subscriptions, you should plan this migration during a low activity time, if possible. Note that when performing the data migration for a Production Copy Environment (services environment), the migration can take significantly longer.

Order Metrics Enablement Process

Perform the following steps to enable the Order Metrics feature in your tenant:

  1. First complete the Zuora University training "Zuora Orders: An Introduction" and "Subscription Management, Order Metrics, and CPQ". This will give you an introduction to Full Orders as well as 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". 
  2. Submit a request at Zuora Global Support to enable Order Metrics in your API Sandbox tenant.
  3. Your support agent will help you check the most common prerequisites for Order Metrics based on the Limitations in Order Metrics. If applicable, you should use the workarounds as listed in the table below. 
    a Cannot change Term Start Date with Renewal Amendment in place

    The following type of subscriptions are not supported to be migrated to Order Metrics: if you have changed the term start date to an earlier date via a T&Cs amendment after performing the renewal. Doing so would result in potential gaps in the order metrics generated.

    A workaround is to change the start date back or to a later date via the T&Cs amendment before enabling Order Metrics.

    b 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, but 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 Order Metrics, you should remove all subscriptions with Account level discounts completely. 

    c 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.  

  4. If your tenant has any data queries (for example, ZOQL or AQuA) or third party data warehouse transformations that depend on amendment data, you should consider refactoring these queries or transformations to use Orders.

  5. New data sources become available with Order Metrics, for example, Order TCB, Order ELP, and Order Item. Since the new data sources can be leveraged by your Revenue Recognition integration (especially for ASC 606 or IFRS 15), you should review your Revenue Recognition processes to determine any impacts or any improvements needed.

  6. Check your tenant's subscription setting on "Calculate Tax for TCB and ELP Metrics?". If your setting is Yes, Zuora will call the tax engine to populate the Tax fields for TCB and ELP metrics during the Orders migration. Zuora recommends that you configure the setting to No before migrating to Order Metrics.

  7. Your support agent will now enable Order Metrics in your API Sandbox tenant. You do not need to take any action in this step.

  8. Now your API Sandbox tenant has Order Metrics enabled. You should test in your tenant with dummy data. Zuora recommends that you run the use cases in Order API Migration Guidance and verify the Order Metrics output.

  9. Following successful Sandbox testing, submit a request at Zuora Global Support to enable Order Metrics in your Production Copy Environment (PCE) tenant if you have purchased one. Note that the Reporting UI is not available in PCE tenants, but data source exports are available. 

  10. As in step 3, your support agent will help you check the limitations checklist for your PCE tenant. You should use the same workarounds as listed in the table in step 3, if necessary.

  11. Your support agent will now enable Order Metrics in your PCE tenant. You do not need to take any action in this step.

  12. Your PCE tenant now has Order Metrics enabled. You should verify Order Metrics in your PCE tenant with production copy data prior to enabling in Production.

Orders Enablement Process

Perform the following steps to enable the Orders feature in your tenant:

  1. First complete the Zuora University training "Zuora Orders: An Introduction" and "Subscription Management, Order Metrics, and CPQ". This will give you an introduction to Full Orders as well as 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".  
  2. Upgrade your Zuora Quotes to the latest version assuming you have assessed any customization related issues. See Upgrade Zuora Quotes.
  3. Submit a request at Zuora Global Support to enable Orders in your API Sandbox tenant.
  4. 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 Cannot change Term Start Date with Renewal Amendment in place

    The following type of subscriptions are not supported to be migrated to Order Metrics: if you have changed the term start date to an earlier date via a T&Cs amendment after performing the renewal. Doing so would result in potential gaps in the order metrics generated.

    A workaround is to change the start date back or to a later date via the T&Cs amendment before enabling Order Metrics.

    b 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, but 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, you should remove all subscriptions with Account level discounts completely. 

    c 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.  

    d Subscription product features With Orders enabled, you can still have features related to the product in your tenant, but you cannot change these features when creating your subscription.
  5. 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.

  6. Check your tenant's subscription setting on "Calculate Tax for TCB and ELP Metrics?". If your setting is Yes, Zuora will call the tax engine to populate the Tax fields for TCB and ELP metrics during the Orders migration. Zuora recommends that you configure the setting to No before migrating to Orders.

  7. If your Salesforce org has used Order Builder in Zuora 360, check whether Subscribe/Amend APIs are used in your Order Builder integration code. If yes, migrate your integrations to use the Orders REST APIs.

  8. 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 (e.g., Delta TCB, Delta TCB Tax, Delta Discount TCB).

  9. 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.

  10. New Orders Notifications will be enabled for Orders to replace the Amendment and Subscribe notifications. Since notifications for Subscribe and Amend will stop, you should change any applicable integrations to use the new Orders notifications.

  11. If your tenant has any data queries (for example, ZOQL or AQuA) or third party data warehouse transformations that depend on amendment data, you should consider refactoring these queries or transformations to use Orders.

  12. New data sources become available with Order Metrics, for example, Order TCB, Order ELP, and Order Item. Since the new data sources can be leveraged by your Revenue Recognition integration (especially for ASC 606 or IFRS 15), you should review your Revenue Recognition processes to determine any impacts or any improvements needed.

  13. Verify any existing in-flight quotes in your Zuora Quotes implementation. Any existing quotes should be able to send to Zuora successfully after enabling 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. 

  14. Your support agent will now enable Orders in your API Sandbox tenant. You do not need to take any action in this step.

  15. Now your API Sandbox tenant has Orders enabled. You should test in your tenant with dummy data. Zuora recommends that you run the use cases in Order API Migration Guidance.

  16. Submit a request at Zuora Global Support to enable Orders in your Production Copy Environment (PCE) tenant if you have purchased one. Note that the Reporting UI and Orders UI is not available in PCE tenants, but data source exports are available. 

  17. As for the API Sandbox tenant, your support agent will help you check the limitation checklist for your PCE tenant. You should use the same workarounds as listed in the table in step 4.

  18. Your support agent will now enable Orders in your PCE tenant. You do not need to take any action in this step.

  19. Your PCE tenant now has Orders enabled. You should test your PCE tenant with production copy data prior to enabling in Production.

Last modified

Tags

This page has no custom tags.

Classifications

(not set)