Revision as of 16:19, 1 May 2020

If you are looking for documentation regarding configuration of invoice related settings, visit Invoicing Setup.

Searching Invoices

There are a number of ways to search for and locate invoices.

• You can search by Invoice Number using the Intelligent Search from any page of the admin area.
• For more advanced search options, including searching by line item descriptions, you must use the Invoices List.
  • There is the global Invoices List that lists invoices for all clients. You can access this by navigating to Billing > Invoices (selecting a status is optional).
  • There is the clients' Invoices List, which the system restricts to just a single clients invoices. You can access this via the Invoices tab from the Clients Summary page.

Creating Custom Invoices

WHMCS automatically generates invoices for recurring products and services.

To create a one-off custom invoice, follow the steps below:

1. Navigate to the client you wish to generate an invoice for.
2. Click the Create Invoice link in the Invoices/Billing panel on the Client Summary page. A new invoice will be created in Draft status.
   The due date for manually-created invoices defaults to the same number of days in the future as you allow for automatic invoice generation. You can customize the due date via the Options tab when managing an invoice.
   You can immediately begin adding line items to the invoice.
3. For each invoice that you wish to add, enter a description and amount, and then click the Save Changes button. A new row will then appear to allow adding further line items.
4. If you wish to customise any of the invoice options, including due dates, payment methods, and tax rates, use the Options tab at the top of the invoice

Publishing an Invoice

To publish an invoice, click the Publish button at the top right of the invoice creation screen. Two publish options are available:

• Publish & Send Email — Clicking this button converts the invoice to Unpaid and sends the Invoice Creation email to the customer.
• Publish — Clicking this button converts the invoice to Unpaid without notifying the customer.

Note: The publish buttons only display when the invoice is in Draft status.

Sending Emails

WHMCS has a range of Invoice-related Email Templates, which are all fully customisable.

The system sends most of these emails when various automated triggers occur, but admin-level users can also send all of them on-demand.

To send an email:

1. Navigate to the invoice you wish to send an email for.
2. Select the email template that you wish to send from the menu under the invoice status banner.
3. Click Send Email.

Mass Payment

Mass Payment of Invoices allows customers to pay for multiple invoices in a single transaction.

This is often quicker and more convenient for customers with multiple invoices outstanding. It can also reduce your transaction costs by only processing a single transaction.

Clients can request to perform Mass Payment via the client area if it is enabled.

Admin users can also create Mass Payment invoices:

1. Navigate to the Clients Invoices list within the admin area (you can access this from the Client Summary page).
2. Select the checkboxes next to the invoices you wish to combine for payment.
3. Click the Mass Pay button at the bottom of the list of invoices.

Adding Funds

Adding of funds or credit to an account allows a client to prefund their account ahead of time.

When this option is enabled, clients can deposit funds into their account between a minimum and maximum amount that you define. These funds are the client's Credit Balance.

Admin users can create and add funds invoices:

1. Navigate to the Client Summary page for the client.
2. Click the Create Add Funds Invoice option under the Billing/Invoices section.
3. Enter the desired amount to deposit to the account.
4. Click Submit to complete the process and create the invoice.

The customer will receive an email for the invoice that the system generated with a link to pay it.

Splitting Invoices

Splitting invoices allows you to separate one or more line items from an invoice into a separate invoice.

This is useful if you have a situation where items appear together on a single invoice that a client wants to renew separately, or where a merge has been done incorrectly.

To split items from an invoice:

1. Navigate to the invoice you wish to split items from.
2. Select the checkboxes next to all the line items that you wish to split out into a new invoice.
   Note: All the line items you select here will move to a single new invoice.
3. Select the Split to New Invoice option in the menu immediately below the invoice line items. The form will auto submit and the page will reload with the new invoice containing only the line items you had selected.

This process does not send any email to the customer. If you wish, you should then use the Send Email option to notify the customer of the new invoice.

Merging Invoices

Merging invoices allows you to combine multiple separate invoices into a single invoice.

This is useful for when a client would like to pay for items on separate invoices together at the same time.

To merge invoices, follow the steps below:

1. Navigate to the Clients Invoices list within the admin area (which you can access from the Client Summary page).
2. Select the checkboxes next to the invoices you wish to combine for payment.
3. Click the Merge button at the bottom of the list of invoices.

The system won't send an email notification to customers when performing this action, so if you wish to notify the customer, use the Send Email option in the resulting invoice.

Refunding Transactions

Refunding transactions allows you to issue credits and refunds for payments that clients have made.

There are three options for refunding payments:

• Refund through Gateway — Many payment gateways in WHMCS support automatic refund capability, meaning WHMCS communicates with the payment gateway and instructs the refund amount for the payment gateway to process. This will return the money to the payment method that the customer used to pay.

• Manual Refund Processed Externally — This allows you to record refunds against invoices when something outside of the system processed the refund. For example, you may use this if you process a refund directly within your payment gateway or a chargeback or dispute occurs.

• Add to Client's Credit Balance — This allows you to refund money to the Clients Credit Balance for use towards future invoices.

To perform a refund, follow these steps:

1. Navigate to the invoice you wish to perform a refund for.
2. Select the Refund tab.
3. If there have been multiple transactions for the invoice, select the transaction you wish to issue a refund against.
   You can only refund one transactions at a time, and the refund amount cannot exceed the total amount of the transaction.
4. Enter the amount to refund for a partial amount. Otherwise, leave this blank to refund the entire transaction value.
5. Choose the appropriate Refund Type (see above).
6. If you do not wish to send an email confirming the refund has been processed, uncheck the Send Email checkbox.
7. Click the Refund button to perform the refund.

The page will reload and display the results of the refund attempt if you chose Refund through Gateway. If it fails for any reason, the Gateway Log will help you diagnose why.

Reverse Payment

When making a refund, there is the option to reverse the effects of the original payment. For example, you might prefer to set the invoice status to Collections status and reverse the Next Due Date for associated services.

When you select this option, the system's actions while issuing a refund depend on the configuration in the Setup > Automation Settings page. For more information on this feature, refer to the Payment Reversals page.

Troubleshooting Invoice Generation Problems

When the system isn't generating invoices as you expect, there are several things you should check first.

See Troubleshooting Invoicing Issues for more information.