Customizing Invoices 

Introduction 

Chargebee allows you to tailor the PDFs of invoices, credit notes and quotes sent to your customers.

Navigate to Settings > Configure Chargebee > Invoices, credit notes and quotes to access this feature.

At any time while making changes, you may preview them by clicking on Preview invoice or Preview credit note on the left pane.

Note

Once you have finished customizing and have previewed the changes, please click the Apply changes button at the top to save the changes.

General Settings 

The General Settings tab has options that apply to PDFs of invoices, credit notes and quotes.

Organization Address Format 

If the address of your organization has been added to your profile, this section gives you a way to choose how it appears on the PDFs.

You may choose between the following:

  1. Expanded: The address is displayed as a neat block with each part on a new line.
  2. Single Line: The address is laid out like a sentence.
  3. Custom: Gives you more precise control over the layout. You may edit the text directly or use Mail Merge fields that show up on clicking Show Address Fields. Mail Merge fields are special tags that refer to individual parts of an address. When you use a Mail Merge field, it gets replaced on the PDF with the part of the address that it refers to. This way, when the organization address is changed, the Organization Address Format on the PDF is automatically updated with the new information.

For example, if you want just the name of your company and the email address to appear, you may type-in the Mail Merge fields as follows:
{{org.name}}
{{org.email}}

On clicking Apply, the result would look like this:


Restrictions on country selections


In accordance with the applicable sanctions and export control laws with which Chargebee is required to comply — including those implemented and enforced by the U.S. Department of the Treasury's Office of Foreign Assets Control ("OFAC"), the U.S. Department of State ("DOS"), U.S. Department of Commerce's Bureau of Industry and Security ("BIS"), and other departments and agencies — Chargebee is prohibited from conducting business with any individual or company located in any of the following countries and jurisdictions, absent an applicable government authorization:
  • Cuba
  • Iran
  • North Korea
  • Syria
  • Crimea and Donbas regions of Ukraine

In accordance with Chargebee's Terms of Service, users certify that they will not use Chargebee's products or services in any manner that would result in Chargebee's non-compliance with applicable sanctions and export control laws.

Restrictions on certain parties

Absent an applicable government authorization, Chargebee is prohibited from conducting business with certain individuals and companies appearing on restricted party lists — including, but not limited to, the List of Specially Designated Nationals and Blocked Persons ("SDN List")  published by the U.S. Office of Foreign Asset Control (OFAC)., the Foreign Sanctions Evaders List, the Sectoral Sanctions Identification List ("SSI List"), and the BIS Denied Persons List or Entity List (collectively, the "Restricted Party Lists").

In accordance with Chargebee's Terms of Service, users certify that they will not use Chargebee's products or services in any manner that would result in Chargebee's non-compliance with applicable sanctions and export control laws."

Common Fields 

Additional information to be shown on your invoice/credit note/quote PDFs can be selected here. Enabling/disabling any of these would not affect the PDFs for any regenerated invoices; only the PDFs for newly created invoices/credit notes/quotes would carry the changes.

  • Customer ID and Subscription ID: when enabled, the customer and subscription IDs will be displayed.

  • Billing address and customer VAT number: when enabled, the billing address and customer VAT number (if applicable) will be displayed.

  • Shipping address: when enabled, the shipping address will be displayed.

  • Payments/Refunds: when enabled, any successful payment or refund details will be displayed on the PDFs of invoices or credit notes respectively.

Signature 

This feature can be used to add a handwritten signature to invoice/credit note/quote PDFs. You may upload an image of the signature and add the name to be shown below it. This feature affects the PDFs for regenerated invoices also.

Note

Click here to learn how to add a logo to your invoice.

Template Builder 

Early Access
Template Builder is in early access.

This feature provides a powerful yet intuitive platform for creating customized invoice templates. It supports drag-and-drop functionality for easy design, including essential elements like text, images, custom HTML blocks, merge variables, and more. This allows for the creation of detailed and branded invoices, ensuring templates meet unique business requirements efficiently.

Customize Invoice Template

To Customize your invoice template, follow these steps:

  1. Login to your Chargebee account.

  2. Navigate to Settings > Configure Chargebee > Invoices, Credit Notes and Quotes > General Settings > Invoice Templates. Click Manage.

  3. In the Invoice Templates screen, click New Template to create a new invoice template for customizations. The Default template cannot be customized as it is controlled by Chargebee.

  4. Customize the template as per your requirements.

  5. Click Preview or Save. The saved template is kept in Draft mode for further modification.

  6. Click Edit to modify the invoice template in the Draft mode.

  7. Click Publish. Once the template is published you cannot edit that template.

  8. Click Use this template, once the template is published you can use the template for all your invoices and this template becomes a Default template with an IN USE status. Click Confirm.
    Or
    Click Duplicate as draft to create a duplicate template once the template is published. You cannot create duplicate templates from a Default template.

  9. Click Delete to remove a drafted or published template. You cannot delete a Default template.

