Billing period, transaction and invoice statuses
Three records carry a status through the monthly run, and they are easily confused because two of them can read Completed at once. This topic describes each in the order the work passes through them.
Billing period statuses
The billing period is the month of a contract. Its status is shown in the header of the billing period screen and as the Status column on the Billings list.
| Status | Meaning |
|---|---|
| Pending | No transaction has been generated yet. The screen states when one is due and offers to generate it now. |
| Open | A transaction exists and is being worked on. |
| Completed | The period's transaction is complete. Charge averages are updated at this point. |
| Cancelled | The period will not be billed. Only available while no live transaction exists against it. |
The Billings list separates these across tabs — Pending, Open, Released, Completed and Cancelled — with the Open tab being where the month's review work is done.
Filtering the list
Two filters govern what the Billings screens show. Both are set from Adjust Current Filter and both persist across the billing screens — including a contract's own Billings tab — until they are removed with the × on the filter chip.
| Filter | Values |
|---|---|
| Billing group | Any billing group configured for your organisation. Also available as one click from Public Filters. |
| Billing month | Current Month, Next Month, Previous Month. |
Billing month is relative to today, not a fixed date, so a saved filter stays correct as the months pass.
Period fields
| Field | Description |
|---|---|
| BMS Ref | Reference for the billing period, derived from the contract reference and the period. |
| Customer Ref | The customer's own reference, where they have supplied one for the invoice. |
| Description | Human-readable period name, for example Billing for APR 2026. |
| Billing no | The period's sequence within the contract, for example 62 of 60. |
| Previous Billing / Next Billing | Links to the adjacent periods on the same contract. |
| Due On | The date the period falls due. |
| Base Period | The date range the fixed charges cover. |
| Usage Period | The date range the metered charges cover. |
| Recon Period | The date range being reconciled, on contracts that reconcile over multiple periods. |
| Readings progress | How many assets and meters have been read, split by whether the readings are automatic or manual. |
| Readings requested | When a meter request was last sent. |
Transaction statuses
The transaction is the calculated bill for a billing period.
| Status | Meaning |
|---|---|
| Open | Editable. Readings can be entered, lines added or adjusted. |
| Held | Deliberately excluded from this run. A held transaction is not picked up by bulk release. |
| Released | Approved for invoicing. Reversible until an invoice is generated. |
| Completed | An invoice has been generated from the transaction. |
| Cancelled | The transaction will not be billed. |
| Action | From | To |
|---|---|---|
| Hold | Open | Held |
| Unhold | Held | Open |
| Release | Open | Released |
| Unrelease | Released | Open |
| Complete | Open, Released | Completed |
| Cancel | Open, Held | Cancelled |
| Void invoice | Completed | Released |
Transaction types
The type describes what a transaction is for, and appears beside its reference.
| Type | Meaning |
|---|---|
| Advance | The first transaction on a contract. Fixed charges only — there is no usage history yet. |
| Pro rata advance | An advance transaction for a partial first period, where the contract starts mid-month and bills on calendar months. |
| Cyclical | The ordinary monthly transaction: fixed charges forward, usage backward. |
| Termination | The final transaction, settling what is outstanding when a contract ends. |
| Reversal | Reverses a transaction that has already been invoiced. |
| Rebill | Replaces a reversed transaction with a corrected one. |
| Adjustment | A correction raised against a period without reversing it. |
A billing period schedules one of Advance, Cyclical or Termination. The remaining three types are only ever created by a correction. Reversals and adjustments cannot themselves be reversed or rebilled.
Invoice statuses
An invoice is generated from one or more released transactions.
| Status | Meaning |
|---|---|
| Draft | Created, not yet approved. |
| Approving | Approval is in progress. |
| Approved | Approved and ready to be processed. |
| Processing | Being processed. |
| Processed | Processed and ready to send. |
| Completed | Sent to the customer. |
| Cancelled | Cancelled, or voided after processing. |
| Action | From | To |
|---|---|---|
| Approve | Draft, Approving | Approved |
| Unapprove | Approved, Approving | Draft |
| Process | Approved, Processing | Processed |
| Cancel processing | Processing, Processed | Approved |
| Complete | Processing, Processed | Completed |
| Uncomplete | Completed | Processed |
| Cancel | Draft, Approved | Cancelled |
| Void | Processed, Completed | Cancelled |
| Reset | Approving, Approved, Processing | Draft |
Important
Cancelling an invoice that was already processed or completed voids its snapshots. The transaction behind it returns to Released rather than to Open, so it can be invoiced again without being recalculated.