This changelog outlines the latest REST API updates and documentation updates in the   API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to   docs@zuora.com. Thank you!   2019-10-16   API Updates   This section lists operations and fields that were added, changed, or removed.   The following API updates are available as of Zuora Billing Release 259, October 2019. Subscriptions   - Added the following fields to the request body of the "Create subscription" operation: gatewayId paymentMethodId Workflows   - Added the following operations: Run a workflow Import a workflow Export a workflow Get tasks Get a task by ID Update tasks in batch ... View more

This changelog outlines the latest REST API updates and documentation updates in the API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to docs@zuora.com. Thank you!   2019-10-10   API Updates   This section lists operations and fields that were added, changed, or removed.   The following API updates are available as of Zuora Billing Release 258, October 2019.   Custom Object Definitions -  Added a resource called "Custom Object Definitions", with the following operations : Get all namespaces Get namespace Get all custom object definitions in namespace Create custom object definition Get custom object definition Delete custom object definition Update custom object definition Custom Object Records -  Added a resource called "Custom Object Records", with the following operations : Create custom object records Query custom object records Get custom object record Update custom object record Update individual fields in a custom object record Delete custom object record Update or delete custom object records as a batch Settings -  Added a resource called "Settings", with the following operations : List all settings Submit multiple settings requests as a batch Data Queries -  In the request body of the "Submit data query" operation, changed the  JSON  value of the  outputFormat  field to  JSONL .    Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   In the request body of the "Preview order" operation, added descriptions for the subscriptions > orderActions > updateProduct > chargeUpdates field. In the request body of the "Amend" action, updated the description of the requests > Amendments > Type field. In the request body of the "Subscribe" action, updated the description of the subscribes > Account > DefaultPaymentMethodId field. In the "Create order" operation, added the missing query parameter returnIds and the following missing response fields: orderId accountId subscriptionIds subscriptions > subscriptionId invoiceIds creditMemoIds paymentId In the following operations, corrected the data type to  number  for all fields that previously had the  string <decimal>  data type. Preview subscription Create subscription Get subscriptions by account Update subscription Get subscriptions by key Get subscriptions by key and version Renew subscription Cancel subscription Resume subscription Suspend subscription In the "Create revenue schedule on subscription charge" operation, updated the description to clarify that a maximum of 3,000 revenue schedules can be created for one subscription charge. In the "Get custom foreign currency exchange rates" operation, updated the request sample and the response sample. In the description of the "Generate an OAuth token" operation, added more details about the rate limit of the operation. In the Introduction section, added links to Zuora Collect API Reference and RevPro API Reference. Added a section called Usage (With Active Rating), containing the following operations. Previously, these operations were documented on a separate page. Create usage records Update usage record Get usage record Delete usage record Query usage records Query usage records in stream Import usage file Get usage imports Get details of usage import Get status of usage import Download usage import file Download usage import failure file Download usage file template Get rating results by account Get rating results by subscription Get rating results by charge Get rated usage by account Get rated usage by subscription Get rated usage by charge Get Usage custom field definition Set schema of Usage custom field definition Delete schema of Usage custom field definition ... View more

This changelog outlines the latest REST API updates and documentation updates in the API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to docs@zuora.com. Thank you!   2019-09-19   API Updates   This section lists operations and fields that were added, changed, or removed.   The following API updates are available as of Zuora Billing Release 257, September 2019.   Credit Memos - Made the following updates: In the request body of the "Create credit memo from charge" operation: Changed the behavior of the charges > chargeId field. The availability of this field now depends on the zuora-version request header. Added the produceRatePlanChargeId nested field to the charges field. The new field is only available if you set the zuora-version request header to 257.0 or later. Changed the behavior of the charges > comment field. The availability of this field now depends on the zuora-version request header. Added the description nested field to the charges field. The new field is only available if you set the zuora-version request header to 257.0 or later. In the response body of the "Get credit memo items" operation: Changed the behavior of the items > comment field. The availability of this field now depends on the zuora-version request header. Added the description nested field to the items field. The new field is only available if you set the zuora-version request header to 257.0 or later. In the response body of the "Get credit memo item" operation: Changed the behavior of the comment field. The availability of this field now depends on the zuora-version request header. Added the description field. This field is only available if you set the zuora-version request header to 257.0 or later. Debit Memos - Made the following updates: In the request body of the "Create debit memo from charge" operation: Changed the behavior of the charges > chargeId field. The availability of this field now depends on the zuora-version request header. Added the produceRatePlanChargeId nested field to the charges field. The new field is only available if you set the zuora-version request header to 257.0 or later. Changed the behavior of the charges > comment field. The availability of this field now depends on the zuora-version request header. Added the description nested field to the charges field. The new field is only available if you set the zuora-version request header to 257.0 or later. In the response body of the "Get debit memo items" operation: Changed the behavior of the items > comment field. The availability of this field now depends on the zuora-version request header. Added the description nested field to the items field. The new field is only available if you set the zuora-version request header to 257.0 or later. In the response body of the "Get debit memo item" operation: Changed the behavior of the comment field. The availability of this field now depends on the zuora-version request header. Added the description field. This field is only available if you set the zuora-version request header to 257.0 or later. Invoices - Made the following updates: In the request body of the "Create credit memo from invoice" operation: Changed the behavior of the items > comment field. The availability of this field now depends on the zuora-version request header. Added the description nested field to the items field. The new field is only available if you set the zuora-version request header to 257.0 or later. In the request body of the "Create debit memo from invoice" operation: Changed the behavior of the items > comment field. The availability of this field now depends on the zuora-version request header. Added the description nested field to the items field. The new field is only available if you set the zuora-version request header to 257.0 or later.   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   Moved the “Get the revenue automation start date” operation from the "Settings" section to the “Revenue rules” section. Removed the deprecated "Get billing information for order" operation. ... View more

