Invoices
Invoices
Overview
Invoices collect billable Charges into project-level billing documents.
They sit between charge generation and team-level statements:
Usage Record
↓
Charge
↓
Invoice
↓
StatementInvoices are the right level when staff need to review billing for a specific project before those amounts are rolled up to the team level.
Invoices are intended to be billable artifacts, not just intermediate calculations.
What an Invoice Represents
An invoice groups together eligible charges for:
- a project
- a billing period
- a billing workflow run
Invoices may include:
- charge totals
- billing-rule adjustments
- project-specific billing instructions
- export-ready detail for finance review
How Invoices Are Generated
Invoices are generated from Charges.
Key behavior:
- only charges not already attached to an invoice are added automatically
- overlapping periods do not duplicate charges
- existing invoices may be regenerated and updated
Project-level invoice generation can be run directly, and team-scoped workflows can generate invoices for all projects under selected teams.
Invoice Rules and Adjustments
Invoice rules operate on invoice totals after charges have already been grouped.
Typical uses include:
- capping invoice totals
- scaling invoice totals
- applying team-, project-, or project-type-based targeting
Invoice totals therefore include:
- the raw total from included charges
- any invoice-level adjustment
- the final invoice total after rules
States and Locking
Invoices may move from editable operational billing into locked financial records.
Important behavior:
- invoices remain part of the normal billing workflow while still under review
- marking an invoice as paid makes it read-only
- when an invoice is paid, associated charges are also treated as locked beneath it
If an invoice is later consolidated into a statement, it still remains the project-level billing artifact inside that statement.
Invoice Updates and Export Invalidation
Until an invoice is paid and locked, it may still change when the underlying billing data changes.
For example:
- usage corrections can regenerate charges
- regenerated charges can change invoice totals
- invoice regeneration invalidates any current cached invoice export
This means the invoice remains the live source of truth, while any previously generated export becomes stale and must be regenerated.
Exports
Invoices support export generation.
Invoice exports:
- include detailed charge breakdowns
- are assembled into export batches
- can be reused in later export workflows unless deleted
This makes invoices useful both for project-level review and for downstream finance workflows.
For more detail on export behavior, see Exports.
When to Use the Invoice View
Use Invoices when you need to:
- review billing by project
- confirm that charges were grouped correctly
- inspect invoice-level rule adjustments
- generate or review project-level export detail
- investigate billing before statement consolidation
The Billing Admin → Invoices tab is the primary frontend working list for invoice review.