Table of contents
- 1. Overview
- 2. Solution
- 2.1. Add a Product
- 2.1.1. Add a Product via UI
- 2.1.2. Add a Product via API
- 2.2. Update a Product
- 2.2.1. Update a Product via UI
- 2.2.2. Update a Product via API
- 2.3. Remove a Product
- 2.3.1. Remove a Product via UI
- 2.3.2. Remove a Product via API
- 2.4. Upgrade a Product
- 2.4.1. Upgrade a Product via UI
- 2.4.2. Upgrade a Product via API
- 2.5. Downgrade a Product
- 2.5.1. Downgrade a Product via UI
- 2.5.2. Downgrade a Product via API
- 2.6. Renew a Subscription
- 2.6.1. Renew a Subscription via UI
- 2.6.2. Renew a Subscription via API
- 2.7. Change Subscription Terms and Conditions
- 2.1. Add a Product
- 3. Related
- 1. Overview
- 2. Solution
- 2.1. Add a Product
- 2.1.1. Add a Product via UI
- 2.1.2. Add a Product via API
- 2.2. Update a Product
- 2.2.1. Update a Product via UI
- 2.2.2. Update a Product via API
- 2.3. Remove a Product
- 2.3.1. Remove a Product via UI
- 2.3.2. Remove a Product via API
- 2.4. Upgrade a Product
- 2.4.1. Upgrade a Product via UI
- 2.4.2. Upgrade a Product via API
- 2.5. Downgrade a Product
- 2.5.1. Downgrade a Product via UI
- 2.5.2. Downgrade a Product via API
- 2.6. Renew a Subscription
- 2.6.1. Renew a Subscription via UI
- 2.6.2. Renew a Subscription via API
- 2.7. Change Subscription Terms and Conditions
- 2.1. Add a Product
- 3. Related
Overview
In Z-Billing, amendments are used to make changes to an active subscription.
Solution
Use amendments to make subscription changes including adding products, updating products, removing products, upgrades, downgrades, renewals and changing terms and conditions. Amendments can be executed via the UI or API
Add a Product
Use the following steps to add a product to a subscription. These steps must be followed for each product you want to add.
Add a Product via UI
- Click on the subscription you want to change.
- Click on the Amendment button.

- Enter in an Amendment Name, Change Description (optional).
- Select New Product from the Amendment Type drop down, and click Save.
- Click Add New Product & Rate Plan, using the Select Product drop down, choose the product you want to add, and click Select to choose a rate plan.

- Click the Contract effective button, enter a Contract effective Date and click Save.
- The contract effective date should be set to the date you want the new product to take effect.
- Most companies make product additions effective immediately during an invoice period.
- If proration is enabled the next invoice will include a prorated charge for any recurring fees for the partial period and full charges for any usage and one time fees for the partial period.
- If proration is disabled, the next invoice will only include one time fees for the partial period and will not include and recurring or usage fees for the partial period.
- If you want to make product additions effective for the next invoice period or next term, set the contract effective date to the first day of the next invoice period or the first day of the next term.
- If you have Service Activation and Customer Acceptance dates enabled then click the Service Activation button, enter the Service Activation Date and click Save, then click the Customer Acceptance button, enter the Customer Acceptance Date and click Save.
Add a Product via API
Refer to the API Documentation for Adding a Product and follow the instructions based on your WSDL version.
The contract effective, effective, service activation and customer acceptance dates should be set to the date you want the new product to take effect.
- Most companies make product additions effective immediately during an invoice period.
- If proration is enabled the next invoice will include a prorated charge for any recurring fees for the partial period and full charges for any usage and one time fees for the partial period.
- If proration is disabled, the next invoice will only include one time fees for the partial period and will not include and recurring or usage fees for the partial period.
- If you want to make product additions effective for the next invoice period or next term, set the contract effective date to the first day of the next invoice period or the first day of the next term.
Update a Product
Use the following steps to update a product on a subscription. These steps must be followed for each product you want to update.
Update a Product via UI
- Click on the subscription you want to change.
- Click on the Amendment button.

