Skip to main content

Overview of bill runs


Overview of bill runs

Bill runs automatically create invoices for your customers on a set schedule, as well as create invoices for your customers, as needed. A bill run gathers information from one or more customer accounts and generates invoices for those accounts. Because of this, bill runs are also referred to as invoice runs.

Also, if you have the Invoice Settlement feature enabled, bill runs can automatically generate credit memos for negative charges based on your invoice and credit memo generation rule. The number of billing documents, invoices, and credit memos that are generated during the bill run is displayed on the bill run individual page.


Each bill run can be for a single customer, a group of customers (for example, those in a batch, or those that have the same bill cycle day), or for all customers. Bill runs can be scheduled in advance (for example, they can be scheduled to run every day at a set time), or run on an ad hoc basis (this means that you can initiate a bill run manually).

Zuora billing and rating engine generates chargeable events for timely and accurate invoices. The invoices are generated automatically and driven by the configuration of products, rate plans, and billing schedules. When it is time to invoice, you can process them thousands at a time, do it on-demand, or one at a time as your customers need it. You can generate real-time invoices immediately after refunds on payments or subscription changes. The prorated charges can be included in the invoice amount calculation to ensure that your customers are billed correctly when subscriptions start part way through a billing period.

After invoices have been created in the bill run, they are now ready to collect for payments. This is where payment runs come in: they are used to collect cash from your customers.

You must have the Create Bill Runs permission to create bill runs. See Zuora Billing Roles for more information.

Bill runs and batches

If you need to create an invoice for more than one customer account, but you do not need to create invoices for every customer, you can do this easily by batching your customers so that you can process them together.

Types of bill runs

There are two types of bill runs: ad hoc and scheduled.

  • An ad hoc bill run is one that you can run once to create invoices on demand.
  • A scheduled bill run occurs on a regular interval, such as once a week or once a month. It creates invoices for you automatically on that schedule. (Scheduled bill runs are also called recurring bill runs.)

You can create a bill run for multiple or single customer accounts. After a bill run is created, you will have the options of posting invoices individually, or posting all invoices for the bill run. Invoices must be posted before you can collect payments.

See Creating Bill Runs for detailed instructions about creating bill runs.

Billing in advance

Customers can be billed in advance directly from your bill run. If you want to send an invoice in advance of a billing period, set your invoice date to be the date of your bill and your target date to be the billing period you are billing in advance. For example, if you want to send your invoice on March 1, but the billing period is for April 1 to April 30, set your invoice date to March 1 and your target date to April 30. Your customer will receive an invoice for the billing period of April 1 to April 30 on March 1.


Keep in mind the following limit when using bill runs.

Charges per invoice

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

Filter charges in bill runs

When generating an invoice for your recurring charges, you can filter out Usage in the bill run. Use the  Filter Charges options to exclude specific types of charges from being included in this bill run.

You can include or remove the following types of charges from a bill run:

  • One time
  • Recurring
  • Usage

You can use these options to create bill runs for specific charges. For example, you could create one bill run for recurring charges, then bill for usage at a later time in a subsequent bill run.

Bill run status types

A bill run can have one of the following possible statuses. The status provides information about how the bill run is being processed in Zuora.

Status Description
Pending Immediately after a bill run is executed, the status changes to pending. Pending means that a bill run is being queued up for processing.
Paused If a scheduled bill run in Pending status is stopped temporarily, its status will be changed to Paused. When you resume the Paused bill run, its status will be changed to Pending or Cancel In Progress depending on whether it has the next run.
Processing The bill run is processing all accounts for that bill run.

For successful bill runs, the status is completed. Only invoices for accounts that are due to be billed are generated. An email is sent to the user who executed the bill run to notify the user that the bill run has completed.

Although the bill run is complete, the invoices have not yet been posted. You must post the bill run, which will post the invoices and then email the invoices to complete the billing process. Typically, the Completed status for bill run is used to review the invoices for accuracy and then post/email them to your customers.

When you create the bill run, you can select an option to automate the posting and emailing of the invoices after the bill run. 

Error If a bill run is not successful, the bill run shows an error status. An email is sent to the user who executed the bill run to notify the user that the bill run has an error.
Cancel in progress The bill run is being canceled.

A bill run can be canceled if it is either pending or completed. Bill runs still processing cannot be canceled.

You can still individually cancel invoices that were all posted when an entire bill run was posted.

Post in progress The bill run is being posted.

A bill run is posted if all invoices from that bill run were posted together. Posting a bill run means that all invoices generated as part of that run are considered committed. Once invoices have been posted, they are eligible to be processed in payment runs. Depending on how you configured your bill run settings, you might need to email invoices to your customers. 

Posted invoices can no longer be edited. You must adjust for any errors that were found.

Remove in progress The bill run is being removed.

Conditions for status changes on a bill run 

If the status of an invoice generated in a bill run changes from Posted to Draft, the status of the corresponding bill run changes from Posted to Completed.