This changelog outlines the latest REST API updates and documentation updates in the API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to docs@zuora.com. Thank you!   2019-09-11   API Updates   This section lists operations and fields that were added, changed, or removed.   The following API updates are available as of Zuora Billing Release 256, September 2019.   Data Queries  - In the request body of the "Submit data query" operation, made the following updates: Added TSV and DSV to the enum values of the outputFormat field. Added the columnSeparator field. Use this field to pass in your custom delimiter when you set the outputFormat field to DSV .   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   In the 200 response body of the "Submit data query" operation, added descriptions for the enum values of the data > queryStatus field. Added the missing "CRUD: Update rate plan charge" operation. In the "CRUD: Update invoice" operation, corrected the request example. ... View more

This changelog outlines the latest REST API updates and documentation updates in the API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to docs@zuora.com. Thank you!   2019-08-28   API Updates   This section lists operations and fields that were added, changed, or removed.   The following API updates are available as of Zuora Billing Release 255, August 2019. Credit Memos - Made the following updates: In the response body of the following operations, added the taxStatus and taxMessage fields: Create credit memo from charge Get credit memo Update credit memo Apply credit memo Unapply credit memo Cancel credit memo Post credit memo Unpost credit memo In the response body of the "Get credit memos" operation, added the following fields to the creditmemos field: taxStatus taxMessage Debit Memos - Made the following updates: In the request body of the "Create debit memo from charge" operation: Added the accountNumber field. Changed the behavior of accountId field. This field is now conditionally required. You must specify accountNumber , accountId , or both in the request body. In the response body of the following operations, added the taxStatus and taxMessage fields: Create debit memo from charge Get debit memo Update debit memo Cancel debit memo Post debit memo Unpost debit memo In the response body of the "Get debit memos" operation, added the following fields to the debitmemos field: taxStatus taxMessage Invoices - In the response body of the following operations, added the taxStatus and taxMessage fields: Create credit memo from invoice Create debit memo from invoice   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference. In the request body of the following operations, added the missing ProductRatePlanChargeTierData field and its nested fields: CRUD: Create product rate plan charge CRUD: Update product rate plan charge In the request sample of the following operations, removed the ProductRatePlanChargeTierData > ProductRatePlanChargeTier > Active field: CRUD: Create product rate plan charge CRUD: Update product rate plan charge Added the missing “CRUD: Update ProductRatePlanChargeTier” operation. In the “Get credit card payment methods for account” operation, updated the description to clarify that the response does not include effective details for ACH payment methods if this operation is used to get ACH payment methods. ... View more

This changelog outlines the latest REST API updates and documentation updates in the API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to docs@zuora.com. Thank you!   2019-08-15   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   In the "Amend" action, added the following missing fields to the requests > Amendments field in the request body: ResumeDate SuspendDate ... View more

This changelog outlines the latest REST API updates and documentation updates in the API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to docs@zuora.com. Thank you!   2019-08-08   API Updates   This section lists operations and fields that were added, changed, or removed.   The following API updates are available as of Zuora Release 253, July 2019.   Workflows - Added a new resource called “Workflows”, with   the “Get workflows” operation for retrieving workflows on a tenant . Filters can be used to retrieve specific workflows. If no filters are specified, all workflows will be returned.   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   Added more information about the REST endpoint base UL of the US Production Copy Environment . In the "Create payment method" operation, corrected the names of the following fields: bankAccountName bankAccountNumber bankAccountType bankName Previously, they were incorrectly documented as: achBankAccountName achBankAccountNumber achBankAccountType achBankName ... View more

