About Jing

Jing

The release notes for Zuora Release 236, January 2018 are on our Knowledge Center! Release Schedule Subscribe to Release Notifications in Zuora Community to receive notifications about Zuora Application releases. Here are some highlights: REST API See API Changelog for a summary of REST API updates and documentation updates in the API Reference. Orders and Subscriptions Suspend and Resume Supported in Order Metrics Resume Extends Term Field in Orders UI Billing Customer Account Search Enhancement for New Payment Runs Support for Not Displaying Invoices With Zero Amount Changes to Existing Billing Rules Payments Support for SoftBank Payment Gateway Support for Dankort Credit Card Type on Payment Pages 2.0 Label Updates on Payment Gateway Setting Page Analytics New features, enhancements, and resolved issues for Zuora Reporting and the Zuora Insights add-on Zuora CPQ Release New features, enhancements, and resolved issues for Zuora Quotes and Zuora 360 Connect Marketplace New features, enhancements, and documentation updates for Zuora Connect NOTE: The features described in the release notes are available only from the Zuora API Sandbox environment. They are not yet available in the Zuora Production environment.

Jing · ‎12-07-2018

The release notes for Zuora Release 235, December 2018 are on our Knowledge Center! Release Schedule Subscribe to Release Notifications in Zuora Community to receive notifications about Zuora Application releases. Here are some highlights: REST API See API Changelog for a summary of REST API updates and documentation updates in the API Reference. Billing Changes to Billing Settings Enhancements to Generation of Multiple Taxation Items Analytics New features, enhancements, and resolved issues for Zuora Reporting and the Zuora Insights add-on Zuora CPQ Release New features, enhancements, and resolved issues for Zuora Quotes and Zuora 360 Connect Marketplace New features, enhancements, and documentation updates for Zuora Connect NOTE: The features described in the release notes are available only from the Zuora API Sandbox environment. They are not yet available in the Zuora Production environment.

Jing · ‎11-09-2018

The release notes for Zuora Release 234, November 2018 are on our Knowledge Center! Release Schedule Subscribe to Release Notifications in Zuora Community to receive notifications about Zuora Application releases. Here are some highlights: REST API See API Changelog for a summary of REST API updates and documentation updates in the API Reference. Orders and Subscriptions Resolved: Removing Create Subscription Button on Product Catalog Page Billing Nested Table Support for Credit and Debit Memo Items Custom Field Support for Grouping Invoice Items and Memo Items in Nested Tables Payments First Data Account Updater Now Available New Bank Transfer Schemes Supported on GoCardless Payment Gateway Integration Analytics New features, enhancements, and resolved issues for Zuora Reporting and the Zuora Insights add-on Zuora CPQ Release New features, enhancements, and resolved issues for Zuora Quotes and Zuora 360 Connect Marketplace New features, enhancements, and documentation updates for Zuora Connect NOTE: The features described in the release notes are available only from the Zuora API Sandbox environment. They are not yet available in the Zuora Production environment.

Jing · ‎10-11-2018

The release notes for Zuora Release 233, October 2018 are on our Knowledge Center! Release Schedule Subscribe to Release Notifications in Zuora Community to receive notifications about Zuora Application releases. Here are some highlights: REST API See API Changelog for a summary of REST API updates and documentation updates in the API Reference. Billing Sequential Billing Document Number Localization Support for Credit and Debit Memos Changes of Reason Codes Configured in Invoice Settlement Migration Payments Gateway Reconciliation Supported by Gulf Management Systems Gateway Integration Enhancement on Vantiv (Now Worldpay) Payment Gateway Integration Analytics Deprecation of Data Exports New features, enhancements, and resolved issues for Zuora Reporting and the Zuora Insights add-on Zuora CPQ Release New features, enhancements, and resolved issues for Zuora Quotes and Zuora 360 Connect Marketplace New features, enhancements, and documentation updates for Zuora Connect NOTE: The features described in the release notes are available only from the Zuora API Sandbox environment. They are not yet available in the Zuora Production environment.

Jing · ‎09-28-2018

