Welcome to the release notes for the Zuora April 2016 Release, R199. This release includes new Zuora features, enhancements, resolved issues, and improvements to the Knowledge Center.
The following table shows the product versions currently released on the Zuora Production and API Sandbox environments.
|Environment||Current Product Version||Release Date||Current WSDL Version|
|Production||R199.1||May 4, 2016||76.0|
|API Sandbox||R199.1||May 3, 2016||76.0|
See Product Versions and Release Dates for more information.
Now you can control whether users can delete subscriptions and amendments by setting the new Delete Subscriptions/Amendments permission. The Manage Subscriptions/Amendments permission no longer controls the deleting subscriptions and amendments action. This enhancement gives you more flexible admin control on subscriptions and amendments.
By default, for all existing Z-Billing roles, if the Manage Subscriptions/Amendments permission is turned on, the Delete Subscriptions/Amendments permission is turned on. If the Manage Subscriptions/Amendments permission is turned off, the Delete Subscriptions/Amendments permission is turned off.
To access this feature, navigate to Settings > Administration Settings > Manage User Roles, and select Z-Billing from the drop-down list.
See Z-Billing Roles for more information.
Previously from the Zuora UI you could only preview subscriptions for up to five years starting from the subscription start date. You could not preview historical or future invoices if the period between the subscription start date and end date was over five years. Now you can preview subscriptions starting from any date later than the subscription start date. The Preview Start Date field is newly added to specify the preview start date when previewing a subscription.
See Previewing a Subscription for more information.
Zuora has adjusted the timing of the GoCardless gateway reconciliation batch from 22:00 UTC (Coordinated Universal Time) to 13:30 UTC. This adjustment is made to provide reconciliation results earlier in the day for EMEA customers.
Submit a request at Zuora Global Support only if you wish to have access to the GoCardless gateway. If you already have the GoCardless gateway enabled, adjust the timing with the following setting:
See GoCardless Gateway for more information.
This feature is in Limited Availability. If you wish to have access to the feature, submit a request at Zuora Global Support.
Before this release, you had to maintain the product catalog in multiple languages and create a separate invoice template in each language you wanted to support. For example, if you had customers across 30 different languages, you would have to create and maintain 30 different products in the Zuora product catalog in order for invoices to display the product name, rate plan, charge, and so on, in the correct language.
In this release, Zuora introduced the ability to translate invoice merge fields into multiple languages. Now you can generate invoice PDFs in multiple languages with a single instance of your product catalog. You create a translation table for supported merge fields and upload the translation table to Zuora. Supported merge field values are displayed on invoice PDFs in the language specific to the customer.
See Support Multiple Languages in Invoice Template for setting up invoice PDF localization.
The Confirmation Dialog option is supported in Payment Pages 2.0 for the Bank Transfer-Direct Debit (UK) payment method. When your customers select to pay with the UK Direct Debit payment method, they must confirm the mandate information on this Confirmation Dialog page before payments can be processed.
The following key features are included.
The Confirmation Dialog option is selected by default for new Direct Debit (UK) payment pages.
Although the Confirmation Dialog is disabled by default for the Direct Debit (UK) payment pages created prior to this release, we strongly recommend that you enable this functionality in your existing UK Direct Debit payment pages to align with the BACS best practices for Direct Debit (UK).
See Configure UK Direct Debit Type Payment Pages 2.0 for configuring your Direct Debit (UK) Payment Page with the Confirmation Dialog.
Zuora allows you to pass in special Adyen gateway-specific parameters for payments. For each of these special parameters, you supply the name-value pair and Zuora passes it to the gateway. This allows you to add functionality that's supported by Adyen but currently not supported by Zuora.
For more information, see the following articles:
End-to-end foreign currency conversion is now available in Zuora, allowing you to easily manage transactions in foreign currencies. Highlights include:
See Foreign Currency Conversion for an overview of currency conversion in Zuora.
You can now configure email and callout notifications for journal runs and trial balances, making it easier to automate your general ledger integration with Zuora.
The following notification events are available:
Navigate to Z-Finance Settings > Setup Profiles, Notifications and Email Templates to configure notifications.
See Notifications for more information.
To simplify your general ledger integration with Zuora, we have added the following fixed-name columns to the Journal Entry Transaction Detail export:
If you use Foreign Currency Conversion, the following columns are also added:
See Download Transaction Details for more information about the export.
We are deprecating the accounting period Summary Tab Information export. This export is being superseded by the more comprehensive Transaction Details export, which is available for download after generating Summary Journal Entries in Zuora.
You can now delete unused accounting codes using the Zuora UI or SOAP API.
See Delete an Accounting Code for more information.
You can now delete the last open accounting period using the Zuora UI or SOAP API.
See Deleting Accounting Periods for more information.
You can now associate general ledger segments with custom fields on the Sold To Contact and Bill To Contact objects.
See Fields Supported by Segments for a full list of supported fields.
We have made the following changes to accounting codes in this release:
Please ensure that your Zuora integration complies with these changes.
Current WSDL version: 76
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.
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.
We have updated the following Knowledge Center articles based on your feedback:
Previously it was described as Discount-Fixed Percentage.
generate() SOAP API call: Updated the example to include the response of the example request.
How do I handle free trials in Zuora?: Updated this article with the following changes:
Added a note in Example 1 that all the charges must set to be triggered on the Service Activation date if there is over one charge within the subscription.
Updated the incorrect screenshot in Example 3.
The Getting Started Guide is now available in Japanese. The self-guided tutorial is used as a companion guide to the Zuora free trial to introduce you to the core Zuora functionality.
See Zuora入門 for the Japanese version of the Getting Started Guide.