Tenant-level Limits

Knowledge Center > Zuora Central > Policies > Tenant-level Limits

Tenant-level Limits

Zuora is a true multi-tenant SaaS based application. As such, Zuora enforces a number of tenant-level limits to ensure that no one tenant monopolizes shared resources. This article describes these tenant-level limits.

Zuora Internal Documentation. This article is intended for Zuora only. Do not share or distribute publicly.

 

Need higher thresholds?

If your business requires higher thresholds, please contact Zuora Global Support. We can work with you to evaluate your specific requirements.

Amendments per Subscription

Zuora recommends that you create no more than 100 amendments on a subscription to ensure high performance of the subscriptions. The limit of amendments allowed on a subscription is 1000. However, if you create more than 100 amendments, the performance may be severely degraded, depending on the products and charges set up in your subscription.

If the renewal term period of the latest version of the subscription is Day or Week, the limit of amendments allowed on a subscription is 100.

The 100 amendment limit does not apply to Orders. See Orders Performance Guidance for more information.

User Interface

Type Description More Information

Customer Hierarchy

Five levels are allowed in a customer hierarchy.

Customer Account Basic Information

URL Length on Callouts

2048 characters are allowed for the Base URL.

Configuring Callout  Notifications

SOAP API Calls

Type Description More Information
Object Threshold per Call

amend()

The number of amendments supported in a single amend call are:

  • For WSDL versions 69+: Up to ten amendments
  • For WSDL versions 42.0 through 68: Up to three amendments
  • For WSDL versions 29.0 through 41.0: Only one amendment

create()

delete()

subscribe()

update()

50 objects are supported in a single call.

WHERE Clause Threshold in Queries

Number of Conditions

A maximum of 200 conditions are allowed in a WHERE clause of a query() call. For example, you can have up to 200 distinct AND or OR clauses.

Zuora Object Query Language

Data Source ZOQL

Type Description More Information

Number of Characters 

Export ZOQL

Bill Runs

Type Description More Information

Number of Charges

20,000 charges are allowed per invoice on a bill run. 

Bill Runs

Subscription Optimization and Performance Guidelines

Invoice Presentment

Type Description

Number of Items

An invoice can display up to 20,000 items on the invoice PDF. The number of items includes invoice items, tax items, and usage records.

Zuora Objects

Zuora Object Type Description More Information

Account

Number of Subscriptions

3,000 subscriptions are allowed on an account.

Subscription

Account

Number of Contacts

100 contacts are allowed for each customer account.

N/A

ProductRatePlanCharge

Up To Period

Number greater than 0 and less than 65,536 is allowed on a discount charge model.

Creating and Changing Discount Charges

ProductRatePlanCharge Product Discount Apply Detail Data One discount product rate plan charge can be applied to no more than 1,000 product rate plans or product rate plan charges.  

Import / Upload

Type Description More Information

File Size

 4 MB (i.e., 4,94304 bytes or 4096 KB) is allowed on the import file size.

Using the Zuora API to Import Mass Usage Records

Export

Type Description More Information

Number of Records

200,000 records are allowed on an Export Mass Order Entry file. This large file contains every subscription and amendment that has been created for your Zuora tenant. 

Zuora recommends uploading up to 400 records per file for improved processing. 

Using Mass Order Entry to Create Subscriptions

File Size

The maximum export file size is 2047MB. If you have large data requests that go over this limit, you will get the following 403 HTTP response code from Zuora:
  <security:max-object-size>2047MB</security:max-object-size>

Submit a request at Zuora Global Support if you require additional assistance.

We can work with you to determine if large file optimization is an option for you.

Generate a Data Source

Export ZOQL

Export SOAP Object

Get Files REST API

Quotes Document REST API

Accounting Period Revenue Detail

Salesforce

Type Description More Information

API-based Sync

For Salesforce Professional and Enterprise, each organization has a limit of 1,000 API calls per user license per day. Review the limits for your Salesforce edition in Salesforce API Limit.

Each API-based Sync, such as On-demand Sync or Real-time Sync, consumes:

  • 4 to 8 API calls based on the number of object types that need to be synced
  • 1 API call per 200 records

Salesforce Limits and Zuora 360 Syncs

Turbo Sync

Salesforce allows 5,000 Bulk API batches per user license per day. 

Each Turbo Sync, such as Manual Sync or Scheduled Sync, session consumes:

  • 1 Bulk API batch per every 9000 records of each object type to be DELETED
  • 1 Bulk API batch per every 9000 records of each object type to be UPSERTED

Salesforce Bulk API Limits

Salesforce Limits and Zuora 360 Syncs

 

Zuora Quotes General governors and limits apply to the use of Zuora Quotes in your Salesforce organization. Salesforce Governor and Limits

Concurrent Requests

See Concurrent Request Limits.

Limitation on Memo PDF

Up to 20,000 line items are allowed in a single memo PDF.

Limitation on Invoice PDF 

Zuora limits the sum total of certain line items up to a maximum number in a single invoice. For example, the sum total of line items for invoice items, taxation items, and usage items in a single invoice cannot exceed 20,000. 

Maximum sum total of 20,000 is allowed for the following line items:

  • invoice item
  • taxation item
  • usage item

Maximum sum total of 2,000 is allowed for the following line items:

  • credit balance adjustment
  • invoice adjustment
  • invoice item adjustment
  • payment
  • refund

Maximum sum total of 2,000 is allowed for the following line items:

  • subscription
  • rate plan

When generating an invoice PDF, if the maximum number is exceeded, an error message is generated.

Amendments per Subscription

Zuora recommends that you create no more than 100 amendments on a subscription to ensure high performance of the subscriptions. The limit of amendments allowed on a subscription is 1000. However, if you create more than 100 amendments, the performance may be severely degraded, depending on the products and charges set up in your subscription.

If the renewal term period of the latest version of the subscription is Day or Week, the limit of amendments allowed on a subscription is 100.

The 100 amendment limit does not apply to Orders. See Orders Performance Guidance for more information.

Limitations on Orders

The migration to full Orders is in Limited Availability. We are actively soliciting feedback from a small set of early adopters before releasing as generally available.

Zuora has the following limits on Orders to prevent performance degradation:

You can request a limit increase by submitting a request at Zuora Global Support.

Last modified

Tags

Classifications

(not set)