Evaluate and bill commitments
Learn how to evaluate and bill commitments using batch bill runs or ad-hoc API evaluations, and when commitment periods become billable.
Postpaid commitment
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:
-
The billing target date falls on or after the commitment period end date.
-
All contributing charges have been billed through the commitment period end date (for active commitments), or the commitment cancellation effective date (for cancelled commitments).
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.
You can also trigger evaluation for specific commitments through APIs:
-
Create an orderAPI: If commitments are included in the order request andrunBilling=true, the system will try to evaluate and bill all commitments in the order automatically. -
Generate billing documentsAPI: The system will try to evaluate and bill all commitments specified in thecommitmentKeysarray automatically.
True-up invoice items are always issued to the commitment account as non-subscription invoice items.
Prepaid commitment
For prepaid commitments, Zuora generates prepayment invoices based on the commitment periods. Each installment is billed as a separate invoice line and uses the commitment name as the line description.
For more information, see Prepayment billing.