Handling a Late Payment
Collections assume payment deadlines and reminder emails from Settings → Payments, Invoicing & Utilities and Settings → Emails (setup steps 8 and 11) are configured — complete Getting Started — Recommended Setup Sequence steps 1–15 and at least one live reservation before routine arrears work. Lockout catch-up: Getting Started — Lockout catch-up after password recovery. Workflow pairing: Common Workflows — Setup sequence after go-live.
Identify arrears in Step 1 — Identify overdue payments; tenant outreach: Step 3 — Contact the tenant. Record and approve: Step 4 / Step 4b; penalties: Step 5. Escalation and month-end Pending: Step 6 / Step 6b. Non-linear operator habits (Lockout catch-up, Payment alert to receivables triage, Pending manual receipt approval, Reject/revert mistaken receipts, Month-end invoicing (fixed date), Bulk Hostkit invoicing, Utility overage collections, Check-out final utilities handoff, Check-in to check-out handoff, Check-out collections before refund, Check-out ledger cleanup before refund, Finance debt receivables triage, Handling a Late Payment collections, Cancellation collections before void, Rent reduction after invoicing, Same-day turnover coordination, Occupancy KPI to block hygiene handoff, Deposit missing on Finance Deposits, Partly collected security deposit, Wrong tenant on a booking, Cancel Booking vs Delete Booking, Portfolio retirement decisions, Directory list load failures, Booking sidebar tab load failures, Confirmation alert triage, Portfolio segmentation by tenant category) have matching Related subsections below. Full pairing matrix: Handling a Late Payment section cross-reference · Common Workflows section cross-reference.
When a tenant misses a payment due date, follow this workflow to manage the situation consistently. Collections usually apply to Ongoing stays (current in the API) with unpaid scheduled charges, though Upcoming bookings can also owe confirmation or move-in requirements before check-in — see Booking lifecycle.
Start from Notification triage when a payment overdue alert brought you here — during month-end, pair Step 4 row-click triage with Portfolio KPI review — Dashboard Total Debt subtitle and clear payment alerts in Notification triage — Step 5 after balances settle. During departure week, pair with Common Workflows — Check-out collections before refund (upstream Managing a Check-out — Step 6 / downstream Step 5 after Steps 1–4; workflows-check-out-coordination-flow.mp4, bookings-detail-payment-plan-tab-schedule.png). Before policy void, pair with Common Workflows — Cancellation collections before void (upstream Cancelling a Booking — Step 2 / downstream Step 4 after Steps 1–4; finance-contract-values-in-debt-filter.png, bookings-detail-transactions-approve-payment-modal.png, workflows-cancel-booking-refund-modal-flow.mp4). For utility overages on Payment plan, pair with Common Workflows — Utility overage collections (upstream Entering Monthly Utility Bills — Step 4 / Step 4b → Steps 1–4 here; utilities-allocations-row-breakdown-expanded.png, finance-contract-values-in-debt-filter.png, utilities-allocations-review-flow.mp4), Entering Monthly Utility Bills, and Check-out final utilities handoff (departure-week subset). During Step 6 / Step 6b month-end sign-off, poll AI usage API (landlord_chat on GET /ai-usage/summary) when teams leaned on AI Chat for debtor lookups — there is no in-app ledger screen yet. Step-to-module pairing: Handling a Late Payment section cross-reference. Full pairing matrix: Common Workflows — Workflow cross-reference.
- Payment deadlines and penalty rules should be configured in Settings > Payments
- Automated reminder emails should be set up in Settings > Emails > Communication Module
Step 1 — Identify overdue payments
Step 1 pairs with Common Workflows — Payment alert to receivables triage (upstream Notification triage — Step 4 / Step 5; notifications-row-navigate-to-booking-detail.png, notifications-row-navigation-flow.mp4, finance-overview-debt-aging-walkthrough-flow.mp4), Common Workflows — Finance debt receivables triage, Common Workflows — Handling a Late Payment collections hub (triage surface → collections step decision table), FAQ — Handling a Late Payment hub, Common Workflows — Reject/revert mistaken receipts (tenant insists they paid — check booking Transactions for duplicate approved rows before Step 3), FAQ — Bookings that owe money (Top debtors / overdue buckets on Finance → Overview), and FAQ — Finance debt receivables triage hub. Full pairing matrix: Handling a Late Payment section cross-reference.
Collections triage pairs with Notification triage — Step 4, Finance — Debt Aging, Dashboard — Total Debt, and list-bookings / get-payment on Landlord MCP. Downstream: Step 2 when reminders may have fired. Full pairing matrix: Handling a Late Payment section cross-reference.
When a payment overdue or balance alert brought you here, you already completed the upstream path in Notification triage — Step 4 — confirm the balance on this booking before you chase the tenant. Hub matrix: Common Workflows — Payment alert to receivables triage (alert → receivables surfaces → Steps 1–6; notifications-row-navigate-to-booking-detail.png, finance-overview-income-chart-debt-aging.png, finance-overview-debt-aging-expanded-bucket.png) · Handling a Late Payment collections hub (triage surfaces vs Steps 1–6).
| You opened from… | Confirm on booking | Then |
|---|---|---|
| Debt Aging / Top debtors row-click | Payment Plan overdue pills | Step 2 → Step 3 |
/notifications payment overdue row-click | Transactions / Payment Plan | Hub: Payment alert to receivables triage — notifications-row-navigate-to-booking-detail.png → Steps 2–3 |
| Dashboard Total Debt headline only | Open Finance → Overview → Debt Aging first | Finance debt receivables triage — card is not clickable |
| Tenant insists they already paid | Booking Transactions for duplicates | Reject/revert mistaken receipts before Step 3 |
| In Debt line is utility overage (not rent) | Entering Monthly Utility Bills — Step 4 / Step 4b | Hub: Utility overage collections — same Steps 1–4 after charge posts (utilities-allocations-row-breakdown-expanded.png, finance-contract-values-in-debt-filter.png) |
| Ready To Refund blocked by rent/fee arrears | Booking Payment Plan overdue pills | Hub: Check-out collections before refund → Managing a Check-out — Step 6 before Step 5 (workflows-check-out-coordination-flow.mp4) |
Otherwise, find overdue payments in one of these locations:
- Notifications — Payment overdue alerts at
/notifications— when you already received a payment overdue or balance alert, click the row to open the related booking (or tenant / listing when those ids are set) — see FAQ — Notification row-click navigation, Glossary — Notification row navigation, and Notification triage — Step 4 - Finance > Overview tab — use the Debt Aging panel (Top debtors or an overdue bucket) for booking-level receivables, or click In debt on the stacked Income chart for payment-line detail — Glossary — Finance income status; see Finance > Debt Aging and Income status drill-down
- Finance > Contract Values — narrow to In Debt rows (scheduled charges past due or unpaid). On large portfolios, open Other filters first: use the paged Property picker (and Select owners when you reconcile one landlord) to scope the table, then add Booking → Select categories when you segment collections by booking tag, or Tenant → Tenant category when arrears cluster on one tenant segment — see Finance — Property and listing filters, Finance — Tenant category filter, and Glossary — Booking Tag
- Bookings — paste the unit internal name in toolbar Search when you know the room but not the tenant spelling; unit hits rank above tenant name or email. See Bookings — Search bar and Glossary — Directory search ranking.
- Tenants — paste a fiscal ID or identification ID in toolbar Search when collections paperwork references the tax id instead of the tenant’s display name; use the With Debt pill for net-negative balances, then switch to table view and expand the row to scan per-booking Balance before you open a profile or booking sidebar. See Tenants — Interface overview (
tenants-directory-fiscal-id-search.png), Table view (expandable booking rows) (tenants-table-row-expanded-bookings.png), and Glossary — Tenants table expand. - Booking → Payment Plan — scan due-date rows for Overdue, Partial Paid, or Partial Overdue status pills; compare Total (expected for that date) with Paid before opening Contract Values for line-level edits — see Schedule table columns
- Finance → Deposits — when arrears are a partly collected security deposit (not rent schedule lines), click Partial paid in the Deposit lifecycle status row and open a row — the booking Deposit tab shows Partially paid with a remaining helper. Distinct from Partial Paid rent rows on Payment Plan — see FAQ — Partly collected security deposit and Managing a Check-in — Step 3
- Dashboard — Total Debt and related KPI cards highlight live-portfolio underpayment at a glance (ongoing bookings only; the card subtitle is debt on stays older than 15 days, not a repeat of the headline — hover the info icon for in-app rules). Finance Total Debt includes all bookings with current underpayment. When the Dashboard headline looks high but you need deposit coverage or ended-booking receivables, open Finance > Overview (Uncovered Debt, seven-card strip) — see Glossary — Dashboard KPI cards, Dashboard — Total Debt vs Finance Overview, Portfolio KPI review — Dashboard Total Debt subtitle, and FAQ — Dashboard Total Debt subtitle.






Debt Aging and In debt drill-down clips embedded 2026-06-20 20:08 UTC (shared with Portfolio KPI review — Step 7; recorded via tools/record-finance-overview-debt-aging-walkthrough-mp4.ts and tools/record-finance-overview-income-drill-down-mp4.ts).
On Finance > Overview, scan Uncovered Debt and the Debt Aging top-debtor list to prioritize the largest balances before opening individual bookings. Contract Values → In Debt remains the ledger view when you need every overdue scheduled line.
Account-scoped Landlord MCP clients can surface the same overdue balances you find in Step 1 — list-bookings when several tenants owe on the same property, list-payments / get-payment after you resolve a booking id, and get-booking when a payment overdue alert already supplied the reservation context from Notification triage — Step 4. Booking-scoped Tenant MCP get-payment-info remains the right surface when the conversation is tenant-facing, not portfolio-wide (Step 3).
Full pairing matrix: Handling a Late Payment section cross-reference.
Step 2 — Check the automated reminder status
Reminder history is operator UI only — pair Settings > Emails — Communication Rules with booking-scoped get-payment-info on Tenant MCP when chatbot tenants ask about due dates. Upstream: Step 1. Downstream: Step 3. Full pairing matrix: Handling a Late Payment section cross-reference.
If you have overdue reminder emails configured in Settings > Emails > Communication Module, verify whether a notification has already been sent to the tenant and when.
Communication Rule send history is operator UI only — external clients cannot read Settings > Emails — Communication Rules from MCP. Before you chase a tenant in Step 3, booking-scoped Tenant MCP get-payment-info and get-dates-and-schedule answer chatbot questions about due dates and outstanding balances ("when is rent due?") — contrast with whether your overdue reminder rule already fired, which you confirm in the management UI or on Bookings → Communication. get-portal-links surfaces Make payment when the tenant should self-serve after a reminder. Surface-choice contrast: Automation & AI — Workflow pairing for surface choice.
Full pairing matrix: Handling a Late Payment section cross-reference.
Step 3 — Contact the tenant
Direct outreach pairs with Tenant Portal — Make payment (Paywall), Bookings — Communication tab, Inbox module, Common Workflows — WhatsApp per-booking messaging / Notification row-click navigation when collections started from a New WhatsApp message from … alert on /notifications. Upstream: Step 2. Downstream: Step 4 when payment arrives. Full pairing matrix: Handling a Late Payment section cross-reference.
If automated reminders have not resolved the issue, contact the tenant directly. Many late payments are due to oversight — a quick message is usually enough.
Optional — Tenant self-service (Make payment).
When the account payment module and Property Payments Active are enabled, tenants with portal access can pay from Home or Payments → Make payment (/paywall): they pick an amount (overdue, next installment, or full balance), then Bank Transfer (virtual IBAN) or Credit Card (embedded checkout iframe). Card receipts appear on Finance → Transactions after webhook completion — you may still need Approve payment for manual bank transfers your team records. See Tenant Portal — Make payment (Paywall).
Optional — Grant a due-date extension (when agreed with the tenant).
When you negotiate a short extension (for example “pay by Friday”) instead of adding a penalty immediately, an operator with bookings.change_payment_due_date can move the charge due date without rebuilding the whole payment plan:
- Open the booking → Contract Values (or triage from Finance > Contract Values at portfolio scope with In Debt filtered).
- Locate the scheduled or in debt line and use the row calendar action (or Edit due date in the row menu).
- Choose the agreed date in Edit Payment Due Date and save — the Payment Plan tab and Finance roll-ups refresh on the new due date.

