Sign in

Billing · Reference

Billing period, transaction and invoice statuses

Published documentation for BMS Cloud.

#billing #statuses #transactions #invoices

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.