Template Builder for Invoices

This section will talk about template customization through various editors, conditions, and more. You can use multiple content formatting options to customize your content like bold, italics, ordered list, unordered list, hyperlink, merge tags, smart text, and more.

The following are the template customization options:

Add Text
Add custom text to your invoice using the text block.

Add Heading
Define section titles using the Heading feature.

Add Columns
Adjust the layout with Columns to manage row width.

Add Divider
Use the Divider to segment your invoice into clear sections.

Add HTML
Embed custom HTML/CSS code with HTML blocks. Ensure to preview this HTML block before publishing the template.

Add Items Table
Organize charges, amounts, and taxes in the Items table.

Add Sections
Include various invoice components such as the Invoice block, Subscription block, Payments & Credits block, and more, in a visually intuitive manner for you to construct an invoice from scratch.

Note

The fields within these sections are not editable. To modify fields, add an HTML block from the Content section, copy and paste the HTML code of the read-only Section Block into it, and then make field-level adjustments.

Add Links
Insert links to the invoice template for different purposes like Payment links for payment purposes.

Control Position
Adjust block positioning with the control position feature. You can re-position each block by dragging and dropping them.

Control Font and Font Size
Customize text appearance with font type, font size controls, and more.

Note

Some fonts during PDF conversion have limitations, and we are currently determining which fonts will be compatible for selection from the UI dropdown.

Add Merge Variables
Include fields that already exist within the Chargebee like billing address, shipping address, subscription ID, Invoice status, and more using the Merge Tags option in the content format panel.

Operations supported on Merge Variables
For the merge variables use conditional statements to show the same template in multiple ways based on certain conditions like if, this, then, that, and more. This allows you to modify the template code.

Click on the Drag & Drop container, you will get the autogenerated code as follows:

{{invoice.hasAnyNote}}
{{invoice.hasAnyPaymentInstruction}}
{{invoice.transferDetails.hasBankTransferInstruction}}
{{invoice.hasAnyPayments}}
{{invoice.hasAnyCredits}}

Example of an if statement

If the invoice does have credits, it displays the word "CREDITS." This allows for the automatic acknowledgment of credits on an invoice when they are present.