This changelog outlines the latest REST API updates and documentation updates in the API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to docs@zuora.com. Thank you!   2019-08-01   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   Added the missing Zuora-Entity-Ids request header in the following operations: Get revenue recognition rule by product rate plan charge Create revenue schedule for credit memo item (manual distribution) Get revenue schedule by credit memo item ID Create revenue schedule for credit memo item (distribute by date range) Create revenue schedule for debit memo item (manual distribution) Get revenue schedule by debit memo item ID Create revenue schedule for debit memo item (distribute by date range) Get all revenue schedules of product charge by charge ID and billing account ID In the request body of the “Create stored credential profile” operation, added the missing networkTransactionId field. In the request body of the "CRUD: Update account" operation, corrected the descriptions of the following fields: Currency Status In the response body of the "CRUD: Get account" operation, corrected the descriptions of the Status field. In the request body of the "CRUD: Create account" operation, corrected the descriptions of the Status field. In the Zuora Object Model section, added more information about the differnces between the BillingRun object and BillRun object. In the response body of the "CRUD: Get payment method" operation, updated the description of the Active and PaymentMethodStatus fields to distinguish them. In the request body of the "CRUD: Update payment method" operation, updated the description of the PaymentMethodStatus field for better clarity. ... View more

This changelog outlines the latest REST API updates and documentation updates in the API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to docs@zuora.com. Thank you!   2019-07-26   API Updates   This section lists operations and fields that were added, changed, or removed.   The following API updates are available as of Zuora Release 252, July 2019.   Credit Memos - Changed the behavior of the "Apply credit memo" operation. You can now use this operation to perform the following operations: Apply negative credit memo items to negative invoice items or debit memo items. Apply negative credit memo items to the taxation items of negative invoice items or debit memo items. Apply the taxation items of negative credit memo items to negative invoice items or debit memo items. Apply the taxation items of negative credit memo items to those of negative invoice items or debit memo items. Debit Memos - Changed the behavior of the "Create debit memo from charge" operation. You can now use this operation to create negative debit memo items from negative product rate plan charges. Invoices - Changed the behavior of the "Create debit memo from invoice" operation. You can now use this operation to create negative debit memo items from negative invoice items.   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   In the "Create payment method" operation, made the following updates: Added the following missing fields to the request body: bankABACode achBankAccountName achBankAccountNumber achBankAccountType achBankName addressLine1 addressLine2 phone city country state zipCode Clarified that these fields are applicable to ACH payment methods. In the "Get revenue schedule by invoice item adjustment" operation, corrected the description of the invoice-item-adj-key path parameter. In the code sample of the request body for the following operations: Create revenue schedule for credit memo item (distribute by date range) Create revenue schedule for debit memo item (distribute by date range) Made the following updates: Removed the redundant top-level application/json field. Corrected the eventType and eventTypeSystemId field to avoid confusion. In the request body of the following operations, corrected the data type of the billingCycleDay field to string : Create payment run Update payment run In the response body of the "Get payment run" operation, corrected the data type of the billingCycleDay field to string . ... View more

This changelog outlines the latest REST API updates and documentation updates in the API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to docs@zuora.com. Thank you!   2019-07-21   API Updates   This section lists operations and fields that were added, changed, or removed.   The following API updates are available as of Zuora Release 251, July 2019.   Contacts - Changed the behavior of the “Scrub contact” operation. The value of the country field becomes null instead of 0 after scrubbing as of this release.   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   In the request body of the "CRUD: Create usage", made the following updates: Added the following missing fields: ChargeNumber Description SubscriptionNumber Removed the unsupported Rbestatus field. In the response body of the "CRUD: Create usage", added the following missing fields: Description SubscriptionNumber ... View more

This changelog outlines the latest REST API updates and documentation updates in the API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to docs@zuora.com. Thank you!   2019-07-11   API Updates   This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 250, July 2019.   Invoices - In the request body of the "CRUD: Update invoice" operation, changed the behavior of the RegenerateInvoicePDF field by adding a limit that you can use this field to regenerate PDF files for the same invoice for at most 100 times.   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   In the request body of the "CRUD: Update invoice" operation, added the missing RegenerateInvoicePDF field. In the description of the "Create authorization" operation, made the following updates: Clarified the subsequent operations as part of the Delayed Capture feature. Added a known limitation of the Delayed Capture feature. In the description of the "CRUD: Create payment" operation, clarified that this operation cannot work if the Invoice Settlement feature is enabled. In the request body of the "CRUD: Create payment method" operation, removed the MitProfileAgreedOn field. The details of this field are moved to the PaymentMethod article in Zuora's Knowledge Center. In the request body of the "Amend" action, updated the description of the requests > Amendments > ServiceActivationDate field to add more information about how to use this field. In the request body of the "CRUD: Update amendment" operation, updated the description of the ServiceActivationDate field to add more information about how to use this field. In the response body of the "CRUD: Get amendment" operation, updated the description of the ServiceActivationDate field to add more information about how to use this field. Corrected the endpoints of the following asynchronous Orders operations: Preview order asynchronously Create order asynchronously Get job status and response ... View more