Starting from Zuora Release 233 (R233), October 2018, the Release Notes Highlights posts for Zuora releases will be published under Release Notifications to avoid confusion. The previous Release Notes Highlights will stay under Zuora Announcements. Please subscribe to Release Notifications in Zuora Community to receive notifications about future Zuora releases.

Jing · ‎09-14-2018

@perswardh, @ysireesha, and @Nigel: Regarding Release Notes, we've spared no efforts to publish the Release Notes as earlier as possible while maintaining the accuracy of the release changes, since the release cycle has been shortened to every two weeks and become a flexible range instead of a fixed day. For important or breaking changes, we generally publish a separate post under "Release Notifications" in the Community in advance. Thank you!

Jing · ‎09-13-2018

The release notes for Zuora Release 232, September 2018 are on our Knowledge Center! Release Schedule Subscribe to Release Notifications in Zuora Community to receive notifications about Zuora Application releases. Here are some highlights: REST API See API Changelog for a summary of REST API updates and documentation updates in the API Reference. Orders and Subscription Resolved: Subscription Owner Automatically Selected for Amendment Orders Billing Customer Account Search Enhancement for New Bill Runs Enhancement for Creating Credit and Debit Memos from Charges Payments Support for Gulf Management Systems Payment Gateway Analytics User Permission to Control Access to Data Exports New features, enhancements, and resolved issues for Zuora Reporting and the Zuora Insights add-on Zuora CPQ Release New features, enhancements, and resolved issues for Zuora Quotes and Zuora 360 Connect Marketplace New features, enhancements, and documentation updates for Zuora Connect NOTE: The features described in the release notes are available only from the Zuora API Sandbox environment. They are not yet available in the Zuora Production environment.

Jing · ‎08-23-2018

The release notes for Zuora Release 231, August 2018 are on our Knowledge Center! Release Schedule Subscribe to Release Notifications in Zuora Community to receive notifications about Zuora Application releases. Here are some highlights: REST API See API Changelog for a summary of REST API updates and documentation updates in the API Reference. Billing Default Value Changes for New Bill Runs Enhancement for Unposting Posted Billing Documents Payments Apple Pay Supported on CyberSource Payment API v2.0 Platform New Home Page for Easier Navigation Analytics New features, enhancements, and resolved issues for Zuora Reporting and the Zuora Insights add-on Zuora for Salesforce Release New features, enhancements, and resolved issues for Zuora Quotes and Zuora 360 Connect Marketplace New features, enhancements, and documentation updates for Zuora Connect NOTE: The features described in the release notes are available only from the Zuora API Sandbox environment. They are not yet available in the Zuora Production environment.

Jing · ‎08-10-2018

The release notes for Zuora Release 230, August 2018 are on our Knowledge Center! Release Schedule Subscribe to Release Notifications in Zuora Community to receive notifications about Zuora Application releases. Here are some highlights: REST API See API Changelog for a summary of REST API updates and documentation updates in the API Reference. Billing More Locale Support for Invoice PDF Localization Support for Controlling Electronic Payment Processing during Payment Run Execution Key Invoice Settlement Metrics Available in Customer Account Details Source Han Serif K for Invoice File Generation Payments CyberSource, Payment API v2.0 Gateway Supported SEPA Supported on CyberSource, Payment API v2.0 Analytics New features, enhancements, and resolved issues for Zuora Reporting and the Zuora Insights add-on Zuora for Salesforce Release New features, enhancements, and resolved issues for Zuora Quotes and Zuora 360 Connect Marketplace New features, enhancements, and documentation updates for Zuora Connect NOTE: The features described in the release notes are available only from the Zuora API Sandbox environment. They are not yet available in the Zuora Production environment.

Jing · ‎08-03-2018

If you set Auto Renew to Yes, a subscription automatically renews when its initial term comes to an end. Auto-renewals are triggered by an automatically generated renewal amendment. The amendment is created by Zuora Billing on the last day of the initial term at 07:00 UTC (Coordinated Universal Time) regardless of your tenant time zone. Your tenant’s renewal amendment will be triggered based on the system default time or your specified time. Note that the renewal amendment is processed asynchronously and Zuora does not guarantee the renewal to be completed within a certain time. Typically the renewal will be completed within a few hours. In this context, the best practice is to select the Automatically renew auto-renew subscriptions that are up for renewal check box when creating scheduled bill runs. Then, in the case that auto-renewals are delayed, the bill run can trigger the subscription renewal when billing is performed for the corresponding account.

