Analytics (KPI workspace)
Optional after core setup steps 1–15 — month-range KPI charts when your role includes Analytics module permission (analytics.module). Reconcile figures with Dashboard snapshot cards and Finance ledgers during Portfolio KPI review. Complete Getting Started — Recommended Setup Sequence first. Workflow pairing: Modules — Setup sequence after go-live.
Confirm Who can use it, then skim Layout and controls and Tab overview before Revenue, ADR, and RevPAR tabs (shared layout). Operational follow-up: Maintenance tab. Reconcile figures with Dashboard and Finance during Portfolio KPI review. Guide subsection map: Analytics guide subsection index (tab sections + Related subsections). Non-linear operator habits (Lockout catch-up, Pending manual receipt approval, Reject/revert mistaken receipts, Notification row-click navigation, Payment alert to receivables triage, Confirmation alert triage, Finance debt receivables triage, Finance Income status drill-down, Cash flow forecast drill-down, Partly collected security deposit, Portfolio segmentation by tenant category) have matching Related subsections below. Full pairing matrix: Analytics section cross-reference · Modules — Module cross-reference.
The Analytics module (/analytics) is the portfolio KPI workspace: charts and breakdowns for Overview, Revenue, Occupancy, ADR, RevPAR, and Maintenance over a configurable from–to date range you pick in the toolbar. It answers “how is the portfolio performing over time?” — not “what should this listing’s nightly rate be next week?” For per-listing availability, pricing grids, and channel status, use Sales instead.
Reconcile month-end charts with Finance Income and Sales Pricing grids; pair Dashboard snapshot cards for daily ops. When Revenue or debt KPIs spike during Portfolio KPI review, triage payment overdue alerts with Handling a Late Payment — Step 1. Poll AI usage API during Portfolio KPI review — Step 7 when assistant or utility-bill extraction volume should explain operational spikes. When weak metrics look tied to one tenant category, scope Finance — Tenant category filter (or Bookings — Other filters tenant category) during Portfolio KPI review — Step 6 — see Glossary — Tenant category. Section-to-doc pairing: Analytics section cross-reference. Full pairing matrix: Modules — Module cross-reference.
Open Analytics at platform.vivin.app/analytics. Bookmarkable tab routes are listed in Deep Links — Analytics (KPI Dashboard).
Who can use it
The sidebar entry Analytics (under Business, after Finance and before Operations) is shown only when your role includes the Analytics module permission (analytics.module). Without it, the link is hidden and opening /analytics (or a deeper tab URL) directly shows the standard permission message. Administrators grant access in Users and roles.
Layout and controls
- Page header — Title and short subtitle for the workspace.
- Tab strip — Pill-style tabs switch the main chart set: Overview, Revenue, Occupancy, ADR, RevPAR, and Maintenance. The URL updates to
/analytics/<tab>(for example/analytics/revenue). - Date range — A from–to month range in the toolbar applies to all tabs; click the range control to open the month picker, choose a start month then an end month, and close the popover. Quick presets inside the picker — 6M, 12M, and YTD — set common windows in one click (rolling multi-month spans anchored on the current month for 6M / 12M, calendar year-to-date for YTD). Every tab reuses the range you pick until you change it.

- Refresh indicator — A small spinner may appear while data is refetching after you change the range or tab. On a cold visit or after a large range change, chart cards can take roughly 15–20 seconds to populate; the tab strip and month picker are visible immediately, but ranking and heatmap sections stay empty until the workspace finishes loading KPI data.
- When data fails to load — If the analytics service does not return KPI data on the first fetch, the page shows a red inline alert (for example “We couldn’t load your portfolio KPIs”) instead of blank chart cards that look like a zero portfolio. Copy explains that charts would be empty or stale until data loads. Click Try again to refetch — you do not need to leave the module or change the month range first. Do not treat this state as proof of zero revenue or occupancy; retry or check back before operational decisions. A slow success path (spinner, then charts) is different from this hard failure path. For a same-day snapshot when Analytics is unavailable, use the Dashboard. See also FAQ — Analytics shows a red error banner.

- Aggregation — Revenue, ADR, RevPAR, and Occupancy expose property, unit, and (when your portfolio has multiple owners and the tab offers it) owner roll-ups on ranking and heatmap sections. Maintenance uses property vs unit only for rankings and heatmaps. Overview has no aggregation control — it always shows portfolio-wide monthly bars.
- Tab info (non-Overview tabs) — On Revenue, Occupancy, ADR, RevPAR, and Maintenance, an information icon appears next to the month-range picker. Open it for the same definitions the product uses for that tab (revenue components, ranking rules, heatmap meaning, and forecast handling).


Several inner card titles (for example Monthly Trend and Heatmap) are fixed English strings in the UI today; tab names, tooltips, and numeric formatting still follow your interface language where applicable.
Screenshots
These captures use a desktop viewport (about 1536×900): you see the management shell, the Analytics tab strip, and the month-range picker. In the live app, scroll for additional charts or tables below the fold.