- Enter in an Amendment Name, Change Description (optional).
- Select Update a Product from the Amendment Type drop down, and click Save.
- Using the Select Product drop down, choose the product and rate plan you want to update.
- In the Original section click on the Charge Name to view current product details.
- In the New section click on the Charge Name to view and edit the product details and click Save.
- Click the Contract effective button, enter a Contract effective Date and click Save.
- The contract effective date should be set to the date you want the product update to take effect.
- Most companies make product updates effective immediately during an invoice period.
- If proration is enabled the next invoice will include a prorated charge for any recurring fees for the partial period and full charges for any usage and one time fees for the partial period.
- If proration is disabled, the next invoice will only include one time fees for the partial period and will not include and recurring or usage fees for the partial period.
- If you want to make product updates effective for the next invoice period or next term, set the contract effective date to the first day of the next invoice period or the first day of the next term.
- If you have Service Activation and Customer Acceptance dates enabled then click the Service Activation button, enter the Service Activation Date and click Save, then click the Customer Acceptance button, enter the Customer Acceptance Date and click Save.
Update a Product via API
Refer to the API Documentation for Updating a Product and follow the instructions based on your WSDL version.
The contract effective, effective, service activation and customer acceptance dates should be set to the date you want the product update to take effect.
- Most companies make product updates effective immediately during an invoice period.
- If proration is enabled the next invoice will include a prorated charge for any recurring fees for the partial period and full charges for any usage and one time fees for the partial period.
- If proration is disabled, the next invoice will only include one time fees for the partial period and will not include and recurring or usage fees for the partial period.
- If you want to make product updates effective for the next invoice period or next term, set the contract effective date to the first day of the next invoice period or the first day of the next term.
Remove a Product
Use the following steps to remove a product from a subscription. These steps must be followed for each product you want to remove.
Remove a Product via UI
- Click on the subscription you want to change.
- Click on the Amendment button.

- Enter in an Amendment Name, Change Description (optional).
- Select Remove Product from the Amendment Type drop down, and click Save.

- Using the Select Product drop down, choose the product you want to remove and click Save.
- Click the Contract effective button, enter a Contract effective Date and click Save.
- The contract effective date should be set to the date you want the cancellation or downgrade to take effect.
- If proration is enabled and the amendment contract effective date is not set to the start of the next invoice period or next term, the customer will receive a proration credit for the unused portion of a recurring fee. One time charges and usage charges will never prorate.
- In order to ensure no proration for a recurring charge set the contract effective date to the first day of the next invoice period or the first day of the next term, depending on if you want to cancel at the end of the last invoice period or end of term.
- In this example the current invoice period for this product extends from 10/01/2011-10/31/2011 and the next invoice period for this product begins on 11/01/2001, so we set the contract effective date to 11/01/2001 and the charge will not prorate.

- If you have Service Activation and Customer Acceptance dates enabled then click the Service Activation button, enter the Service Activation Date and click Save, then click the Customer Acceptance button, enter the Customer Acceptance Date and click Save.
Remove a Product via API
Refer to the API Documentation for Removing a Product and follow the instructions based on your WSDL version.
The contract effective, effective, service activation and customer acceptance dates should be set to the date you want the cancellation or downgrade to take effect.
- If proration is enabled and the amendment contract effective date is not set to the start of the next invoice period or next term, the customer will receive a proration credit for the unused portion of a recurring fee. One time charges and usage charges will never prorate.
- In order to ensure no proration this should be the first day of the next invoice period or the first day of the next term, depending on if you want to cancel at the end of the last invoice period or end of term.
- If the current invoice period for the product extends from 10/01/2011-10/31/2011 and the next invoice period for this product begins on 11/01/2001, if you do not want proration set the contract effective date to 11/01/2001.
Upgrade a Product
Upgrades require a Remove Product amendment and an Add Product amendment. These steps must be followed for each product you want to upgrade.
Upgrade a Product via UI
- Follow the Remove a Product via UI steps.
- Once the product is removed, follow the Add a Product via UI steps. Use the same dates as the Remove Product amendment, which makes the new product effective the day the old product is removed.
Upgrade a Product via API
Refer to the API Documentation for Removing a Product and follow the instructions based on your WSDL version.
When the Remove Product amendment is succesful, follow the Adding a Product instructions using the date used in the Remove Product amendment.
Downgrade a Product
Downgrades require a Remove Product amendment and an Add Product amendment. These steps must be followed for each product you want to downgrade.
Downgrade a Product via UI
- Follow the Remove a Product via UI steps. If you do not want a proration credit for the downgrade, make the Remove Product amendment effective on the first day of the next Invoice period or next term.
- Once the product is removed, follow the Add a Product via UI steps. Use the same dates as the Remove Product amendment, which makes the new product effective the day the old product is removed.
Downgrade a Product via API
Refer to the API Documentation for Removing a Product and follow the instructions based on your WSDL version.
You must set the ContractEffectiveDate and EffectiveDate fields (and also the ServiceActivationDate and CustomerAcceptanceDate fields if enabled) to the correct date to ensure there are no refunds, credits or prorations.
- The contract effective, effective, service activation and customer acceptance dates should be set to the date you want the cancellation or downgrade to take effect.
- In order to ensure no proration this should be the first day of the next invoice period or the first day of the next term, depending on if you want to downgrade at the end of the last invoice period or end of term.
- If the current invoice period for the product extends from 10/01/2011-10/31/2011 and the next invoice period for this product begins on 11/01/2001, set the contract effective date to 11/01/2001.
When the Remove Product amendment is succesful, follow the Adding a Product instructions using the date used in the Remove Product amendment.
Renew a Subscription
Use the following steps to renew a subscription. These steps must be followed for each subscription you want to renew.
Renew a Subscription via UI
- Click on the subscription you want to renew.
- Click on the Amendment button.