Jing · ‎07-31-2018

Resolution: This error occurred because there is an Avalara limitation that a maximum of 15,000 items can be contained in one invoice. If an invoice contains more than 15,000 items and is sent to Avalara, the tax calculation request will fail and an error will be returned. Currently, the workaround is to split the invoice into smaller invoices with less than 15000 lines. For more information, see Avalara FAQs.

Jing · ‎07-31-2018

Issue description: When attempting to process an invoice with more than 15,000 items in Avalara Tax, the following error message was displayed: Zuora and Avalara both support 15,000 invoice items per invoice. If you require more than 15,000 invoice items per invoice, you will need to contact both Avalara and Zuora Support teams for further assistance.

Jing · ‎07-31-2018

I believe this operation has been deployed. Could you please submit a ticket at Zuora Global Support with full details about what you have tried? Thank you!

Jing · ‎07-19-2018

The release notes for Zuora Release 229, July 2018 are on our Knowledge Center! Release Schedule Subscribe to Release Notifications in Zuora Community to receive notifications about Zuora Application releases. Here are some highlights: REST API See API Changelog for a summary of REST API updates and documentation updates in the API Reference. Subscriptions set activation dates Button Unavailable for Active Subscriptions Orders Respecting Subscription Permissions Billing Support for Permanently Deleting Billing Document PDF Files Support for Embedding Images in Billing Document PDF Files Enhancement for Controlling the Regeneration of Billing Document PDF Files Analytics New features, enhancements, and resolved issues for Zuora Reporting and the Zuora Insights add-on Zuora for Salesforce Release New features, enhancements, and resolved issues for Zuora Quotes and Zuora 360 Connect Marketplace New features, enhancements, and documentation updates for Zuora Connect NOTE: The features described in the release notes are available only from the Zuora API Sandbox environment. They are not yet available in the Zuora Production environment.

Jing · ‎07-09-2018

The release notes for Zuora Release 228, July 2018 are on our Knowledge Center! Release Schedule Subscribe to Release Notifications in Zuora Community to receive notifications about Zuora Application releases. Here are some highlights: REST API See API Changelog for a summary of REST API updates and documentation updates in the API Reference. Billing Advanced AR Settlement Renamed to Invoice Settlement Support for Controlling Billing Documents Generation in Microsoft Word Analytics New features, enhancements, and resolved issues for Zuora Reporting and the Zuora Insights add-on Zuora for Salesforce Release New features, enhancements, and resolved issues for Zuora Quotes and Zuora 360 Connect Marketplace New features, enhancements, and documentation updates for Zuora Connect NOTE: The features described in the release notes are available only from the Zuora API Sandbox environment. They are not yet available in the Zuora Production environment.

Jing · ‎06-22-2018

