Skip to main content

Zuora Release 2024.05.R1

Zuora

Zuora Release 2024.05.R1

COMING SOON!
This is a preview of our upcoming release. These release notes are a work in-progress and are subject to change. Some of the articles that the release notes link to might not yet be updated for the upcoming release.

Welcome to the release notes for Zuora Release 2023.05.R1. This article is a consolidated page of release notes for the following Zuora products:

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

Release schedule

To receive notifications about releases, join Release Notifications in Zuora Community. For the planned release schedule, see Zuora Release Management.

Zuora Billing

here_black.png Orders and Subscriptions

Deprecation of Amend and Subscribe features

The Subscribe and Amend features are approaching end of support on February 16, 2026. 

During the deprecation period through February 15, 2026, Zuora will no longer actively develop or enhance the Subscribe and Amend features. Only critical, revenue-impacting defects with no workarounds or alternatives may be fixed at Zuora’s discretion. Customers should start planning for the required changes and begin the transition process to Orders. For more information, see Product and feature end of support plan.

Enhancement to Standalone Order feature

We have enhanced the Standalone Order feature. You can now use a standalone order to create a Minimum Commitment subscription. 

here_black.png Invoicing and Tax

Period Start Date and Period End Date for Multiple Taxation Items

We have now introduced two new fields, PeriodStartDate and PeriodEndDate, within TaxationItem, CreditTaxationItem, and DebitTaxationItem in Data Query. These additions facilitate the display of tax rate and tax rate period details directly on the invoice PDF. With these fields, you can now ensure accurate representation of separate rates for distinct periods, particularly when an invoice item's service period extends across multiple tax rate periods.

The PeriodStartDate and PeriodEndDate fields on TaxationItem are always the same as the ones on the InvoiceItem, provided you do not use the Generation of multiple taxation items feature. If you use the feature, then configure the rule as Multiple Tax Items. This configuration ensures precise tax calculation when an invoice item's service period overlaps multiple tax rate periods.

Deprecation of Invoice Adjustments, Invoice Item Adjustments, and Credit Balance Adjustments features

The Invoice Adjustments, Invoice Item Adjustments, and Credit Balance Adjustments features are approaching end of support on February 16, 2026. 

During the deprecation period through February 15, 2026, Zuora will no longer actively develop or enhance the Invoice Adjustments, Invoice Item Adjustments, and Credit Balance Adjustments features. Only critical, revenue-impacting defects with no workarounds or alternatives may be fixed at Zuora’s discretion. Customers should start planning for the required changes and begin the transition process to Invoice settlement. For more information, see Product and feature end of support plan.

Enhancements on scheduled bill runs

We enhanced the scheduled dates of the monthly scheduled bill runs, and made the enhancements at the following places:

  • “Create bill run” API operation
  • Create Scheduled Bill Run UI page
  • Bill Run Data Query

Enhancement on bill run date

The Bill Run Date you specified is the date that the first bill run is executed. 

Previously, after you specified the Repeats field as Monthly and the Bill Run Date field, the bill run date could only recur on the same day of each month. 

Now, after specifying the Repeats field as Monthly and the Bill Run Date field as the end day of a month, you can choose one of the following options:

  • Monthly on day X: The bill run date still recurs on the same X day of each month based on your specified Bill Run Date
  • Always on month end: The bill run date recurs on the end day of each month. 

Enhancements on invoice date and target date

The Invoice Date is the invoice date displayed on the invoices, and the Target Date is used to determine which charges are to be billed. Take the Invoice Date as an example, and the Target Date is similar. 

Previously, after you specified the Bill Run Date and Invoice Date fields, invoices could only be generated before or after a fixed number of days from the bill run dates. The fixed number of days is calculated based on the difference in days between your specified Bill Run Date and Invoice Date

Now, after specifying the Repeats field as Monthly and the Invoice Date field as the end day of a month, you can schedule the invoice dates recur in one of the following ways:

  • Still recur before or after a fixed number of days from the bill run dates
  • Recur before or after a fixed number of months from the bill run dates, and the day value is a day of the month (for example, 29) specified in the Invoice Date field.
  • Recur before or after a fixed number of months from the bill run dates, and the day value is the end day of the month.

For more information, see Create bill runs and Monthly Scheduled bill run use cases.

Support for previewing scheduled dates

We added a preview section at the right on the Create Scheduled Bill Run UI page.

