Docs
You are viewing:
Product Catalog 1.0
The Invoice index page displays the list of invoices generated for your customers. You can access a specific invoice by clicking on it. Chargebee allows you to perform the following operations on an invoice:
Classic UI users can refer to the Invoice Operations doc here.
These are the basic operations you can perform on any invoice, regardless of its status.
Using the Update Invoice Address option, you can edit the billing and shipping address information listed on an invoice. You can also update non-address fields such as First Name, Last Name, Email, Company, and Phone. Note that this action only updates the address details on the invoice and does not update the billing or shipping details of the customer or subscription.
Note:
Using the Update PO Number option, you can update the Purchase Order Number on the invoice.
This option is helpful when:
Note:
This action will change the PO number linked to the invoice, not the PO number linked to the subscription.
If you want to return an amount to the customer in the form of credits, use the Create Credit Note operation.
You can create Credit Notes as either refundable or adjustable, based on the invoice status.
Note:
If the invoice is partially paid, you can either create an Adjustable Credit Note to adjust the invoice amount or a Refundable Credit Note to refund the paid amount.
See also
You can access actions for a paid invoice by clicking the ellipsis icon on the invoice.
A screenshot showcasing the actions available for a paid invoice is shown below:
Using the Record an offline refund option, you can issue refunds for offline payments made by cash, check, or bank transfer.
See also
Using the Issue a refund option, you can issue refunds for paid or partially paid invoices. This option is available only if the payment was made online or via bank transfer.
See also
Using the Remove option, you can remove the payment associated with an invoice.
The screenshot below shows where you can find the Remove option:
The effect on invoices of different statuses when a payment is removed is detailed below:
Paid Invoice:
When the payment is removed from an already paid invoice, the amount removed will be added to the Excess Payments balance of the customer. Additionally:
Payment Due and Not Paid Invoices:
Once the partial payment is removed from a Payment Due or Not Paid invoice, the amount due will increase 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.
You can access actions for a Payment Due/Not Paid invoice by clicking the ellipsis icon on the invoice.
The screenshot below shows the actions available for a payment due invoice (these are also available for not paid invoices):
The Set expected payment date option allows you to set the date when payment is expected from the customer. You can also set a payment expected date while pausing dunning for an invoice.
The Pause dunning option is available only when the invoice is in dunning. It is used to suspend the dunning process until a certain date. On reaching that date, Chargebee's behavior will depend on whether the date was set within or outside the dunning period.
The Stop dunning option is available only when the invoice is in dunning. It is used to stop the dunning process and cancel all scheduled retries for an invoice. However, the subscription will remain Active and the invoice will be marked as Not Paid, regardless of the final action set in dunning.
Using the Collect Now option, you can collect full or partial payment for an invoice. This option will not appear if there is no payment method on file.
Using the Record Payment option, you can manually record offline payments.
Based on the amount recorded, the payment is considered either a Partial Payment (less than the invoice amount) or Excess Payment (more than the invoice amount).
Partial Payments: When recording the payment, enter the amount collected in the Amount field. The partial amount is deducted from the total amount of the due invoice.
The invoice remains in Payment Due or Not Paid status until the entire due amount is recorded.
Excess Payments: If an excess amount is recorded, it will be added as an Excess Payment at the customer level. This will automatically be applied to future invoices or can be manually applied to existing Not Paid or Payment Due invoices for the customer.
The Apply Credits option appears if there are any refundable credits available for the customer. When selected, the list of available Refundable Credits will be shown and you can choose which credit to apply to the invoice.
The Apply payments option appears if there is any excess amount available for the customer. When selected, the list of available Excess Payments will be shown and you can choose which payment to apply to the invoice.
If the invoice's due amount was not collected after multiple attempts, you can use the Write Off operation to close the invoice.
When this option is used:
Using the Void option, you can cancel an invoice generated with incorrect details. You can recover a voided invoice by regenerating it after correcting the invoice details.
The Void option is available only for the roles of Owner, Admin, Sales Manager, and Customer Support. Voiding an invoice will trigger the invoice_updated event.
You can void an invoice when:
You cannot void an invoice if it has payments associated with it. However, you can void an invoice after removing the payments.
This option is used to permanently delete an invoice.
The Delete option is available only for the roles of Owner and Admin. Deleting an invoice will trigger the invoice_deleted event.
An invoice cannot be deleted if:
During a Void/Delete action:
The Regenerate invoice option lets you restore a voided invoice after making any necessary changes. To correct the details of an invoice before regenerating, navigate to the relevant resources (Customer, Subscription, Plan, Addon, and Coupon) and make the changes.
See our FAQ on scenarios when an invoice can be regenerated.
Example:
If an invoice has an incorrect shipping or billing address, you can change it in the relevant subscription before regenerating the invoice.
If an invoice has incorrect tax details, navigate to Settings > Configure Chargebee > Taxes and change the tax configuration before regenerating the invoice.
After making the necessary corrections, follow these steps to regenerate the invoice.
Step 1: Navigate to the subscription record of the voided invoice using the subscription link at the top of the invoice details page and select the Regenerate invoice option from the banner as shown below:
Step 2: Choose a billing term
Step 3: Configure the options for Custom Period:
Note: The time component chosen will not apply if Chargebee is running on day-based billing mode.
Note:
If you have enabled metered billing on your Chargebee site, invoices will be generated in Pending status. You can perform the following actions on these invoices.
To include one-time charges, use the Add Charge option.
Use the Add Addon option to include an addon in the invoice.
Use the Close this invoice option to add all usage-based charges and post the invoice. When you click Close this invoice, the Close Invoice pop-up displays all the Invoice notes present for this invoice. You can remove some of these notes and add a new note as needed. This note is displayed first in the invoice under Invoice Notes.
The invoice status changes from Pending to Payment Due.
You can also perform operations related to invoices using the Invoices API.
Will the invoice number change when you regenerate an invoice?
Yes, the invoice number will be different when you regenerate the invoice for the subscription.
How do invoice operations affect orders in Chargebee?
See 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.
What is the difference between deleting and voiding an invoice?
If an invoice is deleted, it is removed from the system and the operation cannot be undone. If you are filing taxes, deleting an invoice might be problematic because you will lose the record of the invoice number sequence. For example, if Invoice #002 is deleted, the list of invoices would then be #001, #003, #004, #005, and so on.
If an invoice is voided, the invoice status will be marked as Voided but the invoice will still be available in the system.
When can an invoice be regenerated?
Scenario 1: If you missed adding a coupon to the subscription or taxes were applied incorrectly, you can use the Regenerate Invoice option. When an invoice is generated with an incorrect amount, coupons, taxes, or shipping/billing address, you may void the invoice, make corrections, and then regenerate the invoice with accurate details.
Scenario 2: If 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:
Was this article helpful?