Invoice Lifecycle
Invoices in Floatless follow a predictable lifecycle from creation to payment.
When should I read this?
Read this if you need to understand how invoices progress through different states, or how to handle invoices at each stage.
Lifecycle stages
Draft → Posted → Paid
↓
Overdue → Void
Draft
Invoice is being prepared. Not yet visible to customer.
- Add or modify line items
- Adjust amounts
- Delete without consequences
Posted
Invoice is finalized and sent to customer.
- No more edits (create adjustments instead)
- Payment can be collected
- Visible in customer portal
Paid
Full payment received.
- Invoice is settled
- Revenue is recognized
- No further action needed
Overdue
Past due date without full payment.
- Triggers collection workflows
- May accrue late fees (if configured)
- Can still be paid
Void
Invoice is canceled and no longer valid.
- Used for billing errors
- No payment expected
- Doesn't affect revenue
Automatic transitions
| Trigger | Transition |
|---|---|
| Finalize invoice | Draft → Posted |
| Full payment received | Posted → Paid |
| Due date passes | Posted → Overdue |
| Admin voids invoice | Any → Void |
Common operations
| Action | When to use |
|---|---|
| Finalize | Invoice is ready to send |
| Send reminder | Payment is overdue |
| Record payment | Payment received outside Stripe |
| Void | Cancel incorrect invoice |
| Create credit note | Partial refund or adjustment |