This changelog outlines the latest REST API updates and documentation updates in the API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to docs@zuora.com. Thank you!   2019-07-04   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   In the response body of the "Get account" operation, added the following missing nested fields to the metrics fields: totalDebitMemoBalance unappliedPaymentAmount unappliedCreditMemoAmount In the 200 response body of the "CRUD: Get payment" operation, added the missing Processing enum value to the Status field. In the request body of the "CRUD: Create payment method" operation, made the following updates: Added the missing BankTransferAccountName , BankTransferAccountNumber , and BankTransferAccountNumberMask fields. Added the missing SEPA enum value for the BankTransferType field. In the response body of the "CRUD: Get payment method" operation, made the following updates: Added the missing BankTransferAccountNumber field. Added the missing SEPA enum value for the BankTransferType field. In the request body of the "Amend" action, updated the description of the requests > Amendments > CustomerAcceptanceDate field to add more information about how to use this field. In the request body of the "CRUD: Update amendment" operation, updated the description of the CustomerAcceptanceDate field to add more information about how to use this field. In the response body of the "CRUD: Get amendment" operation, updated the description of the CustomerAcceptanceDate field to add more information about how to use this field. ... View more

This changelog outlines the latest REST API updates and documentation updates in the API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to docs@zuora.com. Thank you!   2019-06-28   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   In the request body of the “Create a notification definition” operation, added an example of how to get the communication profile Id to the description of the communicationProfileId field. In the request body of the following operations, updated the description of the subscriptions > orderActions > updateProduct > specificUpdateDate field to add more information about how to use this field: Create order Preview order In the response body of the following operations, updated the description of the order ( orders ) > subscriptions > orderActions > updateProduct > specificUpdateDate field to add more information about how to use this field: Get an order Get all orders Get orders by subscription owner Get orders by subscription number Get orders by invoice owner Get order metrics for evergreen subscription In the description of the "Create authorization" and "Cancel authorization" operations, added the missing "Chase Paymentech Orbital" and "Ingenico ePayments" to the payment gateways that support both operations. ... View more

This changelog outlines the latest REST API updates and documentation updates in the API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to docs@zuora.com. Thank you!   2019-06-20   API Updates   This section lists operations and fields that were added, changed, or removed.   The following API updates are available as of Zuora Release 249, June 2019.   Payment Methods - Added the cardSecurityCode field in the request body of the “Create stored credential profile” operation.   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   In the request body of the “Subscribe” action, added the description for the subscribes > PreviewOptions > EnablePreviewMode field as a workaround to avoid potential charges for payment method validation in subscription and amendment previews. In the descriptions of the "Create order" and "Preview order" operations, added notes to inform customers about the limits on Orders. In the Authorization header parameter of the following operations, added the description that the OAuth token must be regenerated after the Notification and the Configurable Event features are enabled in your Zuora tenant: Create a notification definition Query notification definitions Update a notification definition Get a notification definition Delete a notification definition Create an email template Query email templates Update an email template Get an email template Delete an email template In the eventCategory query parameter of the following operations, added the description that two formats are supported: Get callout notification histories Get email notification histories In the response body of the "Get account" operation, added the missing sequenceSetId nested field to the basicInfo field. Corrected the endpoint URL of the "Upload file for invoice" operation to /v1/invoices/{invoice-id}/files . Corrected the endpoint URL of the "Upload file for credit memo" operation to /v1/creditmemos/{creditMemoId}/files . Corrected the endpoint URL of the "Upload file for debit memo" operation to /v1/debitmemos/{debitMemoId}/files . In the following operations, changed the path parameter name from invoice-id to invoiceId . Get invoice files Get invoice items In the “Get taxation items of invoice item” operation, changed the following path parameter names: Changed invoice-id to invoiceId Changed item-id to itemId In the response body of the "Get product catalog" operation, corrected the URL example in the description of the products > productRatePlans field. In the response body of the "Get product" operation, corrected the URL example in the description of the productRatePlans field. ... View more

