Commitment balance adjustments
Learn how to adjust commitment balances in Zuora using contribution charge adjustments or standalone credit and debit memo adjustments.
In Zuora, commitments represent contractual obligations - either as postpaid minimum spend guarantees or as prepaid spend balances. Over the course of a commitment lifecycle, you may need to adjust the remaining balance of a commitment period due to renegotiations, goodwill exceptions, or error corrections.
Zuora supports two approaches for modifying commitment balances:
-
Contribution charge adjustment: Direct system-driven adjustment from the modification of the contribution charges.
-
Credit and debit memo adjustment from invoice items: Ad-hoc memos applied to contributing invoices.
Considerations
-
Active period required: Adjustments are strictly blocked on commitment periods that have a Cancelled status. Evaluated commitment periods still support balance adjustments.
-
Currency alignment: The adjustment or memo currency must strictly match the commitment currency. Multi-currency cross-contributions are not supported.
-
Eligible source items: For memo-based adjustments, the source invoice item must have previously contributed to the same commitment period.
-
Unsupported objects: Standalone invoices, Ad-hoc memos from product rate plan charges, legacy Invoice Adjustments (IA), and Invoice Item Adjustments (IIA) cannot adjust commitment balances.
-
Full-amount memo rule: The entire applied amount of an eligible memo item contributes to the adjustment; partial item contributions are not supported. To adjust a partial amount, split or create separate invoice items or memo items.
-
Prepaid vs. postpaid mechanics: Financial transaction outcomes depend on the commitment structure. Prepaid commitments may generate
PrepaymentApplicationrecords, while postpaid commitments directly update the remaining guarantee balance.