Docs

Invoice Operations Classic UI 

Leap UI users can refer to the Invoice Operations doc here.

When you open an invoice from the Invoices tab in Chargebee, the invoice details are presented. Here, you can choose from the following actions that are made available on the "Actions" panel on the right:

Emailing Invoices 

You can send the invoice via email using the Send Email option.

Update Addresses 

Using the Update Invoice Address option, you can change the billing and shipping addresses for individual invoices.

Note
  1. This action will only change the address details linked to the particular invoice and not the billing or shipping address linked to the customer or subscription.

  2. If you have enabled the taxation feature for your site, the region cannot be changed using this option if the tax rate calculated is dependent on the location, as the tax rate applied would change. More on Chargebee's taxation feature here.

Collect Now 

Using the Collect Now option, you can collect full or partial payment for an invoice.

Record Payment 

Using the Record Payment option, you can manually record offline payments received for invoices which are in Payment Due or Not Paid state.

Partial Payments

While recording the payment, enter the amount collected in the Amount field. The partial amount is deducted from the total amount of the due invoice.

Note

The invoice remains in Payment Due or Not Paid state until the entire due amount is recorded.


Excess Payments

You can record the amount paid by the customer which is in excess to the invoice amount.

The Record Payment option can also be used to record the amount received in excess of the amount due.

Once the excess amount has been recorded, it will be added as an Excess Payment at the customer level. This will then automatically be applied to the future invoices. It can also be manually applied to the existing Not Paid or Payment Due invoices.

Apply Excess Payments 

Using the Apply Payments option, you can apply excess payments manually on invoices.

The Apply Payments option is only available when:

  1. Excess Payments are present for the customer.
  2. The invoice is in Payment Due or Not Paid state.

Remove Payments 

Use the Remove option to remove the payment applied to an invoice.

The effect on invoices of different statuses when a payment is removed, is detailed below:

Paid Invoice

Once the payment is removed from a Paid invoice, the amount will be added to the Excess Payments balance of the respective customer. Additionally, if

  • Auto collection is ON, the invoice status will change to Not Paid and the amount due will be increased.
  • Auto collection is OFF, the invoice status will change to Payment Due and the amount due will be increased.

Payment Due and Not Paid Invoices

Once the payment is removed from a Payment Due or a Not Paid invoice, the amount due will be increased but the invoice status will remain the same.

Note

The Remove option will not be available if the invoice has been partially or fully refunded.

Apply Credits 

The Apply Credits option allows you to apply Refundable Credits that are present for a particular customer to the invoice.

The Apply Credits option is only available when,

  • Refundable Credits are present for the customer.
  • The invoice is in Payment Due or Not Paid state.

When this operation is selected, a list of the available Refundable Credits will be shown and the preferred credit can be chosen to be applied to the invoice.

Refund 

Using the Refund option, you can issue refunds for paid or partially paid invoices. More on issuing refunds via the web interface here.

Record Refund 

If you've collected offline payments and need to refund the same, use the Record Refund option.

More on refunding offline payments here.

Create Credit Note (Reverse Invoice) 

If you would like to return an amount to the customer but would like to retain the same in the form of credits, you could use the Create Credit Note operation.

Update PO Number 

Using the Update PO Number option, you can update the Purchase Order Number in the invoice. This option is helpful when,

  1. PO Number was not entered while creating a subscription.
  2. The PO Number has been modified and needs to be updated in the older invoices.
Note

This action will only change the PO number linked to the particular invoice and not the PO number linked to the subscription.

Write Off 

If the invoice's due amount was not collected even after multiple attempts, the Write Off operation can be used to close the invoice.

When this option is used,

  • An Adjustment Credit Note will be created for the invoice due amount. This Credit Note will have the reason code as "Write Off" and will then be applied to the same invoice.
  • The invoice's status will be marked as Paid.

Void 

Using the Void option, you can cancel an invoice generated with incorrect details. An invoice can be voided when:

  • The invoice amount is incorrect.
  • The customer requests for a change in the invoice.
  • The customer cancels the order.

An invoice cannot be voided if it has payments associated with it.

Note
  1. The Void option will be available only for the roles of Owner, Admin, Sales Manager, and Customer Support.
  2. If Promotional Credits had been applied to a voided invoice, the credits will be reclaimed and added back to the customer.
  3. If Prorated Credits had been applied to a voided invoice, the credits will be reclaimed and added back to the subscription.
  4. If the current term's invoice is voided and if the subscription is changed with the option Apply prorated credits and charges enabled, then Prorated Credits will not be created for that subscription and will not be applied for subsequent invoices.
  5. Voiding an invoice will trigger the invoice_updated event.
  6. The voided invoice can be regenerated after correcting the invoice details.

Delete 

This option is used to permanently delete an invoice.

Note
  1. The Delete option will be available only for the roles of Owner and Admin.

  2. If Promotional Credits had been applied on a deleted invoice, then the credits will be reclaimed and added back to the customer.

  3. If Prorated Credits had been applied on a deleted invoice, then the credits will be reclaimed and added back to the customer.

  4. If the current term's invoice is deleted and if the subscription is changed with the option Apply prorated credits and charges enabled, then Prorated Credits will not be created for that subscription and will not be applied for subsequent invoices.

  5. Deletion of an invoice will trigger the invoice_deleted event.

  6. An invoice cannot be deleted if:

    • the invoice has been paid for
    • Credit Notes were applied to the invoice

