Delete an invoice

Idempotency Supported

Deletes the specified invoice.

Void the invoice

If the invoice was generated incorrectly, void it instead of deleting it. Voiding preserves the audit trail and allows for future reference and compliance without removing the original record.

Regenerate or import an invoice

If the invoice is for the current term of a subscription, you may regenerate it using the Regenerate an invoice API.
If the invoice is not for the current term of a subscription, you may import it using the Import an invoice API or the UI bulk import action.

Prerequisites & Constraints

The invoice should not have any linked_payments with txn_status as success or in_progress.
The amount_adjusted on the invoice should be zero.
The invoice should not have any applied_credits with cn_status as refunded or refund_due.
The invoice should not have any issued_credit_notes with cn_status as refunded or refund_due.
The invoice should not have any linked_taxes_withheld.
The invoice must not belong to a gift subscription.

Impacts

Invoices

The invoice is marked as deleted = true and can only be retrieved using the List invoices API by using the parameter include_deleted=true.
If the invoice is the first invoice for a subscription or customer (invoice.first_invoice = true), the next invoice generated for the subscription or customer is marked as the first invoice.

Subscription

If the invoice is for the current term of a subscription and the subscription is changed later with proration enabled, no prorated credits are issued.

Usages

Deleting an invoice permanently deletes all associated usages. To regenerate the data, add or bulk import usages and then regenerate the invoice.

Usage Events

Deleting an invoice does not delete the associated usage_event resources.

Integrations

Verify the impacts of deleting an invoice on your accounting integrations.

Implementation Notes

Before calling this API, ensure the following:

Remove any linked_payments with txn_status as success or in_progress.
Remove the following credits:
- any applied_credits with cn_status as refunded or refund_due
- any issued_credit_notes with cn_status as refunded or refund_due
- any adjustment_credit_notes with cn_status as adjusted
Remove any linked_taxes_withheld.

Sample Request

URL Format

POST https://[site].chargebee.com/api/v2/invoices/{invoice-id}/delete

Input Parameters

comment

optional, string, max chars=300

Reason for deleting the invoice. This comment will be added to the subscription entity if the invoice belongs to a subscription. It is added to the customer entity if the invoice is associated only with a customer.

claim_credits

optional, boolean, default=false

Indicates whether to put prorated credits back to the subscription or ignore while deleting the invoice.

Returns

invoiceInvoice object

Resource object representing invoice