WSDL and API Versions

From API Documentation

The Z-Commerce API and its corresponding WSDL are assigned a new version number when objects, calls, fields, or behaviors are added. The versions are indicated by a number that is part of the WSDL file name. For example, the name of the WSDL file for version 3.0 is zuora.3.0.wsdl.

You can also see the version number by inspecting the endpoint within the WSDL file, which is found at the end of the WSDL file. For example, the following is from version 32.0:

<!-- from Zuora.x.0.wsdl file -->
<service name="ZuoraService">
 <port name="Soap" binding="zns:SoapBinding">
   <soap:address location="https://staging.zuora.com/apps/services/a/32.0" />
 </port>
</service>

Each version might have one or more releases associated with it. Each release will introduce bug fixes and enhancements. Some releases also introduce new features, such as new objects or calls or new fields, and therefore new capabilities for existing objects. However, the version number will not change for interim releases; the version number changes only when a new version is released.

Each WSDL version is backwards compatible with previous versions. You can continue using an older version of the WSDL with your code, or use a newer version without changing your code. However, to take advantage of new features you must use the latest version of the WSDL and update your code to reflect the changes.

WSDL Version and the Describe Call

The describe call references the current version of the WSDL on your tenant. To use features introduced in new versions of the Zuora WSDL (as described in What's New), you must update your system to use the latest version.