- Enter in an Amendment Name, Change Description (optional).
- Select Renewal from the Amendment Type drop down, and click Save.

- The Amendment Detail section outlines the effect of the renewal.

- Click Active, enter a Customer Acceptance Date, and click Save.
Renew a Subscription via API
Refer to the API Documentation for Renewing a Subscription and follow the instructions based on your WSDL version.
Change Subscription Terms and Conditions
Use the following steps to change the terms and conditions on a subscription. These steps must be followed for each subscription you want to change.
Change Subscription Terms and Conditions via UI
- Click on the subscription you want to renew.
- Click on the Amendment button.

- Enter in an Amendment Name, Change Description (optional).
- Select Terms and Conditions from the Amendment Type drop down, and click Save.

- In the New Value section edit the terms and conditions and click Save

- Click the Contract effective button, enter a Contract effective Date and click Save.
- If you have Service Activation and Customer Acceptance dates enabled then click the Service Activation button, enter the Service Activation Date and click Save, then click the Customer Acceptance button, enter the Customer Acceptance Date and click Save.
Change Subscription Terms and Conditions via API
Refer to the API Documentation for Changing the Terms and Conditions and follow the instructions based on your WSDL version.
Related
- Subscription Charge Display
- In the subscription, under Product & Charges, you can view your charges grouped by product, trigger condition, or key statistics. You can also view the date in which the charge was invoiced through and the history for that charge.
- Subscription Views
- Use the Subscription Views area (located in the upper-right of the Subscriptions page) to quickly see the status of your subscriptions, and view subscriptions by status.
- Creating Subscriptions
- You must first create your customer accounts before you can create your subscription. Once you have a customer account, you can create subscriptions for that account in three different ways. The easiest way to create a subscription is from the Customer Accounts page. You can also create a subscription from the Subscriptions page or from a product page.
- Previewing a Subscription
- You can preview a subscription at any time (when the subscription is in draft, active, or canceled status) to see the invoice charges that will be generated by the subscription.
- Changing Subscriptions (Amendments)
- In Z-Billing, amendments are used to make changes to an active subscription.
- Amendment Types
- Z-Billing offers multiple types of amendments: Terms and Conditions (T&Cs) New Product Update a Product Remove a Product Renewal Each amendment type describes an action you can take to modify an existing subscription.
- Amendment Fields
- Every amendment type shares the following fields: Amendment Name Subscription Version Change Description Effective Date Amendment Code Amendment Type
- Invoice Subscriptions to Different Accounts
- Using the Invoice Subscription to Different Accounts feature, you can configure a subscription in an account to be rated and billed by a billing run initiated from a different account. This is typically used to create a hierarchical billing situation for larger companies with many departments, divisions, or subsidiaries.
- Subscription and Amendment Dates
- Making Changes: Amendment Use Cases
- Once a subscription is set up, you can make changes to that subscription. For example, you can change the terms and conditions, or change or delete a product. In such cases, you would identify the subscription, then make the desired changes. The Amendment object carries the primary fields for making these kinds of changes. The following topics provide specific information about the types of changes you can make using the Amendment object.
- Add a Product (Beginner)
- Update a Product (Beginner)
- Upgrade a Product (Beginner)
- Downgrade a Product (Beginner)
- Remove a Product (Beginner)
- Renew a Subscription (Beginner)
- Change a Subscription's Terms and Conditions (Beginner)
- Previewing Amendments (Beginner)
- Deleting Amendments (Beginner)
- Using Amendments (Intermediate)
- Using Mass Order Entry to Create Amendments (Intermediate)
- Changing the Terms and Conditions (Intermediate)
- How do I allow my customers to increase or decrease the units associated with a subscription?
- How do I automatically notify my customers of subscriptions coming up for renewal?
- How do I create a refund in UI and API (including shutting off a subscription)?
- How do I create an ad hoc charge or credit in Zuora?
- How do I determine current RatePlanCharges and map back to active subscriptions?
- How do I handle free trials in Zuora?
- How do I handle subscriptions that do not auto-renew at the end of the subscription term?
- How do I properly cancel or downgrade customers to avoid issuing a credit or refund?
- How do I select from more than 15 products and rate plans when adding them to a new subscription?
- How do I stop billing a customer who discontinued their subscription?
- How do I support evergreen subscriptions?
- How do I undo a change made to a subscription (delete an amendment)?

Comments