Vivin locks due dates on move-in requirement, booking confirmation requirement, and split rent lines — the calendar control is disabled with an explanatory tooltip. Extensions apply only to manually editable lines. See Bookings > Contract Values — system-managed due dates.
Document the agreed extension in Internal Notes or the Communication thread when the tenant confirms in writing. If Communication shows Could not load messages, use Refresh in the sidebar header — other tabs stay available. See Glossary — Booking detail sidebar tab load failures.
Full pairing matrix: Handling a Late Payment section cross-reference.
Step 4 — Record the payment when received
Receipt recording pairs with Finance > Add Payment, Payment Allocation, and create-manual-payment-in on Landlord MCP — pending until Step 4b. Full pairing matrix: Handling a Late Payment section cross-reference.
Go to Finance > Add Payment, select the booking, enter the amount and payment date, and save. The system allocates it to the oldest outstanding charge first based on your payment priorities.
Manual receipts often stay pending until someone with Approve payments confirms them on Finance → Transactions or the booking Transactions tab. Until approval, Total Debt and In debt contract lines may still show the old balance — triage Pending on the ledger and approve (or Reject selected for a mistaken entry) before you mark the tenant current. See Finance — Pending manual payments.
Account-scoped Landlord MCP create-manual-payment-in records the same bank-transfer rows you enter in Add Payment — the receipt may still show pending until Approve payments in Step 4b. External clients cannot approve from MCP; operators continue on Finance → Transactions or the booking Transactions tab.

Step 4b — Approve the receipt (when required)
Pending receipt approval pairs with Processing a New Booking — Step 5b (same habit), Finance — Pending manual payments, and Notification triage — Step 5 after balances settle. Upstream: Step 4. Full pairing matrix: Handling a Late Payment section cross-reference.
When a Payment received from tenant … alert brought you here via Notification triage — Step 4, use this step before you mark the notification read in Step 5 — Total Debt and In debt lines may stay stale until approval completes. Follow the same approval habit as Processing a New Booking — Step 5b and Managing a Check-in — Step 3b. During month-end, the same Pending pill queue appears in Portfolio KPI review — Step 7 when Total Debt or Manual Payments disagree with Analytics:
After you save Add Payment, the row may still show pending until approval:
- Open Finance → Transactions (widen the date range if needed) or the booking Transactions tab and confirm Pending rows exist when you expect a manual approval queue.
- On the ledger, click the amber Pending chip on the All type-summary card (or use the Pending status filter) to isolate manual rows — see Finance — Pending manual payments (
finance-transactions-pending-pill.png). - Locate the manual row in the filtered table.
- Click Approve payment (per-row check icon) or tick several rows and use Approve selected from the floating bar. For a mistaken duplicate on the ledger, use Reject selected (bulk-only on Finance — no per-row reject icon there). Reject selected shows the same red credit note warning as booking Transactions when accounting may already have invoiced the charge — see Finance — Reject payment and Bookings — Transactions row actions.



Full pairing matrix: Handling a Late Payment section cross-reference.
Step 5 — Apply a late payment penalty (if applicable)
Penalty charges pair with Settings > Payments policy, Bookings — Adding Extra Charges, and Audit — Discounts tab when goodwill credits overlap penalties. Upstream: Step 4b when the base charge is still pending. Full pairing matrix: Handling a Late Payment section cross-reference.
If your penalty policy in Settings > Payments requires it:
- Open the booking and click Add Charge on the Transactions tab (see Adding Extra Charges)
- Select Penalty Fee as the category

