2026-04-01 subscriptions API; the invoices it produces are ordinary invoices readable through GET /invoices with the parent’s customer_id. For where customers, subscriptions, and invoices fit together, see How Alguna Works.
Who this is for
How roll-up billing works
Core concepts
- Serviced customer: the customer that receives the product or service — the child that owns the subscription.
- Billed customer: the customer that receives the invoice and is responsible for payment — the parent, when roll-up is enabled.
- Roll-up invoice: a consolidated invoice containing line items from subscriptions across several customers in the same family.
Flow
- A child customer has a subscription with roll-up billing enabled.
- When the billing period closes, instead of generating an invoice for the child, the charges are included in the parent customer’s invoice.
- The parent’s invoice groups line items by customer, so it is clear which charges belong to which subsidiary.
- The parent pays the consolidated invoice.
Configuration
Prerequisites
- A customer family exists (parent–child relationship configured).
- The child customer has an active subscription.
Enabling roll-up billing on a subscription
Roll-up billing is configured per subscription.- Open the customer’s subscription (or create a new one).
- In the Invoicing Settings section, find the Roll-up Billing toggle.
- Enable it. The description reads: “Invoice the parent customer for this subscription.”
- Save or activate the subscription.
Roll-up billing is a dashboard setting. It is not a field on the current (
2026-04-01) subscriptions API.System behaviour
What always happens
- With roll-up enabled on a child subscription, the invoice is addressed to the parent customer.
- Line items on a roll-up invoice are grouped by customer, each under a labelled section with the customer’s name. Within a customer group, lines are organised by bundle (if any) and then by product.
- Changing a child’s parent recalculates billing schedules for the child, the old parent, and the new parent.
- The
{CustomerName}memo variable renders the parent.
What is configurable
- Roll-up is per subscription. Not all of a child’s subscriptions have to participate.
- A parent can have its own direct subscriptions. They appear on the same invoice alongside the rolled-up charges.
What never happens
- Issued invoices are never modified when roll-up is enabled or disabled. Unissued invoices for the current period are recalculated, which may cancel a child’s
upcominginvoice so the charges land on the parent instead. - Roll-up does not convert currency. All subscriptions consolidated into one invoice must share the invoice currency. See Multi-Currency.
Edge cases
Enabling roll-up on an existing subscription. Enabling it mid-cycle recalculates the schedule. The child’s mutable (upcoming) invoices may be cancelled and the charges included in the parent’s next invoice.
Disabling roll-up. Future invoices for that subscription revert to the child. The parent’s schedule is updated to remove the child’s charges.
Removing the parent while roll-up is active. Severing the relationship recalculates schedules; with no parent to bill, future invoices go to the child directly.
Children on different billing cadences. Each child subscription keeps its own cadence. Roll-up invoices follow the parent’s billing schedule, and children’s charges are consolidated into the parent’s invoice for the matching period.
Subscription credits. Credits are consumed per subscription within a roll-up invoice: a subscription’s credits apply to its own line items, and the credit lines sit under the same customer section as the charges they offset. Cancelling an unissued invoice rolls consumption back; voiding an issued one does not.
Impact on other parts of Alguna
Examples
Enterprise with three subsidiaries
Resulting invoice to Global Industries:
Partial roll-up
GI North America’s charges appear on Global Industries’ consolidated invoice; GI Europe receives its own invoice.