Skip to main content

Zuora Billing Release 288, November 2020

Zuora

Zuora Billing Release 288, November 2020

Welcome to the release notes for Zuora Billing Release 288 (R288), November 2020

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 Billing API Reference.

Orders and Subscriptions

TCV calculation change for recurring charges with weekly based billing periods

As of Zuora Billing Release 288, Zuora has changed the TCV calculation methodology of recurring charges with weekly based billing periods to be the same as that of the recurring charges with monthly based billing periods.

With this change, TCV of a recurring charge equals to the Monthly Recurring Revenue (MRR) multiplied by the number of months that the charge is effective. See Total Contract Value for more information.

Objects and fields in the Charge Metrics service now available in Data Query

The objects and fields in the Charge Metrics service are now available in Data Query, including the ChargeMetrics and ChargeMetricsDiscountAllocationDetail objects and corresponding fields. See Charge Metrics for more information.

New field now available in the Order Action data source

The Order Action data source now supports the Sequence field. See Order Action Data Source for more information.

Delete button now available for draft or pending subscriptions in tenants with Orders Harmonization enabled

The delete button is now available on the subscription details page for the draft or pending subscriptions in the tenants that have the Orders Harmonization feature enabled. As Orders Harmonization customers, you can use this button to delete any:

  • Draft subscriptions
  • Pending Activation or Pending Acceptance subscriptions created through the Create subscription operation
  • Pending Activation or Pending Acceptance subscriptions created through the Subscribe action
  • Pending Activation or Pending Acceptance subscriptions created through the subscribe() call
  • Pending Activation or Pending Acceptance subscriptions created through the Zuora UI before the Orders Harmonization feature has been enabled

Cpq Bundle Json ID field removed from the subscription details page

As of Zuora Billing Release 288, Zuora has removed the Cpq Bundle Json ID field from the subscription details page for subscriptions that do not contain this field. This field will still be available on the subscription details page for subscriptions containing this field.

Invoicing and Invoice Settlement

Changes to the billing rule of generating invoices or credit memos

This feature is only available if you have Invoice Settlement enabled. The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memos, and Invoice Item Settlement. If you want to have access to the feature, see Invoice Settlement Enablement and Checklist Guide for more information.

Zuora has introduced the following changes to the Invoice/Credit Memo generation rule billing rule: 

  • Changed the default value from Put all negative charges on a credit memo to Create credit memos for net invoice totals without grouping charges.
  • Changed the display order of the options available for the billing rule.

You can configure this billing rule under Billing Settings > Define Billing Rules. See Invoice/Credit Memo generation rule for more information.

Limit on the number of items in memo creation per request

This feature is only available if you have Invoice Settlement enabled. The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memos, and Invoice Item Settlement. If you want to have access to the feature, see Invoice Settlement Enablement and Checklist Guide for more information.

When you create a credit memo or debit memo from an invoice or a product rate plan charge through the Zuora UI or API, a limit is now set on the maximum number of items that can be created for one credit memo or debit memo in one request. The limit is 1,000 for the maximum number of items. 

If an invoice or a product rate plan charge contains more than 1,000 items, you can call the corresponding operations to create multiple memos from it:

Payments

CyberSource Payment API v2.0 now supports Decision Manager

Decision Manager is a fraud detection service that Cybersource offers to its merchants. Zuora now integrates with the Decision Manager service and gives you the flexibility to enable this service on payment method creation, on payment runs, or both. You can set custom rules about which payment and billing information is allowed to be processed so that the fraudulent payments can be reduced.

After the Decision Manager is set up in your CyberSource account, you must configure the corresponding settings in Zuora. The following gateway settings are now available on the gateway configuration page of CyberSource, Payment API v2.0:

  • Enable Decision Manager on new payment method
  • Enable Decision Manager on payment capture

For more information, see CyberSource payment gateway

Behavior change to the payment run details page

Zuora has introduced a behavior change to the payment run details page. If a payment run is still being processed, the payment run details page is now displayed only with basic information. 

The following areas are now displayed on the payment run details page only after the payment run is completed: 

  • Payments Processed Successfully
  • Payments Processed with Errors
  • Credit Balance Applied
  • Selected Invoice(s)
  • Unprocessed Debit Memos

Enhancement for payment run performance

To improve the performance of payment runs, Zuora has introduced an enhancement by reducing the number of unprocessed invoices in payment runs. 

Zuora Billing UI enhancements

The following changes are available as of this release.

  • On the All Payment Runs page, the actions displayed for payment runs are now corrected and consistent in the expanded view and list view.
    • Payment runs in Pending status: Cancel and Edit actions (Edit only available for scheduled payment runs)
    • Payment runs in Processing status: Stop action 
    • Payment runs in Error status: Delete action 
    • Payment runs in Cancelled status: Delete action 
    • Payment runs in Completed or Terminated status: no action available
  • After you click cancel this bill run on the bill run details page, you can now stay on the bill run details page. 
    Previously, it automatically jumped to the list view of the All Bill Runs page after the canceling action.
  • On the All Bill Runs page, the actions displayed for each bill run are now consistent in the expanded view and list view. 

SOAP API

Current WSDL version: 106

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.