This changelog outlines the latest REST API updates and documentation updates in the API Reference. The changelog is a work in progress and we would love to hear your feedback on how we can improve it. For convenience, we have disabled direct comments on this post. If you have any comments on the API Changelog, please go to the API Changelog Discussion post. Thank you! 2018-06-10 API Updates This section lists API operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 226, June 2018. Accounts - Made the following updates: Added the creditMemoTemplateId and debitMemoTemplateId fields to the request body of the following operations: Create account Update account Added the creditMemoTemplateId and debitMemoTemplateId fields to the basicInfo field in the response body of the “Get account” operation. Credit Memos - Added the gatewayId field to the request body of the “Refund credit memo” operation. Orders - Added the ProcessingOptions > ApplyCreditBalance field to the request body of the “Create order” operation. Doc Updates This section lists the documentation updates that were made in this version of the API Reference. In the “Create order” operation, made the following updates : Updated the JSON request and response samples for the following new field added to the request body: ProcessingOptions > ApplyCreditBalance In the request body, corrected the subscriptions > orderActions > updateProduct > chargeUpdates > billing > billingPeriodAlignment field from required to optional. In the description of the following country fields in the request body, clarified that this field is required for the use of the Zuora Tax feature: newAccont > soldToContact > country newAccont > billToContact > country subscriptions > orderActions > createSubscription > newSubscriptionOwnerAccount > billToContact > country subscriptions > orderActions > createSubscription > newSubscriptionOwnerAccount > soldToContact > country In the description of the following billCycleDay fields in the request body, clarified that when this field is set to 0 (zero), the bill cycle day is configured as “AutoSet”: newAccount > billCyleDay subscriptions > orderActions > createSubscriptions > newSubscriptionsOwnerAccount > billCycleDay In the source YAML file, changed the Contact reference object name to BillToContact in the newAccount > billToContact field definition of the request body. In the source YAML file, changed the Contact reference object name to SoldToContact in the newAccount > soldToContact field definition of the request body. In the source YAML file, changed the Contact reference object name to BillToContact in the definition of the subscriptions > orderActions > createSubscription > newSubscriptionOwnerAccount > billToContact field in the request body. In the source YAML file, changed the Contact reference object name to SoldToContact in the definition of the subscriptions > orderActions > createSubscription > newSubscriptionOwnerAccount > soldToContact field in the request body. In the “Preview order” operation, made the following updates: In the request body, corrected the previewAccountInfo > soldToContact field from required to optional. In the description of the following country fields in the request body, clarified that this field is required for the use of the Zuora Tax feature: previewAccountInfo > soldToContact > country subscriptions > orderActions > createSubscription > newSubscriptionOwnerAccount > billToContact > country subscriptions > orderActions > createSubscription > newSubscriptionOwnerAccount > soldToContact > country In the description of the following billCycleDay fields in the request body, clarified that when this field is set to 0 (zero), the bill cycle day is configured as “AutoSet”: previewAccountInfo > billCyleDay subscriptions > orderActions > createSubscriptions > newSubscriptionsOwnerAccount > billCycleDay In the source YAML file, changed the Contact reference object name to BillToContact in the definition of the subscriptions > orderActions > createSubscription > newSubscriptionOwnerAccount > billToContact field in the request body. In the source YAML file, changed the Contact reference object name to SoldToContact in the definition of the subscriptions > orderActions > createSubscription > newSubscriptionOwnerAccount > soldToContact field in the request body. In the source YAML file, specified that the zObject reference object has additional properties. In the source YAML file, specified that the zObject_update reference object extends the zObject reference object. Corrected the value of the creditmemos > referredInvoiceId field in the 200 response sample of the “Get credit memos” operation. In the “Subscribe” action, corrected the enum values of the PriceFormat field from Flat Fee to FlatFee and from Per Unit to PerUnit . Added the 200 response sample to the “CRUD: Retrieve Subscription” operation.

Jing · ‎06-21-2018

The release notes for Zuora Release 227, June 2018 are on our Knowledge Center! Release Schedule Subscribe to Release Notifications in Zuora Community to receive notifications about Zuora Application releases. Here are some highlights: REST API See API Changelog for a summary of REST API updates and documentation updates in the API Reference. Subscriptions Term Number for Order Metrics Data Sources Payments New REST API Operation to Scrub Sensitive Data Related to Payment Methods Analytics New features, enhancements, and resolved issues for Zuora Reporting and the Zuora Insights add-on Zuora for Salesforce Release New features, enhancements, and resolved issues for Zuora Quotes and Zuora 360 Connect Marketplace New features, enhancements, and documentation updates for Zuora Connect NOTE: The features described in the release notes are available only from the Zuora API Sandbox environment. They are not yet available in the Zuora Production environment.

Jing · ‎06-11-2018

The release notes for Zuora Release 226, June 2018 are on our Knowledge Center! Release Schedule Subscribe to Release Notifications in Zuora Community to receive notifications about Zuora Application releases. Here are some highlights: REST API See API Changelog for a summary of REST API updates and documentation updates in the API Reference. Billing Support for New Currency Venezuelan Bolivar Soberano Analytics New features, enhancements, and resolved issues for Zuora Reporting and the Zuora Insights add-on Zuora for Salesforce Release New features, enhancements, and resolved issues for Zuora Quotes and Zuora 360 Connect Marketplace New features, enhancements, and documentation updates for Zuora Connect NOTE: The features described in the release notes are available only from the Zuora API Sandbox environment. They are not yet available in the Zuora Production environment.

