February 2016 Release Notes

Knowledge Center > ZZ ARCHIVE > ARCHIVED Zuora Billing Release Notes > 2016 New Features > February 2016 Release Notes

February 2016 Release Notes

Welcome to the Zuora February 2016 Release, R197. This release includes new Zuora features, enhancements, and resolved issues.

Released Versions

Environment Current Product Version Release Date Current WSDL Version
Production R197.2 March 10, 2016 75.0
API Sandbox R197.2 March 8, 2016 75.0

See Version Information for more version information.​​

Zuora's RBM Solution

Features and enhancements related to Relationship Business Management solutions.

Subscription​ Management

Key Dates Notification Now Supports Charge End Date

This feature is in Limited Availability. If you wish to have access to the feature, submit a request at Zuora Global Support

Previously, you could only configure a notification to be sent out on the date when the subscription ends. You could not configure a notification to be sent out when each charge ends on a different date than the subscription end date.

Now Zuora supports a key dates notification for the charge end date. For example, you can get a notification callout for deprovisioning access to your products based on the end date of certain charges. This feature is available for email and callout notifications. You can select the number of days before or after the charge end date to send out a notification. 

See Key Date(s): Rate Plan Charge for more information.

Update Subscription REST Method Supports Service Activation Date and Customer Acceptance Date

You can now change the service activation date and customer acceptance date when creating the following amendments through the PUT Subscription method:

  • Add product
  • Update product
  • Remove product 

Create Account and Create Subscription REST Methods Now Support Subscription Numbers

You can now specify a subscription number when creating a subscription through the following methods:

Support Viewing Amendments Using REST API

You can now retrieve information about subscription amendments through the Zuora REST API with the following two new methods:

These two methods are now more consistent with the SOAP query call on the Amendment object.

Resolved Issues

The following subscription management issues were resolved in this release.

SOAP API Returned Incorrect Value for the Product Category through the Query call

Querying the Category field from the Product object to get the product category, Zuora SOAP API returned DefaultCatalog regardless of the value of the Category field.

This issue is now resolved. You must download WSDL version 75.0+ for the query to return the actual value for the product category. To view product categories from data source, Zuora now supports the Category field in the Product data source. 

Unable to Set a Value for a Required Account Customer Field through REST Subscription Preview Method

When you preview a subscription through the POST subscription/preview method if you created a required account custom field in Z-Billing, an error message was displayed. This error occurred no matter whether you set a value for this custom field in the request.

This issue is now resolved. Zuora now supports custom fields for providing customer account information in the POST subscription/preview method. 

Billing and Payments

Ability to Group and Subtotal Usage Charges in Invoices

You can now configure your invoice templates to display usage charges in nested tables. For example, display usage charges in your invoices that are grouped and subtotaled by a custom field, such as Billing Code, and sorted in ascending order by Charge Date.

Use the following new mergefields to configure nested tables:

  • NestedTable:GroupColumn
  • NestedTable:ValueColumn

You must have the Individual Usage feature enabled to display grouped subtotals.

NestedTable mergefields are currently available only on Usage tables. See Group and Subtotal Usage Data in Nested Tables for more information.

Tax Exempt Provisioning Available Through the REST API

You can now set the tax exempt value using the REST API. The following tax exempt fields were added to the REST account methods.

  • companyCode
  • exemptCertificateId
  • exemptCertificateType
  • exemptDescription
  • exemptEffectiveDate
  • exemptExpirationDate
  • exemptIssuingJurisdiction
  • exemptStatus
  • VATId

See the following articles for more information:


Upcoming Changes to Accounting Codes

We will soon be making the following changes to accounting codes in the Zuora April release, R199.

  • You will only be able to specify accounting codes that already exist in your chart of accounts. For example, if you update the accounting code on a product rate plan charge by specifying a non-existent accounting code, an error is returned.
  • Accounting codes will require unique names, regardless of the accounting code type. For example, if you have a Sales Revenue accounting code called “Revenue,” you cannot have another accounting code also called “Revenue,” even if it is of a different type, such as Deferred Revenue. Only newly-created accounting codes will be affected. Existing accounting codes with duplicate names will not be affected.