- Calculate and enter the penalty amount (e.g., 1% of the overdue amount per day late).
- Set the due date and save the charge.
Penalties are not automatically applied — they must be manually added as charges. The penalty configuration in Settings defines your terms, but you must create the charge yourself.
Unpaid move-in requirements after check-in may trigger Auto-cancel unpaid move-in when the account enables it and the grace period elapses with no partial payment — distinct from chasing ongoing rent on Ongoing stays in the steps below.
Step 6 — Escalate if unresolved
Segment-wide escalation pairs with Portfolio KPI review — Step 6, Settings > Emails — Communication Rules audience, Using in-app support (Vivin product defects), and notify-landlord on Tenant MCP (tenant-facing alert — contrast operator filters). Last resort: Cancelling a Booking — hub: Common Workflows — Cancellation collections before void (Step 2 settlement before Step 4; bookings-cancel-booking-modal-refund-types.png, workflows-cancel-booking-refund-modal-flow.mp4). Full pairing matrix: Handling a Late Payment section cross-reference.
If multiple contact attempts fail, escalate through your standard collections process. Document all communication attempts in the booking's notes field for future reference. When arrears block a departure-week Ready To Refund toggle (Ready to Refund on depositStatus — see Glossary — Deposit lifecycle status), pair this step with Common Workflows — Check-out collections before refund and Managing a Check-out — Step 6 before finance queues the deposit return — when the tenant already passed check-out day but status still reads Ongoing with unpaid rows, continue Managing a Check-out — Step 7 after settlement rather than opening a duplicate collections case on an Ended stay. On Upcoming bookings with unpaid confirmation or move-in requirements, pair segment filters with Processing a New Booking — Step 6 before you change portal modules account-wide — portal mail and tenant-category gates may still block self-service Make payment in Step 3. On newly onboarded inventory, pair first-live-booking collections with Onboarding a New Property — Step 7 before you change tenant-category portal rules account-wide. When repeated collections fail, last-resort cancel still requires refund-type confirmation in the booking sidebar — see Cancelling a Booking — Step 4 and post-cancel cleanup in Cancelling a Booking — Step 6. When arrears cluster on one tenant category across several bookings, scope Finance → Other filters Tenant → Tenant category (and mirror on Bookings → Other filters or Tenants — Tenant category filter) before you change communication rules or portal modules account-wide — see Settings > Tenant categories and Portfolio KPI review — Step 6. When unpaid utility overage lines cluster on one segment, pair the same filters with Entering Monthly Utility Bills — Step 4 before you chase rent on unrelated bookings. At month-end, after you clear individual balances in Steps 4–4b, run Portfolio KPI review — Step 7 to confirm Total Debt, Manual Payments, and Debt Aging agree before you sign off portfolio KPIs — lingering Pending rows may still inflate KPIs until you finish the Step 6b mesh: arrival-week move-in transfers (Managing a Check-in — Step 6b), confirmation-week imports (Processing a New Booking — Step 6b), departure-week settlements (Managing a Check-out — Step 6b), cancellation settlements (Cancelling a Booking — Step 6b), and utility overage bank transfers (Entering Monthly Utility Bills — Step 4b). Clear stale payment overdue rows in Notification triage — Step 5 after segment escalation settles — file Notification triage — Step 6 when row-click or read-state fixes need Vivin support.
Account-scoped Landlord MCP get-booking-summary gives portfolio-level active/upcoming counts before you scope Finance → Other filters Tenant → Tenant category for segment-wide arrears — pair with list-bookings when several tenants in the same tenant category owe at once, then list-payments / get-payment after you resolve booking ids from Contract Values In Debt rows. When escalation paperwork lists a fiscal ID or tenant display name instead of a booking id, list-tenants, get-tenant, and get-tenant-bookings resolve the profile and linked reservations before you open Contract Values. get-booking returns reservation context when a payment overdue alert already supplied the id from Notification triage — Step 4. list-tickets / get-ticket / add-ticket-comment surface open Operations prep or damage jobs and document collections attempts on the ticket thread when maintenance disputes block payment — external clients cannot close-ticket or edit Cost allocation from MCP alone. cancel-booking is a write tool; operators still confirm refund type in the booking sidebar (Cancelling a Booking — Step 4). External clients cannot change Communication Rules from MCP; operators finish escalation in the management UI.
Booking-scoped Tenant MCP notify-landlord alerts your team when a tenant reports arrears through a chatbot or portal channel — it does not replace operator collections in Steps 1–5 or segment filters in this step. get-payment-info remains the right tenant-scoped read when the conversation is about one reservation's schedule, not portfolio-wide In Debt rows. list-bookings-by-email resolves the booking id when a WhatsApp or email thread only shows the guest address — pair with Notification triage — Step 4 when Inbox preceded the escalation. Surface-choice contrast: Automation & AI — Workflow pairing for surface choice.
Finish Steps 1–5 and segment filters in this step before you open a Vivin support ticket — payment overdue alerts, Finance → Contract Values In Debt rows, and Tenant Portal — Make payment self-service are operator workflows, not product defects. File Using in-app support when Vivin behaviour blocks collections despite correct operator steps:
- Approve payments or
bookings.change_payment_due_datepermission missing for your role — attach your user email and the booking id on the New Support Ticket modal (Finance or Bookings module). - Finance → Other filters Tenant → Tenant category omits a segment that Bookings and Tenants still list — attach the category name and a sample booking id; see FAQ — Finance tenant category filter parity before filing.
- Landlord MCP or Tenant MCP external clients return persistent 403 / auth errors after you refreshed the management JWT — see Using in-app support — When to use in-app support, Landlord MCP — Permissions and safety, and Resetting a Management User Password — Troubleshooting.
Use the Help & Support drawer from Finance or Bookings so screenshots stay in context; bookmark /bookings?support=<ticketId> when you need the drawer on the reservation you are chasing — Deep Links — Support. If a management lockout delayed segment-wide collections triage, recover access with Resetting a Management User Password (Step 3) before you rerun Step 1 and Steps 4–4b — refresh Landlord MCP Bearer JWT after Step 3 there; catch up unread payment overdue rows in Notification triage — Step 5; continue Portfolio KPI review — Step 7 when month-end Total Debt lagged during the lockout.
Step 6b — Approve lingering collections receipts (when required)
Month-end Pending mesh pairs with Portfolio KPI review — Step 7, Processing a New Booking — Step 6b, and Managing a Check-in — Step 6b on the same ledger queue. Upstream: Step 4b. Full pairing matrix: Handling a Late Payment section cross-reference.
At month-end when collections-week bank transfers you recorded in Step 4 still show Pending on Finance → Transactions but Contract Values In Debt rows or Payment Plan due-date pills still list the charge as unpaid — follow Step 4b and the same approval habit in Portfolio KPI review — Step 7 before you treat segment-wide arrears in Step 6 as unresolved collections:
- Open Finance → Transactions (widen the date range if needed) or the booking Transactions tab.
- Click the amber Pending chip on the All type-summary card (or use the Pending status filter) — see Finance — Pending manual payments.
- Locate manual in-payment rows tied to Contract Values lines you cleared in Step 4.
- Click Approve payment (per-row check icon) or tick several rows and use Approve selected from the floating bar. For a mistaken duplicate, use Reject selected — see Payment Allocation — Correcting mistaken receipts.
When Total Debt, Manual Payments, or Debt Aging still disagree with Analytics after you approve collections receipts on individual bookings, finish the cross-workflow Pending mesh in Step 6 before you open a Vivin support ticket: arrival-week move-in transfers (Managing a Check-in — Step 6b), confirmation-week imports (Processing a New Booking — Step 6b), departure-week settlements (Managing a Check-out — Step 6b), cancellation settlements (Cancelling a Booking — Step 6b), and utility overage bank transfers (Entering Monthly Utility Bills — Step 4b). Clear stale payment overdue rows in Notification triage — Step 5 after the mesh settles.
Approve payments and ledger Reject selected are operator workflows — finish Step 4b and the mesh above before you file Using in-app support when Approve payment is missing for your role, Pending rows persist after approval, or Landlord MCP / Tenant MCP clients return persistent 403 after you refreshed the management JWT — see Resetting a Management User Password — Troubleshooting. If a management lockout delayed month-end collections approval, recover access with Resetting a Management User Password (Step 3) before you rerun this step — pair with Processing a New Booking — Step 6b and Portfolio KPI review — Step 7 on the same Pending queue.
Full pairing matrix: Handling a Late Payment section cross-reference.
Handling a Late Payment section cross-reference
Use this table when one step in this workflow naturally leads into another module, concept page, or downstream workflow — each row links to the docs you should read before or after that step.
| Workflow step / section | Pair with these docs |
| ------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Step 1 — Identify overdue payments | Notification triage, Notification triage — Step 4, Notification triage — Step 5, Notifications — Payment overdue alerts, Portfolio KPI review — Dashboard Total Debt subtitle, Finance — Debt Aging, Finance — Contract Values, Finance — Tenant category filter, Finance — KPI strip, Glossary — Dashboard KPI cards, Glossary — Finance income status, Glossary — Finance Debt Aging, Glossary — Tenant category, Glossary — Uncovered Debt, Notifications module, Tenants — Table view, Dashboard module, Landlord MCP — Extended account tools (list-bookings, list-payments, get-payment, get-booking) |
| Step 2 — Check the automated reminder status | Settings > Emails > Communication Module, Settings > Emails — Communication Rules, Bookings — Communication tab, Automation & AI — Workflow pairing for surface choice, Tenant MCP — Property, payments, and portal tools (get-payment-info, get-dates-and-schedule, get-portal-links — chatbot due-date reads; reminder send history remains operator UI) |
| Step 3 — Contact the tenant | Tenant Portal — Make payment (Paywall), Tenant MCP — Property, payments, and portal tools (get-payment-info), Bookings — Communication tab, Inbox module |
| Step 4 — Record the payment when received | Finance > Add Payment, Payment Allocation, Settings > Invoicing & Payments, Glossary — Invoiced floor (rent) (rent relief blocked below exported invoice totals), Glossary — Credit note (payment reject/revert) (when correcting mistaken receipts on invoiced months), Landlord MCP — Extended account tools (create-manual-payment-in) |
| Step 4b — Approve the receipt | Notification triage — Step 4, Notification triage — Step 5, Processing a New Booking — Step 5b, Managing a Check-in — Step 3b, Portfolio KPI review — Step 7, Finance > Transactions — Row actions, Finance — Pending manual payments, Payment Allocation — Correcting mistaken receipts, Glossary — Pending manual in-payment (Finance), Glossary — Credit note (payment reject/revert), FAQ — Manual receipt still pending, Landlord MCP (create-manual-payment-in pending until operator approval) |
| Step 5 — Apply a late payment penalty | Settings > Payments, Bookings — Adding Extra Charges, Audit — Discounts tab |
| Step 6 — Escalate if unresolved | Cancelling a Booking (Step 4 refund-type confirmation in UI), Cancelling a Booking — Step 6 (post-cancel cleanup after last-resort cancel), Cancelling a Booking — Step 6b (cancellation-week Pending settlements at month-end), Onboarding a New Property — Step 7 (first-live-booking collections on new inventory), Managing a Check-in (move-in requirements), Managing a Check-in — Step 6b (arrival-week Pending receipts at month-end), Processing a New Booking — Step 6 (portal gates on Upcoming unpaid confirmation/move-in rows), Processing a New Booking — Step 6b (confirmation-week Pending receipts at month-end), Managing a Check-out — Step 6 (departure-week arrears before Ready To Refund), Managing a Check-out — Step 6b (departure-week Pending receipts at month-end), Managing a Check-out — Step 7 (collections after check-out day vs Ended status), Entering Monthly Utility Bills, Entering Monthly Utility Bills — Step 4 (segment-wide utility overages), Entering Monthly Utility Bills — Step 4b (utility overage Pending receipts at month-end), Portfolio KPI review — Step 6, Portfolio KPI review — Step 7 (month-end Total Debt sign-off after segment escalation), Notification triage — Step 5, Notification triage — Step 6 (row-click or read-state blocked after settlement), Finance — Tenant category filter, Bookings — Other filters, Tenants — Tenant category filter, Tenants — Interface overview (fiscal ID search), Settings > Tenant categories, Settings > Emails — Communication Rules (segment audience before account-wide rule changes), Inbox module (WhatsApp follow-up on contested arrears), Using in-app support (When to use in-app support, Help & Support drawer, New Support Ticket modal — Vivin product tickets when MCP scope, permissions, or Finance filter parity block escalation; contrast self-serve Steps 1–5), Resetting a Management User Password — Step 3 (lockout-delayed collections catch-up), Resetting a Management User Password — Troubleshooting (refresh Bearer JWT before MCP auth tickets), Deep Links — Support (?support=<ticketId> drawer from Finance/Bookings), Automation & AI (Landlord vs Tenant MCP on collections escalation), Glossary — Tenant category, FAQ — Finance tenant category filter parity, Landlord MCP — Read-only and intelligence (get-booking-summary), Landlord MCP — Extended account tools (list-bookings, list-tenants, get-tenant, get-tenant-bookings, list-payments, get-payment, get-booking, list-tickets, get-ticket, add-ticket-comment; cancel-booking write tool — confirm refund type in UI), Tenant MCP — Maintenance and escalation (notify-landlord tenant-facing alert; contrast with operator Step 6), Tenant MCP — Booking and contract data (list-bookings-by-email when chatbot thread lacks booking id), Tenant MCP — Property, payments, and portal tools (get-payment-info per-reservation reads) |
| Step 6b — Approve lingering collections receipts | Step 4b — Approve the receipt, Step 6 — Escalate if unresolved, Portfolio KPI review — Step 7, Onboarding a New Property — Step 7 (collections Pending on new inventory at month-end), Processing a New Booking — Step 6b, Managing a Check-in — Step 6b, Managing a Check-out — Step 6b, Cancelling a Booking — Step 6b, Entering Monthly Utility Bills — Step 4b, Notification triage — Step 5, Using in-app support (When to use in-app support, Help & Support drawer), Resetting a Management User Password — Step 3 (lockout-delayed month-end catch-up), Resetting a Management User Password — Troubleshooting, Finance — Pending manual payments, Payment Allocation — Correcting mistaken receipts, Glossary — Pending manual in-payment (Finance), FAQ — Manual receipt still pending |
| Lockout catch-up after password recovery | Collections triage delayed by sign-in lockout | Common Workflows — Lockout catch-up, Notification triage — Step 4, Resetting a Management User Password — Step 3 |
| Pending manual receipt approval | Collections receipts still pending | Common Workflows — Pending manual receipt approval, Step 4b, Step 6b |
| Reject/revert mistaken receipts | Duplicate collections bank transfers | Common Workflows — Reject/revert mistaken receipts, Payment Allocation — Correcting mistaken receipts |
| Same-day turnover coordination | Outgoing In Debt blocks incoming key handover on Step 1 | Common Workflows — Same-day turnover coordination, Step 1 — Identify overdue payments, FAQ — Same-day turnovers (operations-add-ticket-modal.png, bookings-timeline-day-week-month-and-sidebar.mp4) |
| Occupancy KPI to block hygiene handoff | Vacant Units vs Multicalendar holds on Step 1 — not rent arrears | Common Workflows — Occupancy KPI to block hygiene handoff, Step 1 — Identify overdue payments, FAQ — Analytics (KPI workspace) (analytics-kpi-occupancy-tab.png, audit-manual-blocks-filter-scroll.mp4) |
| Deposit missing on Finance Deposits | Partial paid lifecycle card empty on Step 1 collections triage | Common Workflows — Deposit missing on Finance Deposits, Step 1 — Identify overdue payments, FAQ — Deposit missing on Finance Deposits (finance-deposits-date-range-toolbar-default.png, finance-deposits-date-range-clear-flow.mp4) |
| Partly collected security deposit | Deposit shortfall vs rent Partial Paid | Common Workflows — Partly collected security deposit, Step 1, Finance — Deposits status summary cards, FAQ — Partly collected security deposit, Glossary — Deposit lifecycle status |
| Wrong tenant on a booking | Wrong Tenant card on Upcoming row during collections triage | Common Workflows — Wrong tenant on a booking, Step 1 — Identify overdue payments, FAQ — Wrong tenant on a booking (bookings-detail-change-tenant-control.png, bookings-detail-change-tenant-flow.mp4) |
| Cancel Booking vs Delete Booking | Policy void needs Cancel booking — not Delete on Step 6 | Common Workflows — Cancel Booking vs Delete Booking, Step 6 — Escalate if unresolved, FAQ — Cancel Booking vs Delete Booking (bookings-cancel-booking-modal-refund-types.png, bookings-list-canceled-tab.png, workflows-cancel-booking-refund-modal-flow.mp4) |
| Portfolio retirement decisions | Policy void needs Cancel booking — not Delete Booking | Common Workflows — Portfolio retirement decisions, Step 6 — Escalate if unresolved, FAQ — Portfolio retirement decisions (listings-archived-populated-table.png, finance-transactions-type-summary-cards.png) |
| Directory list load failures | Receivables directories fail on Step 1 triage | Common Workflows — Directory list load failures, Step 1 — Identify overdue payments, FAQ — Directory list load failures (notifications-module-load-failure.png, utilities-bills-load-failure.png) |
| Booking sidebar tab load failures | Collections outreach Communication tab red on Step 3 | Common Workflows — Booking sidebar tab load failures, Step 3 — Contact the tenant, FAQ — Communication or Tickets load failure (bookings-detail-communication-tab-whatsapp-thread.png, bookings-detail-tickets-tab.png) |
| Confirmation alert triage | Upcoming payment overdue on confirmation stay | Common Workflows — Confirmation alert triage, Step 1 — Identify overdue payments, FAQ — Processing a New Booking hub (notifications-row-navigate-to-booking-detail.png, bookings-detail-transactions-approve-payment-modal.png) |
| Portfolio segmentation by tenant category | Segment-wide arrears during collections | Common Workflows — Portfolio segmentation, Portfolio KPI review — Step 6, Bookings — Other filters |
| Rent reduction after invoicing | Collections goodwill on invoiced rent lines | Common Workflows — Rent reduction after invoicing, Step 4 — Record the payment when received, Glossary — Invoiced floor (rent) (bookings-detail-change-monthly-rent-modal.png, bookings-rent-reduction-invoiced-floor-flow.mp4) |
| Month-end invoicing (fixed date) | Collections Pending mesh at month-end before bulk export | Common Workflows — Month-end invoicing (fixed date), Step 6b — Approve lingering collections receipts, Portfolio KPI review — Month-end invoicing (fixed date) (settings-invoicing-invoice-date-toggle.png, finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png) |
| Bulk Hostkit invoicing | Collections month-end Issue allocation after lingering Pending | Common Workflows — Bulk Hostkit invoicing, Step 6b — Approve lingering collections receipts, FAQ — Bulk Hostkit invoicing slow (finance-transactions-bulk-selection-bar.png, settings-invoicing-hostkit-series.png) |
| Utility overage collections | Utility overage In Debt after bill posting | Common Workflows — Utility overage collections, Step 1 — Identify overdue payments, Entering Monthly Utility Bills — Step 4 (utilities-allocations-row-breakdown-expanded.png, utilities-allocations-review-flow.mp4) |
| Check-out final utilities handoff | Departure-week overage Overdue blocks Ready To Refund | Common Workflows — Check-out final utilities handoff, Step 1 — Identify overdue payments, Managing a Check-out — Step 6 (utilities-allocations-review-flow.mp4, bookings-detail-payment-plan-tab-schedule.png) |
| Check-in to check-out handoff | payment overdue on Ongoing stay blocks departure planning | Common Workflows — Check-in to check-out handoff, Step 1 — Identify overdue payments, Managing a Check-out — Step 1 (operations-check-in-out-check-outs-next-7-days.png, bookings-timeline-view.png) |
| Check-out collections before refund | Canonical collections when Ready To Refund is blocked | Common Workflows — Check-out collections before refund, Step 1 — Identify overdue payments, Managing a Check-out — Step 6 (workflows-check-out-coordination-flow.mp4, bookings-detail-payment-plan-tab-schedule.png, finance-contract-values-in-debt-filter.png) |
| Check-out ledger cleanup before refund | Tenant paid once — ledger duplicate, not collections | Common Workflows — Check-out ledger cleanup before refund, Step 1 — Identify overdue payments, Managing a Check-out — Step 6 (bookings-detail-transactions-revert-modal-info-banner.png, finance-transactions-bulk-reject-selected-bar.png) |
| Payment alert to receivables triage | Collections payment overdue alert before Step 1 triage | Common Workflows — Payment alert to receivables triage, Step 1 — Identify overdue payments, Portfolio KPI review — Payment alert to receivables triage (notifications-row-navigate-to-booking-detail.png, notifications-row-navigation-flow.mp4) |
| Finance debt receivables triage | Portfolio Top debtors ranking after collections triage on Step 1 | Common Workflows — Finance debt receivables triage, Step 1 — Identify overdue payments, Common Workflows — Payment alert to receivables triage (finance-overview-income-chart-debt-aging.png, finance-overview-debt-aging-walkthrough-flow.mp4, finance-transactions-pending-pill.png) |
| Handling a Late Payment collections | Canonical collections workflow — triage surfaces → Steps 1–6 |
| Finance Income status drill-down | Income → In debt payment-line detail vs Top debtors on collections Step 1 | Common Workflows — Finance Income status drill-down, Step 1 — Identify overdue payments, Finance debt receivables triage (finance-overview-income-status-in-debt-modal.png, finance-overview-income-drill-down-flow.mp4) |
| Cash flow forecast drill-down | Collections collected in a month vs who still owes on Step 1 | Common Workflows — Cash flow forecast drill-down, Step 1 — Identify overdue payments, Finance Income status drill-down (finance-overview-cash-flow-all-payments-modal.png, finance-overview-cash-flow-drill-down-flow.mp4) |
| Cancellation collections before void | Canonical pre-cancel collections before last-resort void | Common Workflows — Cancellation collections before void, Step 1 — Identify overdue payments, Cancelling a Booking — Step 2 (finance-contract-values-in-debt-filter.png, bookings-detail-transactions-approve-payment-modal.png, bookings-cancel-booking-modal-refund-types.png, workflows-cancel-booking-refund-modal-flow.mp4) |
Related
Related below links this workflow to modules, concepts, settings, and escalation paths. Pair Documentation map & escalation with Common Workflows hub — Documentation map & escalation; pair Upstream & downstream workflows with Common Workflows — Workflow cross-reference. Topic-to-section pairing in sections above: Handling a Late Payment section cross-reference. Full hub matrix: Common Workflows section cross-reference.
Documentation map & escalation
Documentation-map bullets pair with Introduction — Section cross-reference and FAQ — Section cross-reference. Hub parity: Common Workflows hub — Documentation map & escalation. Full pairing matrix: Handling a Late Payment section cross-reference · Common Workflows section cross-reference.
- Common Workflows — Hub pairing matrix across all operator guides
- Glossary — Term definitions referenced in the steps above
- FAQ & Troubleshooting — Quick answers when collections steps do not match live product behaviour
- Get Help & Support — Escalate when permissions block due-date extensions or approvals
Upstream & downstream workflows
Workflow bullets pair with Common Workflows — Workflow cross-reference for inter-guide step pairing. Full pairing matrix: Handling a Late Payment section cross-reference · Common Workflows section cross-reference.
- Notification triage (section cross-reference; Deeper workflow reads; hub) — Upstream when a payment overdue alert brought you here (Step 1); clear payment alerts after the balance is settled (Step 5 (section cross-reference; Deeper workflow reads; hub))
- Notifications — Payment overdue alerts — Operator Payments category rows on
/notificationsand the Dashboard bell (Step 1) - Entering Monthly Utility Bills (section cross-reference; Deeper workflow reads; hub) — Unpaid utility overage lines use the same collections path (Step 1); segment-wide overage triage in Step 4 (section cross-reference; Deeper workflow reads; hub) (Step 6)
- Entering Monthly Utility Bills — Step 4b (section cross-reference; Deeper workflow reads; hub) — Utility overage Pending receipts in the Step 6 / Step 6b month-end mesh
- Processing a New Booking — Step 6b (section cross-reference; Deeper workflow reads; hub) — Confirmation-week Pending receipts that can inflate Total Debt during Step 6 month-end review
- Managing a Check-out — Step 6b (section cross-reference; Deeper workflow reads; hub) — Departure-week Pending receipts before Ready To Refund during Step 6 month-end review
- Cancelling a Booking — Step 6b (section cross-reference; Deeper workflow reads; hub) — Cancellation settlement receipts and stale alerts after last-resort cancel (Step 6)
- Notification triage — Step 6 (section cross-reference; Deeper workflow reads; hub) — Vivin support when payment alert row-click or read-state is blocked after Step 6 settlement
- Managing a Check-in (section cross-reference; Deeper workflow reads; hub) — Resolve move-in requirements before key handover
- Managing a Check-out — Step 6 (section cross-reference; Deeper workflow reads; hub) — Clear arrears before Ready To Refund
- Managing a Check-out — Step 7 (section cross-reference; Deeper workflow reads; hub) — Collections after check-out day vs Ended status (Step 6)
- Processing a New Booking — Step 6 (section cross-reference; Deeper workflow reads; hub) — Portal gates on Upcoming unpaid confirmation/move-in rows (Step 6)
- Automation & AI — Landlord vs Tenant MCP surface choice during segment-wide escalation (Step 6)
- Portfolio KPI review — Step 7 (section cross-reference; Deeper workflow reads; hub) — Month-end Pending pill triage when Total Debt or Manual Payments lag recorded collections receipts (Step 4b); segment-wide Total Debt sign-off after Step 6 escalation
- Managing a Check-in — Step 6b (section cross-reference; Deeper workflow reads; hub) — Arrival-week Pending move-in receipts that can inflate Total Debt during Step 6 month-end review
- Processing a New Booking — Step 5b (section cross-reference; Deeper workflow reads; hub) — Same approval habit for confirmation receipts (Step 4b)
- Managing a Check-in — Step 3b (section cross-reference; Deeper workflow reads; hub) — Move-in receipt approval on arrival week (Step 4b)
- Cancelling a Booking (section cross-reference; Deeper workflow reads; hub) — Last-resort path when auto-cancel or repeated collections fail (Step 6)
- Cancelling a Booking — Step 6 (section cross-reference; Deeper workflow reads; hub) — Post-cancel ticket closure after last-resort cancel (Step 6)
- Onboarding a New Property — Step 7 (section cross-reference; Deeper workflow reads; hub) — First-live-booking collections on newly onboarded inventory (Step 6)
- Notification triage — Step 5 (section cross-reference; Deeper workflow reads; hub) — Clear payment alerts after escalation or settlement (Step 6)
- Using in-app support (section cross-reference; Deeper workflow reads; hub) — Vivin product tickets when Step 6 permissions, Finance filter parity, or MCP auth block self-serve collections; Help & Support drawer (section cross-reference; Deeper workflow reads; hub) from Finance or Bookings
- Resetting a Management User Password (section cross-reference; Deeper workflow reads; hub) — Recover access when a lockout delayed segment-wide collections (Step 6, Step 6b) or payment overdue triage (Step 1)
Concepts & settings that shape this workflow
Concept and settings bullets pair with Concepts hub subsection index and Concept cross-reference and Account Settings — Tab cross-reference. Full pairing matrix: Handling a Late Payment section cross-reference · Common Workflows section cross-reference.
- Booking Lifecycle — Which list filters and status labels apply while chasing overdue charges (section cross-reference; Deeper workflow reads; hub)
- Tenant Portal — Tenant self-service Make payment when the payment module is enabled (section cross-reference; Deeper workflow reads; hub)
- FAQ — Tenant contract signing blocked — No PDF yet, mandatory Your Details gates, category locks, or Lease purpose; portal signing vs paper upload on Contract Info
- Tenant MCP — Booking-scoped
get-payment-infoduring tenant-facing collections (Step 3);notify-landlordwhen tenants escalate through chatbot channels — contrast with operator Step 6 segment filters; file Using in-app support — When to use in-app support (section cross-reference; Deeper workflow reads; hub) for Vivin product defects (section cross-reference; Deeper workflow reads; hub) - Using in-app support (section cross-reference; Deeper workflow reads; hub) — Help & Support drawer (section cross-reference; Deeper workflow reads; hub) and New Support Ticket modal (section cross-reference; Deeper workflow reads; hub) when Step 6 permissions, Finance filter parity, or MCP auth block self-serve collections
- Landlord MCP — Account-scoped
get-booking-summarybefore segment-wide escalation (Step 6 (section cross-reference; Deeper workflow reads; hub));list-bookings,list-tenants,get-tenant,get-tenant-bookings,list-payments,get-payment,get-booking,list-tickets,get-ticket, andadd-ticket-commentduring collections and maintenance-blocked arrears (Steps 1, 4–4b, 6);create-manual-payment-in(Steps 4–4b (section cross-reference; Deeper workflow reads; hub));cancel-bookingwrite tool — operators still confirm refund type in UI (Cancelling a Booking — Step 4 (section cross-reference; Deeper workflow reads; hub)); hub (section cross-reference; Deeper workflow reads; hub) - Payment Allocation — Two-layer receipts and credit note reject/revert warnings (section cross-reference; Deeper workflow reads; hub)
- Integrations & Distribution — Collections on marketplace-imported bookings (section cross-reference; Deeper workflow reads; hub)
- Services Marketplace — Portal service charges on Transactions when overdue balances include add-ons (section cross-reference; Deeper workflow reads; hub)
- Settings > Emails > Communication Module — Overdue reminder automation (Step 2)
- Tenant MCP — Property, payments, and portal tools — Booking-scoped
get-payment-info,get-dates-and-schedule, andget-portal-linkswhen chatbot tenants ask about due dates after an overdue reminder (Step 2); contrast operator Communication Rules send history (section cross-reference; Deeper workflow reads; hub) - Settings > Payments — Penalty policy configuration (Step 5)
- Settings > Preferences — Auto-cancel unpaid move-in — Unpaid move-in requirements after check-in
- Settings > Preferences — In-app notifications — Account-wide payment overdue categories
- Settings > Tenant categories — Segment portal rules and portfolio filters when Step 6 arrears cluster on one tenant category
Finance, bookings & tenant surfaces
Finance, bookings & tenant surfaces bullets pair with the matching topic rows in Handling a Late Payment section cross-reference. Full pairing matrix: Handling a Late Payment section cross-reference · Common Workflows section cross-reference.
- Finance module — Overview, Contract Values, Total debt drill-down, and pending manual payments
- Bookings — Payment Plan tab — Due-date status pills and Add Payment
- Tenants module — Fiscal ID search and table expand
- Finance — Tenant category filter — Other filters → Tenant → Tenant category when arrears cluster on one segment (Step 6)
- Bookings — Other filters — Tenant → Tenant category mirror when Finance cache parity lags (Step 6)
- Tenants — Tenant category filter — Profile-count cross-check before changing portal rules account-wide (Step 6)
- Finance > Transactions — Row actions — Approve and bulk Reject selected (Step 4b)
- Payment Allocation — Correcting mistaken receipts — Approve, reject, and revert on Transactions (Step 4b)
- Dashboard — Total Debt — Month-scoped KPI before Finance drill-downs (Step 1)
- Analytics module — Revenue tab — Longer-range Debt Aging context
- Inbox module — WhatsApp follow-up when tenants reply on overdue balances
- Audit — Discounts tab — Cross-portfolio discount review before goodwill reductions (Step 5)
- API Reference — Creating bookings — Partner imports with outstanding confirmation payment (Step 4)
- API Reference — Booking lifecycle validations — Background validation before Contract Values triage (Step 1)
- API Reference — Management session — Operator JWT routes for scripted reconciliation (Step 4b)
Deeper workflow reads
Concept workflow reads pair with Concepts hub subsection index and Concept cross-reference. Each concept sub-guide reciprocates with [Deeper workflow reads](../workflows/handling-a-late-payment.md#deeper-workflow-reads) anchors on Handling a Late Payment bullets — hub parity: Common Workflows hub — Deeper workflow reads. Full pairing matrix: Handling a Late Payment section cross-reference · Common Workflows section cross-reference.
- Booking Lifecycle — Computed status model, list filters, and Timeline (section cross-reference; Deeper workflow reads; hub)
- Payment Allocation — Two-layer receipts, invoiced-floor rent, and reject/revert corrections (section cross-reference; Deeper workflow reads; hub)
- Tenant Portal — Booking-scoped tenant self-service, contract signing, and payments (section cross-reference; Deeper workflow reads; hub)
- Tenant MCP — Booking-scoped external AI clients and portal-link tools (section cross-reference; Deeper workflow reads; hub)
- Landlord MCP — Account-scoped portfolio automation from external clients (section cross-reference; Deeper workflow reads; hub)
- Automation & AI — Channel map, chatbot, in-app assistant, and MCP clients (section cross-reference; Deeper workflow reads; hub)
- Services Marketplace — Portal add-on catalogue and fulfilment on Payment plan (section cross-reference; Deeper workflow reads; hub)
- Create New Menu — Global + slide-out shortcuts into module create flows (section cross-reference; Deeper workflow reads; hub)
- Management Frontend Deep Links — Bookmarkable management routes and notification deep links (section cross-reference; Deeper workflow reads; hub)
Deeper API reads
API reads pair with API Reference hub subsection index and API guide cross-reference. Hub parity: Common Workflows — Deeper API reads. Full pairing matrix: Handling a Late Payment section cross-reference · Common Workflows section cross-reference.
- Management session authentication — Operator JWT routes for scripted reconciliation (Step 4b) (section cross-reference; Deeper workflow reads; hub)
- Booking Lifecycle & Validations — Background validation before Contract Values triage (Step 1) (section cross-reference; Deeper workflow reads; hub)
- Webhooks & Notifications — Payment-related webhook events that surface as in-app alerts (section cross-reference; Deeper workflow reads; hub)
- Error Handling — Retry policy when receipt approval or allocation returns recoverable errors (section cross-reference; Deeper workflow reads; hub)
- AI usage API — Internal LLM token ledger (
GET /ai-usage/summary;landlord_chat) during Step 6 month-end escalation (section cross-reference; Deeper workflow reads; hub)
Lockout catch-up after password recovery
Collections triage and receipt approval delayed by lockout pair with Resetting a Management User Password. Hub parity: Common Workflows — Lockout catch-up after password recovery. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Lockout catch-up after password recovery — Hub matrix when sign-in was restored mid-workflow
- Getting Started — Lockout catch-up after password recovery — Collections backlog after recovery
- Notification triage — Step 4 — Payment-overdue alert row-click
- Portfolio KPI review — Step 7 — Month-end Total Debt catch-up
Pending manual receipt approval
Collections receipts stay pending until Step 4b and Step 6b. When a duplicate collections transfer sits in the amber Pending queue, Reject it — do not Approve both rows (Common Workflows — Reject/revert mistaken receipts). Hub parity: Common Workflows — Pending manual receipt approval. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Pending manual receipt approval — Hub matrix when recorded transfers still await Approve payments (
finance-transactions-pending-pill.png,finance-transactions-pending-approve-flow.mp4) - Glossary — Pending manual in-payment (Finance) — Definition and three-surface triage
- Glossary — Pending manual receipt approval hub — Surface table + per-guide/module mesh reciprocal hub
- FAQ — Pending manual receipt approval hub — Symptom table + per-guide/module mesh
- Step 4b — Approve the receipt — Primary approval habit (
bookings-detail-transactions-approve-payment-modal.png) - Step 6b — Approve lingering collections receipts — Month-end mesh
- Common Workflows — Reject/revert mistaken receipts — Reject duplicate while pending (
finance-transactions-bulk-reject-selected-bar.png) - Finance — Pending manual payments — Amber Pending chip
- Processing a New Booking — Pending manual receipt approval — Confirmation mesh on Step 5b / Step 6b
- Portfolio KPI review — Pending manual receipt approval — Month-end Pending sign-off on Step 7 (
dashboard-kpi-total-debt-tooltip.png) - Notification triage — Pending manual receipt approval — Payment received alert row-click on Step 4
WhatsApp per-booking messaging
Collections outreach on Step 3 — Contact the tenant pairs with Bookings → Communication when you need Payment Plan visible — cross-booking Inbox alone lacks booking context. Hub parity: Glossary — WhatsApp per-booking messaging hub · Common Workflows — WhatsApp per-booking messaging. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — WhatsApp per-booking messaging — Hub matrix (
bookings-detail-communication-tab-whatsapp-thread.png,bookings-detail-communication-tab-whatsapp-composer.png) - Glossary — WhatsApp per-booking messaging hub — Surface table + per-guide/module mesh reciprocal hub
- FAQ — WhatsApp per-booking messaging hub — Collections outreach on Step 3 with Payment Plan visible symptom table
- Step 3 — Contact the tenant — Communication composer with Payment Plan context
- Notification triage — Step 2 — Message ping entry before collections
- Inbox module — Portfolio-wide triage when tenant name is unknown
- Common Workflows — Notification row-click navigation —
New WhatsApp message from …on/notifications - Managing a Check-in — WhatsApp per-booking messaging — Upstream arrival-week threads
Bot reasoning (audit)
Collections bot replies on Step 3 — expand Reasoning under mint Bot bubbles on Bookings → Communication → WhatsApp to audit automated replies before editing ChatBot persona or IF/THEN rules. Hub parity: Glossary — Bot reasoning (audit) hub · Common Workflows — Bot reasoning (audit). Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Bot reasoning (audit) — Hub matrix (
bookings-detail-communication-tab-bot-reasoning-expanded.png) - Glossary — Bot reasoning (audit) hub — Surface table + per-guide/module mesh reciprocal hub
- FAQ — Bot reasoning (audit) hub — Symptom table for Reasoning vs ChatBot settings
- ChatBot settings — Bot reasoning audit — Read-only thread audit vs editable persona / IF/THEN
- Bookings — Communication tab — Reasoning control on Bot bubbles
- Glossary — ChatBot settings hub — Edit persona / IF/THEN after thread audit
- Step 3 — Contact the tenant — Workflow step where bot replies surface
ChatBot settings
Pair Account Settings → ChatBot (Persona, IF/THEN, Status Bot) with thread review on Communication when collections bot replies on step 3. Hub parity: Glossary — ChatBot settings hub · Common Workflows — ChatBot settings. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — ChatBot settings — Hub matrix (
settings-chatbot-tab-overview.png,settings-chatbot-status-bot-connected.png,settings-chatbot-save-rule-flow.mp4) - Glossary — ChatBot settings hub — Surface table + per-guide/module mesh reciprocal hub
- FAQ — ChatBot settings hub — Symptom table for pairing, persona, and IF/THEN tuning
- ChatBot settings — Persona, IF/THEN rules, Status Bot WhatsApp pairing
- Glossary — Bot reasoning (audit) hub — Thread Reasoning audit after rule changes
- Onboarding a New Property — Step 4 — Setup-step pairing for tenant chatbot rules
Notification row-click navigation
Collections payment overdue alerts pair with Notification triage — Step 4 before Step 1 — Identify overdue payments — contrast alert-driven entry with portfolio Debt Aging on Finance debt receivables triage. Hub parity: Common Workflows — Notification row-click navigation. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Notification row-click navigation — Hub matrix (
notifications-row-navigate-to-booking-detail.png,notifications-row-navigation-flow.mp4) - Glossary — Notification row navigation — Target-field order and bell General contrast
- Glossary — Notification row navigation hub — Surface table + per-guide/module mesh
- FAQ — Notification row-click navigation hub — payment overdue on Step 1 after alert row-click symptom table
- Common Workflows — Handling a Late Payment collections hub — Triage surfaces → Steps 1–6
- Notification triage — Step 4 — Row-click before Debt Aging outreach
- Step 1 — Identify overdue payments — Top debtors after alert triage
- Pending manual receipt approval — Pending manual in-payment row-click → Approve (
finance-transactions-pending-pill.png) - Payment alert to receivables triage — Ongoing receivables contrast on Step 1
Payment notification (operator)
Collections payment overdue alerts pair with Notification triage — Step 4 before Step 1 — Identify overdue payments — distinguish Payment overdue from Payment received / Pending manual in-payment row types. Hub parity: Common Workflows — Payment notification (operator). Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Payment notification (operator) — Hub matrix (
notifications-row-navigate-to-booking-detail.png,notifications-row-navigation-flow.mp4) - Glossary — Payment notification (operator) — Three row types + opt-in layers
- FAQ — Payment notification (operator) hub — Symptom table + per-guide/module mesh
- Settings — Preferences — Notifications & emails — Account Receive payment notifications master
- Settings — Interface language — Your email preferences — Per-user Payment notification emails
- Step 1 — Identify overdue payments — Canonical payment overdue follow-through after row-click
- Step 4b — Approve the receipt when required — Payment received may still need Approve
- Payment alert to receivables triage — Ongoing/Ended before Debt Aging
- Pending manual receipt approval — Pending before collections mesh
Payment alert to receivables triage
Collections payment overdue alerts pair with Notification triage — Step 4 before Step 1 — Identify overdue payments — contrast alert-driven entry with portfolio Debt Aging on Finance debt receivables triage. Hub parity: Common Workflows — Payment alert to receivables triage. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Payment alert to receivables triage — Hub matrix (
notifications-row-navigate-to-booking-detail.png,notifications-row-navigation-flow.mp4) - Glossary — Payment alert to receivables triage — Ongoing/Ended payment overdue before Debt Aging
- Glossary — Payment alert to receivables triage hub — Surface table + per-guide/module mesh
- FAQ — Payment alert to receivables triage hub — payment overdue on Step 1 after alert row-click symptom table
- Common Workflows — Handling a Late Payment collections hub — Triage surfaces → Steps 1–6
- Notification triage — Step 4 — Row-click before Debt Aging outreach
- Step 1 — Identify overdue payments — Top debtors after alert triage
- Pending manual receipt approval — Clear Pending before collections (
finance-transactions-pending-pill.png) - Portfolio KPI review — Payment alert to receivables triage — Month-end alert batch during Step 7
Finance debt receivables triage
Collections triage pairs with Step 1 — Identify overdue payments before tenant outreach — upstream Notification triage — Step 4 on payment overdue alerts. Hub parity: Common Workflows — Finance debt receivables triage. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Finance debt receivables triage — Hub matrix (
finance-overview-debt-aging-expanded-bucket.png,finance-overview-debt-aging-walkthrough-flow.mp4) - Common Workflows — Payment alert to receivables triage — Alert-driven entry before Debt Aging (
notifications-row-navigate-to-booking-detail.png,notifications-row-navigation-flow.mp4) - Common Workflows — Handling a Late Payment collections hub — Triage surfaces → Steps 1–6
- Glossary — Handling a Late Payment collections hub — Surface table + per-guide/module mesh reciprocal hub
- Step 1 — Identify overdue payments — Top debtors / overdue buckets before outreach
- Pending manual receipt approval — Clear Pending before Debt Aging (
finance-transactions-pending-pill.png) - Portfolio KPI review — Step 7 — Month-end receivables sign-off (
dashboard-kpi-total-debt-tooltip.png) - Glossary — Finance debt receivables triage hub — Surface table + per-guide/module mesh reciprocal hub
- FAQ — Finance debt receivables triage hub — Collections triage symptom table
Handling a Late Payment collections
This guide is the collections workflow — receivables triage surfaces on Step 1 answer “who owes?” and Steps 1–6 answer “what do I do next?” Hub matrix: Common Workflows — Handling a Late Payment collections hub. Hub parity: Common Workflows — Handling a Late Payment collections hub. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Handling a Late Payment collections hub — Hub matrix (
finance-overview-income-chart-debt-aging.png,notifications-row-navigate-to-booking-detail.png,finance-overview-debt-aging-walkthrough-flow.mp4,handling-a-late-payment-collections-flow.mp4) - Step 1 — Identify overdue payments — Triage surface → collections step decision table
- Payment alert to receivables triage — payment overdue alert entry
- Finance debt receivables triage — Debt Aging before outreach
- Pending manual receipt approval — Step 4b / Step 6b approval mesh
- Glossary — Handling a Late Payment collections hub — Surface table + per-guide/module mesh reciprocal hub
- FAQ — Handling a Late Payment collections hub — Collections symptom table
Dashboard Total Debt subtitle
Step 1 ranks Top debtors on Finance — use post-login Total Debt as a live-portfolio snapshot before outreach, not as the booking list. Hub parity: Common Workflows — Finance debt receivables triage. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- FAQ — Dashboard Total Debt subtitle — Headline vs >15 days subtitle (
dashboard-kpi-total-debt-tooltip.png) - Step 1 — Identify overdue payments — Debt Aging / Top debtors (
finance-overview-debt-aging-expanded-bucket.png) - Payment alert to receivables triage — Alert-driven entry before
/compare - Pending manual receipt approval — Clear Pending before collections (
finance-transactions-pending-pill.png) - Portfolio KPI review — Dashboard Total Debt subtitle — Month-end headline reconciliation
Uncovered Debt KPI
Step 1 ranks Top debtors — when Uncovered Debt ≈ Total Debt on the seven-card strip, deposit cushions are thin and collections risk is high. Hub parity: Common Workflows — Finance debt receivables triage. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- FAQ — Uncovered Debt KPI — Deposit coverage vs Total Debt (
finance-overview-kpi-cards.png) - Glossary — Uncovered Debt — Prioritize thin-offset debtors (Step 1)
- Step 1 — Identify overdue payments — Debt Aging / Top debtors
- Finance debt receivables triage — Hub mesh (
finance-overview-debt-aging-expanded-bucket.png) - Dashboard Total Debt subtitle — Ongoing-only
/vs Finance all-booking KPIs
Finance Income status drill-down
Collections on Step 1 — Income → In debt opens payment-line detail for one month; Debt Aging Top debtors ranks bookings for outreach. Hub parity: Common Workflows — Finance Income status drill-down. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- FAQ — Finance Income status drill-down — Income chart (Paid / Scheduled / In debt); month-scoped payment-line modal (
finance-overview-income-status-in-debt-modal.png) - Glossary — Finance income status — In debt segment vs Debt Aging booking rows
- Finance debt receivables triage — Top debtors when you need ranked debtors, not payment lines (
finance-overview-debt-aging-expanded-bucket.png) - FAQ — Bookings that owe money — Booking-level receivables on Debt Aging
- Step 1 — Identify overdue payments — Primary collections entry (
finance-overview-income-chart-debt-aging.png) - Glossary — Finance Income status drill-down hub — Surface table + per-guide/module mesh reciprocal hub
- FAQ — Finance Income status drill-down hub — Collections segment symptom table
Cash flow forecast drill-down
Collections on Step 1 — Cash flow forecast answers what was collected in a month; Debt Aging answers who still owes. Hub parity: Common Workflows — Cash flow forecast drill-down. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- FAQ — Cash flow forecast drill-down — Cash flow forecast chart (Month / Day); All payments modal (
finance-overview-cash-flow-all-payments-modal.png) - Glossary — Cash flow forecast (Finance Overview) — Collections history vs Dashboard rent-due chart vs Income status
- Finance Income status drill-down — Paid / Scheduled / In debt when scheduled vs collected mismatch
- Dashboard — Cash Flow Forecast — Rent due timing (
dashboard-cash-flow-forecast-chart.png) — not Finance collections - Step 1 — Identify overdue payments — Pair Cash flow forecast with Debt Aging (
finance-overview-cash-flow-drill-down-flow.mp4) - Glossary — Cash flow forecast drill-down hub — Surface table + per-guide/module mesh reciprocal hub
- FAQ — Cash flow forecast drill-down hub — Collections triage symptom table
Reject/revert mistaken receipts
Duplicate collections transfers pair with Payment Allocation — Correcting mistaken receipts and Common Workflows — Pending manual receipt approval (clear amber Pending queue before you Revert an approved duplicate). Re-open Finance debt receivables triage Top debtors only after ledger cleanup. Hub parity: Common Workflows — Reject/revert mistaken receipts. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
-
Common Workflows — Reject/revert mistaken receipts — Hub matrix when duplicate receipts need Reject / Revert (
bookings-payment-row-actions-flow.mp4,bookings-detail-transactions-revert-modal-info-banner.png) -
Glossary — Credit note warning (reject/revert) — Modal banners and Not issued credit note queue
-
Glossary — Reject/revert mistaken receipts hub — Surface table + per-guide/module mesh reciprocal hub
-
Glossary — Credit note warning (reject/revert) hub — Modal-banner surface table + per-guide/module mesh
-
FAQ — Credit note warning (reject/revert) hub — Symptom table + per-guide/module mesh
-
Common Workflows — Pending manual receipt approval — Approve legitimate pending rows before Revert (
finance-transactions-pending-pill.png) -
Common Workflows — Finance debt receivables triage — Re-check Debt Aging after Revert (
finance-overview-income-chart-debt-aging.png) -
Payment Allocation — Correcting mistaken receipts — Reject duplicate collections receipts
-
Glossary — Credit note (payment reject/revert) — Invoiced charge follow-up
-
FAQ — Reject or revert an incoming payment — Operator FAQ
-
Step 4b — Approve the receipt — Reject duplicate collections while pending (
finance-transactions-bulk-reject-selected-bar.png) -
Step 6b — Approve lingering collections receipts — Month-end Pending mesh before Revert on approved duplicates
-
Processing a New Booking — Reject/revert mistaken receipts — Confirmation duplicate mesh on Step 5b
-
Portfolio KPI review — Reject/revert mistaken receipts — Re-check Debt Aging after Revert (Step 7)
-
FAQ — Handling a Late Payment hub — Collections duplicate symptom table
-
FAQ — Reject/revert mistaken receipts hub — Collections duplicate symptom table
Month-end invoicing (fixed date)
Collections month-end on Step 6b may overlap Issue allocation — save a fixed Invoice date in Settings → Invoicing before bulk export — pair Bulk Hostkit invoicing on the same amber toolbar banner. Hub parity: Common Workflows — Month-end invoicing (fixed date). Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Month-end invoicing (fixed date) — Hub matrix (
settings-invoicing-invoice-date-toggle.png,finance-transactions-fixed-invoice-date-banner.png,finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png) - Invoicing — Default invoice date — Toggle Use today as invoice date off + Save
- Finance — Month-end invoicing with a fixed date — Six-step operator habit on Transactions
- Common Workflows — Bulk Hostkit invoicing — Issue allocation after fixed date is saved
- FAQ — Month-end invoicing (fixed date) hub — Symptom table + toggle reset after batch
- Glossary — Fixed invoice date — Account-wide until you change it
- Step 6b — Approve lingering collections receipts — Month-end collections mesh before bulk export
- Portfolio KPI review — Month-end invoicing (fixed date) — Step 7 sign-off contrast
Bulk Hostkit invoicing
Collections month-end on Step 6b may overlap Issue allocation — pair Month-end invoicing (fixed date) (save fixed Invoice date before bulk export — finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png) and Rent reduction after invoicing when Change monthly rent clamps exported months — not Hostkit slowness. Hub parity: Common Workflows — Bulk Hostkit invoicing. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Bulk Hostkit invoicing — Hub matrix: Hostkit pacing + bulk toolbar (
finance-transactions-bulk-selection-bar.png,settings-invoicing-hostkit-series.png) - FAQ — Bulk Hostkit invoicing hub — Symptom table + per-guide mesh
- Common Workflows — Month-end invoicing (fixed date) — Fixed Invoice date before bulk export (
settings-invoicing-invoice-date-toggle.png,finance-transactions-fixed-invoice-date-banner.png) - Common Workflows — Reject/revert mistaken receipts — Issue credit notes (N) after invoiced Reject / Revert (
bookings-detail-transactions-reject-modal-credit-note-banner.png) - FAQ — Bulk Hostkit invoicing slow — HTTP 429 pacing — leave batch running; refresh Transactions before re-issue
- Finance — Invoice automation — Bulk Issue allocation / Invoice selected
Utility overage collections
Utility-type In Debt lines on Contract Values pair with Step 1 — Identify overdue payments after Entering Monthly Utility Bills — Step 4 confirms posting — hub: Common Workflows — Utility overage collections. Distinct from rent Cancellation collections before void. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Utility overage collections — Hub matrix (
utilities-allocations-row-breakdown-expanded.png,finance-contract-values-in-debt-filter.png,utilities-allocations-review-flow.mp4) - Step 1 — Identify overdue payments — Collections follow-through after bill posting
- Entering Monthly Utility Bills — Step 4 — Upstream overage line verification
- Step 4b — Approve the receipt when required — Overage Pending mesh ↔ Entering Monthly Utility Bills — Step 4b
- Common Workflows — Check-out final utilities handoff — Departure-week subset
- Portfolio KPI review — Step 7 — Month-end segment overage arrears sign-off
Check-out final utilities handoff
Departure-week utility Overdue lines pair with Step 1 — Identify overdue payments after Entering Monthly Utility Bills — Step 4 — hub: Common Workflows — Check-out final utilities handoff. Distinct from rent Check-out collections before refund. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Check-out final utilities handoff — Hub matrix (
utilities-allocations-review-flow.mp4,finance-contract-values-in-debt-filter.png,bookings-detail-payment-plan-tab-schedule.png) - Step 1 — Identify overdue payments — Collections when final overage blocks refund
- Entering Monthly Utility Bills — Step 4 — Upstream overage line verification
- Managing a Check-out — Step 6 — Downstream settlement before Step 5
- Step 4b — Approve the receipt when required — Overage Pending mesh ↔ Step 6b
- Portfolio KPI review — Step 7 — Month-end departure overage sign-off
Check-in to check-out handoff
payment overdue on Ongoing stays ~7 days from departure pair with Step 1 — Identify overdue payments before Managing a Check-out — Step 1 — hub: Common Workflows — Check-in to check-out handoff. Distinct from rent Check-out collections before refund. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Check-in to check-out handoff — Hub matrix (
operations-check-in-out-check-outs-next-7-days.png,finance-contract-values-in-debt-filter.png) - Glossary — Check-in to check-out handoff hub — Surface table + per-guide/module mesh
- Step 1 — Identify overdue payments — Collections on Ongoing stay entering departure week
- Managing a Check-out — Step 1 — Downstream departure planning after arrears cleared
- Notification triage — Step 4 — Row-click payment overdue on Ongoing stay
- Common Workflows — Payment alert to receivables triage — Bell scan before departure week
- FAQ — Handling a Late Payment hub — Collections symptom table
Check-out collections before refund
Canonical collections when departure-week Ready To Refund is blocked: Step 1 — Identify overdue payments → Step 4 — Record the payment when received before Managing a Check-out — Step 5 — hub: Common Workflows — Check-out collections before refund. Distinct from utility Check-out final utilities handoff and Check-in to check-out handoff. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Check-out collections before refund — Hub matrix (
workflows-check-out-coordination-flow.mp4,finance-contract-values-in-debt-filter.png,bookings-detail-payment-plan-tab-schedule.png) - Step 1 — Identify overdue payments — Primary collections entry on rent/fee arrears
- Step 4b — Approve the receipt when required — Pending mesh ↔ Managing a Check-out — Step 6b
- Managing a Check-out — Step 6 — Downstream settlement verification before refund
- Common Workflows — Finance debt receivables triage — Portfolio Top debtors when arrears cluster
- FAQ — Handling a Late Payment hub — Collections symptom table
Check-out ledger cleanup before refund
When the tenant insists they paid once but Ready To Refund stays blocked by a duplicate ledger pair, Revert the duplicate on Transactions — not Step 3 — Contact the tenant collections outreach. Hub parity: Common Workflows — Check-out ledger cleanup before refund. Distinct from rent Check-out collections before refund. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
-
Common Workflows — Check-out ledger cleanup before refund — Hub matrix (
bookings-detail-transactions-revert-modal-info-banner.png,finance-transactions-bulk-reject-selected-bar.png) -
Step 1 — Identify overdue payments — Confirm row is duplicate transfer, not unpaid rent/fee
-
Reject/revert mistaken receipts — Reject / Revert path when tenant already paid
-
Managing a Check-out — Step 6 — Downstream settlement before Step 5
-
Check-out collections before refund — Real arrears contrast on Payment Plan
-
FAQ — Reject/revert mistaken receipts hub — Symptom table before escalation
-
FAQ — Check-out ledger cleanup before refund hub — Symptom table for phantom In Debt / Ready To Refund blocked when tenant paid once
Cancellation collections before void
Canonical pre-cancel collections: Steps 1–4 before Cancelling a Booking — Step 4 — last resort after Step 6 — Escalate if unresolved. Hub parity: Common Workflows — Cancellation collections before void. Distinct from departure-week Check-out collections before refund. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Cancellation collections before void — Hub matrix (
finance-contract-values-in-debt-filter.png,bookings-detail-transactions-approve-payment-modal.png,bookings-cancel-booking-modal-refund-types.png,workflows-cancel-booking-refund-modal-flow.mp4) - Step 1 — Identify overdue payments — Primary collections entry before void
- Step 4b — Approve the receipt when required — Pending mesh before Cancelling a Booking — Step 2a
- Step 6 — Escalate if unresolved — Last-resort cancel after outreach fails
- Cancelling a Booking — Step 2 — Settlement before Step 4
- FAQ — Cancelling a Booking hub — Pre-cancel symptom table
Rent reduction after invoicing
Goodwill rent cuts on invoiced months pair with Bulk Hostkit invoicing when external credit notes need Issue credit notes (N) — same Hostkit pacing as first-time Issue allocation. Hub parity: Common Workflows — Rent reduction after invoicing. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Rent reduction after invoicing — Hub matrix: invoiced-floor modals + MP4 (
bookings-detail-change-monthly-rent-modal.png,bookings-detail-contract-values-invoiced-floor-edit-amount.png,bookings-rent-reduction-invoiced-floor-flow.mp4) - FAQ — Rent reduction after invoicing hub — Collections goodwill on invoiced rent lines symptom table
- Common Workflows — Bulk Hostkit invoicing — Issue credit notes Hostkit pacing after external rent relief (
finance-transactions-bulk-selection-bar.png) - Glossary — Invoiced floor (rent) — Change monthly rent clamp vs Edit amount Save block
- FAQ — Lower rent below invoiced — External credit note path when in-product net cannot drop
- Step 4 — Record the payment when received — Collections before repricing goodwill discounts
- Bookings — Changing contract dates and rent — Repricing entry on booking sidebar
- Finance — Invoiced floor and rent edits — Why edits start on the booking, not Transactions
Same-day turnover coordination
Step 1 — Identify overdue payments when outgoing In Debt on a departing stay blocks incoming Managing a Check-in — Step 4 on a same-day turnover unit — clear outgoing Managing a Check-out — Step 6 before you treat the row as rent arrears on the incoming guest. Hub parity: Common Workflows — Same-day turnover coordination. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Same-day turnover coordination — Hub matrix (
bookings-detail-payment-plan-tab-schedule.png,workflows-check-out-coordination-flow.mp4) - Glossary — Same-day turnover coordination hub — Surface table + per-guide/module mesh
- Step 1 — Identify overdue payments — Outgoing vs incoming ledger on shared units
- Managing a Check-out — Step 6 — Upstream settlement before key handover
- Common Workflows — Check-out collections before refund — Departure-week collections mesh
- Bookings — Timeline view — Confirm same-day overlap on unit row
- FAQ — Same-day turnovers — Outgoing In Debt row in numbered habit
Occupancy KPI to block hygiene handoff
Step 1 — Identify overdue payments when a unit appears on Dashboard Vacant Units but Sales Multicalendar shows manual holds — clear stale blocks via Manual block hygiene before you treat the row as rent arrears. Hub parity: Common Workflows — Occupancy KPI to block hygiene handoff. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Occupancy KPI to block hygiene handoff — Hub matrix (
dashboard-vacant-units-widget.png,sales-multicalendar-tab.png) - Glossary — Occupancy KPI to block hygiene handoff hub — Surface table + per-guide/module mesh reciprocal hub
- FAQ — Occupancy KPI to block hygiene handoff hub — Vacancy vs manual hold symptom table
- Step 1 — Identify overdue payments — Vacancy vs hold distinction before collections
- Manual block hygiene — Step 4 — Clear holds surfaced during triage
- Dashboard — Vacant Units — Widget that can list held units
- Glossary — Vacant Unit Preference — Include manual blocks setting
Deposit missing on Finance Deposits
Step 1 — Identify overdue payments must distinguish deposit shortfalls from rent Partial Paid — when the Partial paid lifecycle card is empty, clear the Finance → Deposits toolbar date range first. Hub parity: Common Workflows — Deposit missing on Finance Deposits. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Deposit missing on Finance Deposits — Hub matrix (
finance-deposits-date-range-toolbar-cleared.png,finance-deposits-date-range-clear-flow.mp4) - Step 1 — Identify overdue payments — Deposit tab vs Payment Plan distinction after range is cleared
- Partly collected security deposit — Partial paid card triage after toolbar fix
- Glossary — Finance Deposits date range — Default ~3 months intersection rule
- Managing a Check-out — Deposit missing on Finance Deposits — Departure refund mesh (completed stay)
Deposit lifecycle status
Step 1 — Identify overdue payments contrasts rent Partial Paid on Payment Plan with deposit Partial Paid on depositStatus — open booking Deposit when the shortfall is a security deposit. Hub parity: Common Workflows — Deposit lifecycle status. Full pairing matrix: Handling A Late Payment section cross-reference · Common Workflows section cross-reference.
- Step 1 — Identify overdue payments — Deposit vs rent Partial Paid contrast
- Common Workflows — Deposit lifecycle status — Hub matrix
- Glossary — Deposit lifecycle status —
depositStatuspill vocabulary - Partly collected security deposit — Finance → Deposits Partial paid card
Partly collected security deposit
Step 1 — Identify overdue payments must distinguish deposit shortfalls (Partially paid on the Deposit tab; Partial Paid on depositStatus) from rent schedule Partial Paid on Payment Plan. Hub parity: Common Workflows — Partly collected security deposit. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Partly collected security deposit — Hub matrix when Paid on the deposit is above zero but below Amount
- Step 1 — Identify overdue payments — Deposit tab vs Payment Plan distinction
- Finance — Deposit lifecycle status cards — Partial paid card for portfolio triage (#2091)
- Finance — Deposit status filter — Other filters → Deposit status → Partial paid on Bookings and Finance (#2090)
- Operations — Tickets toolbar search — Paste the full sequential ticket ID (for example
S259,T27) in toolbar Search (#2074) - FAQ — Find a ticket by its ID — Paste the full sequential ticket ID (for example
S259,T27) in Operations → Tickets toolbar Search (#2074) - FAQ — Skip automatic check-in/out tickets for one booking — Turn off Use unit contract rents and other contract details on Add booking to reveal CI/CO ticket checkboxes (#1140)
- FAQ — Same-day turnovers — Check-out + check-in on one unit same day: Operations → Check-in & Check-out, Timeline / Multicalendar, turnover tickets
- FAQ — Manual payments after Delete Booking — Delete Booking hides manual/provider_platform rows on Finance → Transactions; vIBAN and credit card stay visible (#1897)
- Glossary — Directory list load failures — First-fetch directory failures show Retry / Try again; distinct from filter-empty states and booking-sidebar tab errors
- Glossary — Vacant Unit Preference — Include manual blocks counts operator holds as free on Dashboard / Sales vacancy surfaces (#1427)
- FAQ — Communication or Tickets load failure — Tab-scoped Refresh (Communication) or Retry (Tickets); other booking sidebar tabs stay usable
- FAQ — Partly collected security deposit — Operator triage habit
- Glossary — Deposit lifecycle status — partial filter under status summary cards
- Glossary — Deposit lifecycle status —
depositStatuspill vocabulary (Partial Paid vs rent Partial Paid) - Finance — Deposit lifecycle status cards — Deposit lifecycle status row on Finance → Deposits; click Partial paid for collection shortfalls (#2091)
Wrong tenant on a booking
Collections triage on Step 1 — Identify overdue payments may surface Upcoming bookings linked to the wrong tenant profile — use Change tenant on Contract Info before escalation, not Delete Booking when dates and unit are correct. Past invoiced allocations stay on the original tenant for audit. Hub parity: Common Workflows — Wrong tenant on a booking. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Wrong tenant on a booking — Hub matrix (
bookings-detail-change-tenant-control.png,bookings-detail-change-tenant-modal.png) - Step 1 — Identify overdue payments — Verify Tenant card before With Debt outreach
- Bookings — Change tenant — Upcoming guards and audit warning
- Common Workflows — Cancel Booking vs Delete Booking — Wrong profile → Change tenant, not Delete
- Glossary — Cancel Booking vs Delete Booking hub — Contrast duplicate import → Delete, not Change tenant
- Processing a New Booking — Wrong tenant on a booking — Post-import fix on Step 6
- Glossary — Wrong tenant on a booking hub — Surface table + per-guide/module mesh reciprocal hub
- FAQ — Wrong tenant on a booking — Eligibility symptom table
Cancel Booking vs Delete Booking
Last-resort escalation on Step 6 — Escalate if unresolved uses Cancel booking via Cancelling a Booking with refund-type dialogs — not Delete Booking when reconciled manual receipts and full Finance → Transactions history matter (#1897). Mistaken duplicate rows use Delete — see Processing a New Booking — Step 1. Hub parity: Common Workflows — Cancel Booking vs Delete Booking. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Cancel Booking vs Delete Booking — Hub matrix (
bookings-cancel-booking-modal-refund-types.png,bookings-list-canceled-tab.png,workflows-cancel-booking-refund-modal-flow.mp4) - Glossary — Cancel Booking vs Delete Booking hub — Surface table + per-guide/module mesh reciprocal hub
- Step 6 — Escalate if unresolved — Cancel booking for policy voids — not Delete Booking
- Cancelling a Booking — Cancel Booking vs Delete Booking — Settlement before Step 4
- Wrong tenant on a booking — Valid stay with wrong profile → Change tenant, not Delete
- FAQ — Manual payments after Delete Booking — Manual Transactions hidden (#1897)
- Portfolio retirement decisions — Building Archive — third scope beyond Cancel / Delete
Portfolio retirement decisions
Last-resort escalation on Step 6 — Escalate if unresolved uses Cancel booking via Cancelling a Booking — not Delete Booking when ledger history and refund dialogs matter. Building sunsetting is Archive property — a third scope. Hub parity: Common Workflows — Portfolio retirement decisions. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Portfolio retirement decisions — Hub matrix (
bookings-cancel-booking-modal-refund-types.png,bookings-list-canceled-tab.png) - Glossary — Portfolio retirement decisions hub — Surface table + per-guide/module mesh reciprocal hub
- Common Workflows — Cancel Booking vs Delete Booking — Refund dialog vs soft-archive decision table
- Step 6 — Escalate if unresolved — Cancel booking for policy voids — not Delete Booking
- Cancelling a Booking — Portfolio retirement decisions — Settlement before Step 4
- FAQ — Manual payments after Delete Booking — Manual Transactions hidden after Delete (#1897)
- Glossary — Archived booking ledger visibility — System vs Manual buckets after soft-archive
Provider platform Delete Booking guard
Last-resort policy void on Step 6 — Escalate if unresolved uses Cancel booking — not Delete Booking when manual receipts must stay on Finance → Transactions. When soft-archiving mistaken integration rows elsewhere, clear provider platform in-payment first (#2076). Hub parity: Common Workflows — Provider platform Delete Booking guard. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Provider platform Delete Booking guard — Hub matrix (
bookings-provider-platform-reject-delete-flow.mp4) - Glossary — Provider platform Delete Booking guard hub — Surface table + per-guide/module mesh reciprocal hub
- Cancel Booking vs Delete Booking — Cancel booking on Step 6 when ledger history matters
- Step 6 — Escalate if unresolved — Policy void — not soft-archive
- Bookings — Provider platform payment — Clear in-payment before Delete elsewhere
- Glossary — Archived booking ledger visibility — Manual Transactions hidden after Delete (#1897)
- FAQ — Delete Booking on integration reservation — Integration guard (#2076)
Archived booking ledger visibility
Last-resort policy void on Step 6 — Escalate if unresolved uses Cancel booking — not Delete Booking when Manual Transactions must stay on Finance → Transactions (#1897). Soft-archive hides manual/provider_platform rows for that reservation. Hub parity: Common Workflows — Archived booking ledger visibility. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Archived booking ledger visibility — Hub matrix (
finance-transactions-type-summary-cards.png) - Glossary — Archived booking ledger visibility hub — Surface table + per-guide/module mesh reciprocal hub
- Step 6 — Escalate if unresolved — Cancel booking when ledger history matters
- Cancel Booking vs Delete Booking — Cancel for policy voids — not Delete
- Cancelling a Booking — Archived booking ledger visibility — Settlement workflow keeps full ledger
- Provider platform Delete Booking guard — Clear in-payment before Delete elsewhere (#2076)
- Finance — Type summary cards — System vs Manual Transactions
- FAQ — Manual payments after Delete Booking — Symptom table (#1897)
Archive property (building-level)
Before building Archive, finish open collections on Step 6 — Escalate if unresolved — sunsetting a building does not void receivables. Use Archive property only after arrears are settled or written off per policy. Hub parity: Common Workflows — Archive property (building-level). Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Archive property (building-level) — Hub matrix (
listings-archived-populated-table.png) - Glossary — Archive property (building-level) hub — Surface table + per-guide/module mesh reciprocal hub
- Step 6 — Escalate if unresolved — Collections before building sunsetting
- Finance debt receivables triage — Open arrears before Archive
- Portfolio retirement decisions — Cancel vs Archive vs Delete
- Cancelling a Booking — Archive property (building-level) — Policy void vs building sunsetting
- Portfolio KPI review — Archive property (building-level) — Step 7 review
- FAQ — Portfolio retirement decisions — Decision table
Directory list load failures
Collections triage on Step 1 — Identify overdue payments needs loaded Finance, Bookings, or Tenants directories — Failed to load … + Retry is a first-fetch failure, not zero arrears in the portfolio. Pair Dashboard partial-load Retry when the headline Total Debt card loaded but aggregate stats failed. Hub parity: Common Workflows — Directory list load failures · Glossary — Directory list load failures hub. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Directory list load failures — Hub matrix (
finance-contract-values-in-debt-filter.png,dashboard-partial-data-load-failure.png) - FAQ — Directory list load failures hub — Receivables directory Retry on collections triage (Step 1)
- Step 1 — Identify overdue payments — Finance / Bookings / Tenants list Retry before assuming zero rows
- Common Workflows — Finance debt receivables triage — Surface choice after directories load
- Finance — Contract Values — In Debt filter needs successful first fetch
- Bookings — Loading more rows — Whole-module list-card Retry
- Common Workflows — Booking sidebar tab load failures — Tab-scoped Communication Refresh on Step 3 — distinct from list failure
Booking sidebar tab load failures
Collections outreach on Step 3 — Contact the tenant often needs Bookings → Communication while Payment Plan stays visible — Could not load messages needs header Refresh, not whole Bookings / Finance list Retry from Step 1. Hub parity: Glossary — Booking sidebar tab load failures hub · Common Workflows — Booking sidebar tab load failures. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Booking sidebar tab load failures — Hub matrix (
bookings-detail-communication-tab-whatsapp-thread.png) - Glossary — Booking sidebar tab load failures hub — Surface table + per-guide/module mesh reciprocal hub
- FAQ — Booking sidebar tab load failures hub — Communication Refresh during collections (Step 3)
- Step 3 — Contact the tenant — Communication Refresh during collections outreach
- WhatsApp per-booking messaging — Normal thread vs load-error Refresh
- Directory list load failures — Whole-module Retry on Step 1 — distinct from tab failure
- Managing a Check-out — Booking sidebar tab load failures — Departure outreach pairing
- FAQ — Communication or Tickets load failure — Tab-scoped recovery controls
Confirmation to check-in handoff
Unpaid Upcoming confirmation or move-in charges on Step 1 — Identify overdue payments block handoff to Managing a Check-in — Step 4 — contrast Upcoming payment overdue with Ongoing receivables collections. Finish Processing a New Booking — Step 6 portal gates before arrival-week planning. Hub parity: Common Workflows — Confirmation to check-in handoff. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Confirmation to check-in handoff — Hub matrix (
bookings-detail-contract-method-of-payments.png,finance-contract-values-in-debt-filter.png) - Glossary — Confirmation to check-in handoff — Upcoming portal gates → arrival week ~7 days before move-in
- Glossary — Confirmation to check-in handoff hub — Surface table + per-guide/module mesh
- Step 1 — Identify overdue payments — Upcoming move-in shortfall before key handover
- Payment alert to receivables triage — Ongoing receivables contrast
- Processing a New Booking — Step 6 — Upstream portal gates
- Managing a Check-in — Step 3 — Downstream move-in charge verification
- Confirmation alert triage — Upcoming payment overdue alert path
- FAQ — Confirmation to check-in handoff — Unpaid move-in before handoff symptom table
Confirmation alert triage
Collections triage on Step 1 — Identify overdue payments must distinguish Upcoming payment overdue (confirmation-week unpaid charges — row-click via Notification triage — Step 4, finish Processing a New Booking — Step 6 before handoff) from Ongoing receivables on Payment alert to receivables triage. Hub parity: Common Workflows — Confirmation alert triage. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Confirmation alert triage — Hub matrix (
notifications-row-navigation-flow.mp4) - Glossary — Confirmation alert triage — Upcoming Booking created / Payment received before mark-read
- Glossary — Confirmation alert triage hub — Surface table + per-guide/module mesh
- Step 1 — Identify overdue payments — Upcoming vs Ongoing payment overdue contrast
- Payment alert to receivables triage — Ongoing receivables path
- Notification triage — Step 4 — Row-click entry from
/notifications - Processing a New Booking — Step 6 — Portal gates on Upcoming unpaid rows
- FAQ — Confirmation alert triage hub — Upcoming vs Ongoing contrast symptom table
- FAQ — Processing a New Booking hub — Confirmation-week symptom table
Portfolio segmentation by tenant category
Segment-wide arrears after Step 6 pair with Portfolio KPI review — Step 6. Hub parity: Common Workflows — Portfolio segmentation by tenant category. Full pairing matrix: handling-a-late-payment-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Portfolio segmentation by tenant category — Hub matrix when workflows must align across reservations, receivables, and profiles
- Glossary — Portfolio segmentation by tenant category hub — Surface table + per-guide/module mesh reciprocal hub
- FAQ — Portfolio segmentation by tenant category hub — Segment filter symptom table
- Bookings — Other filters — Scope overdue list by Tenant category
- Tenants — With Debt — Directory segmentation for collections
- Finance — Tenant category filter — Contract Values segment pass
Key glossary terms
Glossary rows pair with Glossary cluster cross-reference. Full pairing matrix: Handling a Late Payment section cross-reference · Common Workflows section cross-reference.
-
Glossary — End-of-Booking cost split — Charge Time → End of Booking splits daily overage across every occupied unit; still-staying roommates stay in the denominator (#2111)
-
Operations — Property-level ticket search — Property-name matches share the top relevance tier with unit hits; building-scoped rows float first under an active Property filter (#2089)
-
Glossary — Change history — Operator-initiated edits on Listings setup and Bookings Changelog; create-time defaults excluded (#2093)
-
FAQ — Booking Changelog scope — Operator-initiated edits only; create-time defaults excluded (#2093)
-
Glossary — Archived booking ledger visibility — Delete Booking hides manual/provider_platform rows on Finance → Transactions; vIBAN and credit card stay visible (#1897)
-
Bookings — Provider platform payment — Non-rejected provider platform in-payment blocks Delete Booking until Reject or assign (#2076)
-
FAQ — Delete Booking on integration reservation — Clear pending provider platform in-payment with Reject or assign before soft-archive (#2076)
-
Listings — Property edit sidebar pills — Setup / Full integration / Photos pills on property and unit edit sidebars; replaced the old Go to details shortcut (#2082)
-
Glossary — Finance tenant category cache refresh — Recategorizing a tenant on Tenants → Tenant Info force-refreshes Finance caches so Contract Values, Overview, and Deposits filters match within seconds (#2088)
-
FAQ — Assign tenant category for direct booking — Add booking has no category field; assign on Tenants → Tenant Info or + Create New → Tenant before contract mail
-
Glossary — SIMAR water contract ID — SIMAR (Loures e Odivelas) water bills use Cód. Local in Connections — not Nº de Contador; leading zeros stripped (#2110)
-
FAQ — SIMAR water bill property match — Cód. Local in Connections — not Nº de Contador; strip leading zeros (#2110)
-
Glossary — Per-booking maintenance ticket opt-out — Add booking checkboxes skip automatic CI/CO tickets for one reservation only; property rule unchanged (#1140)
-
FAQ — Cancel Booking vs Delete Booking — Cancel for real stays with settlement; Delete soft-archives mistaken/test rows (#1897 / #2076)
-
Glossary — Archived property — Archive retires a building to Listings → Archived without deleting bookings; distinct from Delete Booking (reservation soft-archive) — Listings — Archived properties
-
FAQ — Archive a property — Edit property sidebar Archive / Unarchive on Listings; building-level — not Delete Booking or Cancel booking
-
FAQ — Portfolio retirement decisions — Archive property (building) vs Cancel booking vs Delete Booking (reservation soft-archive) — three-way decision table
-
Glossary — Tenant category — Segment-wide collections escalation when Step 6 arrears repeat across one profile type
-
FAQ — Finance tenant category filter parity — When Finance Other filters omits a segment Bookings/Tenants still list (Step 6)
-
Glossary — Notification row navigation — Open the booking from a payment overdue alert (Step 1)
-
FAQ — Notification row-click navigation — On
/notifications, row click marks unread then openslink,bookingId,tenantId,listingId, orpropertyId(first match); Dashboard bell General rows stay in-panel unlesslinkis set -
FAQ — Phone shows Operations only — Mobile phone user agent locks operators with Operations access to
/operations; iPads and narrow desktop browsers keep the full module list -
Glossary — Finance income status — In debt payment-line drill-down on Finance Overview (Step 1)
-
FAQ — Finance Income status drill-down — Overview Income chart (Paid / Scheduled / In debt); click a segment for month-scoped payment-line modal; Debt Aging for booking-level receivables
-
Glossary — Finance Debt Aging — Top debtors and overdue buckets for booking-level triage (Step 1)
-
Glossary — Dashboard KPI cards — Total Debt on
/vs Finance seven-card strip (Step 1) -
Glossary — Uncovered Debt — Deposit coverage vs Total Debt when prioritizing calls (Step 1)
-
FAQ — Uncovered Debt KPI — When Uncovered Debt ≈ Total Debt, deposit cushions are thin (Step 1)
-
Glossary — Deposit lifecycle status —
depositStatusthrough Ready to Refund when arrears block departure-week refund (Step 6) -
Finance — Deposit status filter — Other filters → Deposit status multi-select for portfolio deposit queues (#2090)
-
Glossary — Tenants table expand — Scan per-booking Balance before opening a profile (Step 1)
-
Glossary — Pending manual in-payment (Finance) — Approve or reject manual receipts before you close a collections case (Step 4b)
-
FAQ — Pending manual in-payment on /notifications — Alert persists until Approve payments clears Finance or booking Transactions
-
FAQ — Uncovered Debt KPI — Finance Total Debt minus deposit offsets; pair with Debt Aging and In debt drill-down
-
Glossary — Credit note (payment reject/revert) — Reject/revert when accounting may already have invoiced the charge (Step 4b)
-
FAQ — Manual receipt still pending — When Payment Plan still shows unpaid after Step 4 (Step 4b)
-
FAQ — Finance Income status drill-down — In debt segment opens payment-line detail; Debt Aging opens bookings (Step 1)
-
FAQ — Bookings that owe money — Top debtors and overdue buckets on Finance → Overview (Step 1)
-
Glossary — Invoiced floor (rent) — Rent relief on invoiced months needs external credit notes
-
FAQ — Bulk Hostkit invoicing slow — Vivin paces Hostkit API calls and retries HTTP 429 during bulk Issue allocation / Invoice selected; refresh Transactions before re-issuing
-
Glossary — Booking detail sidebar tab load failures — Communication / Tickets recovery while chasing balances
-
FAQ — Lower rent below invoiced — Why Change monthly rent clamps and Edit amount blocks lowering exported rent during collections (
bookings-detail-change-monthly-rent-modal.png) -
FAQ — AI token usage — Poll GET /ai-usage / GET /ai-usage/summary with management JWT;
landlord_chat+utility_bill_extraction; no management UI screen yet -
FAQ — Automatic check-in email — Trigger matrix, 15-day cutoff, paper upload vs portal signing, Nuki-only toggle, Send / Resend on Contract Info
-
FAQ — WhatsApp and email per booking — Bookings → Communication tab when tenant chatbot is enabled; Inbox for portfolio-wide triage
-
FAQ — Deposit missing on Finance Deposits — Default ~3 months date range; clear or widen before triaging older move-outs or dispute row actions
-
FAQ — Analytics (KPI workspace) — Portfolio KPIs vs Sales/Listings/Dashboard; load-failure Try again
-
FAQ — Permission denied toast — Red You do not have permission to perform this action. toast when RBAC blocks a save; fix in Users → Role Permissions
-
FAQ — Fixed rent on variable unit — Variable listing + equal rent every contract month → booking stores fixed headline Monthly rent; payment plan unchanged
Module documentation hubs
Module hub bullets pair with Modules — Module cross-reference. Full pairing matrix: Handling a Late Payment section cross-reference · Common Workflows section cross-reference.
- Utilities module — Bills Included ceiling model and tenant overage charges (section cross-reference; Deeper workflow reads; hub)
- Operations module — Maintenance tickets and check-in/out coordination (section cross-reference; Deeper workflow reads; hub)
- Listings module — Property wizard and unit management (section cross-reference; Deeper workflow reads; hub)
- Sales module — Portfolio availability and channel connections (section cross-reference; Deeper workflow reads; hub)
- Notifications module — Full
/notificationshistory (section cross-reference; Deeper workflow reads; hub); Payment overdue alerts when scheduled charges are overdue (Step 1) - Booking engine details — Rich marketplace payload editor (section cross-reference; Deeper workflow reads; hub)
- Properties workspace — Legacy
/propertiesURL redirects (section cross-reference; Deeper workflow reads; hub) - AI Chat module — Vivin-internal AI Assistant (section cross-reference; Deeper workflow reads; hub)
- Account Settings — Workspace-wide financial policies (hub subsection index; Deeper workflow reads; hub)
- API Reference hub — Partner HTTP contracts (hub subsection index; hub)