Jing · ‎05-18-2018

The release notes for Zuora Release 225, May 2018 are on our Knowledge Center! Release Schedule Subscribe to Release Notifications in Zuora Community to receive notifications about Zuora Application releases. Here are some highlights: REST API See API Changelog for a summary of REST API updates and documentation updates in the API Reference. Subscriptions Order Item for Usage Charge Type Billing Tax Calculation Enhancement in Advanced AR Settlement More Locales for Invoice PDF Localization Analytics New features, enhancements, and resolved issues for Zuora Reporting and the Zuora Insights add-on Zuora for Salesforce Release New features, enhancements, and resolved issues for Zuora Quotes and Zuora 360 Connect Marketplace New features, enhancements, and documentation updates for Zuora Connect NOTE: The features described in the release notes are available only from the Zuora API Sandbox environment. They are not yet available in the Zuora Production environment.

Jing · ‎05-09-2018

The release notes for Zuora Release 224, May 2018 are on our Knowledge Center! Release Schedule Subscribe to Release Notifications in Zuora Community to receive notifications about Zuora Application releases. Here are some highlights: REST API See API Changelog for a summary of REST API updates and documentation updates in the API Reference. Payments Field Updates in Hosted Payment Pages 2.0 Platform Enhanced User Interface for Sharing Custom Fields Analytics New features, enhancements, and resolved issues for Zuora Reporting and the Zuora Insights add-on Zuora for Salesforce Release New features, enhancements, and resolved issues for Zuora Quotes and Zuora 360 Connect Marketplace New features, enhancements, and documentation updates for Zuora Connect NOTE: The features described in the release notes are available only from the Zuora API Sandbox environment. They are not yet available in the Zuora Production environment.

Jing · ‎05-06-2018

Following Release 224, updates to the Zuora Application will be released on a twice-monthly schedule instead of a monthly schedule. Releases will continue to be deployed to APISandbox environments in advance of Production environments. The timing of releases will be adjusted as necessary to ensure that the Zuora Application does not change close to the end of a month. Subscribe to Release Notifications in Zuora Community to receive notifications about Zuora Application releases.

Jing · ‎04-17-2018

The April 2018 release notes are on our Knowledge Center! Release Schedule APISandbox Release Date: April 16, 2018 Production Release Date: April 23, 2018 Here are some highlights: REST API See API Changelog for a summary of REST API updates and documentation updates in the API Reference. Subscription Management Creating Pending Subscriptions in Orders Analytics New features, enhancements, and resolved issues for Zuora Reporting and the Zuora Insights add-on Zuora for Salesforce Release New features, enhancements, and resolved issues for Zuora Quotes and Zuora 360 Connect Marketplace New features, enhancements, and documentation updates for Zuora Connect NOTE: The features described in the release notes are available only from the Zuora API Sandbox environment. They are not yet available in the Zuora Production environment.

Jing · ‎03-22-2018

