Skip to main content

Zuora Release 2022.11.R4


Zuora Release 2022.11.R4

Welcome to the release notes for Zuora Release 2022.11.R4. This article is a consolidated page of all release notes for the following Zuora products:

For the latest release notes of Zuora Revenue, see Zuora Revenue release notes.

We welcome and appreciate your feedback on this release notes article. Please use the Feedback button to let us know what you think about the new release notes.

Release schedule

For release schedule details, see this release notification.

For the planned schedule of upcoming Zuora releases, see Zuora Release Management in Zuora Community.

Join Release Notifications in Zuora Community to receive timely notifications about Zuora Billing, Collect, and Central Platform.

Zuora Billing

here_black.png Invoicing and Tax

Deprecation of Bill Run Notification: Posted email notification setting

In late December 2022, we will deprecate the non-configurable "Bill Run Notification: Posted” email notification setting from production tenants. This change will go live in sandbox tenants on 6 December 2022. After this change, the notification emails will not be sent to the user accounts that are used to create bill runs. 

The alternative solution to revive "Bill Run Notification: Posted” notifications is to use custom events. For more information about how to configure Bill Run Posted custom events, see the “Bill Run Posted” section in Custom events.

Additionally, you can use the following standard events for Bill Run Completion to trigger email notifications:

  • Completed Status
  • Error Status

here_black.png Usage and Rating

Resolved: Cannot create evergreen subscriptions when the Prepaid with Drawdown feature is enabled

Previously, if your tenant has enabled the Prepaid with Drawdown feature, you couldn’t create non-prepaid type evergreen subscriptions.

This issue has been resolved. You can now create non-prepaid evergreen subscriptions in tenants that have enabled the Prepaid with Drawdown feature.

up-arrow.png Back to Table of Contents

Zuora Collect

Zuora Collect has only internal enhancements and resolved issues in this release.​​​​

up-arrow.png Back to Table of Contents

Zuora Central Platform

here_black.png Data Query

Support for foreign currency conversion through Data Query

A new function called fx_convert is now available in Data Query. You can use this function to convert monetary values from an original currency to a target currency and export converted data to query results.

For example, you can convert the invoice amounts from the transaction currency to your home currency or any specific currency.

For more information, see Foreign currency conversion for Data Query.

here_black.png Audit Trail

Enhancement to Audit Trail for sandbox tenants

On 23 Nov 2022 PDT, we will perform an upgrade on Audit Trail for all sandbox tenants.

After this upgrade, you can use three new fields (year, month, and day) in the following Audit Trail tables:

  • auditloginevent
  • auditobjectchangeevent
  • auditsettingchangeevent

For example, you can use the following query to retrieve login history records in October:

select * from auditloginevent where year = 2022 and month = 10

For more information about sample queries, see Sample Queries of Audit Trail for sandbox tenants.

After this upgrade, only the last three months of Audit Trail data in your sandbox tenant will be available.

Note that this upgrade is specifically for sandbox tenants. The upgrade for production tenants will be performed at a later time and the entirety of Audit Trail history in your production tenants will be available after the upgrade.

up-arrow.png Back to Table of Contents


Zuora REST API provides comprehensive support for common business use cases. 

API for Billing, Collect, and Platform

For the detailed API documentation, see API Reference.

For a summary of REST API updates and documentation updates in the Zuora API Reference, see 2022 API Changelog

Quickstart API

From 2022.09.R1, the Quickstart API is available to you if you have the Orders (or Order Harmonization) and Invoice Settlement features enabled in your tenant. The QuickstartAPI allows new integrators to swiftly integrate with Zuora, and it supports essential business use cases.

For the detailed Quickstart API documentation, see Quickstart API Reference.

For a summary of REST API updates and documentation updates in the Quickstart API Reference, see Quickstart API Changelog


Current WSDL version: 128

For information about how to check your version and download the latest version. see Zuora WSDL.

SOAP API change history

For a summary of updates made to the SOAP API in recent Zuora releases, see Zuora SOAP API Version History.