Deleting Vs. Voiding 

If an invoice is deleted, it is removed from the system and the operation cannot be undone. If you are filing for taxes, deletion of invoice might be problematic because you will lose record of the invoice number sequence. For example, if an Invoice #002 is deleted, the list of invoices would then be #001, #003, #004, #005, and so on.

If an invoice is voided, on the other hand, the invoice status will be marked as Voided but the invoice would still be available in the system.

Regenerate Invoice 

Regenerate invoice option allows you to create the invoice for the subscription, again, for the current term.

When will you regenerate the invoice?

Scenario 1: In case you have missed adding a coupon to the subscription or if the taxes have been applied incorrectly, you can utilize the Regenerate Invoice option. So when an invoice is generated with incorrect amount, coupons, taxes, shipping/billing address etc., you may void the invoice and correct the invoice. After the corrections are made, you can regenerate the invoice with accurate details.

Scenario 2: If the subscriptions are imported into Chargebee (via API), invoices will not be created automatically. In this case, you can create an invoice using the Regenerate Invoice option.

An invoice can be regenerated when,

a) A Subscription has no current term invoices (Invoices are voided/deleted)
b) A Subscription has no current term Unbilled charges

An invoice cannot be regenerated when,

  1. A Subscription is In-Trial, Future or Cancelled state
  2. A Subscription has a recurring invoice for the current term
  3. A Subscription has recurring Unbilled charges for the current term
  4. A Subscription has an Advance Invoice

Steps to Regenerate an Invoice

Step 1: Search for a subscription and select the Regenerate Invoice option.

Step 2: Choose a billing term

  1. Full Term - the invoice will be generated for the entire billing term
  2. Custom Period - select a specific period for which you want to regenerate the invoice.

Step 3: Configure the options for Custom Period:

  1. Choose a custom period for which you want to regenerate the invoice
  2. Choose Start and End date (ensure these dates are within the billing cycle).

    Note:
    The time component chosen would not apply if Chargebee is running on day-based billing mode.

  3. Choose to prorate the charges for that period or not
  4. Choose to invoice the charges immediately or add them to unbilled charges (if Consolidated Invoicing is enabled)
Note
  • The set up fee of a plan does not appear in the line items of the regenerated invoice.

  • If you had enabled the option to hide zero value line items in your site settings, an invoice will not be generated even if the subscription is in Active state. In such cases, you do not see the option to regenerate the invoice.

Manage Dunning 

This option is available when you have enabled dunning, and only for Payment Due invoices.

Chargebee will retry to collect payment from the customer if their invoice is in dunning. However, if you would like to make an exception for your customer, or you were informed that the payment will be made on a specific date, you can stop or pause the dunning for the invoice in Chargebee.

The option to manage dunning is available in the invoice details page.

When you select Manage Dunning option, you can either pause or stop dunning for this invoice.

Download as PDF 

You can download the invoice as PDF copy for local reference.

If you need to download invoices in bulk you can do that as well. Navigate to Invoices tab and use the Export as PDF option.

You can also set the criteria using the filters and download those invoices. When downloading multiple invoices, the PDF files will be mailed to you as an attachment.

Note

Each PDF file will contain a maximum of 50 invoices, one on each page.
So for example, if you're downloading 80 invoices, you will receive 2 separate emails, one with 50 invoices and the other with 30 invoices.

Invoice Notes 

The Invoice Notes option allows you to add additional notes to the invoices.

Invoice Notes can be setup specific to each customer or subscription. It can also be set up at a Plan, Addon, or Coupon level, to ensure they are included only when that specific item is part of the Invoice. You could also use the Invoice Notes option (Settings > Configure Chargebee > Invoices, credit notes and quotes > Invoices tabInvoices, credit notes and quotes) to add a default note for all invoices. More on Invoice Notes here.

Add Charge Item 

To include one-time charges, use the Add Charge Item option. This option is available for invoices in Pending status.

Add Addon Item 

Use the Add Addon Item option to include an addon in the invoice. This option is available for invoices in Pending status.

Close Now 

If you have enabled metered billing in Chargebee, invoices will be generated in Pending status.

Use the Close Now option to add the usage based charges and Chargebee will change the invoice status from Pending to Payment Due.

Invoices API 

You can also perform operations related to invoices using the Invoices API .

FAQ 

How do I correct the details of an existing invoice?

You need to navigate to the respective resources (Customer, Subscription, Plan, Addon, and Coupon) and make the changes.
For instance, if the invoice has incorrect shipping or billing address, you need to change it in the respective subscription or if an invoice has incorrect tax details, navigate to Settings > Configure Chargebee > Taxes and change the tax configuration.

Will the invoice number change when you regenerate an invoice?

Yes, the Invoice number will be different when you regenerate invoice for the subscription.

How do invoice operations affect orders in Chargebee?

Refer to this section on the Chargebee Orders page.

Can I send a quote to a customer and later convert it into an invoice?

Yes, learn more about quotes and proforma invoices in Chargebee.

Was this article helpful?
Loading…