5.x.x
Upgrading and Migrating Zuora Connector to 6.0.x
Upgrade Anypoint Connector for Zuora (Zuora Connector) to version 6.0.x.
Changes in This Release
This release contains new and changed operations, metadata, fields, and values.
New Operations
Zuora Connector 6.0.0 includes the following new operations:
New in Zuora 6.0.0 | |
---|---|
Name |
Description |
Generate an OAuth token |
Generates a bearer token that enables an OAuth client to authenticate with the Zuora REST API. |
Object POSTFeature |
This operation makes an HTTP POST request to the /v1/object/feature endpoint |
Get workflow task usage |
Gets workflow task usage sorted by day within a specified time frame. |
Object PUTFeature |
This operation makes an HTTP PUT request to the /v1/object/feature/{id} endpoint |
PUT Rev Pro Accounting Codes |
Update the Zuora Revenue accounting code that corresponds to a specific Product Rate Plan Charge Id in Zuora Billing. |
Update subscription custom fields of a specified subscription version |
Updates the custom fields of a specified subscription version. |
Removed Operations
The following operations were removed in Zuora Connector 6.0.0:
Removed in Zuora 6.0.0 | |
---|---|
Name |
Description |
Import usage file |
This operation makes an HTTP POST request to the /usage-imports endpoint |
Create usage records |
This operation makes an HTTP POST request to the /usage endpoint |
Request breakdown of credit memo items by order |
Retrieves specified credit memo items which are broken down by orders. |
Request breakdown of invoice items by order |
Retrieves the specified invoice items which are broken down by orders. |
Delete schema of Usage custom field definition |
This operation makes an HTTP DELETE request to the /fields/definitions/Usage endpoint |
CRUD: Delete payment method snapshot |
This REST API reference describes how to delete a Payment Method Snapshot. |
Get Usage custom field definition |
This operation makes an HTTP GET request to the /fields/definitions/Usage endpoint |
Get rating results by account |
This operation makes an HTTP GET request to the /rating/rated-results/account/{accountNumber} endpoint |
Get rating results by charge |
This operation makes an HTTP GET request to the /rating/rated-results/charge/{chargeNumber} endpoint |
Get rating results by subscription |
This operation makes an HTTP GET request to the /rating/rated-results/subscription/{subscriptionNumber} endpoint |
Get rated usage by account |
This operation makes an HTTP GET request to the /rating/rated-usages/account/{accountNumber} endpoint |
Get rated usage by charge |
This operation makes an HTTP GET request to the /rating/rated-usages/charge/{chargeNumber} endpoint |
Get rated usage by subscription |
This operation makes an HTTP GET request to the /rating/rated-usages/subscription/{subscriptionNumber} endpoint |
Get status of usage import |
Get details of usage import |
Download usage import failure file |
This operation makes an HTTP GET request to the /usage-imports/{id}/errors endpoint |
Download usage import file |
This operation makes an HTTP GET request to the /usage-imports/{id}/import-file endpoint |
Get status of usage import |
This operation makes an HTTP GET request to the /usage-imports/{id}/status endpoint |
Download usage file template |
This operation makes an HTTP GET request to the /usage-imports/templates/html endpoint |
Query usage records in stream |
This operation makes an HTTP GET request to the /usage/stream-query endpoint |
Get breakdown of credit memo by order |
Retrieves a specified credit memo that is broken down by orders. One credit memo item might be broken down into a list of order related items. |
Get breakdown of invoice by order |
Retrieves a specified invoice that is broken down by orders. One invoice item might be broken down into a list of order related items. |
Get rated result for order |
Retrieves the rated results of all the subscriptions in the specified order. |
Set schema of Usage custom field definition |
This operation makes an HTTP PUT request to the /fields/definitions/Usage endpoint |
Update usage record |
Updates certain information of a specified usage record. |
Changes in Operations Parameters
The following changes were made to these operations:
Existing in Zuora 5.x | Modified in Zuora 6.x | ||||
---|---|---|---|---|---|
Operation Name |
Input Params |
Output Params |
Operation Name |
Input Params |
Output Params |
Create Credit Memo From Charge |
N/A |
N/A |
Create Credit Memo From Charge |
N/A |
taxStatus (Added) taxMessage (Added) |
Get Credit Memo |
N/A |
N/A |
Get Credit Memo |
N/A |
taxStatus (Added) taxMessage (Added) |
Update Credit Memo |
N/A |
N/A |
Update Credit Memo |
N/A |
taxStatus (Added) taxMessage (Added) |
Apply Credit Memo |
N/A |
N/A |
Apply Credit Memo |
N/A |
taxStatus (Added) taxMessage (Added) |
Unapply Credit Memo |
N/A |
N/A |
Unapply Credit Memo |
N/A |
taxStatus (Added) taxMessage (Added) |
Cancel Credit Memo |
N/A |
N/A |
Cancel Credit Memo |
N/A |
taxStatus (Added) taxMessage (Added) |
Post Credit Memo |
N/A |
N/A |
Post Credit Memo |
N/A |
taxStatus (Added) taxMessage (Added) |
Unpost Credit Memo |
N/A |
N/A |
Unpost Credit Memo |
N/A |
taxStatus (Added) taxMessage (Added) |
Get Credit Memos |
N/A |
N/A |
Get Credit Memos |
N/A |
taxStatus (Added under creditmemos) taxMessage (Added under creditmemos) |
Create Debit Memo From Charge |
N/A |
N/A |
Create Debit Memo From Charge |
accountNumber (Added) (conditionally required) accountId (conditionally required) |
N/A |
Create Debit Memo From Charge |
N/A |
N/A |
Create Debit Memo From Charge |
N/A |
taxStatus (Added) taxMessage (Added) |
Get Debit Memo |
N/A |
N/A |
Get Debit Memo |
N/A |
taxStatus (Added) taxMessage (Added) |
Update Debit Memo |
N/A |
N/A |
Update Debit Memo |
N/A |
taxStatus (Added) taxMessage (Added) |
Cancel Debit Memo |
N/A |
N/A |
Cancel Debit Memo |
N/A |
taxStatus (Added) taxMessage (Added) |
Post Debit Memo |
N/A |
N/A |
Post Debit Memo |
N/A |
taxStatus (Added) taxMessage (Added) |
Unpost Debit Memo |
N/A |
N/A |
Unpost Debit Memo |
N/A |
taxStatus (Added) taxMessage (Added) |
Get Debit Memos |
N/A |
N/A |
Get Debit Memos |
N/A |
taxStatus (Added under debitmemos) taxMessage (Added under debitmemos) |
Create Credit Memo From Invoice |
N/A |
N/A |
Create Credit Memo From Invoice |
items (Added under quantity) |
taxStatus (Added) taxMessage (Added) |
Create Debit Memo From Invoice |
N/A |
N/A |
Create Debit Memo From Invoice |
items (Added under quantity) |
taxStatus (Added) taxMessage (Added) |
Submit Data Query |
outputFormat (JSON) |
N/A |
Submit Data Query |
TSV (Added under outputFormat) DSV (Added under outputFormat) outputFormat (JSONL) columnSeparator (Added) useIndexJoin (Added) readDeleted (Added) |
N/A |
Create Subscription |
N/A |
N/A |
Create Subscription |
gatewayId (Added) paymentMethodId (Added) |
N/A |
Cancel Authorization |
accountId accountNumber |
N/A |
Cancel Authorization |
paymentGatewayId (Added) (Optional) accountId (Modified) (Optional) accountNumber (Modified) (Optional) |
N/A |
Return Hosted Pages |
pageSize nextPage |
N/A |
Return Hosted Pages |
pageSize (Removed) nextPage (Removed) |
N/A |
Preview Order |
N/A |
N/A |
Preview Order |
description (Added) paymentMethod (Added under newSubscriptionOwnerAccount) chargeModelData (Added under various fields) |
N/A |
Preview Order Asynchronously |
N/A |
N/A |
Preview Order Asynchronously |
description (Added) paymentMethod (Added under newSubscriptionOwnerAccount) chargeModelData (Added under various fields) |
N/A |
Create Order |
N/A |
N/A |
Create Order |
description (Added) paymentMethod (Added to various fields) chargeModelData (Added under various fields) |
N/A |
Create Order Asynchronously |
N/A |
N/A |
Create Order Asynchronously |
description (Added) paymentMethod (Added to various fields) chargeModelData (Added under various fields) |
N/A |
Get All Orders |
N/A |
N/A |
Get All Orders |
description (Added under orders) paymentMethod (Added under newSubscriptionOwnerAccount) chargeModelData (Added under pricing) |
N/A |
Get Orders By Subscription Owner |
N/A |
N/A |
Get Orders By Subscription Owner |
description (Added under orders) paymentMethod (Added under newSubscriptionOwnerAccount) chargeModelData (Added under pricing) |
N/A |
Get Orders By Subscription Number |
N/A |
N/A |
Get Orders By Subscription Number |
description (Added under orders) paymentMethod (Added under newSubscriptionOwnerAccount) chargeModelData (Added under pricing) |
N/A |
Get Orders By Invoice Owner |
N/A |
N/A |
Get Orders By Invoice Owner |
description (Added under orders) paymentMethod (Added under newSubscriptionOwnerAccount) chargeModelData (Added under pricing) |
N/A |
Get An Order |
N/A |
N/A |
Get An Order |
description (Added under order) paymentMethod (Added under newSubscriptionOwnerAccount) chargeModelData (Added under pricing) |
N/A |
Get Order Metrics For Evergreen Subscription |
N/A |
N/A |
Get Order Metrics For Evergreen Subscription |
description (Added under order) paymentMethod (Added under newSubscriptionOwnerAccount) chargeModelData (Added under pricing) |
N/A |
Create Account |
N/A |
N/A |
Create Account |
paymentMethod (Added) |
N/A |
Create Payment Method |
N/A |
N/A |
Create Payment Method |
IBAN (Added) businessIdentificationCode (Added) accountNumber (Added) identityNumber (Added) bankCode (Added) branchCode (Added) SEPA (Added under type) Betalingsservice (Added under type) Autogiro (Added under type) Bacs (Added under type) |
N/A |
Query Custom Object Records |
N/A |
N/A |
Query Custom Object Records |
ids (Added query parameter) |
N/A |
Update invoices |
N/A |
N/A |
Update invoices |
invoiceDate (Added under invoices) |
N/A |
Crud: Post or Cancel Build Run |
N/A |
N/A |
Crud: Post or Cancel Build Run |
invoiceDate (Added) |
N/A |
Create Sequence Set |
N/A |
N/A |
Create Sequence Set |
payment (Added under sequenceSets) refund (Added under sequenceSets) |
payment (Added under sequenceSets) refund (Added under sequenceSets) |
Update Sequence Set |
N/A |
N/A |
Update Sequence Set |
payment (Added) refund (Added) |
N/A |
Get Sequence Set |
N/A |
N/A |
Get Sequence Set |
N/A |
payment (Added under sequenceSets) refund (Added under sequenceSets) |
Get Sequence Set |
N/A |
N/A |
Get Sequence Set |
N/A |
payment (Added under sequenceSets) refund (Added under sequenceSets) |
Update Custom Object Definition |
N/A |
N/A |
Update Custom Object Definition |
required (Added) Zuora-Version (Added header parameter) |
required (Added) |
Get All Custom Object Definitions |
N/A |
N/A |
Get All Custom Object Definitions |
Zuora-Version (Added header parameter) |
filterable (Added) |
Create Custom Object Definition |
N/A |
N/A |
Create Custom Object Definition |
filterable (Added) Zuora-Version (Added header parameter) |
filterable (Added) |
Get Custom Object Definition |
N/A |
N/A |
Get Custom Object Definition |
Zuora-Version (Added header parameter) |
filterable (Added) |
Delete Custom Object Definition |
N/A |
N/A |
Delete Custom Object Definition |
Zuora-Version (Added header parameter) |
N/A |
Create Custom Object Records |
N/A |
N/A |
Create Custom Object Records |
Zuora-Version (Added header parameter) |
N/A |
Query Custom Object Records |
N/A |
N/A |
Query Custom Object Records |
Zuora-Version (Added header parameter) |
N/A |
Get Custom Object Record |
N/A |
N/A |
Get Custom Object Record |
Zuora-Version (Added header parameter) |
N/A |
Update Custom Object Record |
N/A |
N/A |
Update Custom Object Record |
Zuora-Version (Added header parameter) |
N/A |
Update Individual Fields In A Custom Object Record |
N/A |
N/A |
Update Individual Fields In A Custom Object Record |
Zuora-Version (Added header parameter) |
N/A |
Delete Custom Object Record |
N/A |
N/A |
Delete Custom Object Record |
Zuora-Version (Added header parameter) |
N/A |
Update Or Delete Custom Object Records As A Batch |
N/A |
N/A |
Update Or Delete Custom Object Records As A Batch |
Zuora-Version (Added header parameter) |
N/A |
Update Invoice |
N/A |
N/A |
Update Invoice |
invoiceDate (Added) |
N/A |
Refund Credit Memo |
N/A |
N/A |
Refund Credit Memo |
gatewayOptions (Added) |
N/A |
Refund Payment |
N/A |
N/A |
Refund Payment |
gatewayOptions (Added) |
N/A |
Preview Subscription |
N/A |
N/A |
Preview Subscription |
chargeModelConfiguration (Added under chargeOverrides) |
N/A |
Create Subscription |
N/A |
N/A |
Create Subscription |
chargeModelConfiguration (Added under chargeOverrides) |
N/A |
Update Subscription |
N/A |
N/A |
Update Subscription |
chargeModelConfiguration (Added under chargeOverrides and chargeUpdateDetails) |
N/A |
Get Subscription By Account |
N/A |
N/A |
Get Subscription By Account |
chargeModelConfiguration (Added under ratePlanCharges) |
N/A |
Get Subscriptions By Key |
N/A |
N/A |
Get Subscriptions By Key |
chargeModelConfiguration (Added under ratePlanCharges) |
N/A |
Get Subscriptions By Key And Version |
N/A |
N/A |
Get Subscriptions By Key And Version |
chargeModelConfiguration (Added under ratePlanCharges) |
N/A |
All Actions Operations |
N/A |
N/A |
All Actions Operations |
rejectUnknownFields (Added queryParameter) |
N/A |
All Crud Post Operations |
N/A |
N/A |
All Crud Post Operations |
rejectUnknownFields (Added queryParameter) |
N/A |
All Crud Put Operations |
N/A |
N/A |
All Crud Put Operations |
rejectUnknownFields (Added queryParameter) |
N/A |
Upgrade Prerequisites
Before you perform the upgrade, you must:
-
Create a backup of your files, data, and configuration in case you need to restore to the previous version.
-
Install Zuora Connector to replace the Zuora operations that were previously included in Zuora Connector 5.x.x.
Upgrade Steps
Follow these steps to perform the upgrade to Zuora Connector 6.0.0:
-
In Studio, create a Mule project.
-
In the Mule Palette view, click Search in Exchange.
-
In Add Modules to Project, type 'Zuora' in the search field.
-
In Available modules, select Zuora Connector, and then click Add.
-
Click Finish.
-
Verify that the
zuora-connector
dependency version is6.0.0
in thepom.xml
.
Anypoint Studio upgrades the connector automatically.
Verify the Upgrade
After you install the latest version of the connector, follow these steps to verify the upgrade:
-
In Anypoint Studio, verify that there are no errors in the Problems or Console views.
-
If you’re running the app from Anypoint Platform, the output is visible in the Anypoint Studio console window.
-
If you’re running the app using Mule from the command line, the app log is visible in your OS console.
Unless the log file path is customized in the app’s log file (
log4j2.xml
), you can also view the app log in the default locationMULE_HOME/logs/<app-name>.log
.
-
-
Check the project
pom.xml
and verify that there are no problems. -
Test the connection and verify that the operations work.
Troubleshooting
If there are problems with caching the parameters and caching the metadata, try restarting Anypoint Studio.
Reverting the Upgrade
If it is necessary to revert to the previous version of Zuora Connector, change the zuora-connector
dependency version 6.0.0
in the project’s pom.xml
to the previous version.
You must update the project’s pom.xml
in Anypoint Studio.