Skip to main content

Zuora Billing Release 308, August 2021

Zuora

Zuora Billing Release 308, August 2021

Welcome to the release notes for Zuora Billing Release 308 (R308), August 2021

For more information about the release notes of other Zuora products, see Zuora Release Notes.

Release schedule

Subscribe to Release Notifications in Zuora Community to receive notifications about Zuora Billing releases.

REST API

See API Changelog for a summary of REST API updates and documentation updates in the Zuora API Reference.

Orders and Subscriptions

Behavior change in billing preview for order line items

The Order Line Items feature is now generally available to all Zuora customers. 

You need to enable the Orders feature to access the Order Line Items feature. Orders is generally available as of Zuora Billing Release 284 (August 2020). If you are an existing Zuora Subscribe and Amend customer and want to adopt Orders, see What is Orders Harmonization and join the Orders Harmonization community group for more information. If you want to enable Orders, submit a request at Zuora Global Support.

As of Zuora Billing Release 313 (November 2021), new customers who onboard on Orders or Orders Harmonization will have the Order Line Items feature enabled by default. If you are an existing Orders or Orders Harmonization customer and want to enable the Order Line Items feature, submit a request at Zuora Global Support.

Zuora has changed the behavior in billing preview for order line items. The item state field is now not required to be specified when you preview billing for order line items. Previously, you must set the field to SentToBilling to perform billing preview.

Invoicing and Invoice Settlement

General availability of the Terminate Bill Runs permission

The Terminate Bill Runs permission for Zuora Billing user roles is now generally available to all Zuora customers. By default, this permission is disabled. 

If this permission is enabled, you can now directly click more > Terminate this bill run on the Bill Run details page to terminate bill runs in Processing status. 

Previously, you had to submit a request at Zuora Global Support to enable this feature.

See Terminate bill runs for more information.

General availability of redistributing Zuora Tax rounding differences

The Redistribute Zuora Tax rounding differences billing rule is now generally available in Define Billing Rules to all Zuora customers. By default, this billing rule is set to No.

If this billing rule is set to Yes, invoice items in one invoice are grouped based on the same tax code, tax name, and tax rate, and the total tax amount is calculated at the group level and the item level. The tax rounding differences between the group level and item level are redistributed to the corresponding items.

Previously, you had to submit a request at Zuora Global Support to enable this feature.

See Define Billing Rules for more information.

General availability of Tax Selection for Calculation

The Tax Selection for Calculation feature is now generally available for all Zuora customers. 

With this feature, you can now directly use the Apply new tax rate for additional units purchased and old tax rate for returns? billing rule to specify which tax rate to use in the rating process when changes are made to subscriptions.

Previously, you had to submit a request at Zuora Global Support to enable this feature.

See Tax Selection for Calculation for more information.

Visibility enhancements on the invoice to memo relationships through the Zuora UI

Zuora has enhanced the visibility of the relationships between invoices and credit memos through the user interface. 

In the Memo Details area of the credit memo details page, you can now see the following information for credit memos generated from billing runs.

  • When hovering a charge name displayed in the Charge Name column, you can now see a floating window displaying detailed information about the invoice where the credit is from.
  • In the newly introduced Credit From column, you can see a link to the invoice where the credit is from.

Payments

General availability of Chase Payment Method Updater

The Chase Payment Method Updater feature is now generally available to all Zuora customers. This feature helps to keep merchants informed when card members update their Chase card information. Previously, you had to submit a request at Zuora Global Support to enable this feature.

See Configure Chase Payment Method Updater for more information about this feature.

Adyen Integration v2.0 now supports submitting recurringDetailReference token in payment requests 

For customer initiated transactions (CIT), Zuora’s Payment Pages stores the recurringDetailReference token if it is returned from the Adyen gateway. However, the primary account number (PAN) was always used for subsequent credit card payment requests, which did not always meet your needs.

To give you more flexibility, Zuora has added the Submit Card Payments with RecurringDetailReference setting to the Adyen Integration v2.0 gateway configuration page. With this setting enabled, the recurringDetailReference token will be submitted to Adyen in credit card payment requests if this token is available. If recurringDetailReference is not returned from the gateway, the primary account number will be used for payments.

See Adyen Integration v2.0 for more information about this setting.

Platform

Concurrent request limits now apply at the entity level

Zuora employs a number of concurrent request limits to maximize the stability of its service. If the Multi-entity feature is enabled in your tenant, the concurrent request limits apply at the entity level. Previously, the concurrent request limits applied at the tenant level.

If the Multi-entity feature is not enabled in your tenant, there is no change in how the concurrent request limits apply.

See Rate and concurrent request limits for more information about the concurrent request limits.

SOAP API

Current WSDL version: 110

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.