Release

Search

In this chapter, we'll explore how you can track and manage invoices in PortaBilling:

Search for invoices

Link copied to clipboard

You can view all invoices in the system by navigating to Toolbox > Find invoice page.

Search for invoices

Here, you can filter invoices by customer, invoice number, invoice status (“issued” or “pending admin's approval”), issue date, and the date the invoice period covers.

Invoices search

You can also view and filter the list of invoices associated with a specific customer on the corresponding customer page. For this, navigate to Customer > Finances > Invoices and Taxation > Issued Invoices.

Issued invoices On a page displaying invoice search results, you can view the details of each invoice such as payment status, invoice sequential number, issue date, period total, and other invoice attributes. Furthermore, you can perform the operations with invoices, such as adjusting the amount due of a specific invoice.

Adjust the amount due

Link copied to clipboard

You may need to adjust an already generated invoice to reduce the invoice amount due.

It is not possible to increase the invoice amount due with this operation.
Example

Suppose a customer receives their monthly invoice and notices a discrepancy between the invoiced amount and the agreed-upon terms (the agreed discount has not been applied). Even though the invoice has already been issued and included in company reports, the customer wants to pay the agreed-upon amount, not the higher incorrect charge. To address this issue, the admin finds the invoice in PortaBilling and makes the necessary adjustment.

Specifics

Link copied to clipboard
  • Since the invoice has already been generated, the adjustment doesn't change the invoice’s period total or regenerate an invoice PDF. The adjustment amount is applied as a special type of payment transaction, so it does not change the amounts charged for individual services – it will be deducted from the invoice’s amount due, thus decreasing the outstanding balance. The customer is expected to pay the reduced outstanding balance to settle the invoice.
  • The adjustment amount will be immediately displayed on the PortaBilling web interface in a separate column in the invoice list. The customer will see the adjustment transaction in the next invoice.
  • The adjustment amount cannot exceed the invoice period total.
  • You can adjust invoices that have already been paid by customers (e.g., automatically by credit card). In this case, the adjustment amount will be applied to the customer's balance as “unallocated payment” that will cover future invoices.
  • Adjustment operation is unavailable for out-of-turn invoices.
  • If you use the Generic VAT/GST taxation plug-in to assess taxes, you can add GST when adjusting the invoice amount due. The GST amount will be automatically added on top of the adjustment amount for the correct calculation.

How to adjust an invoice

Link copied to clipboard

To adjust a specific invoice:

  1. Hover over this invoice in the list and click Action menu action menu

    Action menu

  2. Click Adjust Adjust

    Adjust invoice

  3. Fill in the details in the “Adjust invoice” dialog. Refer to the UI help for descriptions of each field.

    Adjust invoice dialog

Void

Link copied to clipboard

You can void invoices if they were sent to the customer with incorrect amounts.

Voiding existing invoices is highly undesirable as they have already been processed by your’s and the customers' accounting departments. For instance, tracking and addressing discrepancies between PortaBilling and external accounting systems, such as QuickBooks, can be challenging. Additionally, voiding may require reconciliation with your taxation company to ensure accurate reporting of taxes to the authorities.
Example

Say in January, the customer's accounting department conducts a yearly reconciliation of charged amounts and discovers discrepancies. It's found that a subscription, that had to be canceled on October 31st, remained active, resulting in erroneous charges for November and December. To fix this situation, the admin cancels the subscription and reverses the subscription fee xDRs.

To ensure accurate invoicing, the admin voids the November invoice, which automatically voids the subsequent December invoice. The customer is notified via email about the voided invoices. Corrected invoices with the accurate charges are then issued. These invoices are sent to the customer to be processed by their account department.

Specifics

Link copied to clipboard
  • When you void an invoice, all subsequent invoices already generated for this customer will also become void automatically.
  • The indication that an invoice is “voided” is displayed on the PortaBilling web interface (the “Status” column shows “Void”) and is visible in the PDF file.
    To include void invoices in the search results, turn on the “Include void invoices” toggle on the Invoice search panel.
  • The customer receives a notification informing them that their invoice has been voided.
  • The new invoices are automatically generated within the nearest off-peak period instead of the voided ones. The voided invoices are kept for audit purposes.
    New invoices issued after voiding have new numbers.

How to void an invoice

Link copied to clipboard

To void an invoice:

  • Select one or more invoices and click Void on the toolbar; or

    Void Invoice

  • Hover over a specific invoice, click Action menu action menu, and select Void

    Void in Action menu

Regenerate PDF

Link copied to clipboard

If you have modified the invoice template or updated your company or customer information, you can regenerate PDF files for already generated invoices.

Example

Imagine your customer has updated their legal address information and requests you to regenerate the most recent invoice to reflect the change. In this case, the admin updates the address information on the customer page in PortaBilling, finds the recent invoice, and regenerates the invoice PDF file. Subsequently, the admin downloads the new invoice PDF file and sends it to the customer via email.

Specifics

Link copied to clipboard
  • The “Regenerate PDF” operation doesn't affect any time or monetary invoice attributes, or the invoice number. Its sole purpose is to recreate the invoice PDF file with updated layouts, fonts, images, as well as your company or customer information.

How to regenerate PDF

Link copied to clipboard

To regenerate invoice:

  • Select one or more invoices and click Regenerate PDF on the toolbar; or

    How to re-generate invoice

  • Hover over a specific invoice, click Action menu action menu, and select Regenerate PDF Re-generate PDF.

    Regenerate PDF in Action menu

Download

Link copied to clipboard

You may need to download invoice PDF files, for example, after changing the invoice template to ensure the layout looks correct, or to review invoice data in cases of billing disputes.

How to download invoices

Link copied to clipboard

You can download an invoice PDF file in one of these ways:

  • Click on the specific invoice number and the invoice PDF file is automatically downloaded.
  • Select one or more invoices and click Download on the toolbar

    Download invoice on the toolbar

  • Hover over a specific invoice, click Action menu action menu, and select Download .

    Download invoice in Action menu

Reissue (recalculate) invoices

Link copied to clipboard

You may need to reissue invoices to both recalculate invoice amounts and regenerate invoice PDF files.

The “reissue” operation is particularly useful when addressing a widespread issue that affects the invoices of multiple customers in the system. For instance, if incorrect pricing information has been entered into the customer tariff, resulting in inaccurate billing for numerous customers. After the xDRs have been corrected to reflect the new pricing, PortaBilling enables you to reissue invoices for a batch of customers simultaneously.

You have the flexibility to manually select the affected customers or upload a file containing their IDs.

Alternatively, if the issue is isolated to a single customer and invoices need to be reissued, the “void” operation helps you achieve the same result.

Example

Say an incorrect pricelist was uploaded in March and the issue is discovered in April. The admin has updated the tariff and corrected the charges applied since March using the xDR re-rating procedure, but those incorrect March invoices were already generated and sent to customers. To recalculate the invoice amounts in accordance with the corrected xDRs and send the corrected PDF files to customers, the admin reissues the March invoices.

Specifics
Link copied to clipboard
  • You can choose whether invoices should be reissued if they have already been sent to customers and whether to void the already sent invoices:
    • Reissue only those invoices that have not been sent to customers.
    • The invoices already sent to customers should be voided and new invoices should be created with the new sequence numbers.
    • The invoices already sent to customers should be updated, with the same sequence numbers.

      Reissue invoices

  • The corrected invoices are generated within the nearest off-peak period.
  • The corrected PDF files are available for admins and not automatically resent to customers.
How to reissue invoices
Link copied to clipboard

To reissue invoices, navigate to the Toolbox > Find invoice page and click Batch reissue on the toolbar.

In the dialog that opens, select the date after which the incorrect invoices were issued and affected the customers (it’s also possible to upload a file with customer IDs).

Find the instruction on how to reissue (recalculate) invoices in the Recalculate invoices handbook.

On this page

Release
What's new
Admin manuals
Handbooks
API
UI help
Search