Please ensure that your Zuora integration complies with these changes.

GL Account Name and GL Account Number Available Through REST API

You can now retrieve the GL Account Name and GL Account Number of accounting codes through the REST API. The glAccountName and glAccountNumber fields are now returned in the response of the following REST API calls:

Zuora WSDL Automatically Includes Finance Custom Fields

When you download the latest Zuora WSDL, the WSDL now includes your tenant-specific custom fields for the accountingPeriod and accountingCode SOAP API objects. You no longer need to worry about re-adding your custom fields each time you download the latest WSDL.

See Zuora WSDL and Custom Fields in SOAP Objects for more information.

Zuora for Salesforce

Resolved Issue

An Error about an Invalid Object Returned During 360 Sync or Cleanup Operations

During 360 sync or cleanup operations of Accounts and Related Objects, an error occurred: INVALID_TYPE of sObject. This expected and benign error was a result of Zuora 360 attempting to delete a record that did not exist.

Now Zuora 360 gracefully handles the non-critical or expected errors and prevents the errors unnecessarily returned to users during sync and cleanups.

Manage and Extend

Features, enhancements, and release announcements for Zuora admins, Zuora integrations, and general information about Zuora APIs.

Admin and Settings

Full List of Merge Fields Now Available on Email and Callout Notifications

Email and callouts now have access to most data source fields associated with the notification event – including custom fields.

Now you can send richer emails with more personalized and specific data. For example, you can send an email before an invoice is due and include the details of the payment method the customer has chosen to settle with.

Before, you only had access to a limited set of predefined fields.

See Create and Edit Notifications for more information.

Send Email Notifications to Invoice Owners

You can now send email notifications to the invoice owner of a subscription. For example, send a notification to the invoice owner letting them know of an upcoming subscription renewal. Before, you could only send subscription-related notifications to subscription owners.

Support for Invoice Owners is available on following notification events:

  • Subscription:

    • Subscription Created

    • Upcoming Renewal

    • Key Dates

  • Amendment: Amendment Processed

See Create and Edit Email Templates for more information.


Z-Suite Integrations Release

Z-Suite Integrations Release Notes January 27, 2016, v528 – Production Release.



Developer Console No Longer Supported

Zuora no longer supports the Developer Console to test the Zuora REST API. Please remove any bookmarks you may have to https://apigee.com/ZuoraAPI/embed/console/CRESTAPI.

Try using other third party REST Clients, such as Postman or Advanced REST Client to test the Zuora REST API. Sample code is available with Zuora REST API reference articles.


Current WSDL version: 75

See Zuora WSDL for information on how to check your version and download the latest version.

SOAP API Change History

See Zuora SOAP API Version History for a summary of updates made to the SOAP API in recent Zuora releases.


Request queries can now explicitly set ISO-8601 compliant UTC output for fields of type dateTime.
When using the AQuA API Post Query (with WSDL 69 or later), you can specify the dateTimeUtc request parameter to true to ensure that the data set returned will have all dateTime values returned in ISO-8601 compliant UTC format.

Date Field Changes as of WSDL 69

Please read this important note before using WSDL version 69 or later.

In WSDL 68 and earlier, 56 Zuora SOAP API date fields are treated as dateTime fields. As of WSDL 69, Zuora will treat these fields as date only fields. These fields are no longer compatible with dateTime values. Date and dateTime values in WSDL 69 are now the same as date and dateTime values in the Zuora application.

Before downloading and using WSDL 69, check to see if your SOAP integration passes or receives dateTime values to or from any of these fields.

The AQuA API is also affected by these date field changes. If you use the AQuA API, you must review the date field changes and take the appropriate action.

See Date Field Changes in the WSDL for more information.

Last modified



(not set)