Release

Search

 

On this panel, you can see the reseller’s invoices: invoices already generated and those under review. Here you can also manage the invoices.

Reseller invoices list

Each entry in the invoice list consists of:

Status

Link copied to clipboard

This is the invoice payment status (for already generated invoices) or review status (for invoices that require your approval). See the descriptions of possible statuses below.

No.

Link copied to clipboard

This is the invoice sequence number. Click on it to download the invoice .pdf file.

Period

Link copied to clipboard

This is the start and end of the billing period.

Issue date

Link copied to clipboard

This is the date the invoice was created.

Due date

Link copied to clipboard

This is the due date of the invoice.

Period total

Link copied to clipboard

This is the total amount of the invoice which includes all charges for the current billing period.

This is the total amount of payments made by the customer during the current billing period. The color of the numbers in this column corresponds to the invoice status (e.g., green means “paid in full”, orange – “partially paid”, and gray is used for invoices “under review”).

Adjustments

Link copied to clipboard

This is the total of transactions that adjust (decrease or increase) the customer balance during the current billing period:

  • Balance adjustments made by the administrator on the customer panel – charges, promotional credits, refunds, etc. See the Adjust customer balance handbook for more information on transaction types.
  • Adjustments made by the administrator after the invoice is created. See how to adjust an invoice below.

Outstanding balance

Link copied to clipboard

This is the amount the customer must pay to cover the current invoice in full (Period total minus Paid amount and Adjustments). The color of the numbers in this column corresponds to the invoice status (e.g., green means “paid in full”, orange – “partially paid”, and gray is used for invoices “under review”).

Sent

Link copied to clipboard

Shows whether the invoice was sent to the customer.

Invoice statuses

Link copied to clipboard

These are the possible statuses that can be displayed for generated invoices and for invoices under review.

Statuses for generated invoices

Link copied to clipboard
  • Unpaid – this is the invoice status upon generation. If there are previous unpaid invoices, the customer must pay the total amount due from those invoices plus this invoice total to make this invoice paid in full.
  • Paid – the invoice is paid in full (if there are any previous unpaid invoices the payment covers them first).
  • Partially paid – the payment received doesn’t fully cover the invoice total. The partially paid status changes to Paid (if the customer pays in full) or Overdue (if the invoice is still not paid in full the day following the due date).
  • Overdue – the invoice is not paid by the due date. The due date is the date by which payment is expected. The day following the due date, the unpaid or partially paid invoice is considered overdue. An overdue invoice status can trigger system actions for payment collection that are already configured in the customer class (re-sending the invoice to the customer, service limitation, customer suspension, commitment termination, and customer termination).
  • Do not pay – the invoice total is either zero (e.g., the customer didn’t use the service) or negative (e.g., the customer received a promotional credit that was higher than their actual service usage), and there is no unpaid balance from previous invoices (otherwise the status is Previous balance remaining). The customer doesn’t have to make any payments and the invoice is produced for the customer’s reference only.
  • No payment required – the invoice total is lower than the payment collection threshold (specified for the customer class), so the customer isn’t required to pay and the unpaid invoice doesn’t become overdue. If the customer doesn’t make a payment, this invoice total is applied to the next invoice(s) until the Period total of the new invoice crosses the threshold.
  • Previous balance remaining – although this invoice has a zero (or negative) invoice total, when combined with the invoice total from earlier invoices there is still an outstanding balance. The customer must make a payment which will be applied to the earlier invoices. After the previous balance is paid in full, the status of this invoice is Do not pay.

Statuses for invoices under review

Link copied to clipboard

If you want to review and approve invoices before sending them to your customers, enable this option for the specific customer class (Customer class > Invoicing > Regular invoices > Send the invoice via email > select After review and approval by admin).

  • Under review – the invoice is created, but it’s not yet sent to the customer pending your approval. You can review the invoice and either approve it or make corrections first. For example, you can manually adjust the invoice total (the transaction will be included in the current invoice, the invoice .pdf file will be re-generated) or re-issue the invoice (the re-issue task recalculates the invoice charges, payments, refunds, taxes, invoice total, etc. and re-generates the invoice .pdf file). See more details on invoice management options below.
  • Approved – the invoice has just been approved. Once the Approved status changes to Paid or Unpaid, the invoice is automatically sent to the customer.

Note that the period for reviewing the invoice can be limited by the customer class (the number of days specified in the Hold for review field). If you don’t review the invoice during this period, it’s auto-approved by PortaBilling and sent to the customer automatically.

Manage invoices

Link copied to clipboard

To manage a specific invoice, hover over the invoice and click the Action menu more vert. You can select the invoice management options:

  • Download Download
  • Void Void
  • Re-generate PDF Re generate PDF
  • Approve
  • Re-issue
  • Adjust Adjust

To manage several invoices, select them from the list and choose the available action from the toolbar.

Download an invoice

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.
  • Hover over a specific invoice, click Action menu more vert, and select Download Download.
  • Select one or more invoices and click Download on the toolbar.

Void an invoice

Link copied to clipboard

You can void an invoice that was generated incorrectly (and sent to the customer). The invoice is then marked as voided (this is visible in the .pdf file). A new invoice is automatically generated instead of the voided one and the customer is notified via email. The old invoice is kept for audit purposes. To void invoice:

  • Select one or more invoices and click Void on the toolbar; or
  • Hover over a specific invoice, click Action menu more vert, and select Void Void.

Note that when you void an invoice, all subsequent invoices generated for this customer become void, too. The new invoices issued after voiding have new numbers.

Re-generate PDF

Link copied to clipboard

You can re-generate.pdf files for already generated invoices. This can be useful if you have made changes to the invoice template, or if a certain customer or company information was changed. Note that the Re-generate PDF action doesn’t affect any billing data. It only re-creates the invoice .pdf file with updated layouts, fonts, images, and customer and/or company information. To re-generate invoice:

  • Select one or more invoices and click Re-generate PDF on the toolbar; or
  • Hover over a specific invoice, click Action menu more vert, and select Re-generate Re generate PDF.

Approve invoices

Link copied to clipboard

This option is only available when invoices with the Under review status are selected. If you have reviewed the invoice and it’s correct, you can approve it so it is automatically sent to the customer via email. To approve invoice:

  • Select one or several invoices and click Approve on the toolbar; or
  • Hover over a specific invoice, click Action menu more vert, and select Approve.

Re-issue invoices

Link copied to clipboard

You can re-issue an invoice that’s under review, for example, if you need to update the invoice template and/or recalculate billing amounts (charges, payments, refunds, invoice total, etc.).

To re-issue an invoice, click Action menu more vert and click Re-issue. In the Invoice re-issue dialog specify whether you want to process this invoice now or during the nearest off-peak period and click Re-issue.

Once the invoice is re-issued, its status is Under review again, and the invoice is available for re-approval.

Adjust an invoice

Link copied to clipboard

You can adjust regular invoices with a paid, unpaid or overdue status. To adjust a specific invoice, hover over it, click Action menumore vertand click Adjust Adjust. In the Invoice adjustment dialog specify:

  • Adjustment – specify the amount to decrease the reseller’s outstanding balance. It must not exceed the Period total amount.
  • Internal comment – type an internal comment on this transaction. It isn’t visible on the xDR panel and is accessible only from the database directly.
  • Comment visible to the end user – type a comment on this transaction that’s visible to the end user on the xDR panel.
  • Click Adjust in the dialog to complete the task.

When you’re done, click Adjust. The adjustment amount reduces the paid amount and decreases the outstanding balance. The adjustment doesn’t change the invoice period total. The transaction itself will be included in the next invoice.

On this page

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