This changelog outlines the latest REST API updates and documentation updates in the API Reference. We would love to hear your feedback on how we can improve it. If you have any comments on the API Changelog, please send an e-mail to docs@zuora.com. Thank you!   2019-06-12   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   In the request body of the "CRUD: Update payment method" operation, updated the note of the AccountId field to say that, if a payment method is already associated with a customer account, you cannot update the payment method to associate it with another account ID. In the request body of the "Create credit card payment method" operation, corrected the cardHolderInfo > cardHolderName field from optional to required. In the introduction of the "Create payment method" operation, updated the description for the credit card method to emphasize that the cardHolderInfo > cardHolderName field in the request body is required for this type of payment method. In the descriptions of the following actions, added the limitations of supported object types: Create Update In the “Write off invoice” operation, simplified the request example. In the response body of the “CRUD: Get rate plan charge” operation, corrected ServiceActivationDate to ServiceActivation in the description of the TriggerEvent field. ... View more

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!   2019-05-27   API Updates   This section lists operations and fields that were added, changed, or removed.   The following API updates are available as of Zuora Release 247, May 2019.   Contacts - Changed the behavior of the “CRUD: Update contact” operation. You can now edit contacts for canceled accounts.   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   In the response body of the “Get product catalog” operation, noted the array size limit to the description of the products > productRatePlans field. In the response body of the “Get product” operation, noted the array size limit to the description of the productRatePlans field. In the “Upload file for credit memo” operation, changed the path parameter name from id to creditMemoId . In the “Upload file for debit memo” operation, changed the path parameter name from id to debitMemoId . In the “Upload file for invoice” operation, changed the path parameter name from id to invoiceId . In the response body of the Update action, corrected the type of the fieldsToNull nested field from string to array . In the source YAML file, renamed the CreatePMPayPalEC&PayPalNativeEC reference object to CreatePMPayPalECPayPalNativeEC . ... View more

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!   2019-05-20   API Updates   This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 246, May 2019.   Contacts   - Added a new operation called “Scrub contact”. Credit Memos   - Added a new operation called “Upload file for credit memo”. Debit Memos   - Added a new operation called “Upload file for debit memo”. Invoices   - Made the following updates: Added a new operation called “Upload file for invoice”. In the response body of the “Get invoice items” operation, added the availableToCreditAmount nested field to the invoiceItems field and invoiceItems >   taxationItems   >   data   field. In the response body of the “Get taxation items of invoice item” operation, added the   availableToCreditAmount  nested  field to the   data   field. Accounts   - Changed the behavior of the “Generate billing documents by account” operation. You can now generate billing documents for all subscriptions except for cancelled and suspended subscriptions. Previously, you could only generate billing documents for active subscriptions. Payment Methods   - Made the following updates: Removed the   networkTransactionId   field from the response body of the “Get stored credential profiles” operation. Added the   mitProfileAgreedOn   field to the request body of the following operations: Create payment method Create credit card payment method Added the   agreedOn   field to the request body of the “Create Stored Credential Profile” operation. Added the   MitProfileAgreedOn   field to the request body of the “CRUD: Create payment method” operation. Payment Gateway Reconciliation   - Added the Payment Gateway Reconciliation section that includes the following operations: Settle Payment Reject Payment Reverse Payment   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   In the descriptions of the following operations, noted that these API operations are now in Limited Availability: Get billing information for order Request breakdown of invoice items by order Get breakdown of invoice by order Request breakdown of credit memo items by order Get breakdown of credit memo by order In the response body of the “CRUD: Get usage” operation, corrected the description of the   CreatedDate   field. Renamed the Link Queries section to Data Queries. Also renamed the operations in this section: Renamed “Submit Link query” to “Submit data query”. Renamed “Get Link query jobs” to “Get data query jobs”. Renamed “Get Link query job” to “Get data query job”. Renamed “Cancel Link query job” to “Cancel data query job”. In the source YAML file, renamed the following reference objects: Renamed   SubmitLinkQueryRequest   to   SubmitDataQueryRequest . Renamed   SubmitLinkQueryResponse   to   SubmitDataQueryResponse . Renamed   GetLinkQueryJobsResponse   to   GetDataQueryJobsResponse Renamed   GetLinkQueryJobResponse   to   GetDataQueryJobResponse . Renamed   DeleteLinkQueryJobResponse   to   DeleteDataQueryJobResponse . Renamed   LinkQueryJobCommon   to   DataQueryJobCommon . Renamed   LinkQueryJob   to   DataQueryJob . Renamed   LinkQueryJobCancelled   to   DataQueryJobCancelled . Renamed   LinkQueryErrorResponse   to   DataQueryErrorResponse . Added the   X-Zuora-WSDL-Version   request header to the following actions: Amend Create Delete Execute Generate Query QueryMore Subscribe Update ... View more

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!   2019-05-08   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   Added the following operations: CRUD: Create CreditBalanceAdjustment CRUD: Update CreditBalanceAdjustment In the 200 respsonse body of the following operations, added the processId and reasons fields: Update account Activate accounting code Deactivate accounting code Delete accounting code Update an accounting code Close accounting period Set accounting period to pending close Update accounting period Delete accounting period Re-open accounting period Run trial balance Edit attachments Delete attachments Email billing documents generated from bill run Multi-entity: Share a product with an Entity Establish connection to Zuora REST API service Delete credit memo Email credit memo Get breakdown of credit memo by order Request breakdown of credit memo items by order Update debit memos Delete debit memo Email debit memo Delete document properties Update invoices Email invoice Delete journal run Cancel journal run Stop mass action Delete Order Update order custom fields Update subscription custom fields Get an order Get order metrics for evergreen subscription Get orders by subscription owner Get orders by subscription number Get orders by invoice owner Get rated result for order Get billing information for order Create order Update order action trigger dates Preview order Get term information for subscription Get breakdown of invoice by order Request breakdown of invoice items by order Delete payment Delete payment method Scrub payment method Create payment method Delete payment run Delete refund Update custom fields on revenue items by revenue event number Update custom fields on revenue items by revenue schedule number Delete revenue schedule Update revenue schedule basic information Delete sequence set Delete summary journal entry Cancel summary journal entry Update basic information of a summary journal entry Delete taxation item In the 200 respsonse body of the “Get job status and response” operation, added the following nested fields to the result field: processId reasons ... View more

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!   2019-04-18   API Updates   This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 243, April 2019.   Payment Methods - In the request body of the “Create payment method” operation, added the possible value ACH to the type field.   The following items are API updates specific to enhancements to the prefix and numbing configuration for billing documents. These API updates are also available as of Zuora Release 243, April 2019.   Sequence Sets - Added a new resource called “Sequence Sets”, with the following new operations: Create sequence set Get sequence sets Update sequence set Get sequence set Delete sequence set Accounts - In the request body of the following operations, added the sequenceSetId field: Create account Update account Orders - In the request body of the following operations, added the sequenceSetId nested field to the newAccount field: Create order Create order asynchronously   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   In the request body of the “Subscribe” action, corrected the name of the subscribes > Account > Id field. Previously, the name of this field was documented as AccountId . ... View more

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!   2019-04-10   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   Changed “customer-initiated” to “cardholder-initiated” in the following locations: The   mitProfileAction   field in the request body of the “Create payment method” operation. The   mitProfileAction   field in the request body of the “Create credit card payment method” operation. The   action   and   status   fields in the request body of the “Create stored credential profile” operation. In the request body of the “CRUD: Create Import” operation, removed the unsupported import type   MPU   from the enum values of the   ImportType   field.   ... View more

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!   2019-03-27   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   In the request body of the “Create account” and “Renew subscription” operations, made the following updates: Removed the unsupported version 196.0 from the description of the invoiceCollect field. Corrected the data type of the collect field from string to boolean and updated the prerequisite of this field to "The invoice or runBilling field must be true ". In the request body of the subscription-related operations listed below, made the following updates: Removed the unsupported version 196.0 from the description of the invoiceCollect field. Corrected the prerequisite of this field to "The invoice or runBilling field must be true ". The following operations are affected: Create subscription Update subscription Resume subscription Suspend subscription Cancel subscription In the Zuora Object Model section, clarified that the API name of the Billing Run object is BillingRun in Zuora Link. In the request body of the “Submit Link query” operation, made the following updates: Removed the queryType field. Changed the description of the output > target field. ... View more

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!   2019-03-20   API Updates   This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 242, March 2019.   Orders - Made the following updates: In the following operations, added the includeUnits field to the order (or orders ) > subscriptions > orderActions > updateProduct > chargeUpdates > pricing > usageOverage field in the response body: Get an order Get all orders Get orders by subscription owner Get orders by subscription number Get orders by invoice owner Get order metrics for evergreen subscription In the following operations, added the priceChangeOption field to the order (or orders ) > subscriptions > orderActions > createSubscription > subscribeToRatePlans > chargeOverrides > pricing > discount field in the response body: Get an order Get all orders Get orders by subscription owner Get orders by subscription number Get orders by invoice owner Get order metrics for evergreen subscription In the following operations, added the priceChangeOption field to the order (or orders ) > subscriptions > orderActions > addProduct > chargeOverrides > pricing > discount field in the response body: Get an order Get all orders Get orders by subscription owner Get orders by subscription number Get orders by invoice owner Get order metrics for evergreen subscription Payment Methods - Made the following updates: In the “Create payment method” operation, made the following updates in the request body: Added the possible value CreditCard to the type field. Added the following fields: cardHolderInfo cardNumber cardType expirationMonth expirationYear mitConsentAgreementRef mitConsentAgreementSrc mitNetworkTransactionId mitProfileAction mitProfileType securityCode In the “Create credit card payment method” operation, made the following updates in the request body: Added the possible value Persist to the mitProfileAction field. Added the mitNetworkTransactionId field. In the “Create stored credential profile” operation, added the action field in the request body. In the following operations, updated the description of the IPAddress field in the request body (or the response body) to clarify that the field has now been supported by the WorldPay payment gateway integration: CRUD: Create payment method CRUD: Update payment method CRUD: Get payment method Refunds - In the request body of the “Update refund” operation, added the referenceId field.   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   In the request body of the “Create account” operation, added reference information to the description of the creditCard > cardType field. In the request body of the “Subscribe” action, added reference information to the description of the subscribes > PaymentMethod > CreditCardType field. In the request body of the “Create credit card payment method” operation, added reference information to the description of the creditCardType field. In the request body of the following operations, added reference information to the description of the CreditCardType field: CRUD: Create payment method CRUD: Update payment method In the response body of the “Get account summary” operation, added reference information to the description of the basicInfo > defaultPaymentMethod > creditCardType field. In the response body of the “Get credit card payment methods for account” operation, added reference information to the description of the creditCards > cardType field. In the response body of the “CRUD: Get payment method” operations, added reference information to the description of the CreditCardType field. In the request body of the “Create stored credential profile” operation, clarified the description of the status field. Added a new section Link Queries containing the following operations: Submit Link query Get Link query jobs Get Link query job Cancel Link query job In the source YAML file, replaced the PostOrderDiscountPricingOverride reference object by the DiscountPricingOverride reference object. This change affects the following operations: Create order Preview order In the source YAML file, replaced the PostOrderDiscountPricingUpdate reference object by the DiscountPricingUpdate reference object. This change affects the following operations: Create order Preview order In the source YAML file, replaced the UsageOveragePricingUpdatePostOrder reference object by the UsageOveragePricingUpdate reference object. This change affects the following operations: Create order Preview order In the source YAML file, replaced the cardHolderInfo field in the POSTPaymentMethodType reference object by a new reference object called CreatePaymentMethodCardholderInfo . This change affects the “Create credit card payment method” operation. ... View more

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!   2019-03-13   API Updates   This section lists operations and fields that were added, changed, or removed.   The following API updates are available as of Zuora Release 240, March 2019.   Payment Methods   - Made the following updates: In the request body of the “CRUD: Create payment method” and “CRUD: Update payment method” operations, added the following enum values to the   BankTransferType   field: Autogiro Betalingsservice In the response body of the “CRUD: Get payment method” operation, added the following enum values to the   BankTransferType   field: Autogiro Betalingsservice Payment Method Snapshots   - In the response body of the “CRUD: Get payment method snapshot” operation, added the following enum values to the   BankTransferType   field: -   Autogiro -   Betalingsservice   The following API updates are available as of Zuora Release 241, March 2019.   Payment Methods   - Made the following updates: Added the following operations: Create stored credential profile Get stored credential profiles Cancel stored credential profile Expire stored credential profile In the request body of the “Create credit card payment method” operation, added the following fields: mitConsentAgreementRef mitConsentAgreementSrc mitProfileAction mitProfileType   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   In the “CRUD: Create payment method” and “CRUD: Update payment method” operations, added the missing   BankTransferType   field to the request body. In the “Get subscriptions by key” operation, corrected the description of the charge-detail query parameter. ... View more

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!   2019-03-07   API Updates   This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 240, March 2019. Payment Methods   - Made the following updates: In the request body of the “CRUD: Create payment method” and “CRUD: Update payment method” operations, added the following fields: IdentityNumber IsCompany CompanyName In the response body of the “CRUD: Get payment method” operation, added the following fields: IdentityNumber IsCompany CompanyName   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   In the description of the Actions section, clarified that actions do not support the Invoice Settlement feature and the Orders feature. Also clarified this in the description of the “Query” action. ... View more

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!   2019-02-27   API Updates   This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 239, February 2019.   Accounts   - In the request body of the “Create account” operation, changed the behavior of the   runBilling   field to match the documentation. Previously, invoices were also generated even if   runBilling   is set to   false . Credit memos were also generated if the Invoice Settlement feature was enabled.   2019-02-20   API Updates   This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 239, February 2019.   Payments - In the request body of the “Update payment” operation, added the referenceId field. OAuth - In the “Generate an OAuth token” operation, the client_secret request body field now has a maximum supported length of 42 characters. When you create an OAuth client using the Zuora UI, the Client Secret is 38 to 42 characters long. Previously, Client Secrets were always 20 characters long. You can continue to use existing Client Secrets without modification.   The following items are API updates specific to enhancements to the Invoice Item Settlement feature:   Invoices - Made the following updates: Added a new operation “Get taxation items of invoice item”. In the response body of the “Get invoice items” operation, added the balance and taxationItems nested fields to the invoiceItems field. Credit Memos - Made the following updates: Added a new operation “Get taxation items of debit memo item”. In the “Get credit memo items” operation: Added the zuora-version request header. Added the taxationItems nested fields to the items response body field. This field is only available if you set the zuora-version request header to 239.0 or later. Changed the behavior of the items > creditTaxItems response body field. This field is not available if you set the zuora-version request header to 239.0 or later. In the “Get credit memo item” operation: Added the zuora-version request header. Added the taxationItems response body field. This field is only available if you set the zuora-version request header to 239.0 or later. Changed the behavior of the creditTaxItems response body field. This field is not available if you set the zuora-version request header to 239.0 or later. Debit Memos - Made the following updates: Added a new operation called “Get taxation items of debit memo item”. In the “Get debit memo items” operation: Added the zuora-version request header. Added the taxationItems nested field to the items response body field. This field is only available if you set the zuora-version request header to 239.0 or later. Changed the behavior of the items > taxItems response body field. This field is not available if you set the zuora-version request header to 239.0 or later. In the “Get debit memo item” operation: Added the zuora-version request header. Added the taxationItems response body field. This field is only available if you set the zuora-version request header to 239.0 or later. Changed the behavior of the taxItems response body field. This field is not available if you set the zuora-version request header to 239.0 or later.   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   In the “Subscribe” action, made the following updates: Added the AccountId nested field to the subscribes > Account request body field. Removed the following nested fields from the subscribes > Account request body field: Balance BillToId CreatedById CreatedDate CreditBalance SoldToId Status UpdatedById UpdatedDate Improved the request and response samples. In the “Generate an OAuth token” operation, documented the supported length of the client_id request body field. In the “API Versions” section, added the following fields to the “Minor Version History” table: creditTaxItems taxItems taxationItems In the request body of the “Generate RSA signature” operation, removed the redundant “ zuora.com/apps/PublicHostedPageLite.do  if you are on the API Sandbox environment.” from the description of the  uri  field. ... View more

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!   2019-02-14   API Updates   This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 238, February 2019.   Orders - Made the following updates: In both the “Create order” and “Preview order” operations, added the priceChangeOption field to the following fields in the request body: subscriptions > orderActions > addProduct > chargeOverrides > pricing > discount subscriptions > orderActions > updateProduct > chargeUpdates > pricing > discount subscriptions > orderActions > createSubscription > subscribeToRatePlans > chargeOverrides > pricing > discount   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   In the request body of the “Update payment” operation, removed the referenceId field. In the source YAML file, duplicated the DiscountPricingOverride reference object as a new reference object called PostOrderDiscountPricingOverride that is used in the request body of the following operations: Create order Preview order In the source YAML file, duplicated the DiscountPricingUpdate reference object as a new reference object called PostOrderDiscountPricingUpdate that is used in the request body of the following operations: Create order Preview order   2019-02-12   API Updates   This section lists operations and fields that were added, changed, or removed. The following API updates are available as of Zuora Release 238, February 2019.   Accounts - Made the following updates: In the request body of the “Generate billing documents by amount” operation, added the following fields: autoRenew chargeTypeToExclude In the response body of the “Create account” operation, added the following fields: billToContactId soldToContactId   Doc Updates   This section lists the documentation updates that were made in this version of the API Reference.   In the response body of the “Get account” operation, corrected the descriptions of the following fields: billToContact > country billToContact > state soldToContact > country soldToContact > state In the response body of the “Get account summary” operation, corrected the descriptions of the following fields: billToContact > country billToContact > state soldToContact > country soldToContact > state In the request body of the “Create credit card payment method” operation, removed “required” from the following nested fields of the cardHolderInfo field. However, if you do not specify the accountKey  field in the request body, the  cardHolderName  field is still required . cardHolderName City State zipCode country Changed the URL of the source YAML file. See this post for more information. In the request body of the “Update payment” operation, added the  referenceId  field. However, as of Zuora Release 238, this field is not available.   ... View more