Update products on subscriptions with future-dated updates

Use the Zuora application

You can use the Zuora UI to update a product even when future-dated Update Product order actions already exist on the subscription.

1. Follow the steps 1 - 7 in Update products in subscriptions to update the target rate plan for the included product. The rate plan charges in the selected rate plan are listed.

   

2. Complete the following steps to apply the Premium Service settings to the rate plan charge:
   1. Click the name of the rate plan charge to be updated, which is displayed in blue text in the UI. The rate plan charge details are expanded.
   2. Scroll up to the top of the page, and set the dates in the Contract effective, Service activation, and Customer acceptance fields to be July 1, 2021.
   3. In the Charge pricing section of the Products and charges area, change the price to 2 and quantity to 20.

      

   4. In the Timing and frequency of charge section, select Upon contract effective for the Trigger condition field. You can select another option as long as the setting reflects your business requirement correctly.

      

   5. After all the changes are completed, click Done and then Continue.
3. Complete the following steps to apply the Special Service settings in another product update:
   1. Click Update below the name of the rate plan to be updated.
   2. Scroll up to the Trigger Dates area and set the dates in the Contract effective, Service activation, and Customer acceptance fields to be May 1, 2021.
   3. Toggle the Make this update before a future date change switch to specify an exact date for this update. In this tutorial, select a date in May during which you are to apply the Special Service settings. 

      

   4. Click the name of the rate plan charge to be updated, which is displayed in blue text in the UI. The rate plan charge details are expanded.
   5. In the Charge pricing section of the Products and charges area, change the price to 9 and quantity to 15.

      

   6. In the Timing and frequency of charge section, select Upon contract effective for the Trigger condition field. You can select another option as long as the setting reflects your business requirement correctly.
   7. After all the changes are completed, click Done and then Continue.
4. To view the update to the subscription with a future-dated update, click the Order Actions tab. You can see the first Update Product order action addresses the Premium Service update and the second addresses the Premium Service update.

   

5. Click Activate to activate the order.

Use the REST API

You can use the "Create order" operation and the specificUpdateDate field to update a product on subscription with future-dated updates. Before the Orders feature is enabled, you have to use the "Update subscription", "Amend", or "CRUD: Create amendment" operation.

To update a product on subscription with future-dated updates by creating an order:

1. Determine the values of the following variables:

   Variable	Description
   $SubscriptionNum	The number of the subscription to update. For example, A-S00000001.
   $AccountNum	The number of the account that will own the order. For example, A00000001.
   $RPId	The ID of the rate plan to update in the subscription. For example, 2c92c0f85d7d53d3015dac494dfc5cbf.
   $ChargeNum	The number of the charge to update in the rate plan. For example, C-00000020.
   $Today	Today's date. For example, 2020-01-17.
   $UpdateDatePremium	The Service Activation Date and Customer Acceptance Date for the Premium Service. For example, 2021-07-01.
   $UpdateDateSpecial	The Service Activation Date and Customer Acceptance Date for the Special Service. For example, 2021-05-01.

2. Use the "Create and activate order" operation to create an order under an existing account:

   Request

   POST /v1/orders/

   Request Body

   { "orderDate": "$Today", "existingAccountNumber": "$AccountNum", "subscriptions": [ { "subscriptionNumber": "$SubscriptionNum", "orderActions": [ { "type": "UpdateProduct", "triggerDates": [ { "triggerDate": "$Today", "name": "ContractEffective" }, { "triggerDate": "$UpdateDatePremium", "name": "ServiceActivation" }, { "triggerDate": "$UpdateDatePremium", "name": "CustomerAcceptance" } ], "updateProduct": { "ratePlanId": "$RPId", "chargeUpdates": [ { "description": null, "chargeNumber": "$ChargeNum", "pricing": { "recurringPerUnit": { "listPrice": 8, "quantity": 20, "priceChangeOption": null, "priceIncreasePercentage": null } }, "effectiveDate": { "specificTriggerDate": "$UpdateDatePremium", "triggerEvent": "SpecificDate" }, "customFields": {} } ], "customFields": {} } }, { "type": "UpdateProduct", "triggerDates": [ { "triggerDate": "$Today", "name": "ContractEffective" }, { "triggerDate": "$UpdateDateSpecial", "name": "ServiceActivation" }, { "triggerDate": "2$UpdateDateSpecial", "name": "CustomerAcceptance" } ], "updateProduct": { "ratePlanId": "$RPId", "uniqueToken": null, "specificUpdateDate": "$UpdateDateSpecial", "chargeUpdates": [ { "description": null, "chargeNumber": "$ChargeNum", "pricing": { "recurringPerUnit": { "listPrice": 9, "quantity": 15, "priceChangeOption": "NoChange", "priceIncreasePercentage": null } }, "effectiveDate": { "specificTriggerDate": "$UpdateDateSpecial", "triggerEvent": "SpecificDate" }, "billing": { "billingPeriodAlignment": null }, "customFields": {} } ] } } ] } ] }

   To create the order under a new account instead of an existing account, specify the newAccount field instead of the existingAccountNumber field.

To preview invoices for the updated subscription, use the "Preview order" operation.