Bill Runs

A bill run finds subscriptions that are due to be billed, generates invoices for the selected billing window, and advances billing cycles after execution.

Use bill runs when you want Floatless to produce invoices from active subscriptions instead of creating invoices manually.

Preview before execution

Bill run preview is the review step. It lets you see which subscriptions are eligible and what invoices would be generated before any invoice is committed.

You can preview using one of two end conditions:

Preview mode	Use when
As of date	You want to preview all billing activity due on or before a specific date.
Billing cycles	You want to preview a fixed number of future billing turns without choosing a calendar end date.

These modes are mutually exclusive. Choose either an as-of date or a number of billing cycles.

What preview checks

Preview evaluates:

Subscription status.
Next billing date.
Billing period and current billing cycle.
Product prices and quantities.
Metered usage that has been recorded for usage-based lines.
Customer tax settings and tax-exempt flags.
Existing invoices for the same subscription period.

Preview does not send invoices, collect payment, or advance subscription billing dates.

Execute a bill run

Execute only after preview results are correct.

Execution can:

Generate invoices.
Attach invoice line items.
Apply taxes, coupons, discounts, and credits where applicable.
Update subscription billing cycle dates.
Emit billing events for downstream systems.

Common review checks

The customer count matches the expected billing cohort.
No paused, canceled, or future-start subscriptions are included.
Invoice service periods are correct.
Taxes and discounts are visible on invoice lines.
Usage-based amounts include only the intended usage window.
Duplicate invoices are not created for an already billed period.

Troubleshooting

Symptom	Check
Subscription missing from preview	Confirm status, start date, next billing date, and billing period.
Invoice amount is wrong	Check product price, quantity, coupon, customer tax status, and usage records.
Preview shows too many future invoices	Use either as-of date or billing cycles, not both.
Execution created no invoices	Confirm the preview had eligible subscriptions and was not run against an empty window.