This changelog outlines the latest REST API updates and documentation updates in the Real-Time Usage Rating API and Custom Fields API. The Real-Time Usage Rating API and Custom Fields API are both in Limited Availability. 2018-08-10 Doc Updates This section lists the documentation updates that were made in this version of the API Reference. In the “Create usage records” operation, made the following updates: In the operation description, added a link to the aritcle Usage Data Import in Knowledge Center. In the request body, added more usage data verification information to the descriptions of the following fields: data > accountNumber data > tag data > unitOfMeasure 2018-07-11 API Updates This section lists API operations and fields that were added, changed, or removed in this version of the API Reference. Usage (with Real-Time Rating) - In the response body of the following operations, added a value IMPORTED_WITH_ERRORS to the status field and changed the COMPLETED_WITH_ERRORS value to VALIDATION_FAILED for this field: Import usage file Get usage imports Get details of usage import Get status of usage import Doc Updates This section lists the documentation updates that were made in this version of the API Reference. In the “Download usage import failure file” operation, updated the description of this operation to indicate that usage import failure files are only available for usage import files in VALIDATED_FAILED status. In the response body of the following operations, added detailed descriptions to each value of the status field: Import usage file Get usage imports Get details of usage import Get status of usage import In the description of the Custom Fields section, noted that custom field names are case sensitive. 2018-05-08 Doc Updates This section lists the documentation updates that were made in this version of the API Reference. In the description of the “Query usage records in stream” operation, added the standard restriction on the value of the filters parameter in the endpoint URL. 2018-04-22 API Updates This section lists API operations and fields that were added, changed, or removed in this version of the API Reference. Made the following updates to all operations: Added a new Zuora-Track-Id request header and a new Zuora-Track-Id response header. Removed the Zuora-Request-Id request header, which means that you now cannot control the value of the Zuora-Request-Id response header. You should use the new Zuora-Track-Id request and response headers instead. Doc Updates This section lists the documentation updates that were made in this version of the API Reference. Escaped single quotes in the Curl and PHP request samples for the “Set schema of custom fields definition in namespace” operation. 2018-04-16 Doc Updates This section lists the documentation updates that were made in this version of the API Reference. Added placeholders to represent custom fields in the request bodies of the following operations: Create usage records Update usage record Added placeholders to represent custom fields in the response bodies of the following operations: Get usage record Query usage records Query usage records in stream Changed the request sample of the “Set schema of custom fields definition in namespace” operation to only show custom fields of type string . Custom fields of core Zuora objects should only have type string . In the following operations, changed the response samples to only show custom fields of type string : Get all custom fields definitions in namespace Get custom fields definition in namespace Custom fields of core Zuora objects should only have type string . 2018-03-21 API Updates This section lists API operations and fields that were added, changed, or removed in this version of the API Reference. Usage (with Real-Time Rating) - In the “Download usage file template” operation, added a new value xls to the fileType path parameter. Doc Updates This section lists the documentation updates that were made in this version of the API Reference. In the “Import usage file” operation, updated the operation description to list Microsoft Excel ( .xls ) as a supported file format for usage files.

Jing · ‎03-16-2018

The March 2018 release notes are on our Knowledge Center! Release Schedule APISandbox Release Date: March 16, 2018 Production Release Date: March 21, 2018 Here are some highlights: REST API See API Changelog for a summary of REST API updates and documentation updates in the API Reference. Subscription Management Enhancements to Order Metrics Subscription Management Using Orders UI Billing and Payments Support for ACH Non-Referenced Refund for Merchant e-Solutions Support for Credit Card Non-Referenced Refund for Authorize.net PMU Batch Notification Email Enhancement Analytics New features, enhancements, and resolved issues for Zuora Reporting and the Zuora Insights add-on Zuora for Salesforce Release New features, enhancements, and resolved issues for Zuora Quotes and Zuora 360 Connect Marketplace New features, enhancements, and documentation updates for Zuora Connect. NOTE: The features described in the release notes are available only from the Zuora API Sandbox environment. They are not yet available in the Zuora Production environment.

Jing · ‎02-25-2018

The February 2018 Release Notes have been updated! Here is the latest highlight: Real-Time Usage Rating NOTE: The Real-Time Usage Rating feature is in Limited Availability. If you wish to have access to the feature, submit a request at Zuora Global Support. Zuora now provides a capability to rate or re-rate usage records in real time for existing usage charge models. You can create usage records through the REST API, or import usage files through the Zuora UI and REST API. With the Real-Time Usage Rating feature enabled, Zuora rates the usage records in near real-time when the usage records are created or imported into Zuora. You can also retrieve usage consumption information through the Zuora UI and REST API any time after new usage records are submitted. This feature provides near real-time usage rating with better scalability and real-time access to rated usage information. See Real-Time Usage Rating for more information.

Jing · ‎02-08-2018

