> ## Documentation Index
> Fetch the complete documentation index at: https://docs.techfootintl.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Billing Group

> A set of Billing Accounts that bill together — the object a Bill Term is opened against.

## What is a Billing Group

A **Billing Group** is a set of [Billing Accounts](/billing/billing-account) that are billed together. It is the object the [billing orchestrator](/billing/bill-run-creation) opens a [Bill Term](/billing/term) against.

Where a Billing Account decides *what becomes one bill*, a Billing Group decides *what runs in one go*.

```
Subscription        the smallest billable unit
      ↓ sits inside
Billing Account     one account, one bill
      ↓ grouped into
Billing Group       what a single bill run covers
      ↓ a Bill Term is opened over it
Bill Term           the run itself
```

## How you group them is your decision

There is no rule the system imposes about which accounts belong together. The group exists so an operator can decide what runs as one batch of work.

A submetered billing provider might put one property owner's thousand tenants into a single group, so that owner's whole portfolio bills in one run and can be reviewed as a unit. Or they might put two different property owners into the same group because it suits them to process both together. Neither is more correct.

The grouping is operational. It reflects how the people doing the billing want to work, not anything about the customers themselves.

## The one rule

<Warning>
  **Every Billing Account in a Billing Group must share the same [Billing Period](/billing/billing-configuration).**

  A group cannot mix accounts billing monthly with accounts billing weekly, or accounts billing on the 1st with accounts billing on the 15th. The period is decided at the Plan and inherited down through the Subscription and the Billing Account, so by the time an account joins a group its period is already fixed.
</Warning>

This constraint is what makes the orchestrator simple. Because every account in a group falls due on the same day, the orchestrator never has to work out which accounts belong together — the group already answers that. It only has to work out *when*.

## What happens at run time

When a Billing Group's Billing Period falls due:

1. The orchestrator opens a **Bill Term** against the group.
2. Every Billing Account in the group is brought into the term.
3. All of those accounts' Subscriptions are rated in the term's subscription section.
4. Their component values are summed into the term's summary section.

See [What a Bill Term Contains](/billing/term#what-a-bill-term-contains) for what happens inside the term, and [Term Creation](/billing/bill-run-creation) for how the orchestrator picks groups up.

## Related

* [Billing Account](/billing/billing-account) — the level below; one account produces one bill
* [Billing Period](/billing/billing-configuration) — the cycle and billing day every member shares
* [Bill Term](/billing/term) — what gets opened over the group