Welcome to Zuora Product Documentation

Explore our rich library of product information

Evaluate and bill commitments

Learn how to evaluate and bill postpaid commitments using batch bill runs or ad-hoc API evaluations, and when commitment periods become billable.

Postpaid commitments

You can evaluate and run billing for postpaid commitments using a batch process or trigger an ad-hoc evaluation for specific commitments.

A commitment period becomes billable when:

  1. The billing target date falls on or after the commitment period end date.

  2. All contributing charges have been billed through the commitment period end date (for active commitments), or the commitment cancellation effective date (for cancelled commitments).

Batch process

Commitments are evaluated for true-up via a bill run in both UI and API. For each account in a bill run, the system will try to evaluate all of its commitments and billable commitment periods automatically.

Evaluate specific commitments (Ad-hoc)

You can also trigger evaluation for specific commitments through APIs:

  1. Create an order API: If commitments are included in the order request and runBilling=true, the system will try to evaluate and bill all commitments in the order automatically.

  2. Generate billing documents API: If includeCommitments=true, the system will try to evaluate and bill all commitments specified in the commitmentIds array automatically.

True-up invoice items are always issued to the commitment account as non-subscription invoice items.