Lease offboarding

Close out a tenancy in a controlled order — inspection, financial review, approval, then finalize.

Leases → Offboarding → /v2/offboarding

Offboarding is the exit half of a tenancy. A lease ends, and before the unit can be re-let someone has to walk it, settle what is owed, decide what comes out of the deposit, and get the whole thing signed off. Doing that in a fixed order — and refusing to close the record until each step is genuinely done — is what stops a unit being re-let while money is still outstanding.

The stages

An offboarding record moves through one path. Each status is set by completing the stage before it, not by picking it from a list.

StatusWhat it means
DraftCreated, lease not yet bound
InitiatedLease and target date set
Inspection pendingWaiting on the unit walkthrough
Inspection doneChecklist and damages recorded
Financial reviewBalances and deposit being computed
Financials clearedNothing outstanding, or adjustments recorded
Approval pendingWith the checker
ApprovedSigned off, ready to close
FinalizedClosed — the record is now read-only

Two exits sit outside that path: Rejected, when a checker sends it back, and Cancelled, when the tenancy does not end after all.

Starting an offboarding

  1. Open Offboarding → New.
  2. Pick the lease that is ending. The unit, tenant and branch come from the lease.
  3. Set the target offboarding date — the day you expect the tenant out.

The record is created as a draft. Nothing is locked yet, so a record started against the wrong lease can be cancelled without consequence.

Working the record

Each open record has its own tabs.

  1. Inspection

    Work the checklist item by item and record damages as a single amount. An inspection can be waived where a walkthrough is not warranted — that counts as done, and it is recorded as a waiver rather than a silent skip.

  2. Financials

    Computes what the tenancy owes: total invoiced, total paid, the balance, and how the deposit resolves — held, applied against damages and arrears, and what is left to refund. Run it at least once; it reads live figures, so run it again after anything changes.

  3. Documents

    Exit paperwork generated off the record. Each document is pending until it is ready.

  4. Approval

    Maker–checker sign-off. Whoever worked the record cannot approve it.

  5. Activity

    Every state change, in order, with who did it. This is the audit trail for the exit.

What blocks finalize

Finalize is the last step and it is guarded. The record refuses to close while any of these is true, and it tells you which one:

  • The inspection is required and has not been completed or waived.
  • Financials have never been computed.
  • Open invoices remain against the lease.
  • The deposit refund computes to a negative number — damages or allocations need adjusting.
  • A tenant balance is still outstanding.
  • Approval is required and has not been granted.
  • The workflow has not reached approved (or financials cleared, where approval is not required).

Once finalized, the record is closed and read-only. Reopening is not a supported action — raise an adjustment against the lease instead.