After creating a scheduled bill run, you can preview the recurrence and scheduled bill run dates, invoice dates, and target dates in the preview section. 

For more information, see Create bill runs.

Enhancement of e-invoicing file template for Sovos

For Sovos, previously we didn’t provide the Invoice, Credit Memo, and Debit Memo default e-invoicing file templates for countries that are not pre-integrated. For more information, see Pre-integrated countries.

We now provide these default e-invoicing file templates for countries that are not pre-integrated for Sovos. The default e-invoicing file templates include the following common tags:

  • AccountingSupplierParty
  • AccountingCustomerParty
  • Invoice and InvoiceLine

UI enhancement on response field mappings

Previously, if the service provider was specified as Sovos, when you configured the Response Mapping section, you could always click +Add Field Mapping no matter which country was specified in the Basic Info section.

We enhanced the Response Mapping section. The +Add Field Mapping is no longer available for the pre-integrated countries. The default response mappings have been configured and cannot be changed for these pre-integrated countries. For more information, see Manage country-specific configurations.

Standalone credit and debit memos support customized memo numbers through REST API

You can now specify customized memo numbers when creating standalone credit or debit memos through the REST API. Previously, the memo numbers were generated by Zuora.

This enhancement allows you to customize the memo numbers to suit your business needs. For example, you can use the numbers from external billing systems.

Note that if you do not specify the memo number when creating a standalone credit or debit memo, Zuora will generate a unique number per the sequence set on the account level. If the account-level sequence set is not specified, the system default sequence set is used. For more information, see Configure prefix and numbering for billing documents.

up-arrow.png Back to Table of Contents

Zuora Payments

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

up-arrow.png Back to Table of Contents

Zuora Central Platform

here_black.png Events and Notifications

Support for cloning email templates

You can now clone email templates through the Zuora UI. This enhancement simplifies the creation of email templates by using existing templates as the foundation.

here_black.png Administration settings

Subregions available for countries and regions

You can now define subregions, including states and provinces, within countries or regions to enforce consistency and data integrity and implement compliance measures at a granular level.

The states of the United States and the provinces of Canada are out-of-the-box subregions. You can create subregions for other countries or regions as needed.

here_black.png Marketplace

Billing connector for Salesforce CPQ available for early adopters

The CPQ Connector seamlessly integrates Salesforce CPQ with Zuora's backend, optimizing sales-to-billing-to-revenue workflows and enhancing operational efficiency. Synchronizing Salesforce CPQ data seamlessly integrates Accounts, Orders, Subscriptions, Contracts, and Quotes with Zuora objects, ensuring smooth downstream processes.

The Billing connector for Salesforce CPQ feature is in the Early Adopter phase. To join this early adopter program, submit a request at Zuora Global Support.

Enhanced data mapping flexibility for seamless integration

Previously, you could only map custom fields of the text type in Zuora. The latest update of Salesforce CPQ has eliminated this limitation, enabling seamless mapping of custom fields between the platforms regardless of their data type. This flexibility in data mapping extends to all supported objects, improving extensibility and customization capabilities.

Efficient streamlining of contact sync process

In account sync processes, Zuora will now exclusively synchronize relevant contacts from Salesforce CPQ accounts and orders. Syncing in Zuora will be limited to billing and shipping addresses designated as Bill To and Sold To contacts. Additionally, the connector will automatically generate contacts associated with orders during syncing.

Bill cycle default enhancement for subscriptions

The Salesforce CPQ connector now ensures accurate billing by defaulting the Bill Cycle to Charge Trigger Day on all subscriptions. This proactive approach eliminates partial billing periods, thereby preventing potential discrepancies in billing within Zuora. This modification ensures that charges can be evenly spread across multiple invoices, improving billing accuracy and alignment. For more information, see the specific month's list price.

Enhanced email alerts for improved notification

Email alerts for failures now provide more pertinent information, including details such as the object to sync, object ID, tenant ID, Zuora environment, and Salesforce environment. This enhancement aims to facilitate troubleshooting processes.

Enhanced system health logs

The Task Name field in System Health logs has been improved to display a combination of the synced object and its object ID. This enhancement simplifies the process of locating relevant logs for easier troubleshooting.

up-arrow.png Back to Table of Contents

REST API

For the detailed API documentation, see API Reference.

For a summary of REST API updates and documentation updates in the Zuora API Reference, see 2023 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

SOAP API

Current WSDL version: 145

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.