Skip to main content

Zuora SOAP API Version History


Zuora SOAP API Version History

This article documents the schema changes made to each version of Zuora SOAP WSDL, starting with the releases in the second half of 2015.

See the related release notes for detail information about the changes.

WSDL Version Release Date
(Zuora Version)
Object and Field Changed Permission Control? Description
110 November 2021 (R313)   No

To provide more effective error codes and messages, the following enhancements are made to the create() call on the PaymentMethod object:

  • During the creation of a Bank Transfer payment method, a failed call that occurs when an invalid value is specified for the IsCompany field now returns the INVALID_TYPE error code and the corresponding error message. Previously, it was UNKNOWN_ERROR.
  • A failed call that occurs when multiple payment method objects are specified in a single request now returns a self-explanatory error message.
110 October 2021 (R311)   No For better clarity, a failed subscribe() call to Avalara now returns ‘TRANSACTION_FAILED’ error response. Previously it was ‘UNKNOWN_ERROR’.
107 January 2021 (R290) Subscription.Revision added No An auto-generated decimal value uniquely tagged with a subscription. The value always contains one decimal place, for example, the revision of a new subscription is 1.0. If a further version of the subscription is created, the Revision value will be increased by 1. Also, the Revision value is always incremental regardless of the deletion of subscription versions.

The applied or unapplied amount of the payment. 

Note: These fields are only available if you have the Invoice Settlement feature enabled.

103 July 2020 (R280) Export.Encoding added No Specifies whether to include a byte order mark (BOM) at the beginning of exported CSV data.

March 2020 (R270)

BillRun.Batch renamed to BillRun.Batches No The specific batches of customer accounts to be included in the bill run.
101 September 2019 (R256) BillRun.NumberOfCreditMemos added No The number of credit memos generated by the bill run.
101 August 2019 (R255) BillRun.PostedDate added No The date when the bill run was posted.
100 August 2019 (R253) No Query the status of tax calculation for invoices, and message about the status of tax calculation.
96 April 2019 (R243) Account.SequenceSetId added No The ID of a billing document sequence set to assign to a customer account.
94 March 2019 (R242)

PaymentMethod.MitNetworkTransactionId added

No Specifies the ID of a network transaction.
94 March 2019 (R241) No Create a stored credential profile.
91 May 2018 (R224) TaxableItemSnapshot.TaxExemptEntityUseCode added Yes A unique entity use code to apply exemptions in Avalara AvaTax.
89 Feb. 2018 (R221) Invoice.AutoPay added No Whether invoices are automatically picked up for processing in the corresponding payment run. 
88 Sep. 2017 (R216.2) No Specify or query the city, state, country, and postal code information for ACH payment methods.
85 April 2017


Query contact snapshot.

Query apply details info of the discount product rate plan charge.

    No Query apply details info of the discount rate plan charge.
    No The date the Payment Method Snapshot was updated.
This new field cannot be modified or deleted.
    No Specify or query the discount class of discount charge.

Specify or query the discount charge apply details info.


Query apply details info from the discount rate plan charge.

  • Invoice.BillToContactSnapshotId added
  • Invoice.SoldToContactSnapshotId added

When posting an invoice, these fields will be populated with the latest contact snapshot ID.


Feb. 2017

Yes You can query the balances of invoice and taxation item before applying payment or credit memo to them.
82 Dec. 2016


You can manually create/query/delete taxable item snapshot.
81 Oct. 2016


An optional field for the create, update, and query operation of AccountingPeriod.


Support auto-renewal for BillingPreviewRun and BillingPreviewRequest.

80 Sep. 2016


For Discount item, this field describes which InvoiceItem the discount is applied to.

79 Aug. 2016
No The Permission control was removed for these fields as the Weekly Billing features are in GA.


78 July 2016

Specify one or more currencies you want to use in ISO currency codes.


The fields are now generally available and no longer permission controlled.


June 2016


Currency of the payment.

76 April 2016
  • Amendment.SuspendDate added
  • Amendment.ResumeDate added
  • Amendment.Type updated with additional new values:

    • SuspendSubscription

    • ResumeSubscription

  • Subscription.Status with a new value:

    • Suspended


Create a suspend or resume subscription amendment through SOAP calls.



The delete call is supported for the following objects: 

Yes Delete an accounting period or a chart of account using SOAP API.
75 Feb. 2016 

Tenant-specific custom fields on the following objects included in WSDL:


Jan. 2016


Supports getting and setting a Rating Group in SOAP calls


Supports getting and setting a weekly Billing Cycle Day in SOAP calls


You can override PriceIncreasePercentag and PriceChangeOption in subscription


The field type changed from long to decimal.

Starting in WSDL v.74, you can split invoices based on a decimal percentage.


The new values, Week and Specific Weeks, are supported.

You can set billing period to weekly or specific weeks through SOAP calls.


The new value, Week, is supported.

You can set the list price base to weekly or specific weeks through SOAP calls.

    No The field type changed from string to zns:ID

Dec. 2015


Subscription Term and Renewal Term can be specified in days, weeks, months, or years.

72 Nov. 2015

Specifies the charge end condition when creating or updating Product Rate Plan Charges and Rate Plan Charges.


Specifies whether to include draft invoice items in preview results.

71 Oct. 2015

The date when the future-dated UpdateProduct amendment takes effect.

70 Sep. 2015

Specifies whether to bill in advance or in arrears for recurring charge types.


Used when calculating taxes based on origin and sold-to addresses in Avalara.

69 Aug. 2015

ACH address fields required for Vantiv Payment Gateway


The tenant-level permission, BankTransfer, is removed.


July 2015


Field type changed from DateTime to Date

68 June 2015

Supports the charge level metrics