April 2013 - New Features

Knowledge Center > ZZ ARCHIVE > ARCHIVED Zuora Billing Release Notes > 2013 New Features > April 2013 - New Features

April 2013 - New Features


We are pleased to provide you with a summary of our April, 2013 release (R163), including new features and resolved issues.

New features

This release includes the following new features and enhancements.

Zuora Commerce

The following features have been added to Z-Commerce.

Commerce REST API

We are delighted to announce the release of our new Commerce REST API. Streamlined and easy to use, it's designed for rapid integration into web self-service storefronts, and includes powerful use-case-based calls that handle complex, multi-step operations in a single request. For more information consult our REST APIs page.

This is a controlled release feature. Contact Zuora Global Support to learn more about enabling this feature. 

New Java and Ruby Sample Code Libraries

In concert with the release of the REST API, we are releasing new sample code libraries forJava and Ruby. Each library includes a library of objects that wrap the new REST API calls, making it easy to integrate common storefront tasks into your Java or Ruby application without having to deal directly with HTTP requests and responses. Also included are code examples that demonstrate the use of the library objects. For more information please visit our REST Sample Code Libraries page.

This is a controlled release feature. Contact Zuora Global Support to learn more about enabling this feature. 

Enhancements to Quote templates

We've added three enhancements to the Quote templates feature of Z-Force:

  1. We've added some new merge fields in Quote templates: Account Owner, Bill-to Email, Bill-to Title, Sold-to Email, Sold-to Title, Product Description, Product Name, Included Units, Opportunity Owner Email, and Opportunity Owner Phone.
  2. Quote templates can now include your custom fields from Accounts, Opportunities, Quotes, and their related objects.
  3. And you can control the sort sequence of tables in your Quote template.

To help you get the most from these templates, we've posted a new sample Quote template and detailed instructions, including a list of fieldnames, at Z-Force > Quote Templates.

Zuora Billing and Payments

The following features have been added to Z-Billing and Z-Payments.

Ability to fully roll back charges created in a bill run, even if no invoices are generated

When cancelling a bill run, our original logic for rolling back charges was based on invoices; if no invoices were created, Zuora couldn't automatically roll back the charges.  However, it turns out that common real-world use cases do include scenarios in which a bill run doesn't generate any invoices, but does create changes to charges.  The logic has been restructured and it is now possible to roll back all charges regardless of whether invoices were created.

WSDL Version

The Zuora WSDL has been updated to version 46.0. See WSDL and API Versions for information about downloading the latest version.

When amending a subscription via SOAP API, the new subscription ID is returned

When amending a subscription, we always create a new subscription with the new parameters, and keep the old subscription on file for reference. Starting with WSDL 46.0,  when amending a subscription via the SOAP API, the ID of the new subscription is returned for convenience.

Ability to activate foreign currency through the SOAP API

Previously, currencies could only be activated for product rate plans using the Zuora UI.  As of WSDL 46.0 we've added an ActiveCurrencies field to the ProductRatePlan object, so currencies can now be activated using the Zuora SOAP API.  (Note: in this release, we have also deprecated the Active field in the ProductRatePlanChargeTier object of the SOAP API, as this field previously had no business purpose.)

Ability to create non-referenced (credit balance) refunds for CyberSource payment gateway

Zuora began supporting non-referenced refunds in July 2011 for two of our thirteen pre-integrated payment gateways: Chase Orbital and Verifi. In upcoming releases, we will add this ability for several more pre-integrated gateways that offer this functionality. This month we've extended support for non-referenced credit refunds to the CyberSource Payment Gateway.

Non-referenced refunds (also referred to as credit balanced refunds) are used when refunding credit balances. They allow you to issue a credit to a customer electronically without referencing an existing payment in Zuora. For example, you could use a non-referenced refund in the following case:

  • A customer prepays for a service, and that payment is applied to a credit balance.
  • You create an invoice for the customer.
  • The customer uses some of the credit balance, and then asks for a refund of the remaining balance.
  • You can now create a refund and transfer money to the customer.

To use this feature:

  • You must be using the Verifi,  Chase Orbital, or CyberSource payment gateway.
  • As a tenant you must be authorized for Credit Balance Electronic Refunds (available through Zuora Global Support).
  • As a user you must have permission to issue refunds.  To grant the Credit Balance permission, create a new Z-Payments role and assign that role to the appropriate user.
  • The customer must have a credit balance.

See Canceling and Refunding Credit Balances for more information on credit balance refunds.

Resolved issues

The following issues were resolved in this release.

Billing and Payments

The following issues were fixed in Z-Billing and Z-Payments.

Invoice due date in datasource code inconsistent between UI and API

Previously, there were discrepancies in the format of the invoice due date returned by the UI and the SOAP API for reporting purposes. Under some circumstances, we would return a date and time instead of simply a date.

We have fixed this issue in this release, and now return a date in yyyy-mm-dd format.

UI would not activate currency for a negative amount in a ProductRatePlanCharge

Previously, when editing ProductRatePlanCharge price in multiple currencies, the UI would not allow activation of a currency if the price was a negative amount.

We have fixed this issue in this release.

UI allowed empty price for activated currencies on "Edit price in multi-currencies" page 

Previously, when editing ProductRatePlanCharge price in multiple currencies, it was possible to empty the price field for an activated currency and save the change.

We have fixed this issue in this release.

UI deactivated non-default currencies when cloning ProductRatePlan

Previously, when a ProductRatePlan was cloned with the UI, only the default currency from the old PRP was active in the new PRP, and all the other currencies were inactive - regardless of whether they were active in the original PRP or not.

We have fixed this issue in this release.


The R163.1 release (April 11, 2013) resolves the following:

  • COM-4659: Non-administrator SFDC users cannot generate Quotes. When standard users of SFDC attempted to generate quotes (PDF/Word), they would receive an error that includes: "com.zuora.base.ZuoraException: Exception happened when accessing SFDC org".  The issue has been resolved.


The R163.2 release (April 16, 2013) resolves the following:

  • REST-371: Non-verbose REST API error messages. Some of the error messages returned by the REST API were excessively minimal or cryptic. The issue has been resolved.
Last modified


This page has no custom tags.


(not set)