What are the different invoice statuses and what do they mean?
Every tenant invoice moves through a lifecycle tracked by its status. Understanding these statuses helps you manage billing and follow up on payments.
Draft:
The bill has been created but not yet delivered. You can still edit amounts, add or remove line items, change the due date, or delete the bill entirely. Draft bills do not appear in the tenant's portal. Go to Sent Invoices, find the draft, and click to edit or send.
Sent:
The invoice has been delivered to the tenant via the chosen method (email, postal, or tenant portal). The sent_at timestamp records when delivery occurred. Once sent, amounts are locked — to make changes you would need to cancel and recreate.
Viewed:
The tenant has opened the invoice (viewed_at is set). This is tracked automatically when the tenant opens the email link or views the invoice in their portal. Useful for knowing whether follow-up reminders are needed.
Partial Paid:
The tenant has made a payment but the amount is less than the total due. The paid_amount field shows what has been received, and balance_due shows the remaining. You may need to follow up for the outstanding balance.
Paid:
The full amount has been received. The paid_at timestamp records when the final payment cleared. Paid invoices are included in the "Paid" amount on the billing dashboard.
Overdue:
The due date has passed and the invoice is not fully paid. The system automatically marks unpaid invoices as overdue. These appear in your outstanding balance. Consider sending a reminder or updating the due date.
Cancelled:
The invoice has been voided. Cancelled invoices are excluded from all financial calculations. Use this when a bill was created in error or needs to be replaced. The cancelled_at timestamp records when it was voided.
Where to check: Tenant Billing → Sent Invoices. Status badges are color-coded for quick scanning.