Skip to main content

Best practices for Delete job in a Zuora Tenant

Zuora

Best practices for Delete job in a Zuora Tenant

  1. Last updated
  2. Save as PDF

  • Create a backup of the data you plan to delete, before attempting a mass deletion. This ensures that you have a copy of the data in case you need to recover it later.

  • Perform a test of data deletion in a sandbox or test environment first to verify the process and its effect without impacting your production data.

  • Begin by deleting a small batch of records to ensure that the deletion process works as expected and to identify any issues early. 

  • When performing delete actions, ensure that the correct field from the source file is accurately mapped to the record ID in the target, Zuora tenant. The record ID is a unique identifier assigned to each record in the target system, and it is essential for accurately identifying and deleting the intended records.

  • Data Loader functionality includes support for delete action at the Billing API level. Consider all potential dependencies that the records may have before deletion. Deleting records with dependencies could impact other data in the Zuora tenant. 

  • Standalone Invoices can only be deleted if they are in the Draft State.

  • When you delete Accounting Periods, you may not be able to get the direct successful records file. A quick workaround would be to reverse the order, where recent accounting period IDs need to be placed first and uploaded for delete. 

  • Accounting Codes must be in inactive status for deletion.

  • Account deletion is an asynchronous process. For account deletion, the system starts a backend job to remove all transactions under the accounts and change the status of the accounts to 'Cancelled'. This backend job is asynchronous and can take some time depending on the job size.

  •  An account cannot be deleted if

  1. The account is either the invoice owner or the subscription owner of a subscription.

  2. The subscription's invoice owner and subscription owner are two different accounts. To remove this limitation, set the ‘Enable Force Deletion for Account?’ setting to Yes to force delete an account that is the subscription owner of a subscription while the invoice owner is a different account. Force deleting this account deletes all its subscriptions, but the relevant invoices are not impacted.

  3. That account has ever been involved in an Owner Transfer amendment or order action, either as the current owner or as the previous owner.