Getting Started

Product Catalog



Invoices, Credit Notes and Quotes



Site Configuration

Data Privacy & Security

Data Operations

Reports and Analytics


Invoice, Credit Note & Quote Numbering 


Chargebee provides advanced options for numbering your invoices, credit notes and quotes.


For the sake of brevity in this document, the word "invoice" would stand for "invoice, credit note and quote" unless specified otherwise.

The figure below specifies the various parts that an invoice number can have in Chargebee.

Here's what they mean:

  1. Prefix: A prefix, when enabled, will be on all invoice numbers and thus help identify all the invoices generated in the Chargebee site.
  2. Dynamic Prefix: A second optional prefix that indicates the date, month and year of the invoice. Several formats are supported.
  3. Numeric Part: This is the number that increments each time a new invoice is created in Chargebee. This is an essential part of the invoice number.
  4. Separators: You may choose to use the hyphen (-) as a separator between parts of the invoice number.

Some Available Invoice Formats 

Listed below are some useful invoice formats. Steps for configuring each of these formats are given in the next section of this document.

1. Simple Series 

Simple invoice numbers incremented by 1 for each invoice generated. No prefixes or separators here.

100001 > 100002 > 100003 …

You can set your invoice numbers to begin from a specific number, say 50001.

When you set this, if you already have invoice numbers generated till say, 10003, your series would look like this:

… 10001 > 10002 > 10003 > 50001 > 50002 > 50003 …

Click here for steps on setting this format.

2. Fixed-Number-of-Digits Format 

Fix the number of digits for invoice numbers by filling-in leading zeroes.

Here we've fixed the number to 6 digits:

000001 > 000002 > … > 000136 > 000137 > … > 762355 > 762356 … 1007300 > 1007301

Note: As seen in the last two numbers in the series above, the invoice number can eventually exceed the number of digits set.

Click here for steps on setting this format.

3. Adding a Prefix 

A prefix can be added to the invoice numbers:

CB-10001 > CB-10002 > CB-10003

Click here for steps on setting this.

4. Adding a Dynamic Prefix 

A dynamic prefix that indicates the date of the invoice can be added:

2017-12-24-10001 > 2017-12-25-10002 > 2018-01-07-10003

Or just the month and year:

2017-12-10001 > 2017-12-10002 > 2018-01-10003

Or just the year:

2017-10001 > 2017-10002 > 2018-10003

Here are the steps for setting this format.

5. Resetting the Number Periodically 

Reset the numeric part of the first invoice number everyday to say, 10000.

2017-11-23-10003 > 2017-11-23-10004 > 2017-11-24-10000 > 2017-11-25-10000

Reset every month:

2017-06-21-10003 > 2017-06-22-10004 > 2017-07-13-10000 > 2017-07-14-10001

Reset every year, say, in April:

2016-02-13-10002 > 2016-02-15-10003 > … > 2016-03-30-10236 > 2016-04-02-10000 > 2016-04-01-10002 …

When resetting yearly, another dynamic prefix is available: Fiscal Year (FY).

The previous series would look as follows with this prefix:

201516-10002 > 201516-10003 > … > 201516-10236 > 201617-10000 > 201617-10002

(The fiscal year prefix is only available when resetting the invoice number and that too every year)

The invoice number can also be reset to a specific value instead of 1, say 20001:

2017-06-10003 > 2017-06-10004 > 2017-07-20001 > 2017-07-20002


Chargebee automatically prevents invoice number duplication by:

  • Making a dynamic prefix mandatory when you are resetting invoice numbers.
  • Allowing only compatible dynamic prefixes for yearly, monthly or daily reset.

Click here for steps on enabling invoice number reset.

6. Random Number Generation 

You may want to be discreet about how many invoices are being generated by your company by wanting to generate random invoice numbers.

Although random invoice numbering is not strictly supported, Chargebee can help by allowing you to increment your invoice numbers by a value greater than 1.

So if the regular invoice numbers were as follows:

… CB-20001 > CB-20002 > CB-20003 > CB-20004 …

You can break the flow a bit by choosing to increment by say, 13 each time:

… CB-20001 > CB-20014 > CB-20027 > CB-20040 …

Note: Credit note numbers do not have this feature.

Click here for steps on configuring this.

Configuring the Settings 

To configure any of the above formats, first navigate to Settings > Configure Chargebee > Invoices, credit notes and quotes > Invoices tab or Credit Notes tab or Quotes tab (as applicable) > Click on Manage next to Invoice Numbering or Credit Note Numbering or Quote Numbering (as applicable). The screen would look like this:

Before we look at how to configure the settings on this page, there are some points to bear in mind:

  1. Chargebee prevents you from applying any setting that may result in duplicate numbers.
  2. Clicking on Save only saves the settings in draft. The settings are applied when you click on Apply changes on the previous page (Customize Invoices, Credit Notes and Quotes).
  3. As you make the changes described below, a preview of the next invoice number is shown at the top.


Case 1: Simple Series and Fixed-Digit Formatting 

  1. Keep Invoice number prefix and Dynamic prefix blank.
  2. Configure Next invoice number:
    • This field is pre-filled with the next number that would be created for an invoice. (The value is 1 if no invoices have been generated yet).
    • You may keep the pre-filled value or enter the number you wish to have on the next invoice.
    • If you wish to fix the number of digits then insert leading zeros too.


Case 2: Adding Static or Dynamic Prefixes 

  1. Set the Invoice number prefix and Dynamic prefix as required.
  2. Next invoice number:
    • This field is pre-filled with the next number that would be created for an invoice. (The value is 1 if no invoices have been generated yet).
    • You may keep the pre-filled value or enter the number you wish to have on the next invoice.
    • If you wish to fix the number of digits then insert leading zeros too.


Case 3: Resetting the Number Periodically 

  1. Enable Reset invoice numbers periodically and specify How often.
    • When resetting daily or monthly, the number will reset on the first invoice of every day or month respectively.
    • If resetting yearly, choose the month of reset in Reset invoice numbering from. The number will reset on the first day of that month.
  2. Choose a Dynamic prefix from the options available. If resetting yearly, you could also choose Fiscal Year (FY) as an option.
  3. First invoice number after reset
    • Choose the default value of 1.
    • Or specify a value that the first invoice number should take on each reset.
    • If you wish to format the invoice number to have fixed number of digits, insert leading zeros in this field till you have the right number of digits.
      Eg. If you wish the invoice numbers to reset to 4 and the number of digits must be 6, then enter 000004 in the field.

Note: A preview is shown for what the invoice number would be on the next reset.


Case 4: Random Number Generation 

As mentioned earlier, there is no way to generate strictly random invoice numbers in Chargebee. However, you may set Increment invoice numbers by to a suitable value to avoid generating invoice numbers sequentially.

Note: Credit note numbers do not have this feature.

Was this article helpful?