Negative Quantity Usage

Overview

You can upload usage records of negative quantity to adjust the previously uploaded usage records, in the following manner:

• Use the CRUD: Create a usage record operation to upload a usage record of a negative quantity.
• You can upload a usage record of a negative quantity to the same billing period of a previously uploaded usage record while this billing period is open.
• You can also upload a late usage record of a negative quantity when a billing period is closed. In this case, a credit memo or invoice item adjustment is generated in the next billing period for the late usage record of a negative quantity. 
• When you use unit-based prepaid with drawdown, if you upload a usage record of a negative quantity, a prepayment adjustment is generated for the prepayment charge. This is the case even if you upload a late usage record of a negative quantity.
• When you use currency-based prepaid with drawdown or currency-based minimal commitment:
  • If you upload a usage record of a negative quantity to an open billing period, a Prepayment Adjustment transaction is generated for the prepayment charge to increase the prepayment balance.
  • If you upload a late usage record of a negative quantity, a credit memo or invoice item adjustment is generated in the next billing period for the late usage record of a negative quantity.

Availability

The Negative Quantity Usage feature is in the beta phase in the sandbox tenant. To join the waiting list for this beta program, submit a request at Zuora Global Support and we will evaluate whether the feature is suitable for your use cases. 

Also, you need to enable Unbilled Usage to use the Negative Quantity Usage feature. As Unbilled Usage is part of the Advanced Consumption Billing feature, you need to purchase the feature to use it. Contact your Zuora account team for assistance.

Supported charge models

The Negative Quantity Usage feature inherits the same scope of supported charge models from that of the Unbilled Usage feature. For more information, see the supported charge models by the Unbilled Usage feature.

Notes and expectations

The Negative Quantity Usage feature currently has the following expectations:

• You cannot make a day’s total quantity negative.
• You cannot update a usage's quantity from positive to negative.
• You cannot upload a negative usage record by uploading a usage file through the Zuora UI or Upload a usage file API operation. Only creating usage records through the CRUD: Create a usage record API operation is supported.
• You cannot upload negative usage if the Roll up child usage feature is enabled.
• You cannot upload negative usage for a dynamic usage charge.