Why doesn't my new tenant appear on existing invoices?

If you added a new tenant and assigned them to a building local, but they don't show up on invoices you already generated, this is expected behavior — not a bug.

How invoice generation works

When you create an invoice in Tenant Billing, the system captures a snapshot of tenant composition at that moment. It calculates each tenant's allocation based on who has occupancy_status = "active" during the billing period.

Why the new tenant is missing

1. Invoice was generated before move-in: If you created the invoice last week but the tenant's move_in_date is today, they were not active when the invoice was calculated. Old invoices are not retroactively updated.

2. Occupancy status is still "scheduled": The background worker runs hourly. If you just set the move_in_date to today, it may take up to an hour for the status to transition from "scheduled" to "active". Wait for the next worker cycle.

3. The billing period doesn't overlap their occupancy: If the invoice covers January but the tenant moved in February, they correctly have zero allocation for January.

What to do

• For future invoices: No action needed. Once the tenant's occupancy_status is "active", they will automatically be included in the next invoice you generate.

• For the current period: If the tenant should be on the current bill but the invoice was already generated, you can cancel the draft invoice and regenerate it after confirming the tenant is active.

• Check occupancy status: Go to Tenant Hub → select the tenant → verify their local assignment shows "active" (green badge).

Pro-rata billing: When a tenant moves in mid-period, their cost share can be prorated using the "By Area × Hours" allocation method, which factors in how many days they occupied the space during the billing period.

Where to manage: Tenant Billing → view existing invoices or create new ones. Cost Allocation → select building → choose "By Area × Hours" for pro-rata mid-period billing.