{{#if invoice.hasAnyCredits}}
CREDITS
{{/if}}

Example of an if and else statement

If the total amount of the invoice exactly equals "0.00," it displays the message "Zero amount invoice." If the total amount is anything other than "0.00," it displays "Non-Zero invoice." This allows for customized messaging on invoices depending on whether or not there is an amount due.

{{#if (equals invoice.totalExactVal "0.00") }}
  Zero amount invoice
{{else}}
  Non-Zero invoice
{{/if}}

Example of each statement

This code snippet iterates over all subscriptions associated with an invoice and displays each subscription's ID. It lists every subscription ID on the invoice, one after the other.

{{#each invoice.subscriptions as |subscription|}}
{{subscription.id}}
{{/each}}

Add Custom Fields as Merge Variables
Include custom fields that are created by you and inserted into the template to show your customers using the Merge Tags option in the content format panel.

Add Display Condition
Include the display condition for the content appearance on your invoice. You can add one display condition at a time.

Add Quality Text Content
You can use the Smart Text option in the content format panel powered by artificial intelligence to enhance the accuracy of your text content.

Preview Invoice Templates

To preview the invoice template, follow the steps:

  1. Click Preview, once your invoice template is saved as a draft. You can also preview the invoice after editing your saved invoice or before publishing your invoice refer to step 5.

  2. In the Preview screen, select the Customer from the drop-down and select the Invoice ID that is associated with the customer. This feature will help you to preview your template for a specific invoice of a customer.

Limitations of Template Builder

  • The feature is available only for Invoices and not for Credit Notes and Quotes.

  • You can maintain up to 10 templates in published or draft status per site, excluding the default template.

  • Only one published template can be in use or applied to invoices of a site at any given time.

  • Uploading images and using tags are not supported.

  • The item table does not support showing/hiding rows or columns, nor does it support sorting, aggregating, or ordering.

  • Changing the date format is not supported.

  • Importing HTML is not supported. You can import an HTML template if the drag-and-drop editor does not meet your functional requirements. This option is available from the backend with terms and conditions applied, to enable it submit request.

Hide Quantity Columns 

Enabling this option hides the ‘Units' and ‘Unit Price' columns in invoices/credit notes/quotes when the line items are not quantity-based.

If the invoices/credit notes/quotes have both quantity and non-quantity-based products/services, the quantity-related columns will be visible.

Note
  • To enable this feature, contact support .
  • Users who signed up for Chargebee after April 27, 2018 will have quantity related columns hidden by default.

Invoice Settings 

The Invoices tab gives you options specific to customizing the invoice PDFs for your customers.

Title and Numbering 

  • You may choose the title of the invoice.
  • Invoice numbering offers advanced customizations for the generated invoice numbers. More information on this feature is here.
Note

If the invoice numbering customizations are left in the draft state, there is a possibility that those settings may no longer be feasible due to the risk of generating duplicate invoice numbers. Chargebee protects you from such conditions by warning you automatically and not allowing you to apply the changes till you fix them.

Invoice Fields 

Additionally, the following information may be added:

  • Invoice status: Enabling this setting will show the invoice status.

  • Billing period: Adds the billing period(s) for the line items in the invoice. If the billing period is the same for all recurring line items, the period will be shown at the header level. If the billing periods of the line items differ, then the periods will be shown at the line-item level. Please note that this option is only applicable for recurring line items and not for one-time invoices.

  • Next billing date: Displays the next billing date. This option is also only applicable for recurring invoices and not for one-time invoices. Next billing date does not apply to subscriptions in Non-Renewing state.

  • Payment terms & Due date: If you have enabled Net-D, enabling this setting will display the payment terms and the invoice due date on the PDF for invoices that are posted.

  • Credit note number: When a credit note is created and applied on the invoice (both adjustment and refundable), the credit note number gets displayed on the invoice PDF along with the allocated credit amount or adjustments under Credits & Adjustments.

  • Custom fields: If you track additional information about a customer or their subscription using Custom Fields, then up to 3 of those can be displayed.

Invoice Notes 

Here you can set generic notes that should be part of every upcoming PDF invoice. These notes will appear in the Notes section following other invoice notes that may have been set.

Payment Instructions 

To access this information navigate to Settings > Configure Chargebee > Customize Invoices, Credit Notes and Quotes > Invoices

When offline payments are to be made by the customer (For example, using bank transfer/PayPal/ACH credit transfers), complete instructions for doing so can be shown on the PDF invoice using this feature. Payment instructions are not shown for Paid invoices; they are only shown for Payment Due, Not Paid and Posted invoices.

3 kinds of payment instructions can be configured:

  • Bank Transfers
  • PayPal
  • ACH Credit Transfer
  • SEPA Credit Transfer

While Bank Transfer and PayPal options are available by default as shown below, ACH Credit Transfer is made available only when applicable.

Since you may have different bank transfer particulars for different regions, any number of Bank Transfer type payment instructions can be added to the PDF invoice. For each such instruction, up to 9 fields can be added.

For PayPal instructions, a section title and description can be specified. Only one PayPal payment instruction may be configured for your site.

ACH Credit Transfer option shows up under Payment Instructions automatically when Stripe ACH credit transfer is enabled and is removed when Stripe ACH credit transfer is disabled.

Manual addition/removal of this payment instruction cannot be done. Only one ACH credit transfer payment instruction is configurable for your site.

When a customer has a Stripe virtual bank account, ACH credit transfer instruction (if enabled) is included in their PDF invoices. Whenever ACH credit transfer instruction is present, bank transfer instructions (if any) are not included in the PDF.

SEPA Credit Transfer option shows up under Payment Instructions automatically when Stripe SEPA credit transfer is enabled and is removed when Stripe SEPA credit transfer is disabled.

Manual addition/removal of this payment instruction cannot be done. Only one SEPA credit transfer payment instruction is configurable for your site.

When a customer has a Stripe virtual bank account, SEPA credit transfer instruction (if enabled) is included in their PDF invoices. Whenever SEPA credit transfer instruction is present, bank transfer instructions (if any) are not included in the PDF.

Localization is supported for all the information fields under Payment Instructions. More details on configuring multiple languages for localization can be found here.

Whenever a payment instruction is added, it is crucial that any such information that may have been added via invoice notes, be removed. Since past invoices may already have such notes associated with them, Chargebee restricts adding new payment instructions to PDFs of regenerated invoices to avoid duplication. However, you may contact support  if you would still like to remove this restriction for your site.


Credit Note Settings 

The Credit Notes tab gives you options specific to customizing credit note PDFs.

Title and Numbering 

  • Credit note title: Select the title that appears at the top for refundable credit note PDFs. For adjustment credit notes, the title is always "Credit Note".

  • Credit Note Numbering: Credit note numbering offers advanced customizations for the generated credit note numbers. More information on this feature is here.

Credit Note Fields 

Additional information to be included in credit note PDFs can be selected from the following options:

  • Credit note status: Enabling this setting adds the status of the credit note to the PDF such as Adjusted, Refunded, Refund Due, or Voided.

  • Service period: Enabling this setting adds the service period of the credit note to the PDF. If the service period is not provided for the credit note, then the date on which the credit note was created gets displayed.

  • Invoice Date: Enabling this setting adds the date on which the credit note is applied to the PDFs.

Notes 

Generic notes that are to be part of every credit note PDF sent are set here.


Was this article helpful?
Loading…