Skip to main content

Documentation Index

Fetch the complete documentation index at: https://spreesuite.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

What is a Bill Run?

A Bill Run is a billing period — a specific time window (like a month, week) when bills are generated for all customers. It’s the “billing cycle” for that period. Think of a monthly billing cycle:
  1. January 2025 = one TERM
  2. February 2025 = another TERM
  3. March 2025 = another TERM
Each TERM is a separate billing period with its own start date, end date, and due date.

Why Terms Matter

TERMs organize billing into cycles:
  • You create a TERM for a period (e.g., January 1–31, 2025)
  • The system generates bills for all customers for that period
  • Bills are grouped under that TERM
  • You can track how many bills were created, processed, and posted for that TERM
The bill run table shows all completed bill runs. The bill run is responsible for generating invoices on an account’s billing day. It runs every day at 8:15 am in the entity’s timezone and performs the following functions.
  • Processes all accounts whose billing day is the current day
  • Merges any pending invoices for accounts that use consolidated billing
  • Aggregates usage records for subscriptions with usage-based charges
  • Calculates sales tax or VAT
  • Generates an invoice for each account
Once the job has been completed, a summary record is produced that shows how many invoices were generated, how much money was invoiced, etc. If you have multiple entities, each entity will be processed in a separate bill run.
Screenshot 2026 05 14 At 2 55 39 PM
By clicking on a row in the table, you will get a new table with all the invoices that were generated.
Screenshot 2026 05 14 At 2 56 12 PM
The bill run is responsible for generating invoices on an account’s billing day. It runs every day at 8:15 am in the entity’s timezone and performs the following functions.
  • Processes all accounts whose billing day is the current day
  • Merges any pending invoices for accounts that use consolidated billing
  • Aggregates usage records for subscriptions with usage-based charges
  • Calculates sales tax or VAT
  • Generates an invoice for each account
Once the job has been completed, a summary record is produced that shows how many invoices were generated, how much money was invoiced, etc.

title: “Bill Run Status”

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.
StatusDescription
PendingImmediately after a bill run is executed, the status changes to pending. Pending means a bill run is queued for processing.
ProcessingThe bill run is processing all accounts for that bill run. Apply pricing rules and calculate components
CompletedFor successful bill runs, the status is completed.
Post in progressThe bill run is being posted.
PostedA bill run is posted if all invoices from that bill run were posted together. After posting the bills generated and shown in Bills, which is in BillSpree → Billing Ops → Bills