Issue your first billing run
Pick the period, review the exceptions the run works out, and issue invoices for every account with accepted consumption in one step.
Updated on
A billing run prices one invoice for each account with accepted consumption in the period you choose, using the active tariff, and issues them together. Starting a run takes the Owner, Administrator or Finance role; other roles with billing access can open runs but not start them.
Before you start#
- Your utility's application must be approved. Until it is, the dashboard says "Billing is available when the utility application is approved." and the start button stays disabled.
- At least one tariff must be active under Tariffs for the category of the accounts you will bill.
- Customers and their accounts are registered, with meters attached.
- The period's readings are accepted under Readings. A reading still waiting for review is left out of the invoice.
Step 1: Open the wizard#
- In the Billing menu, open Billing runs.
- Click Start run. The New billing run page opens with three steps: Cycle and period, Exceptions and Issue.
Step 2: Choose the period#
- Under Reading cycle, pick an active cycle so the dashboard proposes the dates of its last full period, or keep No cycle: choose the dates.
- Check or change Period start, Period end and Invoice due date.
- Under Service area, keep All service areas or limit the run to one area.
- Leave Work out missing consumption from accepted readings ticked. Tick Estimate consumption for meters without a reading in the period only when you want meters with no reading billed on an estimate.
- Click View exceptions. This step saves nothing; the dashboard simulates the run.
Step 3: Review the exceptions#
- Read the figures Invoices to issue, Total amount, Estimated and Accounts left out.
- Under Meters without an invoice, use the button in the What to do column, such as Record reading or Review readings, to fix each case, then click Recalculate.
- When the figures look right, click Continue.
Step 4: Issue#
- Read the summary under Issue invoices: how many invoices, the period and the total.
- Click the issue button, which shows how many invoices it will issue. An issued billing run cannot be cancelled.
What happens next#
The dashboard shows Billing run issued with Invoices issued and Accounts left out. View billing run lists Invoices in this run and lets you build Invoice PDFs as a single ZIP. Each invoice appears under Invoices with the due date you set and the status Open, or Paid when the settlement of earlier estimated invoices or the account's credits already cover the full amount. Every invoice fires the invoice.issued event; residents are notified only if an automation under Automations uses the trigger An invoice is issued.
Common problems#
- "The due date cannot be before the end of the period." Move the due date to the last day of the period or later.
- "To estimate missing consumption, the period must already have ended." Untick the estimate, or pick a period that has finished.
- The No active tariff exception. The account's category has no tariff in force at the end of the period. Use Activate tariff, then recalculate.
- The Already billed exception. The account already has an invoice for exactly that period, and it is never billed twice. If that invoice's amount is wrong, correct it with a credit note.
- Accounts left out after issuing. Fix the cause, then click Retry run on the run's page. The same period runs again: accounts that already have an invoice are skipped and the others are tried again.