The ADR, RevPAR, and Maintenance tabs use the same three-part layout as Revenue and Occupancy: a wide Monthly Trend next to a Ranking card (top 20), then a full-width heatmap. ADR and RevPAR also offer By Property, By Unit, and (when applicable) By Owner on both ranking and heatmap; Maintenance is By Property or By Unit only.
Committed screenshots must stay operator-presentable — no [CLONE-*] names, obvious test strings, or distorted outlier rows in readable ranking or heatmap labels.
Last verified (2026-07-08 08:02 UTC, hourly docs enricher) on the Vivin docs capture account (@vivin.app staging data): Overview and all metric-tab PNGs (Revenue, Occupancy, ADR, RevPAR, Maintenance) verified publication-clean on disk; no refresh needed this run. Definitions tooltip PNG remains current from 2026-06-04 (tools/capture-analytics-kpi-maintenance-info-tooltip.ts).
Tab overview
Tab grid pairs with Dashboard module and Portfolio KPI review — Step 2 — segment with Finance — Tenant category filter. Full pairing matrix: Analytics section cross-reference.
| Tab | Typical use |
|---|---|
| Overview | A single grid of bar charts for the selected range — revenue, occupancy %, ADR, RevPAR, and maintenance (operations tickets created per month in range) so you can scan trends side by side. |
| Revenue | Monthly trend (portfolio), ranking (top 20 by roll-up), and revenue heatmap — see Revenue, ADR, and RevPAR. |
| Occupancy | Same top-row split as other metric tabs: monthly occupancy trend, occupancy ranking (top 20), then a seasonality heatmap; owner roll-up appears only with multiple owners. |
| ADR | Same layout as Revenue, for average daily rate: total revenue divided by occupied nights (see tab info tooltip). |
| RevPAR | Same layout as Revenue, for revenue per available night: total revenue divided by available nights (see tab info tooltip). |
| Maintenance | Tickets created per month in the selected range, ranking by property or unit (top 20, no owner mode), and a ticket count heatmap — see Maintenance tab. |
Tab names, tooltips, and numeric labels follow your interface language where the product localizes them; URLs and permission keys stay the same.
How amounts are formatted on charts
Portfolio monthly totals and large ranking values use compact EUR notation (for example 86,8 Mio. € in a de-DE locale) so axis ticks stay readable and are not misread as glued symbols. ADR and RevPAR use grouped euros for typical nightly rates and switch to compact notation only from €1M upward on axes and heatmaps. Tooltip and table cells follow the same rules. Your interface language affects separators and wording where the formatter localizes them.
Before charts render, the product caps extreme values used only for display on Revenue, ADR, and RevPAR trend bars and heatmaps when a corrupted balance would otherwise flatten the scale (for example monthly revenue above €100M or nightly rates above €5,000 are clipped to those ceilings). Real portfolio numbers stay unchanged in Finance and bookings; the cap restores readable axes. If you still see a flat or empty chart after a data fix, refresh the tab or change the month range so the workspace refetches.
Mistyped tab URLs (for example /analytics/foo) redirect to /analytics/overview so the address bar matches the tab you see — see Deep Links — Invalid, legacy, and mistyped URLs.
Revenue, ADR, and RevPAR tabs (shared layout)
Revenue, ADR, and RevPAR are implemented as one shared screen pattern:
- Top row — A two-column-wide Monthly Trend bar chart for the portfolio series, next to a one-column Ranking card. The ranking table lists up to 20 entities with mini comparison bars.
- Roll-ups — On both the Ranking card and the heatmap below it, use By Property, By Unit, and (when the portfolio has more than one linked owner) By Owner to change how rows are grouped. The ranking and heatmap each have their own roll-up control so you can compare different slices (for example rank by property while scanning unit-level seasonality).
- Definitions — Open the information icon beside the date range for wording that matches the product: revenue counts rent plus admin and cleaning fees and excludes deposits and full refunds; ranking for property groups uses a simple average of each unit’s metric in that group; heatmap cells are month-by-row values with colour intensity for relative performance; forecast months use confirmed bookings for forward periods.
ADR and RevPAR reuse that exact structure; only the metric on the trend bars, ranking values, and heatmap colouring changes.
Maintenance tab
Ticket trends pair with Operations module and Glossary — Draft ticket (display status) — Portfolio KPI review — Step 5. Full pairing matrix: Analytics section cross-reference.
The Maintenance tab answers “where are we opening the most operations tickets, and when?” using tickets whose created timestamp falls in the selected from–to range:
- Top row — Monthly Trend (ticket count per month) and Maintenance Ranking (total tickets in the period, top 20 rows). Roll-up is By Property or By Unit only (By Owner is not offered on this tab).
- Heatmap — A full-width matrix of ticket counts by month and property or unit (again property / unit only), with a colour scale from zero to the portfolio maximum in view.
- Definitions — Open the information icon beside the month-range picker for How Maintenance works: ticket counts per month, how ranking totals are grouped, and how heatmap colour intensity reflects relative ticket volume (same pattern as the metric tabs).
For ticket workflows in the product (assignments, checklists, and exports), use the Operations module.
How Analytics differs from Sales
Choose Analytics for portfolio roll-ups and Sales for listing-centric calendars — see FAQ — Analytics (KPI workspace) when figures disagree with Sales, Dashboard, or Finance. Pair month-end reconciliation with Portfolio KPI review and FAQ — Dashboard Total Debt subtitle. Full pairing matrix: Analytics section cross-reference.
| Question | Use Analytics | Use Sales |
|---|---|---|
| Scope | Whole portfolio (and roll-ups by property / unit / owner) | Individual listings, calendars, channel rows |
| Time lens | Multi-month from–to range | Availability windows, heatmaps, listing-centric pricing |
| Primary decisions | Portfolio health, trends, investor-style KPIs | Gaps, nightly/monthly prices, channel manager actions |
Analytics guide subsection index
This index pairs Analytics tab sections and Related subsections — use it when month-range charts disagree with Dashboard snapshot cards or Sales listing grids. Full pairing matrix: Analytics section cross-reference.
Analytics section cross-reference
Use this table when one Analytics tab or control naturally leads into another module, workflow, or concept — each row links to the docs you should read before or after interpreting that chart.
Related
Related below links this module to settings, concepts, workflows, and escalation paths. Pair Documentation map & escalation with Modules hub — Documentation map & escalation; pair Upstream & downstream workflows with Common Workflows — Workflow cross-reference. Topic-to-section pairing in sections above: Analytics guide subsection index · Analytics section cross-reference. Full hub matrix: Module cross-reference · Modules hub subsection index.
Documentation map & escalation
Documentation-map bullets pair with Introduction — Section cross-reference and FAQ — Section cross-reference. Hub parity: Modules hub — Documentation map & escalation. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Modules hub — Hub pairing matrix across operator workspaces
- Portfolio KPI review — Month-end walkthrough across Analytics, Dashboard, Sales, and Finance
- Glossary — Term definitions used across KPI reconciliation
- FAQ — Analytics (KPI workspace) — When figures differ from Sales or the Dashboard
- Get Help & Support — Escalate when Analytics fails to load or permissions block access
Upstream & downstream workflows
Workflow bullets pair with Common Workflows — Workflow cross-reference. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Manual block hygiene (section cross-reference; Deeper workflow reads; hub) — Audit pass when occupancy or RevPAR dips without an obvious rate change
- Entering Monthly Utility Bills (section cross-reference; Deeper workflow reads; hub) — Close Missing bill gaps before trusting Revenue or occupancy trends
- Handling a Late Payment — Step 1 (section cross-reference; Deeper workflow reads; hub) — Collections when debt-aging or revenue charts spike during KPI review; upstream path from Notifications — Payment overdue alerts
- Notification triage (section cross-reference; Deeper workflow reads; hub) — Clear KPI-threshold alerts after month-end review
- Managing a Check-out & Deposit Refund (section cross-reference; Deeper workflow reads; hub) — Month-end deposit retention trends after KPI review surfaces overdue refunds
Deeper workflow reads
Workflow reads pair with Common Workflows hub subsection index and Workflow cross-reference. Each workflow sub-guide reciprocates with [Deeper workflow reads](../modules/analytics/index.md#deeper-workflow-reads) anchors on Module documentation hubs bullets — hub parity: Modules hub — Deeper workflow reads. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Portfolio KPI review — Month-end walkthrough across Overview, Revenue, Occupancy, ADR, RevPAR, and Maintenance tabs (section cross-reference; Deeper API reads; hub)
- Manual block hygiene — Audit pass when occupancy or RevPAR dips without an obvious rate change (section cross-reference; Deeper API reads; hub)
- Entering Monthly Utility Bills — Close Missing bill gaps before trusting Revenue or occupancy trends (section cross-reference; Deeper API reads; hub)
- Handling a Late Payment — Step 1 — Collections when debt-aging or revenue charts spike during KPI review (section cross-reference; Deeper API reads; hub)
- Notification triage — Clear KPI-threshold alerts after month-end review (section cross-reference; Deeper API reads; hub)
- Managing a Check-out & Deposit Refund — Month-end deposit retention trends after KPI review surfaces overdue refunds (section cross-reference; Deeper API reads; hub)
Navigation & bookmarks
Bookmark routes pair with Management Frontend Deep Links and Create New menu. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Management Frontend Deep Links — Analytics — Full URL table including
/analyticsdefaults and unknown-path behaviour - Modules overview — Where Analytics sits next to Finance and Operations in the product shell
Settings that shape Analytics
Settings bullets pair with Account Settings — Tab cross-reference. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Settings > Users and roles — Analytics module permission (
analytics.module) - Settings > Preferences — Booking defaults — Preparation-day defaults that affect occupancy calculations
- Settings > Preferences — In-app notifications — Account-wide alert categories before you triage KPI-threshold notifications during month-end review
- Settings > Categories — Tag/type vocabulary on Sales and Finance filters during weak-metric segmentation
- Settings > Tenant categories — Segment portal rules and Finance — Tenant category filter when Step 6 isolates one tenant segment
- Settings > Emails — Communication Rules to audit when KPI charts disagree with payment-reminder delivery
Deeper concept reads
Concept reads pair with Concepts hub subsection index and Concept cross-reference. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Booking lifecycle — Computed booking status filters when reconciling occupancy charts with Bookings list counts (section cross-reference; hub)
- Integrations & Distribution — Reconcile occupancy and revenue charts with multichannel imports and iCal blocks (section cross-reference; hub)
- Tenant Portal — Portal adoption and online-payment trends to cross-check against Income and debt KPIs (section cross-reference; 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
- Services Marketplace — Ancillary portal revenue to reconcile against Income and occupancy KPIs during month-end review (section cross-reference; hub)
- Payment Allocation — Two-layer receipts, invoiced-floor rent edits, and credit note reject/revert warnings (section cross-reference; hub)
- Landlord MCP — External portfolio tools that may answer occupancy or revenue questions from the same KPI data (section cross-reference; hub)
- Automation & AI — In-product AI Chat and MCP clients to cross-check KPI answers (section cross-reference; hub)
Operator modules (pairing surfaces)
Module hub bullets pair with Modules — Module cross-reference. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Dashboard Module — Same-day snapshot when Analytics is slow or unavailable
- Sales Module — Per-listing availability and pricing (complements portfolio KPI charts)
- Finance Module — Overview tab — Receivables and income-status drill-down when revenue charts disagree
- Listings — Portfolio toolbar — Tag and type filters that pair with Analytics occupancy drill-downs
- Audit Module — Cross-portfolio manual blocks when occupancy or RevPAR dips without an obvious rate change
- Audit — Discounts tab — Portfolio-wide discount KPIs and export when Revenue or margin charts need contract-value triage
- Inbox module — WhatsApp volume that can skew Maintenance tab ticket counts during KPI review
- Notifications — Payment overdue alerts — Operator Payments category rows when month-end Revenue charts disagree with receivables
- Utilities module — Bill gaps that skew Revenue and occupancy trends
- Finance — Tenant category filter — Reconcile Contract Values In Debt or Deposits for the same segment after Occupancy or Ranking dips (Step 6)
- Tenants module — Demographic directory when occupancy charts need tenant-segment context
- AI Chat module — Assistant summaries to reconcile against KPI charts during review
- Properties workspace — Legacy
/propertiesURLs that still appear in older bookmarks during KPI review
Lockout catch-up after password recovery
Operational backlog after sign-in recovery pairs with Resetting a Management User Password — Step 3. Hub parity: Common Workflows — Lockout catch-up after password recovery. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Common Workflows — Lockout catch-up after password recovery — Hub matrix when sign-in was restored mid month-end before KPI charts were reviewed
- Getting Started — Lockout catch-up after password recovery — Canonical operational backlog mesh
- Portfolio KPI review — Structured catch-up pass across Analytics tabs after lockout
- Notification triage — Clear KPI-threshold alerts before month-end reconciliation
- Pending manual receipt approval — Revenue trends may lag until Finance clears Pending receipts
Pending manual receipt approval
Receipt approval pairs with Finance — Pending manual payments and Bookings — Transactions tab. Hub parity: Common Workflows — Pending manual receipt approval. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
-
Common Workflows — Pending manual receipt approval — Hub matrix when Revenue or debt-aging charts lag until Approve payments confirms recorded transfers
-
Finance — Pending manual payments — Amber Pending chip on Finance → Transactions
-
Revenue, ADR, and RevPAR tabs (shared layout) — Metric trends that may not refresh until pending receipts are approved
-
Dashboard module — Total debt KPI cross-check before trusting month-range charts
-
FAQ — Manual receipt still pending — Why Analytics and Finance may disagree until approval
-
FAQ — Pending manual receipt approval hub — Symptom table for Approve payments / amber Pending
Reject/revert mistaken receipts
Receipt cleanup pairs with Finance — Row actions on in-payment rows and Bookings — Row actions on in-payment rows. Hub parity: Common Workflows — Reject/revert mistaken receipts. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
-
Common Workflows — Reject/revert mistaken receipts — Hub matrix when duplicate receipts inflated Revenue before cleanup on Finance Transactions
-
Finance — Row actions on in-payment rows — Bulk Reject selected after KPI review triage
-
Payment Allocation — Correcting mistaken receipts — Two-layer model before trusting charts again
-
Portfolio KPI review — Step 7 — Month-end reconciliation when Analytics and Finance disagree after receipt cleanup
-
Handling a Late Payment — Step 1 — Collections when debt-aging charts spike during KPI review
-
FAQ — Reject/revert mistaken receipts hub — Symptom table for Reject / Revert / Issue credit notes
Check-out ledger cleanup before refund
Duplicate-transfer cleanup pairs with Reject/revert mistaken receipts and Managing a Check-out. Hub parity: Common Workflows — Check-out ledger cleanup before refund. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
-
Common Workflows — Check-out ledger cleanup before refund — Hub matrix when Revenue or debt-aging charts show phantom arrears from duplicate departure transfers
-
Reject/revert mistaken receipts — Reject / Revert duplicate before Ready To Refund
-
Managing a Check-out — Step 6 — Canonical departure-week duplicate cleanup before refund
-
Common Workflows — Check-out collections before refund — Real arrears contrast (tenant did not pay)
-
Portfolio KPI review — Step 7 — Month-end sign-off after ledger cleanup
-
Finance — Transactions Tab — Revert duplicate before KPI export
-
FAQ — Check-out ledger cleanup before refund hub — Symptom table for phantom In Debt / Ready To Refund blocked when tenant paid once
Utility overage collections
Utility overage arrears skew Revenue and debt-aging charts after monthly bill posting — segment before collections outreach. Hub parity: Common Workflows — Utility overage collections. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
-
Common Workflows — Utility overage collections — Hub matrix when segment Revenue / debt-aging includes utility overage In Debt
-
Finance — Contract Values tab — In Debt drill-down after Analytics segmentation
-
Entering Monthly Utility Bills — Step 4 — Upstream posting before collections
-
Portfolio KPI review — Step 7 — Month-end overage arrears sign-off
-
Handling a Late Payment — Step 1 — Collections after overage posts
-
FAQ — Utility overage collections hub — Symptom table for unpaid utility overage on Payment Plan after bill posting
Cancellation collections before void
Pre-cancel arrears pair with Portfolio KPI review and Cancelling a Booking. Hub parity: Common Workflows — Cancellation collections before void. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
-
Common Workflows — Cancellation collections before void — Hub matrix when Revenue or debt-aging charts show pre-cancel arrears before policy void queue
-
Portfolio KPI review — Step 7 — Month-end pre-cancel arrears sign-off before void
-
Cancelling a Booking — Step 2 — Settle segment outliers before void
-
Handling a Late Payment — Steps 1–4 — Collections on flagged bookings
-
Finance — Contract Values tab — In Debt filter before analytics export
-
Common Workflows — Check-out collections before refund — Departure-week contrast
-
FAQ — Cancellation collections before void hub — Symptom table for In Debt blocking Cancel booking until Payment Plan settles
Check-out collections before refund
Departure-week arrears pair with Portfolio KPI review and Managing a Check-out. Hub parity: Common Workflows — Check-out collections before refund. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
-
Common Workflows — Check-out collections before refund — Hub matrix when Revenue or debt-aging charts show departure-week rent arrears before refund queue
-
Portfolio KPI review — Step 7 — Month-end departure arrears sign-off
-
Managing a Check-out — Step 6 — Settlement on flagged bookings
-
Handling a Late Payment — Steps 1–4 — Collections on segment outliers
-
Finance — Contract Values tab — In Debt filter before analytics export
-
Common Workflows — Check-out ledger cleanup before refund — Duplicate transfer contrast (tenant paid once)
-
Common Workflows — Cancellation collections before void — Pre-cancel void contrast
-
FAQ — Check-out collections before refund hub — Symptom table for rent/fee In Debt blocking Ready To Refund before deposit release
Handling a Late Payment collections
High receivables can skew Revenue / occupancy KPIs until Handling a Late Payment collections clear — pair Portfolio KPI review Step 7 with Debt Aging. Hub parity: Common Workflows — Handling a Late Payment collections hub. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Common Workflows — Handling a Late Payment collections hub — Hub matrix when analytics KPIs lag until collections Steps 1–6 complete (
analytics-kpi-revenue-tab.png,finance-overview-income-chart-debt-aging.png) - Finance debt receivables triage — Debt Aging before segment KPI sign-off
- Portfolio KPI review — Step 7 — Month-end collections follow-through
- Handling a Late Payment — Step 1 — Collections after KPI outlier triage
- Dashboard — Finance debt receivables triage — Total debt headline vs Finance drill-down
- Pending manual receipt approval — Pending inflates receivables KPIs until Approve
- Common Workflows — Occupancy KPI to block hygiene handoff — Occupancy dip vs arrears contrast
- FAQ — Handling a Late Payment collections hub — Symptom table for triage surface → collections step pairing
Check-out vs cancellation
Month-range Occupancy and Revenue KPIs treat Ended and Canceled exits differently — confirm lifecycle filter on Bookings before month-end sign-off pairs with the wrong workflow. Hub parity: Common Workflows — Check-out vs cancellation. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Common Workflows — Check-out vs cancellation — Hub matrix: KPI skew when Canceled stays are counted as completed departures (
analytics-occupancy-chart.png,bookings-list-canceled-tab.png) - Occupancy tab — Canceled stays free capacity differently than Ended
- Bookings — Check-out vs cancellation — Ended / Canceled filter contrast
- Portfolio KPI review — Step 7 — Month-end sign-off after correct exit routing
- Managing a Check-out — Step 7 — Completed stay closure
- Cancelling a Booking — Step 4 — Policy void closure
- FAQ — Check-out vs cancellation — Symptom table for lifecycle exit routing
Deposit missing on Finance Deposits
Month-range Revenue / occupancy KPIs can look healthy while Finance → Deposits lifecycle card counts stay low — clear the toolbar date range before month-end sign-off when older move-outs are missing. Hub parity: Common Workflows — Deposit missing on Finance Deposits. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Common Workflows — Deposit missing on Finance Deposits — Hub matrix when analytics KPIs lag deposit portfolio triage (
analytics-kpi-revenue-tab.png,finance-deposits-date-range-clear-flow.mp4) - Portfolio KPI review — Step 7 — Month-end deposit sign-off after clearing range
- Finance — Deposit lifecycle status cards — Partial paid card scoped to active date window
- Dashboard — Deposit missing on Finance Deposits — Total debt KPI before Finance drill-down
- Managing a Check-out — Deposit missing on Finance Deposits — Downstream Step 5 refund triage
- Partly collected security deposit — Partial paid card empty until range clears
- FAQ — Deposit missing on Finance Deposits — Symptom table for toolbar date range triage
Notification row-click navigation
Month-range Revenue or Occupancy charts can disagree with receivables until /notifications row-click opens the booking for Notification triage — Step 4 — finish Transactions / Payment Plan triage before you trust KPI trends during Portfolio KPI review. Hub parity: Common Workflows — Notification row-click navigation. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Common Workflows — Notification row-click navigation — Hub matrix (
notifications-row-navigate-to-booking-detail.png,notifications-row-navigation-flow.mp4) - Notifications module — Notification row-click navigation — Canonical
/notificationsrow-click pairing - Dashboard — Notification row-click navigation — Bell General vs full
/notificationsrow-click - Bookings — Notification row-click navigation — Booking sidebar when alert carries
bookingId - Finance — Notification row-click navigation — Overview / Transactions after row-click lands on booking
- Tenants — Notification row-click navigation — Tenant profile when alert carries
tenantId - Listings — Notification row-click navigation — Property or unit sidebar when alert carries
listingIdorpropertyId - Operations — Notification row-click navigation — Turnover-week alerts that row-click into Bookings first
- Utilities — Notification row-click navigation — Overage payment overdue alerts after bill cycle
- Sales — Notification row-click navigation — Channel-import alerts before Multicalendar review
- Inbox — Notification row-click navigation — Bell Inbox
linkdeep-link vs General row-click - AI Chat — Notification row-click navigation — Verify assistant-cited alerts by row-click before KPI conclusions
- Audit — Notification row-click navigation — Discounts / Manual Blocks month-end review after row-click
- Legacy
/propertiesURLs — Notification row-click navigation — Legacy bookmarks that land in Listings during alert triage - Booking engine details — Notification row-click navigation — Engine-sourced alerts before Full integration payload edits
- Revenue, ADR, and RevPAR tabs (shared layout) — Metric trends after row-click opens booking context
- Occupancy tab — Occupancy ranking after receivables triage on opened booking
- Notification triage — Step 4 — Row-click before Step 5
- Payment alert to receivables triage — Ongoing/Ended payment overdue row-click
- Confirmation alert triage — Upcoming Booking created / Payment received row-click
- Portfolio KPI review — Notification row-click navigation — Month-end alert batch on Step 7
- FAQ — Notification row-click navigation — Target field order (
link,bookingId,tenantId,listingId,propertyId)
Payment alert to receivables triage
Ongoing/Ended payment overdue alerts inflate Revenue rankings and debt-adjacent KPI reads until you row-click into Bookings and finish Handling a Late Payment — Step 1 — pair Finance — Overview tab Debt Aging before month-range sign-off. Hub parity: Common Workflows — Payment alert to receivables triage. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Common Workflows — Payment alert to receivables triage — Hub matrix (
notifications-row-navigate-to-booking-detail.png,notifications-row-navigation-flow.mp4,finance-overview-debt-aging-walkthrough-flow.mp4) - Notifications module — Payment alert to receivables triage — Payments category row-click entry
- Dashboard — Payment alert to receivables triage — Total Debt KPI after alert row-click
- Bookings — Payment alert to receivables triage — Payment Plan / Transactions on opened booking
- Finance — Payment alert to receivables triage — Overview → Debt Aging after single-booking triage
- Tenants — Payment alert to receivables triage — With Debt cross-check on tenant profile
- Listings — Payment alert to receivables triage — Property Payments Active portal charges on listing bookings
- Operations — Payment alert to receivables triage — Unpaid move-in lines before key handover
- Utilities — Payment alert to receivables triage — Utility overage lines behind overdue alerts
- Sales — Payment alert to receivables triage — Channel-import schedules behind overdue alerts
- Inbox — Payment alert to receivables triage — payment overdue on General before WhatsApp chase
- AI Chat — Payment alert to receivables triage — Validate assistant debt answers after receivables triage
- Audit — Payment alert to receivables triage — Discounts review when receivables lag behind goodwill lines
- Legacy
/propertiesURLs — Payment alert to receivables triage — Collections on bookings tied to redirected properties - Booking engine details — Payment alert to receivables triage — Engine-sourced schedules behind overdue alerts
- Revenue, ADR, and RevPAR tabs (shared layout) — Metric trends that may lag until receivables clear
- Notification row-click navigation — Row-click on
/notificationsbefore KPI read - Pending manual receipt approval — Amber Pending before collections sign-off
- Confirmation alert triage — Contrast Upcoming vs Ongoing/Ended alerts
- Portfolio KPI review — Step 7 — Month-end reconciliation after triage
- FAQ — Payment alert to receivables triage — Alert-type contrast table
- FAQ — Payment alert to receivables triage hub — Revenue trend may lag until receivables clear symptom table
Finance debt receivables triage
Revenue and debt-adjacent KPI reads may lag until you clear amber Pending receipts and reconcile Finance → Overview → Debt Aging Top debtors. Hub parity: Common Workflows — Finance debt receivables triage. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Common Workflows — Finance debt receivables triage — Hub matrix (
finance-overview-income-chart-debt-aging.png,finance-overview-debt-aging-walkthrough-flow.mp4) - Payment alert to receivables triage — Single-booking alert triage before portfolio surfaces
- Finance — Finance debt receivables triage — Debt Aging Top debtors canonical surface
- Pending manual receipt approval — Clear amber Pending before Top debtors sign-off
- Dashboard — Finance debt receivables triage — Total Debt headline vs Finance drill-down
- Bookings — Finance debt receivables triage — Payment Plan on opened booking
- Handling a Late Payment — Finance debt receivables triage — Debt Aging on Step 1 before outreach
- Portfolio KPI review — Finance debt receivables triage — Month-end Top debtors on Step 7
- FAQ — Finance debt receivables triage hub — Symptom table for four-surface triage
- Revenue, ADR, and RevPAR tabs (shared layout) — Metric trends that may lag until receivables clear
- Portfolio KPI review — Step 7 — Month-end Top debtors sign-off
Finance Income status drill-down
Month-end Revenue reads may disagree with Income → Paid until you reconcile segments on Finance → Overview. Hub parity: Common Workflows — Finance Income status drill-down. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Common Workflows — Finance Income status drill-down — Hub matrix (
finance-overview-income-status-in-debt-modal.png,finance-overview-income-drill-down-flow.mp4) - Finance debt receivables triage — Debt Aging Top debtors when payment-line modal is not enough
- Finance — Income status drill-down — Stacked Income chart canonical surface
- FAQ — Finance Income status drill-down hub — Symptom table for segment vs Debt Aging
- FAQ — Finance Income status drill-down — Paid / Scheduled / In debt segment-click habit
- Portfolio KPI review — Finance Income status drill-down — Month-end Income reconciliation on Step 7
- Revenue, ADR, and RevPAR tabs (shared layout) — Metric trends vs Income segment reconciliation
- Portfolio KPI review — Step 7 — Month-end Income vs Analytics sign-off
Cash flow forecast drill-down
Month-end Revenue reads may disagree with Cash flow forecast All payments until you reconcile on Finance → Overview. Hub parity: Common Workflows — Cash flow forecast drill-down. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Common Workflows — Cash flow forecast drill-down — Hub matrix (
finance-overview-cash-flow-all-payments-modal.png,finance-overview-cash-flow-day-view.png,finance-overview-cash-flow-drill-down-flow.mp4) - Finance Income status drill-down — Paid / Scheduled / In debt segments — not collections history
- Finance — Income chart and cash flow forecast — Canonical Cash flow forecast chart surface
- FAQ — Cash flow forecast drill-down hub — Symptom table for collections vs Income / Dashboard
- FAQ — Cash flow forecast drill-down — Month / Day bar-click habit
- Portfolio KPI review — Cash flow forecast drill-down — Month-end collections reconciliation on Step 7
- Revenue, ADR, and RevPAR tabs (shared layout) — Metric trends vs Cash flow forecast collections
- Portfolio KPI review — Step 7 — Month-end collections vs Analytics sign-off
Confirmation alert triage
Upcoming Booking created / Payment received alerts during month-end review row-click into Bookings — finish Processing a New Booking — Step 5b / Step 6 before you bulk-clear /notifications and sign off Overview / Revenue charts. Hub parity: Common Workflows — Confirmation alert triage. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Common Workflows — Confirmation alert triage — Hub matrix (
notifications-row-navigation-flow.mp4) - Notifications module — Confirmation alert triage — Canonical inbox pairing
- Dashboard — Confirmation alert triage — Post-login Upcoming alert backlog on bell
- Bookings — Confirmation alert triage — Transactions / Contract Info on Upcoming imports
- Tenants — Confirmation alert triage — Tenant Info / Category on confirmation-week clusters
- Finance — Confirmation alert triage — Transactions amber Pending before Overview KPI refresh
- Listings — Confirmation alert triage — Channel import bookings on go-live properties
- Operations — Confirmation alert triage — Turnover prep after confirmation receipts approved
- Utilities — Confirmation alert triage — First bill cycle after go-live alerts
- Sales — Confirmation alert triage — Channel-import Upcoming alerts before Channels linking
- Inbox — Confirmation alert triage — WhatsApp thread after Payment received row-click
- AI Chat — Confirmation alert triage — Assistant-cited confirmation backlog before bulk mark-read
- Audit — Confirmation alert triage — Month-end Discounts review after confirmation receipts approved
- Legacy
/propertiesURLs — Confirmation alert triage — First alerts after legacy redirects land in Listings - Booking engine details — Confirmation alert triage — White-label Upcoming alerts before payload sync
- Notification row-click navigation — Row-click on
/notificationsbefore mark-read - Payment alert to receivables triage — Contrast Upcoming vs Ongoing/Ended payment overdue
- Pending manual receipt approval — Payment received alert until Approve payments
- Portfolio KPI review — Step 7 — Month-end alert cleanup
- Notification triage — Confirmation alert triage — Steps 4 / 5 path
- FAQ — Confirmation alert triage — Alert-type table and bulk mark-read guard
- FAQ — Confirmation alert triage hub — Upcoming alerts during month-end KPI review symptom table
New inventory to first booking handoff
Month-end KPI sign-off on accounts with recent go-live inventory should include first Upcoming reservation backlog — pair Portfolio KPI review — Step 7 with Onboarding — Step 7 and Processing a New Booking — Step 6. Hub parity: Common Workflows — New inventory to first booking handoff. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Sales — New inventory to first booking handoff — Multicalendar on new inventory at month-end
- Bookings — New inventory to first booking handoff — First Upcoming status tabs
- Onboarding a New Property — Step 7 — Upstream go-live baseline
- Portfolio KPI review — Step 7 — First-month sign-off mesh
- Processing a New Booking — Step 6 — Portal gates before KPI close
- Common Workflows — New inventory to first booking handoff — Hub matrix (
listings-module-overview.png,workflows-onboarding-property-wizard.mp4) - Property setup to first arrival handoff — Downstream first-arrival backlog
- FAQ — New inventory to first booking handoff — Symptom table for property wizard → first reservation
Property setup to first arrival handoff
Month-end KPI sign-off on accounts with recent go-live inventory should include first-arrival Upcoming backlog on Operations → Check-in & Check-out — pair Portfolio KPI review — Step 7 with Onboarding — Step 7. Hub parity: Common Workflows — Property setup to first arrival handoff. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Operations — Property setup to first arrival handoff — First-arrival week on Check-in & Check-out
- Sales — Property setup to first arrival handoff — Multicalendar on new inventory at month-end
- Onboarding a New Property — Step 7 — Upstream go-live baseline
- Portfolio KPI review — Step 7 — First-month sign-off mesh
- Managing a Check-in — Step 1 — Downstream arrival-week entry
- Common Workflows — Property setup to first arrival handoff — Hub matrix (
workflows-operations-check-in-out-planning-view.png,workflows-onboarding-property-wizard.mp4) - FAQ — Property setup to first arrival handoff — Symptom table for go-live → first arrival week
Confirmation to check-in handoff
Month-end KPI sign-off should include Upcoming → arrival-week handoff — not only Ongoing receivables. Hub parity: Common Workflows — Confirmation to check-in handoff. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Portfolio KPI review — Step 7 — Month-end Upcoming backlog before sign-off
- Confirmation alert triage — Upcoming alerts during month-end KPI review
- Bookings — Confirmation to check-in handoff — Contract Info portal gates on Upcoming imports
- Operations — Confirmation to check-in handoff — Check-in & Check-out Next 7 days after confirmation closes
- Common Workflows — Confirmation to check-in handoff — Hub matrix (
bookings-detail-contract-method-of-payments.png,workflows-operations-check-in-out-planning-view.png,booking-lifecycle-status-tabs-flow.mp4) - Processing a New Booking — Step 6 — Upstream portal sanity before handoff
- Managing a Check-in — Step 1 — Downstream arrival-week entry (~7 days out)
- Pending manual receipt approval — Step 5b confirmation receipts before handoff
- FAQ — Confirmation to check-in handoff — Symptom table for Upcoming → arrival week
Check-in to check-out handoff
Month-end sign-off should scan Ongoing stays entering departure week — occupancy Revenue dips from missed handoff timing skew Portfolio KPI review — Step 7 reconciliation. Hub parity: Common Workflows — Check-in to check-out handoff. Full pairing matrix: analytics-section-cross-reference · Module cross-reference.
- Revenue, ADR, and RevPAR tabs (shared layout) — Departure-week occupancy skew when handoff missed
- Operations — Check-in to check-out handoff — Check-outs backlog during month-end scan
- Portfolio KPI review — Step 7 — Month-end Ongoing entering departure week
- Managing a Check-in — Step 4 — Upstream keys handed over
- Managing a Check-out — Step 1 — Downstream departure-week entry
- Common Workflows — Check-in to check-out handoff — Hub matrix (
operations-check-in-out-check-outs-next-7-days.png,bookings-timeline-view.png) - Confirmation to check-in handoff — Upcoming → arrival week contrast
- FAQ — Check-in to check-out handoff — Symptom table for Ongoing → departure week
Check-out final utilities handoff
Month-end Portfolio KPI review — Step 7 should close Missing utility bills and departure-week final overages before investor sign-off. Hub parity: Common Workflows — Check-out final utilities handoff. Distinct from Utility overage collections (mid-stay arrears KPI skew). Full pairing matrix: analytics-section-cross-reference · Module cross-reference.
- Revenue, ADR, and RevPAR tabs (shared layout) — Debt-aging skew from departure-week utility overage
- Portfolio KPI review — Step 7 — Month-end Missing + departure utility sign-off
- Utilities — Check-out final utilities handoff — Missing bills upstream of KPI review
- Finance — Check-out final utilities handoff — Contract Values reconciliation during Step 7
- Entering Monthly Utility Bills — Step 5 — Missing bill triage before departure sign-off
- Managing a Check-out — Step 6 — Settlement before deposit release
- Common Workflows — Check-out final utilities handoff — Hub matrix (
utilities-bills-tab-missing-toggle.png,utilities-allocations-review-flow.mp4) - FAQ — Check-out final utilities handoff — Symptom table for final utility overage blocking refund
Same-day turnover coordination
Portfolio KPI review — Step 7 should scan Multicalendar turnover gaps on high-churn units — hub parity: Common Workflows — Same-day turnover coordination. Full pairing matrix: analytics-section-cross-reference · Module cross-reference.
- Common Workflows — Same-day turnover coordination — Hub matrix (
sales-multicalendar-tab.png,bookings-timeline-day-week-month-and-sidebar.mp4) - Portfolio KPI review — Same-day turnover coordination — Multicalendar turnover gaps on Step 7 sign-off
- Sales — Same-day turnover coordination — Channel-scoped overlap without rent cells
- Bookings — Same-day turnover coordination — Timeline Week scale overlap
- Operations — Same-day turnover coordination — Check-outs / Check-ins week lists
- Portfolio KPI review — Step 7 — Month-end turnover gap scan before rate cuts
- FAQ — Same-day turnovers — Four-step operator habit
- Glossary — Same-day turnover — Distinct from hold suppression
WhatsApp per-booking messaging
Month-end message backlog pairs with bell Inbox or Bookings → Communication during KPI review — clear New WhatsApp message from … alerts before unread cleanup. Hub parity: Glossary — WhatsApp per-booking messaging hub · Common Workflows — WhatsApp per-booking messaging. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Common Workflows — WhatsApp per-booking messaging — Hub matrix (
bookings-detail-communication-tab-whatsapp-thread.png,inbox-module-overview.png,inbox-module-triage-flow.mp4) - Glossary — WhatsApp per-booking messaging hub — Surface table + per-guide/module mesh reciprocal hub
- Dashboard — WhatsApp per-booking messaging — Bell Inbox sub-tab vs General on post-login scan
- Notifications — WhatsApp per-booking messaging — Canonical
/notificationsmessage alert rows - Bookings — WhatsApp per-booking messaging — Communication tab composer with Payment Plan context
- Inbox — WhatsApp per-booking messaging — Cross-booking triage and bell Inbox sub-tab
- Tenants — WhatsApp per-booking messaging — Tenant profile after Inbox name click
- Finance — WhatsApp per-booking messaging — Collections outreach with Transactions visible
- Operations — WhatsApp per-booking messaging — Maintenance ticket threads on Communication
- Listings — WhatsApp per-booking messaging — Go-live property tenant threads after channel import
- Utilities — WhatsApp per-booking messaging — Utility overage bill questions on Communication
- Sales — WhatsApp per-booking messaging — Channel-import message backlog during Multicalendar review
- AI Chat — WhatsApp per-booking messaging — Assistant-cited threads before operational follow-up
- Audit — WhatsApp per-booking messaging — Month-end communication review after Discounts audit
- Legacy
/propertiesURLs — WhatsApp per-booking messaging — Legacy bookmarks during message triage - Booking engine details — WhatsApp per-booking messaging — Engine-sourced tenant threads before payload sync
- Notification row-click navigation — Month-range KPI charts after row-click opens booking context
- Common Workflows — Notification row-click navigation —
New WhatsApp message from …on/notificationsvs bell Inbox - Notification triage — WhatsApp per-booking messaging — Message pings on bell Inbox /
/notifications - Handling a Late Payment — WhatsApp per-booking messaging — Collections outreach on Step 3
- Managing a Check-in — WhatsApp per-booking messaging — Arrival-week threads before Step 4
- Managing a Check-out — WhatsApp per-booking messaging — Departure settlement on Step 6
- Processing a New Booking — WhatsApp per-booking messaging — Confirmation follow-up on Step 6
- Cancelling a Booking — WhatsApp per-booking messaging — Void outreach before Step 4
- Entering Monthly Utility Bills — WhatsApp per-booking messaging — Overage bill questions on Step 4
- Portfolio KPI review — WhatsApp per-booking messaging — Month-end message backlog on Step 7
- Manual block hygiene — WhatsApp per-booking messaging — Blocked-date questions on Step 3
- Onboarding a New Property — WhatsApp per-booking messaging — First tenant threads on Step 7 go-live
- Using in-app support — WhatsApp per-booking messaging — Self-serve Inbox / Communication before filing
- Resetting a Management User Password — WhatsApp per-booking messaging — Lockout-delayed bell Inbox after Step 3
- FAQ — WhatsApp per-booking messaging hub — Month-end message backlog during KPI review symptom table
Bot reasoning (audit)
Month-end bot quality during KPI review. Hub parity: Glossary — Bot reasoning (audit) hub · Common Workflows — Bot reasoning (audit). Full pairing matrix: Analytics section cross-reference · Module 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
- Bookings — Bot reasoning (audit) — Canonical Communication Reasoning control
- ChatBot settings — Read-only audit vs editable persona / IF/THEN
ChatBot settings
Account Settings → ChatBot pairs with Communication thread review — month-end bot quality during kpi review. Hub parity: Glossary — ChatBot settings hub · Common Workflows — ChatBot settings. Full pairing matrix: Analytics section cross-reference · Module 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
- ChatBot settings — Persona, IF/THEN rules, Status Bot pairing
- Glossary — Bot reasoning (audit) hub — Thread audit after rule changes
Rent reduction after invoicing
Month-end Overview / Revenue chart review may surface bookings where goodwill repricing hits the invoiced floor — open Bookings → Contract Info → Change monthly rent before KPI sign-off. Pair Bulk Hostkit invoicing when external relief surfaces Not issued credit note rows. Hub parity: Common Workflows — Rent reduction after invoicing. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Common Workflows — Rent reduction after invoicing — Hub matrix (
bookings-detail-change-monthly-rent-modal.png,bookings-rent-reduction-invoiced-floor-flow.mp4) - Bookings — Changing contract dates and rent — Contract Info repricing entry point
- Bookings — Contract Values tab — Per-line Edit amount under the same floor
- Finance — Invoiced floor and rent edits — Why edits start on the booking, not Finance → Transactions
- Layout and controls — KPI load failures vs repricing on live bookings
- Processing a New Booking — Rent reduction after invoicing — Confirmation month already invoiced on Step 3
- Handling a Late Payment — Rent reduction after invoicing — Collections goodwill after Step 4
- Portfolio KPI review — Rent reduction after invoicing — Month-end repricing sign-off on Step 7
- Cancelling a Booking — Rent reduction after invoicing — Settlement repricing during Step 2b
- Managing a Check-in — Rent reduction after invoicing — Pre-move-in goodwill
- Managing a Check-out — Rent reduction after invoicing — Departure-week goodwill adjustments
- Notification triage — Rent reduction after invoicing — Row-click to invoiced booking on Step 4
- Entering Monthly Utility Bills — Rent reduction after invoicing — Month-end bill cycle on Step 5
- Manual block hygiene — Rent reduction after invoicing — Hold cleanup on Step 5
- Using in-app support — Rent reduction after invoicing — Self-serve before filing tickets
- Resetting a Management User Password — Rent reduction after invoicing — Lockout-delayed repricing after Step 3
- FAQ — Rent reduction after invoicing hub — Month-end KPI review repricing blocked by invoiced floor symptom table
Occupancy KPI to block hygiene handoff
Occupancy tab dips without a rate change pair with hub Common Workflows — Occupancy KPI to block hygiene handoff before you lower rent in Sales → Pricing — stale manual holds suppress available nights. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Common Workflows — Occupancy KPI to block hygiene handoff — Hub matrix (
analytics-kpi-occupancy-tab.png,audit-manual-blocks-filter-scroll.mp4) - Portfolio KPI review — Step 3 — Month-range Ranking roll-up before Audit
- Manual block hygiene — Downstream hold cleanup
- Audit — Manual Blocks tab — Portfolio-wide block table
- Glossary — Manual unavailability (manual block) — Hold vocabulary
- Portfolio KPI review — Occupancy KPI to block hygiene handoff — Occupancy Ranking dip on Step 3 before rate cuts
- Manual block hygiene — Occupancy KPI to block hygiene handoff — Audit pass when KPIs stay suppressed after holds cleared (Step 5)
- Processing a New Booking — Occupancy KPI to block hygiene handoff — Timeline overlap from stale holds on Step 1
- Onboarding a New Property — Occupancy KPI to block hygiene handoff — Unexpected Multicalendar holds on Step 7 go-live pass
- FAQ — Occupancy KPI to block hygiene handoff hub — Symptom table for Occupancy dip without rate change
Partly collected security deposit
Deposit shortfalls pair with Finance — Deposits status summary cards and Bookings — Deposit tab. Hub parity: Common Workflows — Partly collected security deposit. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Common Workflows — Partly collected security deposit — Hub matrix when Paid on the deposit is above zero but below Amount
- 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
- Bookings — Deposit tab — Partially paid badge and remaining helper on a single reservation
- FAQ — Partly collected security deposit — Distinct from Partial Paid rent on Payment Plan
- Finance — Deposit lifecycle status cards — Deposit lifecycle status row (#2091)
- 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)
- Manual block hygiene — Partly collected security deposit — Partial paid card when debt KPIs stay high after holds cleared (Step 5)
- Resetting a Management User Password — Partly collected security deposit — Lockout-delayed deposit triage after Step 3
- Using in-app support — Partly collected security deposit — File Finance module tickets when partial filter or badge behaviour is wrong
- Entering Monthly Utility Bills — Directory list load failures — Utilities tab Retry on bill entry (Step 2)
- Handling a Late Payment — Directory list load failures — Receivables directory Retry on collections triage (Step 1)
- Managing a Check-in — Directory list load failures — Check-in & Check-out Retry on arrival-week planning (Step 1)
- Notification triage — Directory list load failures — /notifications Try again before alert row-click (Step 2)
- Resetting a Management User Password — Directory list load failures — Directory Retry after lockout catch-up (Step 3)
- Using in-app support — Directory list load failures — Support inbox Retry before filing tickets
Month-end invoicing (fixed date)
Month-end Overview / Revenue chart review (Portfolio KPI review — Step 7) pairs with fixed Invoice date before bulk Issue allocation on Finance → Transactions. Hub parity: Common Workflows — Month-end invoicing (fixed date). Full pairing matrix: Analytics section cross-reference · Module 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 — Account-wide toggle + Save
- Common Workflows — Bulk Hostkit invoicing — Issue allocation after fixed date is saved
- Layout and controls — KPI workspace after month-end batch completes
- Finance — Month-end invoicing with a fixed date — Bulk toolbar amber banner
- Processing a New Booking — Month-end invoicing (fixed date) — First-month bulk export after confirmation (Step 6b)
- Handling a Late Payment — Month-end invoicing (fixed date) — Collections batch during Step 6b
- Portfolio KPI review — Month-end invoicing (fixed date) — Step 7 sign-off mesh
- Notification triage — Month-end invoicing (fixed date) — Alert cleanup before bulk Issue allocation (Step 5)
- Entering Monthly Utility Bills — Month-end invoicing (fixed date) — Finish Missing data + overage Pending (Steps 4b–5)
- Manual block hygiene — Month-end invoicing (fixed date) — Clear stale holds before Issue allocation (Step 5)
- Using in-app support — Month-end invoicing (fixed date) — Self-serve before filing wrong-date tickets
- Resetting a Management User Password — Month-end invoicing (fixed date) — Lockout-delayed month-end export after Step 3
- FAQ — Month-end invoicing (fixed date) hub — Month-end KPI review sign-off needing fixed Invoice date before bulk export symptom table
Bulk Hostkit invoicing
Month-end Overview / Revenue chart review (Portfolio KPI review — Step 7) pairs with Finance → Transactions bulk Issue allocation Hostkit pacing. Hub parity: Common Workflows — Bulk Hostkit invoicing. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Common Workflows — Bulk Hostkit invoicing — Hub matrix (
finance-transactions-bulk-selection-bar.png,settings-invoicing-hostkit-series.png) - Common Workflows — Month-end invoicing (fixed date) — Fixed Invoice date before bulk Issue allocation
- Settings > Invoicing — Hostkit invoice series — Required FR code before Issue allocation
- Finance — Invoice automation — Bulk Issue allocation / Invoice selected toolbar
- Finance — Issuing credit notes (integrated invoicing) — Issue credit notes (N) after invoiced Reject / Revert
- Layout and controls — KPI workspace after month-end batch completes
- Finance — Bulk Hostkit invoicing — Transactions toolbar reference
- Processing a New Booking — Bulk Hostkit invoicing — First-month Issue allocation after confirmation (Step 6b)
- Handling a Late Payment — Bulk Hostkit invoicing — Collections month-end mesh (Step 6b)
- Portfolio KPI review — Bulk Hostkit invoicing — Step 7 month-end sign-off
- Managing a Check-in — Bulk Hostkit invoicing — Move-in Pending mesh (Step 6b)
- Managing a Check-out — Bulk Hostkit invoicing — Departure-week mesh (Step 6b)
- Onboarding a New Property — Bulk Hostkit invoicing — First month-end on new inventory
- Cancelling a Booking — Bulk Hostkit invoicing — Settlement bulk export (Step 6b)
- Notification triage — Bulk Hostkit invoicing — Alert cleanup before bulk export (Step 5)
- Entering Monthly Utility Bills — Bulk Hostkit invoicing — Finish Missing data + overage Pending (Steps 4b–5)
- Manual block hygiene — Bulk Hostkit invoicing — Clear stale holds before Issue allocation (Step 5)
- Using in-app support — Bulk Hostkit invoicing — Self-serve Hostkit pacing before filing tickets
- Resetting a Management User Password — Bulk Hostkit invoicing — Lockout-delayed month-end export after Step 3
- FAQ — Bulk Hostkit invoicing slow — Hostkit HTTP 429 pacing and refresh-before-reissue habit
- FAQ — Bulk Hostkit invoicing hub — Month-end KPI review sign-off when bulk Issue allocation stays Pending symptom table
Directory list load failures
When /analytics shows We couldn't load your portfolio KPIs + Try again, that is a first-fetch workspace failure — not blank charts that imply zero performance. Pair Layout and controls load-failure copy with Dashboard same-day snapshot while you Retry. Hub parity: Common Workflows — Directory list load failures. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Common Workflows — Directory list load failures — Hub matrix (
analytics-kpi-load-failure.png,dashboard-partial-data-load-failure.png) - Layout and controls — Red inline alert + Try again on cold visit
- Dashboard module — Same-day snapshot when Analytics KPI workspace fails
- Portfolio KPI review — Directory list load failures — Month-end sign-off when Analytics / Dashboard lists fail (Step 7)
- Portfolio KPI review — Step 2 — Month-range charts after workspace loads
- Handling a Late Payment — Directory list load failures — Receivables triage when debt KPIs spike during KPI review
- FAQ — Directory list load failures — Whole-module vs slow success (spinner then charts)
- FAQ — Directory list load failures hub — Portfolio KPI workspace Try again vs empty date range symptom table
- Glossary — Directory list load failures hub — Surface table + per-guide/module mesh reciprocal hub
Portfolio segmentation by tenant category
Segment filters pair with Settings > Tenant categories and Portfolio KPI review — Step 6. Hub parity: Common Workflows — Portfolio segmentation by tenant category. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Common Workflows — Portfolio segmentation by tenant category — Hub matrix when weak metrics look tied to one tenant segment
- Finance — Tenant category filter — Ledger segmentation during month-end review
- Bookings — Other filters — Tenant category on reservation counts behind occupancy charts
- Tenants — Tenant category filter — Profile-count cross-check before segment-wide KPI conclusions
- Settings > Tenant categories — Define segments and portal gates
- Portfolio KPI review — Step 6 — Optional month-end segment pass on weak Analytics metrics
Key glossary terms
Glossary rows pair with Glossary cluster cross-reference. Full pairing matrix: Analytics section cross-reference · Module 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 — Finance tenant category filter parity — Finance Other filters drawer lists segments on cached bookings only; mirror Bookings / Tenants when a segment is missing
-
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
-
Credit note (payment reject/revert) — Finance reconciliation when KPI review finds duplicate or invoiced receipts
-
Invoiced floor (rent) — Mid-month repricing blocked below exported rent during KPI-driven rate reviews
-
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
-
Deposit dispute — Check-out retention trends visible in occupancy and revenue follow-up
-
Draft ticket (display status) — Maintenance volume on the Maintenance tab may include far-future Draft jobs
-
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 — 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
-
FAQ — Dashboard Total Debt subtitle — Post-login Total Debt card headline vs >15 days subtitle; ongoing bookings only
-
FAQ — Lower rent below invoiced — Change monthly rent clamps and Contract Values → Edit amount blocks net below exported invoice totals; use credit notes in accounting when you truly need a reduction
-
FAQ — Reject or revert an incoming payment — Reject pending rows or Revert confirmed ones; Finance → Transactions uses Reject selected bulk-only; modals warn about credit notes when Finance already invoiced
-
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
-
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 — 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 -
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 — Bookings that owe money — Top debtors and overdue buckets on Finance → Overview; Total Debt KPI is not a table
-
FAQ — Fixed rent on variable unit — Variable listing + equal rent every contract month → booking stores fixed headline Monthly rent; payment plan unchanged
API & companion guides
API bullets pair with API Reference hub. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- API Reference — Listings & Availability — Partner partial pulls to reconcile with Occupancy and RevPAR charts during month-end review
- API Reference hub — Partial vs full feed depth when channel sync disagrees with KPI trends
Module documentation hubs
Module hub bullets pair with Modules — Module cross-reference. Full pairing matrix: Analytics section cross-reference · Module cross-reference.
- Analytics module — Hub for month-range portfolio KPI workspace with tabbed charts, rankings, and heatmaps (this page)
- Dashboard module — Post-login Today, Total debt, Vacant Units, and forecast KPI snapshot with bell notification triage (hub)
- Listings module — Property wizard, Channels tab, Archived inventory, and unit management (hub)
- Finance module — Portfolio ledgers (Overview, Income, Contract Values, Transactions, Payouts, Deposits) with payment approval and deposit settlement (hub)
- Tenants module — Tenant directory, profile sidebars, With Debt segmentation, and table expand for linked bookings (hub)
- Sales module — Portfolio availability, monthly rent editing, and channel manager connections (hub)
- Operations module — Maintenance tickets, cash flows, check-in/out coordination, Draft ticket queues, and linked cash flows (hub)
- Utilities module — Bills Included ceiling model, Connections, AI bill upload, and tenant overage charges on payment plans (hub)
- Inbox module — Portfolio-wide WhatsApp workspace with Dashboard bell Inbox sub-tab deep links (hub)
- Notifications module — Full
/notificationshistory with search, filters, and row-click navigation (hub) - AI Chat module — Vivin-internal AI Assistant using Landlord MCP tools for portfolio Q&A (hub)
- Audit module — Portfolio-wide Manual Blocks and Discounts contract-value review (hub)
- Properties workspace — Legacy
/propertiesURL redirects into Listings (hub) - Booking engine details — Rich marketplace payload editor via the Full integration pill (hub)
- Account Settings — Workspace-wide financial policies, templates, integrations, and operational defaults (hub)
- API Reference hub — Partner HTTP contracts, Swagger onboarding, and partial vs full feeds (hub)