The February 2018 release notes are on our Knowledge Center! Release Schedule APISandbox Release Date: February 07, 2018 Production Release Date: February 23, 2018 Here are some highlights: REST API See API Changelog for a summary of REST API updates and documentation updates in the API Reference. Platform Time Limit of Data in AQuA Job Finder Connect Marketplace New features, enhancements, and resolved issues for Zuora Connect Analytics New features, enhancements, and resolved issues for Zuora Reporting and the Zuora Insights add-on Zuora for Salesforce Release New features, enhancements, and resolved issues for Zuora Quotes and Zuora 360 Data Connect Early Adoption in Production NOTE: The features described in the release notes are available only from the Zuora API Sandbox environment. They are not yet available in the Zuora Production environment.

Jing · ‎09-18-2017

@ruffrey Thanks very much for your info. I've changed "deprecated" to "removed" to avoid further confusion. For the "v1" issue, it is actually specific to the Zuora API endpoint design. We have a new Community API feedback forum where you can share your opinions on how our APIs don't fit your purpose well. You could publish a separate post in the API feedback forum to express your concern about API versioning. Thanks.

Jing · ‎09-14-2017

@ruffrey "Deprecated" in this post means that all the current legacy methods and URLs will be "removed" in the April 2018 release, indicating that customers "cannot use them anymore" from then. Thanks!

Jing · ‎09-13-2017

To better standardize the REST APIs for the Advanced AR Settlement feature, Zuora is refactoring the HTTP methods and URLs for some operations. From the September 2017 release (R216) to December 2017 release (R219), both the legacy and new methods and URLs will be maintained for the following operations. In the October 2017 release (R217), the HTTP method and URL updates will be published to the REST API Reference. From the January 2018 release (R220) to March 2018 release (R222), only the new methods and URLs will be maintained for the following operations, but you can still use the legacy ones. In the April 2018 release (R223), all the legacy methods and URLs will be permanently removed for the following operations, indicating that you can only use the new ones. The following table describes the refactor details about the Advanced AR Settlement REST API methods and URLs. Operation New Method/URL Legacy Method/URL Transfer payment PUT /v1/payments/{paymentId}/transfer POST /v1/payments/{paymentId}/accounts Apply payment PUT /v1/payments/{paymentId}/apply POST /v1/payments/{paymentId}/apply Unapply payment PUT /v1/payments/{paymentId}/unapply POST /v1/payments/{paymentId}/unapply Cancel payment PUT /v1/payments/{paymentId}/cancel POST /v1/payments/{paymentId}/cancel Refund payment POST /v1/payments/{paymentId}/refunds POST /v1/payments/{paymentId}/refund Cancel refund PUT /v1/refunds/{refundId}/cancel POST /v1/refunds/{refundId}/cancel Apply credit memo PUT /v1/creditmemos/{creditMemoId}/apply POST /v1/creditmemos/{creditMemoId}/apply Unapply credit memo PUT /v1/creditmemos/{creditMemoId}/unapply POST /v1/creditmemos/{creditMemoId}/unapply Cancel credit memo PUT /v1/creditmemos/{creditMemoId}/cancel POST /v1/creditmemos/{creditMemoId}/cancel Post credit memo PUT /v1/creditmemos/{creditMemoId}/post POST /v1/creditmemos/{creditMemoId}/post Refund credit memo POST /v1/creditmemos/{creditmemoId}/refunds POST /v1/creditmemos/{creditmemoId}/refund Create credit memo from invoice POST /v1/invoices/{invoiceId}/creditmemos POST /v1/creditmemos/invoice/{invoiceId} Query credit memos by account N/A POST /v1/creditmemos/query Cancel debit memo PUT /v1/debitmemos/{debitMemoId}/cancel POST /v1/debitmemos/{debitMemoId}/cancel Post debit memo PUT /v1/debitmemos/{debitMemoId}/post POST /v1/debitmemos/{debitMemoId}/post Create debit memo from invoice POST /v1/invoices/{invoiceId}/debitmemos POST /v1/debitmemos/invoice/{invoiceId} Create taxation items for credit memo POST /v1/creditmemos/{creditMemoId}/taxationitems POST /v1/taxationitems/creditmemo/{memoId} Create taxation items for debit memo POST /v1/debitmemos/{debitMemoId}/taxationitems POST /v1/taxationitems/debitmemo/{memoId}

Happy Business Starts Here