Welcome to Zuora Product Documentation

Explore our rich library of product information

Invoice reversal

Invoice reversal allows correction of billing errors by generating a credit memo and creating a new invoice for the same billing period.

Occasionally, a subscription can be incorrectly configured or account information is not up-to-date. When this happens, the resulting invoice might be incorrect, including either over or undercharging, or incorrect bill-to or sold-to contact information. When you discover mistakes on a posted invoice, you can reverse the invoice, correct the mistakes, and then generate a new corrected invoice for the same billing period.

To learn about the common use cases of invoice reversal, see Invoice reversal use cases.

Reverse Invoice is a single atomic operation that does the following:
  1. A credit memo is automatically generated and applied to the incorrect invoice to reduce the invoice balance to zero.
  2. Existing credit memos associated with the invoice are automatically reversed. This applies only to credit memos whose credit memo items link to the same subscription rate plan charge as the invoice items of the incorrect invoice. For more information about credit memo reversal, see Reverse credit memos.
  3. The charge-through date in the Zuora rating engine is reset so that the related charges can be billed again for the affected period. Depending on the data view, ChargedThroughDate and ProcessedThroughDate might appear as empty after the reset rather than display the start of the billing period. The UpdatedDate of a rate plan charge is not a reliable indicator that the reset occurred.
  4. The incorrect invoice is flagged as Reversed.

For example, you have an invoice with the amount of $100. After you posted the invoice to your customer, you find that a charge fee is missing in the invoice. You can reverse the invoice, and generate the correct one. A credit memo is auto-generated with the memo amount of $100 and auto-applied to the reversed invoice. You can then amend the subscription to include the missing charge and re-run the bill run for that period to create a new correct invoice.

After reversing invoices, the invoices are still in Posted status. Once you have reversed an invoice, you can no longer cancel or change the reversed invoice and the generated credit memo. In the Zuora UI, the Reversed field in the Basic Information panel of an invoice detail page shows whether this invoice is reversed. Currently, Zuora does not flag whether the invoice is reversed in the SOAP API.

You can reverse invoices either from the Zuora UI or REST API, even in a closed accounting period. See Reversing Invoices from the Zuora UI and PUT Reverse Invoice for more information.

As a tenant administrator, you can configure the Billing user permissions to restrict users from reversing invoices. See Billing Roles for more information.

Reason codes for invoice reversals

The reasonCode supplied with a reversal request applies to the credit memo generated for the invoice. In some cases, reversing an invoice also reverses a discount charge and generates a debit memo. That debit memo uses the Debit Memo reason code named Credit memo reversal.

Before reversing an invoice that contains discount charges, verify that the following reason code is active:

  1. In the Zuora application, navigate to Settings > Payments > Configure Reason Codes.

  2. Select Debit Memo from the transaction-type list.

  3. Confirm that a reason code named exactly Credit memo reversal exists and is active.

  4. If the reason code is missing, create it with that exact name and activate it.

  5. Retry the reversal request.

The Credit memo reversal reason code is separate from the reason code supplied for the invoice credit memo. For more information, see Creating and Editing Reason Codes.

Invoice reversal restrictions and taxation behavior

You can only reverse the most recently generated invoices for each subscription. If a new invoice is generated for a subscription, you cannot reverse the previously generated invoices for this subscription. Besides, you cannot reverse an invoice when both of the following conditions are true:
  • The invoice includes more than one subscription
  • One of the subscriptions has a newer invoice generated

For example, an invoice is generated (Service period: March 1 - March 31) and posted for Subscription A and Subscription B. Later, you generate a new invoice (Service period: April 1 - April 30) for Subscription B. You are not allowed to reverse the invoice (Service period: March 1 - March 31), because a new invoice is generated for Subscription B.

Whether you can reverse the invoices that have the total amount of zero depends on the option of the Create credit memos mirroring invoice items billing rule.
  • For zero-amount invoices composed of all zero-amount invoices items and taxation items, they can be reversed only if the billing rule is set to Yes .
  • For zero-amount invoices composed of positive and negative invoices items or taxation items, they can be reversed no matter which option the billing rule is set to. The specific credit memo creation during the invoice reversal might be different according to the option set for the billing rule.

The credit memo items and their taxation items created in the invoice reversal are applied to the corresponding invoice items and invoice taxation items respectively.

After you reverse an invoice, Zuora now sets some taxation item fields of generated credit memo items by copying values from the corresponding invoice taxation items. The values of the following taxation item fields are copied:
  • taxRate
  • exemptAmount
  • taxRateType
  • taxAmount - When an invoice is reversed, tax is not calculated by Avalara through the Connect Tax Engine. Instead, the tax transaction event type is recorded as an "Override Call." This occurs because the billing rule Enable Sequential Billing Document Number is set to Yes, which assigns a temporary document number in the format TMP-CM-***."
Note: With Direct Avalara integration, invoice reversal can temporarily create an orphan billing document in Avalara if the tax call succeeds but the Zuora transaction later rolls back. The credit memo is not persisted in Zuora in this case. Zuora removes the orphan billing document automatically through a scheduled cleanup job.

After the reversal completes

The following changes occur after the reversal finishes:

  • The invoice remains in Posted status and its Reversed field is set to true.

  • The generated credit memo is available in the invoice transaction table and is applied to the reversed invoice.

  • The related charges are returned to an unbilled state so that the affected period can be billed again.

  • The reversal cannot be undone.

The billing-engine reset does not necessarily update RatePlanCharge.UpdatedDate. Do not use an unchanged UpdatedDate to determine whether the reset occurred.

Depending on the data view, ChargedThroughDate and ProcessedThroughDate can appear empty after the reset instead of showing the start of the billing period. A cached, exported, or previously retrieved view can also show the pre-reversal values. Verify the current charge data before concluding that the reversal failed.

Choose the appropriate correction action

Use Reverse Invoice when you need to correct the underlying billing for a posted invoice and generate a new invoice for the same billing period. The operation creates and applies a credit memo, resets the billing checkpoint for the related charges, and marks the invoice as reversed.

Use Write Off when your goal is only to reduce an invoice balance to zero because the balance is uncollectible or because the invoice cannot be reversed under a supported restriction. A write-off creates and applies a credit memo to settle the invoice balance, but it does not reverse the invoice or undo the underlying billing. For more information, see Write off invoices.

Do not use Reverse Invoice to delete an invoice, cancel an invoice, or test a rollback procedure. After a reversal completes, you cannot reset the Reversed field to false, unapply or delete the generated credit memo, or return the invoice to Draft or Canceled status.

Considerations

You cannot reverse an invoice under any of the following conditions:

  • Payments and credit memos are applied to the invoice.
  • Credit memos or debit memos are not canceled and derived from the invoice.
  • The invoice is split.
  • The invoice is not in Posted status.
  • An invoice contains more than 50,000 items in total, including invoice items, discount items, and taxation items. For invoices with more than 2,000 items, the reversal action is performed asynchronously to prevent timeouts. If the limit is reached during invoice reversal, unpost the invoice and cancel it. If you do not want to unpost an invoice, create a credit memo or debit memo from the invoice to adjust or correct the amount.
  • At least one subscription with a charge on the invoice has been transferred to another account. Reversal is not supported because it would conflict with the ownership transfer.
  • The invoice is not the most recent legal document for the account. A newer invoice or credit memo exists for the same account or charges, so only the latest legal document can be reversed.