Skip to main content

Glossary

Finding your way in this guide

Skim Visual quick reference for illustrated terms, then jump via Letter-section index (A–Y) or Glossary deep-dive index for #### sub-entries (credit note, tenant category, invoiced floor, and more). Financial and booking vocabulary pairs with FAQ & Troubleshooting (FAQ subsection cross-reference); integrator terms with API Reference (API hub subsection index). Platform overview hubs: Introduction hub subsection index, Getting Started hub subsection index, Concepts hub subsection index, Modules hub subsection index, Common Workflows hub subsection index, Account Settings hub subsection index. First-time administrators configuring a workspace should pair unfamiliar terms with Getting Started — Recommended Setup Sequence (steps 1–12 tab map: Account Settings — Recommended setup order, then steps 13–15 in Listings, Bookings, and Tenants). Hub cross-links: Related → Navigation & bookmarks and the Glossary cluster cross-reference. Non-linear operator habits (Lockout catch-up, Pending manual receipt approval, Reject/revert mistaken receipts, Portfolio segmentation by tenant category, 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, Same-day turnover coordination, Bulk Hostkit invoicing, Month-end invoicing (fixed date), Rent reduction after invoicing, Occupancy KPI to block hygiene handoff, Utility overage collections, Check-out final utilities handoff, Check-out collections before refund, Cancellation collections before void, Wrong tenant on a booking, Cancel Booking vs Delete Booking, Portfolio retirement decisions, Provider platform Delete Booking guard, Archived booking ledger visibility, Check-out ledger cleanup before refund, New inventory to first booking handoff, Property setup to first arrival handoff, Confirmation to check-in handoff, Check-in to check-out handoff) have matching Related subsections below. Full pairing matrix: Glossary hub cross-reference.

Quick reference for key terms used throughout the Vivin Platform.

Visual quick reference

Pair with other glossary clusters

Illustrated terms here pair with the letter sections below and Glossary cluster cross-reference when you need related FAQ or module docs. Full hub map: the Finding your way tip at the top of this page.

Some terms are easier to recognise on screen than in prose. Use these committed captures when you are onboarding teammates or cross-checking terminology:

| Topic | What to look for | Illustration | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Management shell | Sidebar groups, + Create New, Dashboard KPIs | Getting Starteddashboard-overview-current.png | | Dashboard KPI cards | Top-left four-card grid on /: Listings (rentable count + property subtitle), Today (free rooms headline — recomputed live on each load so it matches Sales → Overview Today and Multicalendar → Available now; optional mid-term · short-term · manual blocks subtitle when buckets are non-zero), Total Debt (ongoing-booking underpayment + >15 days overdue subtitle; hover info icon for ongoing-booking rules), Monthly Revenue (portfolio rent sum + average per occupied unit). Pair with Occupancy Forecast and Vacant Units on the same page — not the seven-card Finance → Overview strip (Finance > KPI strip adds Uncovered Debt, Manual Payments, and all-booking Total Debt). | Dashboard > KPI cardsdashboard-kpi-listings-card.png, dashboard-kpi-today-card.png, dashboard-kpi-total-debt-tooltip.png, dashboard-kpi-monthly-revenue-card.png; Finance > KPI stripfinance-overview-kpi-cards.png; FAQ — Dashboard Total Debt subtitle; Portfolio KPI review — Step 7; Handling a Late Payment — Step 1; FAQ — Analytics vs Dashboard | | Occupancy Forecast (Dashboard) | Top-right chart on /: Past strip + Forecast segment on one axis; vertical today marker; 1M / 3M / 6M / 12M horizon buttons (forward calendar months); legend Total capacity + ADR (€) (average monthly rent among units counted occupied that day — not Analytics nightly ADR). Counts active (non-canceled) bookings using occupancy spans. | Dashboard > Occupancy Forecastdashboard-occupancy-forecast-chart.png; Glossary — ADR; Sales > Overview; Portfolio KPI review — Step 7; FAQ — Analytics vs Dashboard | | Cash Flow Forecast (Dashboard) | Bottom-left chart on /: expected monthly rent summed on each calendar day when rent is due for active bookings — Past (darker) vs Expected (lighter) bars around today; Forecast total in the card header; same 1M / 3M / 6M / 12M horizons as Occupancy Forecast. Not Operations — Cash Flows expenses and not Finance Overview cash flow (collections history). | Dashboard > Cash Flow Forecastdashboard-cash-flow-forecast-chart.png, dashboard-cash-flow-and-vacant-units-row.png; Handling a Late Payment; Portfolio KPI review — Step 7; FAQ — Analytics vs Dashboard | | Vacant Units (Dashboard) | Bottom-right panel on /: units free today (no active booking and no manual block unless Vacant Unit Preference is Include manual blocks); headline free count; scrollable list sorted by consecutive free days from today with relative vacancy bars; click a row → listing edit sidebar in place (listings-edit permission) or deep link /listings/unit/:listingId (view-only). Pair with Today KPI when blocks suppress counts. | Dashboard > Vacant Unitsdashboard-vacant-units-listing-sidebar.png, dashboard-cash-flow-and-vacant-units-row.png; Glossary — Vacant Unit Preference; Manual block hygiene; Portfolio KPI review — Step 7; Sales > Overview | | ADR vs Analytics KPIs | Dashboard occupancy chart ADR (€) vs Analytics ADR tab (nights-based) | Analytics module, FAQ — Analytics, Visual quick reference — Occupancy Forecast (Dashboard) | | Bookings Timeline | Gantt rows per unit; Day / Week / Month; Only bookings toggle (on = booked axis only, excluding cancelled stays; off = vacant units + calendar blocks); initial full-chart skeleton until listing axis + bars settle; listing axis loads in 50-row chunks as you scroll vertically (bottom spinner while the next page is in flight); axis/bars first-fetch failure → Couldn't load the timeline bookings. + Retry (#2310). For portfolio-wide manual holds (filter, export, column sort), use Audit — not Timeline alone | Bookings > Timelinebookings-timeline-initial-skeleton.png, bookings-timeline-load-more-spinner.png, bookings-timeline-view.png, bookings-timeline-unavailability-blocks-visible.png, bookings-timeline-vacant-unit-rows.png; Timeline load failures; Manual block hygiene | | Sales Multicalendar (timeline) | Sales → Multicalendar (/sales/multicalendar): unit × time Gantt without rent cells; Day / Week / Month scale; same Sales toolbar filters as Pricing; click a booking bar to open booking detail from Sales | Sales > Multicalendarsales-multicalendar-timeline-view.png, sales-multicalendar-timeline-booking-click.mp4 | | Sales Pricing (rent grid) | Sales → Pricing (/sales/pricing): listing × month cells with rent and occupancy blocks behind; bulk Edit Price; legacy /sales/calendar redirects here | Sales > Pricingsales-pricing-tab-monthly-rent-grid.png | | Bot reasoning (audit) | On Bookings → Communication → WhatsApp, automated Bot bubbles can show a Reasoning control that expands Vivin’s internal explanation before the reply was sent (operators only; not on tenant or You bubbles) | Glossary — Bot reasoning (audit) hub, Bookings > Communication tabbookings-detail-communication-tab-bot-reasoning-expanded.png | | Bot Status (WhatsApp pairing) | Account Settings → ChatBot → Bot Status: UAZAPI connection badge (Connected / Disconnected / Awaiting scan / Not configured), Connect WhatsApp warning modal, QR pairing, and Refresh QR code when the business line drops | ChatBot settingssettings-chatbot-status-bot-connected.png, settings-chatbot-status-bot-qr-pairing.png | | Finance income status | Overview stacked Income chart (Paid / Scheduled / In debt); click a segment for a month-scoped payment-line drill-down; Debt Aging panel for booking-level receivables. Not Cash flow forecast (Finance Overview) (actual collections) and not Cash Flow Forecast (Dashboard) (rent due dates). | Finance > Income status drill-down, Debt Agingfinance-overview-income-chart-debt-aging.png, finance-overview-income-status-in-debt-modal.png, finance-overview-debt-aging-expanded-bucket.png, finance-overview-debt-aging-walkthrough-flow.mp4; Finance income status (Finance Overview); Portfolio KPI review — Step 7; Handling a Late Payment; FAQ — Income status & debt list | | Cash flow forecast (Finance Overview) | Stacked below Income on Finance → Overview: actual cash received per period (confirmed in-payments only — no scheduled or In debt amounts); Month / Day toggle on the chart header; click a bar → All payments drill-down modal for that period. Not Cash Flow Forecast (Dashboard) (rent due dates) and not Operations — Cash Flows. | Finance > Income chart and cash flow forecastfinance-overview-income-chart-debt-aging.png, finance-overview-cash-flow-day-view.png, finance-overview-cash-flow-all-payments-modal.png, finance-overview-cash-flow-drill-down-flow.mp4; Cash flow forecast (Finance Overview); Portfolio KPI review — Step 7; Handling a Late Payment | | Finance → booking highlight | Ring-highlighted row after Open booking from Contract Values or Transactions | Finance — Cross-navigationfinance-contract-values-booking-highlight-row.png, finance-transactions-booking-highlight-row.png | | Shared utility connection | Identical contract ID on multiple properties; Cost map amber Shared utility connections detected when selection is partial | Utilities > Connections, Cost map warning, Entering Monthly Utility Bills — Step 3 | | AI usage ledger | Append-only ai_usage rows (one per LLM call) with token counts and Vivin internal USD cost; account-scoped read API — landlord_chat (AI Assistant) and utility_bill_extraction (Utilities PDF reader); no management UI screen yet | FAQ — AI token usage, AI usage API, Automation & AI, AI Chat module, Portfolio KPI review — Step 7 | | AI / MCP settings | Account Settings → System → AI / MCP (/settings/mcp): Landlord MCP connection URL, API keys (IDE/custom clients), connector OAuth consent scope (Claude.ai, ChatGPT), account tool permissions, per-user overrides, permission audit trail, and assistant activity — same domain policy as in-app AI Chat and external HTTP /mcp clients; Vivin-internal rollout gate matches /ai-chat; edit requires account_settings.mcp | AI / MCP settings, Landlord MCP — Connector OAuth, AI Chat — Administrator configuration, FAQ — Claude/ChatGPT connector sign-in, FAQ — MCP API keys and tool permissions | | Bulk Hostkit invoicing | Month-end Issue allocation / Invoice selected on many Finance → Transactions rows — Vivin paces Hostkit per listing key and retries HTTP 429; same toolbar for Issue credit notes after invoiced floor rent relief or invoiced Reject / Revert cleanup | Glossary — Bulk Hostkit invoicing, Glossary — Bulk Hostkit invoicing hub, Common Workflows — Bulk Hostkit invoicing, FAQ — Bulk Hostkit invoicing hubfinance-transactions-bulk-selection-bar.png, finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png, settings-invoicing-hostkit-series.png | | Month-end invoicing (fixed date) | Save a fixed Invoice date under Settings → Invoicing before bulk Issue allocation / Invoice selected; turn Use today as invoice date back on after the batch — amber Fixed invoice date reminder on Finance → Transactions | Glossary — Month-end invoicing (fixed date), Glossary — Month-end invoicing (fixed date) hub, FAQ — Month-end invoicing (fixed date) hub, Fixed invoice date reminder hubsettings-invoicing-invoice-date-toggle.png, finance-transactions-fixed-invoice-date-banner.png, finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png | | Fixed invoice date reminder | Amber banner on Finance → Transactions (above search), in the bulk invoice toolbar when rows with pending/failed allocations are selected, and in transaction detail above allocations when a fixed date is saved | Glossary — Fixed invoice date reminder, Glossary — Fixed invoice date reminder hub, FAQ — Fixed invoice date reminder hub, Month-end invoicing (fixed date), Common Workflows — Bulk Hostkit invoicing, Invoicing — Default invoice datefinance-transactions-fixed-invoice-date-banner.png, finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png, finance-transaction-detail-fixed-invoice-date-banner.png | | Pending manual in-payment | Operator-recorded receipt (pending / processing) until Approve payments confirms it; triage on Finance → Transactions (Pending pill) or Bookings → Transactions — the Overview Manual Payments KPI includes pending rows in the monthly total and opens a month drill-down of all manual rails — it is not an approval queue; /notifications Pending manual in-payment rows persist until ledger approval; until approval, Total Debt and In debt lines may not reflect the receipt; ledger Reject is bulk-only (Reject selected); Reject / Revert modals warn about credit notes when charges were already invoiced | Common Workflows — Pending manual receipt approval, Pending manual in-payment (Finance), FAQ — Manual receipt still pending, FAQ — Pending manual in-payment on /notifications, Finance — Pending manual payments, Notification triage — Step 4finance-transactions-pending-pill.png, finance-transactions-pending-approve-flow.mp4, bookings-detail-transactions-approve-payment-modal.png, notifications-row-navigate-to-booking-detail.png | | Credit note warning (reject/revert) | Red banner on Reject Payment and blue info on Revert payment when Finance may already have invoiced the charge — clear the Not issued credit note queue on Finance → Transactions; Hostkit bulk Issue credit notes paces like Issue allocation | Glossary — Credit note warning (reject/revert)bookings-detail-transactions-reject-modal-credit-note-banner.png, bookings-detail-transactions-revert-modal-info-banner.png, finance-transactions-bulk-reject-selected-bar.png, bookings-payment-row-actions-flow.mp4; FAQ — Credit note warning (reject/revert) hub | | Finance Debt Aging | Overview right panel: overdue buckets (0–15 d+60 d), expandable tenant · unit rows per band, and Top debtors ranked list — click to open booking sidebar. Pair with Uncovered Debt KPI and In debt on the Income chart — not payment-line drill-down alone. | FAQ — Bookings that owe money, Common Workflows — Finance debt receivables triage, Finance > Debt Aging panelfinance-overview-income-chart-debt-aging.png, finance-overview-debt-aging-expanded-bucket.png, finance-overview-debt-aging-walkthrough-flow.mp4; Finance Debt Aging (Finance Overview); Handling a Late Payment — Step 1 | | Uncovered Debt | Finance Overview all-time KPI beside Total Debt: tenant underpayment not offset by held security deposits — highlights receivables where deposit coverage is insufficient. Not the Dashboard Total Debt card (ongoing bookings only). | Glossary — Uncovered Debt hub, FAQ — Uncovered Debt KPI hub, Common Workflows — Uncovered Debt KPI, Finance > KPI stripfinance-overview-kpi-cards.png, finance-overview-debt-aging-expanded-bucket.png; Glossary — Uncovered Debt; Finance Debt Aging (Finance Overview); Handling a Late Payment; Portfolio KPI review — Step 7 | | Payout destination IBAN | Finance → Payouts table column showing the outbound bank account; Search also matches tenant names on grouped in-payments; recipient name lives in Payout details sidebar | Finance > Payoutsfinance-payouts-list.png | | Booking defaults (times & prep) | Preferences card with check-in/out and Mid-term / Short-term Prep | Preferences | | Notifications (compact vs full) | Dashboard header bell slide-over (General / Inbox sub-tabs; Inbox rows coalesced per conversation with New WhatsApp message from … / New email from … summaries) vs /notifications mixed history | Notifications modulenotifications-dashboard-bell-slideover-open.png, notifications-dashboard-bell-inbox-tab.png | | Notification row navigation | On /notifications, row click marks unread then opens link, bookingId, tenantId, listingId, or propertyId (first match) — not on the Dashboard bell General rows without a deep link | Glossary — Notification row navigationnotifications-module-row-click-target.png, notifications-row-navigate-to-booking-detail.png, notifications-row-navigation-flow.mp4; Notification triage — Step 4 | | WhatsApp Inbox (global) | Portfolio-wide /inbox two-pane workspace — conversation list, thread, labels, reply composer; mirrors Bookings → Communication; greyed-out sidebar and bell Inbox sub-tab when isTenantChatBotEnabled is off | Inbox moduleinbox-module-overview.png, inbox-thread-labels-pause-bot.png, inbox-sidebar-chatbot-disabled.png, notifications-dashboard-bell-inbox-chatbot-disabled.png | | Large directories (scroll to load) | Skeleton placeholders during search/filter refetch or at the bottom while the next batch fetches; End of list when done | Listings, Tenants | | Tenants table expand | Table view: click the row chevron for an inline booking sub-table (Unit, Rent, Balance, …); tenant name opens the profile sidebar; a sub-row opens the booking sidebar in place — pair with With Debt or fiscal-ID Search for collections triage | Tenants — Table viewtenants-table-row-expanded-bookings.png, tenants-table-expand-flow.mp4; Handling a Late Payment — Step 1 | | Directory search ranking | Toolbar Search on large directories: Bookings and Operations (Tickets, Check-in & Check-out, Cash Flows) rank unit / room hits first; Operations → Tickets also gives property internal name the same top tier (#2089) and floats property-level rows first under an active Property filter; Listings stays A–Z; Tenants matches fiscal ID / identification ID without re-ranking; property-level ticket rows show building name only (no unit suffix) | Glossary — Directory search ranking, Bookings searchbookings-list-search-unit-rank.png, Operations Ticketsoperations-tickets-search-unit-rank.png, operations-tickets-search-property-level.png, Check-in & Check-outoperations-check-in-out-search-unit-rank.png, Cash Flowsoperations-cashflows-search-unit-rank.png, Tenants fiscal IDtenants-directory-fiscal-id-search.png | | End-of-Booking cost split | When Charge Time is End of Booking, daily utility overage divides across every occupied unit that day — including stays whose checkout is still in the future — but charges post only after each booking ends (#2111) | Glossary — End-of-Booking cost split, Settings — Charge Time, Utilities — Smart Cost Distribution | | Utility overage collections | Unpaid utility overage on booking Payment Plan after supplier bill posting — triage on Utilities → Allocations, then collect via Handling a Late Payment Steps 1–4 (distinct from departure-week Check-out final utilities handoff) | Glossary — Utility overage collections, Glossary — Utility overage collections hub, Common Workflows — Utility overage collections, FAQ — Utility overage collections hubutilities-allocations-row-breakdown-expanded.png, finance-contract-values-in-debt-filter.png, utilities-allocations-review-flow.mp4 | | Check-out final utilities handoff | Final supplier bills + utility overage on booking Payment Plan before Ready To RefundEntering Monthly Utility Bills — Steps 2–4 then Managing a Check-out — Step 6 (distinct from mid-stay Utility overage collections) | Glossary — Check-out final utilities handoff, Glossary — Check-out final utilities handoff hub, Common Workflows — Check-out final utilities handoff, FAQ — Check-out final utilities handoff hubbookings-detail-payment-plan-tab-schedule.png, utilities-bills-tab-missing-toggle.png, utilities-allocations-review-flow.mp4, bookings-detail-deposit-tab-ready-to-refund-toggle.png | | Check-out collections before refund | Rent/fee In Debt on booking Payment Plan blocks Ready To RefundHandling a Late Payment Steps 1–4 then Managing a Check-out — Step 6 (distinct from utility Check-out final utilities handoff) | Glossary — Check-out collections before refund, Glossary — Check-out collections before refund hub, Common Workflows — Check-out collections before refund, FAQ — Check-out collections before refund hubworkflows-check-out-coordination-flow.mp4, bookings-detail-payment-plan-tab-schedule.png, finance-contract-values-in-debt-filter.png, bookings-detail-deposit-tab-ready-to-refund-toggle.png | | Check-out ledger cleanup before refund | Tenant paid once but duplicate transfer leaves phantom In Debt before refund — Reject / Revert on booking Transactions before Ready To Refund (distinct from rent Check-out collections before refund) | Glossary — Check-out ledger cleanup before refund, Glossary — Check-out ledger cleanup before refund hub, Common Workflows — Check-out ledger cleanup before refund, FAQ — Check-out ledger cleanup before refund hubbookings-detail-transactions-revert-modal-info-banner.png, finance-transactions-bulk-reject-selected-bar.png, bookings-detail-deposit-tab-ready-to-refund-toggle.png, bookings-payment-row-actions-flow.mp4 | | Cancellation collections before void | Pre-cancel rent/fee In Debt on Payment Plan blocks Cancel booking until settlement — Cancelling a Booking — Step 2 then Step 4 (distinct from departure-week Check-out collections before refund) | Glossary — Cancellation collections before void, Glossary — Cancellation collections before void hub, Common Workflows — Cancellation collections before void, FAQ — Cancellation collections before void hubfinance-contract-values-in-debt-filter.png, bookings-detail-payment-plan-tab-schedule.png, bookings-cancel-booking-modal-refund-types.png, workflows-cancel-booking-refund-modal-flow.mp4 | | Portfolio filter catalog | Account-wide distinct values for Other filters multi-selects (owners, tags, properties, listing types) — not recomputed from only loaded table rows; on Bookings default Unit Name sort, Select owners can look empty until you change sort once (Created / Creation Date) | Glossary — Portfolio filter catalog, Bookings — Select ownersbookings-list-other-filters-select-owners-empty.png, bookings-list-other-filters-select-owners.png; Listings toolbarlistings-portfolio-tags-types-toolbar.png; Finance — Select ownersfinance-other-filters-owner-scoped-property-picker.png | | Lease purpose (booking) | Optional classification on bookings when enabled under Settings → Categories → Lease purpose — searchable dropdown on Add booking and Contract Info; required on tenant Review when Make Lease Purpose mandatory is on | Bookings — Lease purposebookings-detail-contract-info-lease-purpose-readonly.png, bookings-add-booking-lease-purpose-dropdown.png; Categories — Lease purposesettings-categories-lease-purpose-section.png | | Effective contract (template resolution) | Listings property/unit Contract card shows which PDF template applies (unit → property → account fallback) before Vivin generates tenant contracts | Listings — Contract tablistings-property-effective-contract-card.png, listings-unit-effective-contract-inherited.png; Glossary — Effective contract | | Property edit sidebar pills | Property and unit edit sidebars use Setup / Full integration / Photos pills — operational fields, marketplace payload, and gallery; amber dot on Full integration signals missing partner fields (#2082) | Glossary — Property edit sidebar pills, Listings — Editing Propertieslistings-property-edit-sidebar-pills-setup-full-integration-photos.png, listings-unit-sidebar-pills-setup-full-integration-photos.png, listings-property-edit-photos-reorder-cover.png | | Finance tenant category cache refresh | Saving a new Category on Tenants → Tenant Info back-syncs booking.tenantCategoryId and force-refreshes Finance caches — Contract Values, Overview, and Deposits filters reflect the segment within seconds instead of waiting for the ~30-minute cron (#2088) | Glossary — Finance tenant category cache refresh, Finance — Tenant category filter, Tenants — Tenant Info | | SIMAR water contract ID | SIMAR (Loures e Odivelas) water bills use Cód. Local / Código de Local in Connections — not Nº de Contador; leading zeros stripped (#2110) | FAQ — SIMAR water bill property match, Glossary — SIMAR water contract ID, Utilities — Connections, Listings — Step 2 Utility Bills ID | | Per-booking maintenance ticket opt-out | On Add booking, turn off Use unit contract rents and other contract details to reveal Create check-in ticket / Create check-out ticket when the property has auto-create enabled — uncheck to skip automatic tickets for this reservation only (#1140) | Glossary — Per-booking maintenance ticket opt-out, Bookings — Creating a New Bookingbookings-add-booking-maintenance-ticket-opt-out.png, Listings — Maintenances tab | | Change history | In-sidebar entityChangeLogEntries on Listings property/unit setup and Bookings Changelogoperator-initiated field edits and milestones only; create-time defaults excluded (#2093) | FAQ — Booking Changelog scope, Glossary — Change history, Listings — Change history, Bookings — Timeline (booking change log) | | Provider platform Delete Booking guard | Integration bookings with a pending provider platform in-payment cannot be soft-archived until the row is Rejected or assigned (#2076) | Glossary — Provider platform Delete Booking guard hub, Provider platform Delete Booking guard, Bookings — Provider platform paymentbookings-detail-provider-platform-payment-field.png, bookings-detail-delete-booking-provider-platform-error-toast.png, bookings-provider-platform-reject-delete-flow.mp4; FAQ — Delete Booking on integration reservation | | Cancel Booking vs Delete Booking | Cancel booking for real voids (policy settlement, Canceled filter, full ledger); Delete Booking soft-archives mistaken/test rows (drops from default lists; Manual Transactions hidden on Finance → Transactions; System Transactions (vIBAN, credit card) stay — #1897). Clear provider platform in-payment before Delete (#2076) | Check-out vs cancellation | Common Workflows — Check-out vs cancellation, Managing a Check-out — Step 7, Cancelling a Booking — Step 4, Cancel Booking vs Delete Booking, Cancellation collections before void, Check-out collections before refund, FAQ — Check-out vs cancellation (workflows-cancel-booking-refund-modal-flow.mp4, bookings-cancel-booking-modal-refund-types.png, bookings-list-canceled-tab.png, bookings-detail-deposit-tab-ready-to-refund-toggle.png) | | FAQ — Cancel Booking vs Delete Booking, Cancelling a Booking, Bookings — Delete Booking (soft archive), FAQ — Portfolio retirement decisionsbookings-cancel-booking-modal-refund-types.png, bookings-list-canceled-tab.png, workflows-cancel-booking-refund-modal-flow.mp4, finance-transactions-type-summary-cards.png | | Portfolio retirement decisions | Building Archive vs reservation Cancel vs Delete Booking — three scopes with different list visibility and ledger outcomes | Glossary — Portfolio retirement decisions hub, FAQ — Portfolio retirement decisions, Cancel vs Delete, Archive a propertylistings-archived-populated-table.png, listings-archived-unarchive-sidebar.png, bookings-cancel-booking-modal-refund-types.png, finance-transactions-type-summary-cards.png | | Archived property | Archive in the property edit sidebar moves a building to Listings → Archived (/listings/archived); hidden from default pickers; bookings and finance history remain — Unarchive restores to Portfolio | Glossary — Archive property (building-level) hub, Glossary — Archived property, Listings — Archived propertieslistings-archived-populated-table.png, listings-archived-unarchive-sidebar.png, FAQ — Archive a property | | Archived booking ledger | After Delete Booking, Finance → Transactions hides manual/provider_platform rows for that reservation; vIBAN and credit card automated captures stay visible (#1897) | Glossary — Archived booking ledger visibility hub, Archived booking ledger visibility, Finance — Archived bookings on the ledger, Bookings — Delete Booking (soft archive), FAQ — Manual payments after Delete Bookingfinance-transactions-type-summary-cards.png | | Deposit lifecycle status | Payment-driven depositStatus on bookings (#781): Not PaidPartial PaidFully PaidReady to RefundRefunded, with optional Disputed freeze — lifecycle pill on booking Deposit tab; row chips on Finance → Deposits | Glossary — Deposit lifecycle status, Glossary — Deposit lifecycle status hub, FAQ — Deposit lifecycle status hub, Bookings — Deposit tab, Finance — Deposit lifecycle status cardsfinance-deposits-status-cards.png, bookings-detail-deposit-tab.png, bookings-detail-deposit-tab-ready-to-refund-toggle.png, finance-deposits-tab-mark-refunded-flow.mp4 | | Deposit dispute | Fully Paid deposit flagged while deductions are contested — Refund / Mark refunded frozen until Resolve Dispute; bookings.dispute + account toggle | Glossary — Deposit dispute, Glossary — Deposit dispute hub, Common Workflows — Managing a Check-out — Step 5, FAQ — Deposit dispute hubbookings-detail-deposit-tab-mark-disputed-button.png, bookings-detail-deposit-tab-disputed-state.png, finance-deposits-mark-disputed-row-action.png, finance-deposits-resolve-dispute-row-action.png, deposit-dispute-mark-and-resolve-flow.mp4 | | Finance Deposits date range | Default ~3 months window on Finance → Deposits; a row appears when check-in, check-out, or Refund Due Date intersects the range — clear or widen before triaging older move-outs, disputes, or export | Glossary — Finance Deposits date range, Glossary — Finance Deposits date range hub, FAQ — Deposit missing on Finance Deposits hub, Common Workflows — Deposit missing on Finance Depositsfinance-deposits-date-range-toolbar-default.png, finance-deposits-date-range-toolbar-cleared.png, finance-deposits-date-range-clear-flow.mp4 | | Audit Manual Blocks (column sort) | Tools → Audit table headers sort server-side across the full filtered set (default Created descending); click Unit, End, Nights, or Reason to reorder before export or row-open | Audit — Toolbar and filters, Manual block hygiene — Step 3audit-manual-blocks-column-sort-unit-asc.png | | Audit Manual Blocks (Created by) | Tools → Audit Created by multi-select limits the table, Blocked nights per month chart, and Export to blocks added by chosen property managers — pair with Date range after staff turnover | Audit — Toolbar and filters, Manual block hygiene — Step 2audit-manual-blocks-created-by-filter-open.png, audit-manual-blocks-created-by-filter-chip.png | | Finance Deposits lifecycle cards | Deposit lifecycle status row on Finance → Deposits (#2091): click Partial paid, Ready to refund, or other lifecycle cards; counts scope to the selected Timeline bucket — pairs with Other filters → Deposit status | Finance > Depositsfinance-deposits-status-cards.png, finance-deposits-lifecycle-partial-paid-card.png, bookings-detail-deposit-tab-partial-badge.png; walkthrough finance-deposits-partial-collection-walkthrough.mp4 (pre-#2091 UI — follow-up re-record) | | Invoiced floor (rent) | Change monthly rent clamps months below already-invoiced totals; Contract Values → Edit amount blocks net edits under the same floor — lowering invoiced rent uses Contract Values → Credit note then Issue credit notes on Finance (or Set manual when accounting handles the document outside Vivin) | Glossary — Invoiced floor (rent)bookings-detail-change-monthly-rent-modal.png, bookings-detail-contract-values-invoiced-floor-edit-amount.png, bookings-rent-reduction-invoiced-floor-flow.mp4; FAQ — Invoiced floor (rent) hub | | Rent reduction after invoicing | Change monthly rent / Contract Values → Edit amount blocked below exported rent — Contract Values → Credit note then Issue credit notes (N) on Finance → Transactions | Glossary — Rent reduction after invoicing, Glossary — Rent reduction after invoicing hub, Common Workflows — Rent reduction after invoicing, FAQ — Rent reduction after invoicing hubbookings-detail-change-monthly-rent-modal.png, bookings-detail-contract-values-invoiced-floor-edit-amount.png, bookings-rent-reduction-invoiced-floor-flow.mp4 | | Lifecycle check-in email | Settings → Emails → Booking lifecycle emails check-in trigger; auto-send on portal signing / move-in payment / cron; 15-day cutoff; paper upload does not trigger; Send / Resend on Contract Info | Emails — When lifecycle check-in emails send, FAQ — automatic check-in email, Bookings — Check-in & Check-out emails | | Hostkit listing keys | Account Settings → IntegrationsListing keys on the Hostkit card: server search, ~20-row infinite scroll (GET /listings/hostkit-keys), per-row Save without losing scroll position | Glossary — Hostkit hub, Integrations — Hostkit (invoicing), FAQ — Hostkit hub (settings-invoicing-hostkit-series.png) | | Payment adjustment (discount / return / impairment) | Line-level or booking-scoped changes on Contract Values; impairment loss on scheduled charges | Bookings > Discounts and payment adjustmentsbookings-detail-contract-values-line-discount-modal.png; Glossary — Return of value, Impairment loss | | Booking discount | Line-level or booking-scoped reduction on scheduled charges (paymentsPlan); Discounts tri-state filter on Bookings and Finance Other filters | Bookings > Discounts and payment adjustmentsbookings-detail-contract-values-line-discount-modal.png, bookings-detail-contract-values-apply-booking-discount-modal.png; Finance > Deposit refund readiness filters | | Operator payment received | Opt-in email + in-app row (Payment received from tenant …); per-PM audience on /notifications | Notifications module, Glossary — Payment notification (operator) | | Operator payment overdue | In-app Payments category row when a scheduled charge is overdue or a booking balance triggers an operator alert; row-click opens the related booking — continue on Handling a Late Payment | Notifications — Payment overdue alerts, Notification triage — Step 4, Glossary — Notification row navigationnotifications-module-row-click-target.png, notifications-row-navigate-to-booking-detail.png | | Short-term iCal horizon | Channel Manager date + Apply to all listings on Airbnb / Booking.com cards | Integrations — Short-term configurationsettings-integrations-short-term-ical-channel-manager.png | | Short-term iCal pseudo check-in/out | Operations → Check-in & Check-out rows imported from calendar-only feeds (not full API bookings) — often labelled Booking.com Reservation or the platform name | Operations — Check-in & Check-outoperations-check-in-out-other-filters-drawer-short-term.png, operations-check-in-out-check-outs-next-7-days.png; Managing a Check-in, Managing a Check-out | | Partial vs full listing feeds | Partial GET …/listings (calendar/pricing) vs full GET …/:landlordKey/listings/full (publish catalogue) | API Reference — Partial vs full, Full listing feeds | | Inbound integration webhooks | HA / Uniplaces POST …/webhook in Integration Swagger (not the in-app Notifications module) | Webhooks & Notifications | | Landlord vs Tenant MCP | Account-scoped operator tools vs booking-scoped tenant automation | Landlord MCP, Tenant MCP | | Booking engine payload | Full integration pill section cards | Booking engine details | | Booking comments (@mention) | Internal chat thread on a booking; @handle autocomplete, delete confirmation, and email alerts to tagged teammates | Bookings > Comments tabbookings-detail-comments-tab.png, bookings-detail-comments-mention-flow.mp4, bookings-detail-comments-delete-confirm.png | | Booking Communication tab | WhatsApp and email on the booking sidebar when tenant chatbot is enabled; WhatsApp / Email channel pills; Labels row, optional Pause bot toggle (when configured), Bot reasoning audit on automated replies, and WhatsApp composer on the WhatsApp filter; Refresh in the sidebar header toolbar; No messages yet per active channel (including when the other channel has history); expanded emails can list Attachments with preview/download — pair with global Inbox for cross-booking triage | Glossary — WhatsApp per-booking messaging hub, FAQ — WhatsApp and email per booking, Common Workflows — WhatsApp per-booking messaging, Inbox — Relationship to Bookings Communication, Bookings > Communication tabbookings-detail-communication-tab-whatsapp-thread.png, bookings-detail-communication-tab-bot-reasoning-expanded.png, bookings-detail-communication-tab-whatsapp-composer.png, bookings-detail-communication-tab-whatsapp-labels.png, bookings-detail-communication-tab-email-inbox.png, inbox-module-overview.png, inbox-module-triage-flow.mp4 | | Booking Tickets tab | Read-only maintenance ticket table on the booking sidebar when operations.module is granted; Source column (tenant portal, chatbot, team, check-in/out, recurring); Open Operations — Tickets header link (rows are not clickable); load-error Retry; empty No tickets yet state | Bookings > Tickets tabbookings-detail-tickets-tab.png | | Booking sidebar tab load failures | CommunicationCould not load messages + header Refresh; Tickets — red banner + Retry; other booking tabs stay usable — distinct from whole-module Directory list load failures | Glossary — Booking sidebar tab load failures hub, FAQ — Communication or Tickets load failure, Bookings > Sidebar tab load failures, Common Workflows — Booking sidebar tab load failuresbookings-detail-communication-tab-whatsapp-thread.png, bookings-detail-tickets-tab.png | | Directory list load failures | First-fetch failures on large directories — Failed to load … alert cards with Retry / Try again; distinct from zero-row filter matches and from booking-sidebar tab errors | Glossary — Directory list load failures hub, Glossary — Directory list load failures, FAQ — Directory list load failures hub, FAQ — Directory list load failuresdashboard-partial-data-load-failure.png, utilities-overview-load-failure.png, notifications-module-load-failure.png | | Management session (sign-in) | Silent refresh of the short-lived access token via an httpOnly refresh cookie; Logout in the sidebar user section revokes refresh server-side; Your session expired when refresh can no longer continue | Getting Started — Staying signed ingetting-started-sidebar-user-logout-section.png; FAQ — session expired | | Payment Plan schedule grid | One row per due date with Rent, conditional Cleaning / Admin / Exit columns (account toggle or non-zero booking amounts), always-visible Deposit and Others, and a Total that sums only visible columns while Deposit always counts | Bookings > Payment Planbookings-detail-payment-plan-tab-schedule.png | | Deposit refund (booking tab) | Initial Deposit badges; Current Adjustments / Current Deductions from payment-plan balance; Total to refund or Cash back to tenant; post-refund From security deposit / No bank transfer breakdown | Bookings > Deposit tabbookings-detail-deposit-tab.png, bookings-detail-deposit-tab-paid-badge.png | | Tenant Portal (tenant UI) | Signed-in home, Make payment paywall (amount + bank transfer / credit-card iframe), services catalogue, and request confirmation (plus invalid-link recovery) | Tenant Portaltenant-portal-home-overdue-balance-card.png, tenant-portal-paywall-amount-and-methods.png, tenant-portal-paywall-credit-card-checkout-iframe.png | | Ticket — linked cash flows | Cost allocation panel on a maintenance ticket: signed total from linked inflow/outflow rows; click a row to open the Cash flow detail sidebar without leaving the ticket | Operations — Linking cash flows to a ticketoperations-ticket-detail-cashflow-linked-rows.png, operations-ticket-cashflow-linking-flow.mp4 | | Draft ticket (display status) | Schedule date 30+ days ahead → Draft badge and Draft KPI card filter; underlying workflow status stays Unassigned / In progress until the date nears | Operations — Draft statusoperations-tickets-draft-badge-row.png, operations-ticket-draft-filter-flow.mp4 | | Same-day turnover | One unit with a check-out and a check-in on the same calendar day — plan cleaning tickets, access handover, and deposit timing together; use Operations → Check-in & Check-out, then Bookings → Timeline or Sales → Multicalendar for a Gantt overlap check on the unit row | Glossary — Same-day turnoveroperations-check-in-out-check-outs-next-7-days.png, bookings-timeline-view.png, sales-multicalendar-timeline-view.png; Managing a Check-in, Managing a Check-out |

Letter-section index

Pair with other glossary clusters

Jump to a letter when you already know the term — pair illustrated entries in Visual quick reference with Glossary cluster cross-reference for topic grouping. Deep-dive #### terms: Glossary deep-dive index. Full hub map: the Finding your way tip at the top of this page.

| Letter | Section | Pair with | | --------------------------------------------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | A | A | FAQ — Analytics, Analytics module, ADR | | B | B | FAQ — Bookings, Bookings module, Booking, Bulk Hostkit invoicing (Glossary — Bulk Hostkit invoicing hub, FAQ — Bulk Hostkit invoicing hub) | | C | C | FAQ — Settings & tenant communications, Credit note, Credit note warning (reject/revert) (FAQ — Credit note warning hub), Communication schedule, Cancellation collections before void (Glossary — Cancellation collections before void hub, FAQ — Cancellation collections before void hub), Check-out final utilities handoff (Glossary — Check-out final utilities handoff hub, FAQ — Check-out final utilities handoff hub), Check-out collections before refund (Glossary — Check-out collections before refund hub, FAQ — Check-out collections before refund hub) | | D | D | FAQ — Payments & Finance, Deposit lifecycle status (Glossary — Deposit lifecycle status hub, FAQ — Deposit lifecycle status hub), Deposit dispute (Glossary — Deposit dispute hub, FAQ — Deposit dispute hub), Partly collected security deposit (Glossary — Partly collected security deposit hub, FAQ — Partly collected security deposit hub), Draft ticket | | E | E | FAQ — Navigation & shortcuts, End of list, Export failures | | F | F | Finance module, Finance Deposits date range (Glossary — Finance Deposits date range hub, Glossary — Deposit missing on Finance Deposits hub, FAQ — Deposit missing on Finance Deposits hub), Invoiced floor (rent) (FAQ — Invoiced floor (rent) hub), Finance income status | | G | G | Getting Started, Glossary cluster cross-reference | | I | I | Integrations, Infinite scroll | | K | K | Dashboard KPI cards | | L | L | Listings module, Lease purpose | | M | M | Management session, Manual block hygiene, Month-end invoicing (fixed date) (Glossary — Month-end invoicing hub, FAQ — Month-end invoicing hub) | | N | N | Notification row navigation (FAQ — Notification row-click navigation hub), Notifications module, Notification triage | | O | O | Operations module, Operations — Same-day turnover FAQ | | P | P | Payment Allocation, Payment notification (operator) (FAQ — Payment notification (operator) hub, Common Workflows — Payment notification (operator)), Pending manual in-payment (FAQ — Pending manual receipt approval hub) | | R | R | RevPAR, Rent reduction after invoicing (Glossary — Rent reduction after invoicing hub, FAQ — Rent reduction after invoicing hub), Common Workflows — Reject/revert mistaken receipts, Check-out ledger cleanup before refund (Glossary — Check-out ledger cleanup before refund hub, FAQ — Check-out ledger cleanup before refund hub) | | S | S | Same-day turnover, Support | | T | T | Hostkit | Glossary — Hostkit hub, FAQ — Hostkit hub, Common Workflows — Bulk Hostkit invoicing, FAQ — Bulk Hostkit invoicing hub, FAQ — Bulk Hostkit invoicing slow, Integrations — Hostkit API pacing, Settings > Invoicing — Hostkit invoice series, Finance — Hostkit invoice links, Finance — Invoice automation (settings-invoicing-hostkit-series.png, finance-transactions-bulk-selection-bar.png) | | Tenant category, Tenant Portal | | U | U | Utilities module, Utility overage collections (Glossary — Utility overage collections hub, FAQ — Utility overage collections hub), Uncovered Debt (Glossary — Uncovered Debt hub, FAQ — Uncovered Debt KPI hub) | | V | V | Visit (direct booking), Vacant Units (Dashboard) | | W | W | Webhook, API Reference — Webhooks | | Y | Y | Yearly Average (daily contract rent) |

A

Pair with other glossary clusters

A covers access, analytics, audit, and allocation vocabulary — pair B (bookings), C (credit notes, contracts), and the Analytics KPIs row in Glossary cluster cross-reference with FAQ — Analytics.

Access Code A code (manual or Nuki-generated) that allows tenants to enter a property or unit. Configured in the Access Lockers tab during Onboarding a New Property — Step 4 and verified before Managing a Check-in — Step 4 — hub: Common Workflows — Property setup to first arrival handoff. Codes are automatically included in check-in emails and the Tenant Portal.

Admin Fee A one-time administrative charge added to a booking's payment schedule. Default amounts are configured during property creation or on the property Contract Information card (fixed or tiered). Operators can override the € amount on an existing booking on Contract Info → Booking information (Bookings module); setting €0 disables the fee on that reservation's payment plan.

ADR

The abbreviation is reused in two places with different definitions:

  • Dashboard — Occupancy Forecast — In the chart legend on the Dashboard, ADR (€) is the average monthly rent among units counted occupied on that day (not a nightly rate). Use it alongside Total capacity to compare pricing efficiency with occupancy.
  • Analytics (KPI workspace) — On the ADR tab at /analytics/adr, the product defines average daily rate as total revenue divided by occupied nights in the selected range (open the information icon next to the date range for the exact wording). That tab shares the same layout pattern as Revenue and RevPAR; see Analytics module.

Analytics (KPI workspace)

The Business > Analytics screen at /analytics (sidebar order: after Finance): portfolio KPI charts (Overview, Revenue, Occupancy, ADR, RevPAR, Maintenance) for a configurable date range. Access requires the Analytics module permission (analytics.module); it is a separate surface from Sales calendar and pricing tools. See the Analytics module; bookmarkable routes are listed in Deep Links — Analytics (KPI Dashboard).

Property edit sidebar pills

Property and unit edit sidebars in Listings use a pill row with three layers (#2082):

PillPurpose
SetupOperational fields — general info, tags, contract, payments, access, channels, calendar, change history, archive
Full integrationMarketplace and booking-engine payload — copy, amenities, partner platforms, readiness checks; opens the same editor as Property & listing details (booking engine)
PhotosProperty- or unit-level gallery; drag to reorder — first image is the cover

Bookmark Full integration directly with ?propertyDetails=1 or ?listingDetails=1 on Listings URLs — Deep Links — Booking engine details layer. The revamp removed the legacy header Go to details control; all three pills are visible to every operator with Listings edit access.

Finance tenant category cache refresh

Finance Tenant category filter results on Contract Values, Overview, and Deposits match against the denormalized booking.tenantCategoryId stored inside cron-warmed finance caches — not against live tenant profile reads on every request. When you change a tenant's Category on Tenants → Tenant Info (or assign category during + Create New → Tenant), Vivin immediately updates booking.tenantCategoryId on every linked reservation and force-refreshes the affected finance caches in the background (#2088). Filter results on Finance tabs typically catch up within seconds instead of waiting for the ~30-minute refresh cron.

This refresh fixes filter results after recategorization. It does not change the drawer option list — since #2314, Finance loads the full segment catalog from GET /tenant-categories regardless of cache contents. See FAQ — Finance tenant category filter parity. For month-end triage, use Finance — Tenant category filter directly — same habit as Portfolio KPI review — Step 6 and Common Workflows — Portfolio segmentation by tenant category. Pair with FAQ — Assign tenant category for direct booking when direct bookings still show Unassigned.

SIMAR water contract ID

Portuguese water operators use different identifiers on supplier PDFs. SIMAR (Loures e Odivelas) labels the supply location as Cód. Local or Código de Localnot the water meter number (Nº de Contador). Store that local code (without leading zeros) in the Water column on Utilities → Connections and in property setup Step 2: Utility Bills ID (#2110). Example: PDF shows Cód. Local: 0181474 → save 181474 in Connections.

The AI Invoice Reader extracts SIMAR water bills using the same rule and applies a post-extraction fixer when the model picks the meter number by mistake. If a SIMAR PDF still lands on the wrong property, compare the Cód. Local on the statement with your Connections grid before you escalate — see FAQ — SIMAR water bill property match. EPAL uses a similar Código de Local pattern; SIMAS and most other operators still use the meter number.

Per-booking maintenance ticket opt-out

Property-level rules on Listings — Maintenances tab auto-create Operations → Tickets rows for check-ins and check-outs. On Add booking, when you turn off Use unit contract rents and other contract details on the rent step, Vivin shows Maintenance tickets with Create check-in ticket and/or Create check-out ticket — only for event types enabled on the property (#1140). Both default checked (same as the property). Unchecking skips automatic ticket creation for this reservation only; later bookings still follow the property rule. When Use unit contract rents and other contract details stays on, Vivin applies today's property defaults with no per-booking override row. See Bookings — Creating a New Booking (bookings-add-booking-maintenance-ticket-opt-out.png) and FAQ — Skip automatic tickets for one booking.

Archived property

Full hub: Archive property (building-level) (surface/symptom tables, per-guide mesh, and listings-archived-populated-table.png, listings-archived-unarchive-sidebar.png).

A property removed from the active Portfolio tab in Listings via Archive in the property edit sidebar. Archived properties appear under /listings/archived (or legacy /properties/archived, which redirects there — see Legacy /properties URLs — Archived portfolio). Unarchive restores the property to portfolio pickers and the default Listings view without deleting bookings or financial history. Hub matrix: Common Workflows — Archive property (building-level). Pair Common Workflows — Cancel Booking vs Delete Booking for reservation-level void vs soft-archive — building Archive does not replace per-reservation Cancel / Delete. Step-by-step: FAQ — Archive a property (listings-archived-populated-table.png, listings-archived-unarchive-sidebar.png) and Listings — Archived properties. Three-way scope table: Portfolio retirement decisions.

Archived booking ledger visibility

Full hub: Archived booking ledger visibility (symptom table, System vs Manual Transactions buckets, per-guide mesh, and finance-transactions-type-summary-cards.png).

When you Delete Booking (soft-archive), the reservation leaves default Bookings lists but Finance → Transactions may still show some payment rows for that booking (#1897). vIBAN and credit card automated captures under System Transactions stay visible for bank/card reconciliation. Manual operator entries — transfer, cash, deposit refund, provider platform, and similar non-automated types under Manual Transactions — are hidden so test or mistaken stays do not clutter the portfolio ledger. Canceled bookings that are not archived keep every transaction type visible. Distinct from Archived property (building-level archive) and from Tools → Audit (manual availability blocks). When unsure whether to Cancel or Delete, start with FAQ — Cancel Booking vs Delete Booking and Common Workflows — Cancel Booking vs Delete Booking (bookings-cancel-booking-modal-refund-types.png, bookings-list-canceled-tab.png, workflows-cancel-booking-refund-modal-flow.mp4). Building sunsetting uses Archived property — not Delete Booking on every reservation: Portfolio retirement decisions. Per-guide mesh: Portfolio KPI review — Portfolio retirement decisions, Manual block hygiene — Portfolio retirement decisions, Cancelling a Booking — Portfolio retirement decisions, Managing a Check-out — Portfolio retirement decisions, Onboarding a New Property — Portfolio retirement decisions, Processing a New Booking — Portfolio retirement decisions, Entering Monthly Utility Bills — Portfolio retirement decisions, Handling a Late Payment — Portfolio retirement decisions, Managing a Check-in — Portfolio retirement decisions, Notification triage — Portfolio retirement decisions, Resetting a Management User Password — Portfolio retirement decisions, Using in-app support — Portfolio retirement decisions. Per-guide mesh (cancel vs delete): Manual block hygiene — Cancel Booking vs Delete Booking, Cancelling a Booking — Cancel Booking vs Delete Booking, Managing a Check-out — Cancel Booking vs Delete Booking, Onboarding a New Property — Cancel Booking vs Delete Booking, Processing a New Booking — Cancel Booking vs Delete Booking, Portfolio KPI review — Cancel Booking vs Delete Booking, Handling a Late Payment — Cancel Booking vs Delete Booking, Managing a Check-in — Cancel Booking vs Delete Booking, Entering Monthly Utility Bills — Cancel Booking vs Delete Booking, Notification triage — Cancel Booking vs Delete Booking, Resetting a Management User Password — Cancel Booking vs Delete Booking, Using in-app support — Cancel Booking vs Delete Booking. Operator walkthrough when rows vanish after soft-archive: FAQ — Manual payments after Delete Booking (finance-transactions-type-summary-cards.png). See Finance — Archived bookings on the ledger, Finance — Type summary cards, and Portfolio KPI review — Step 7.

Finance Transactions — type summary cards showing System vs Manual Transactions buckets on the ledger

AI Assistant (management) The operator-facing conversational assistant in Tools > AI Assistant (URL /ai-chat). Answers portfolio questions using your account data; Vivin internal access only. API failures show a red inline banner above the composer (for example Failed to send message. Please try again. after a send error — retype your question because the composer clears on submit). See AI Chat module.

AI Chatbot An intelligent chatbot that provides automated 24/7 tenant support via WhatsApp and email (not an in-portal chat in the Tenant Portal). Handles common enquiries about payments, contracts, maintenance, and move-in information, with intelligent routing to your team for complex issues. Account-level persona and IF/THEN rules are edited under Account Settings → Chatbot (/settings/chatbot). On each booking, Bookings → booking detail → Communication exposes WhatsApp (send replies, UAZAPI labels) and read-only email; ingested channel history loads when the integration is enabled on the account (isTenantChatBotEnabled). See Automation & AI and Bookings — Communication tab.

AI Invoice Reader An AI-powered tool that automatically reads utility bills, identifies the correct property, and extracts key data (provider, amount, consumption, billing dates) without manual input. See Utilities Module.

Allocation In Finance, matching an incoming payment to scheduled charges. See Payment Allocation. In Utilities, the product also uses “allocation” for utility cost shares proposed per booking before they become tenant charges — review and approve/reject those rows under Utilities > Allocations tab; that workflow is separate from payment allocation.

Audit The Tools → Audit workspace at /audit for reviewing manual availability blocks (operator holds on unit calendars — same underlying records as Add unavailability in Listings). Access requires the Listings module permission. The first tab is Manual Blocks, with guidance on spotting stale or vague blocks that can silently reduce occupancy; column headers sort server-side across the full filtered set (see Manual block hygiene). Full module documentation: Audit. Bookmarkable routes: Deep Links — Audit.

B

Pair with other glossary clusters

B booking and billing terms pair C (credit note, communication schedule), D (deposit dispute, draft ticket), and FAQ — Bookings.

Bills Included (Ceiling) The maximum utility cost per month that is absorbed into the tenant's rent. If the actual bill exceeds this ceiling, the tenant is charged the difference (overage). Configured during property creation Step 3.

Booking

A reservation linking a tenant to a unit for a specified period. Booking status follows the implemented lifecycle: upcoming -> current -> ended, with canceled available via cancellation.

Booking Engine (White Label) A fully branded booking interface that can be embedded on your website for commission-free direct bookings. Includes instant availability display, visits management, video calls, and conversion tracking. See Integrations & Distribution.

Booking engine details editor The management UI’s full-page Property Details / Listing Details layer, opened from Listings via the Full integration pill in the property or unit sidebar. It edits the marketplace and booking-engine payload (grouped tabs, bilingual fields where supported), separate from the standard Listings setup fields in the same sidebars. You can also open the same layer from a bookmark or shared link using the propertyDetails=1 or listingDetails=1 query flags on Listings URLs (see Deep Links — Booking engine details). See Property & listing details (booking engine).

Booking Tag

A classification label applied to a booking for filtering and reporting purposes. Configured in Settings > Categories > Bookings. The same vocabulary appears in the Select categories toolbar on Bookings (includes synthetic No category for empty bookingTags) and under Booking → Select categories in Finance → Other filters. Distinct from Listing tag (filter) on properties and units.

Bot reasoning (audit)

Full hub: Bot reasoning (audit) hub (thread Reasoning audit vs ChatBot persona / IF/THEN editing, symptom table, and per-guide/module mesh).

On Bookings → Communication → WhatsApp, when Vivin stored internal reasoning text with an automated Bot reply, the mint bubble shows a compact Reasoning control under the message body. Click it to expand the explanation the bot used before sending (italic text in parentheses). Tenant and operator (You) bubbles do not include this toggle. Use it to audit automated answers without server logs — then adjust rules under ChatBot settings. See Bookings — Communication tab (bookings-detail-communication-tab-bot-reasoning-expanded.png), FAQ — Bot reasoning (audit) hub, and Common Workflows — Bot reasoning (audit).

Brand Color The hex color code used as the primary accent color in the Tenant Portal and automated emails. Configured in Settings > General Information.

Bulk Hostkit invoicing

Full hub: Bulk Hostkit invoicing (month-end Issue allocation / Invoice selected Hostkit pacing, Issue credit notes cleanup, symptom table, and per-guide mesh).

When month-end Issue allocation or Invoice selected runs on many Finance → Transactions rows, Vivin paces Hostkit API calls per listing key and retries HTTP 429 with backoff — large batches can take several minutes even though the UI stays responsive. The same bulk toolbar pushes Issue credit notes (N) after invoiced floor rent relief or invoiced Reject / Revert cleanup. Pair Month-end invoicing (fixed date) when every document must share one posting date (finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png).

C

Pair with other glossary clusters

C contract and credit vocabulary pairs B (booking charges), D (deposit disputes), and the Financial & payments cluster in Glossary cluster cross-reference.

Calendar (Listings) The Calendar section at the top of a unit’s sidebar in the Listings module. It shows booked nights, external channel blocks, and manual unavailability on one timeline and list; use Add unavailability for operator holds (renovations, owner use). Booking dates and platform blocks are changed at their source, not by deleting those rows here.

Cash Flow Operational financial transactions not tied to a specific booking — for example, contractor invoices, supplies, or building repairs. Tracked in the Operations module. This is not the same object as the Cash Flow Forecast chart on the post-login Dashboard, which charts expected rent on due dates for active bookings.

Cash Flow Forecast (Dashboard) The bottom-left chart on the Dashboard: expected monthly rent summed on each calendar day when rent is due for active (non-canceled) bookings, with Past vs Expected styling around “today” and the same 1M / 3M / 6M / 12M horizon controls as Occupancy Forecast. Use it for near-term inflow timing from the rent schedule — not for recording operator expenses or non-booking cash lines (those live under Operations — Cash Flows). See the Cash Flow Forecast (Dashboard) row in Visual quick reference.

Finance income status (Finance Overview)

Hub matrix: Common Workflows — Finance Income status drill-down. The stacked Income chart on Finance → Overview: each month splits scheduled income into Paid, Scheduled, and In debt. Click a coloured segment (or a row in its hover tooltip) for a payment-line modal scoped to that month and status — use View booking on a line when you need the reservation sidebar. For booking-level receivables (ranked debtors, days overdue), use the Debt Aging panel (Top debtors or an overdue bucket) on the right — click a row to open the booking sidebar. Pair with FAQ — Finance Income status drill-down (screenshot walkthrough), FAQ — Bookings that owe money, Notification triage — Step 4 when payment alerts deep-link into a booking, Handling a Late Payment for collections triage, and Portfolio KPI review — Step 7 when Analytics revenue disagrees with Finance receivables. Distinct from Cash flow forecast (Finance Overview) (actual cash received) and Cash Flow Forecast (Dashboard) (rent due timing).

Finance Overview — stacked Income chart with Paid, Scheduled, and In debt segments beside Debt Aging panel

Finance Overview — In debt payment-line drill-down modal for a selected month

Cash flow forecast (Finance Overview)

Hub matrix: Common Workflows — Cash flow forecast drill-down. The chart on Finance → Overview below Income: actual cash received (confirmed in-payments only), aggregated by month or day via the Month / Day toggle on the chart header. Click a bar to open an All payments drill-down for that period. Pair with FAQ — Cash flow forecast drill-down (screenshot walkthrough), FAQ — Finance Income status drill-down (Paid / Scheduled / In debt segments vs collections history), Handling a Late Payment for collections triage, and Portfolio KPI review — Step 7 when Analytics revenue disagrees with confirmed cash. This is collections history — not rent due timing (Cash Flow Forecast (Dashboard) — see Visual quick reference) and not Operations — Cash Flows expenses.

Channel Manager Two related surfaces: Sales > Channel Manager for an operational grid of listings and their per-channel status (including per-row Copy iCal in the actions column, Export with a VIVIN iCal spreadsheet column for bulk outbound feed URLs, and Search units that also matches stored platform external ids such as Uniplaces or Airbnb listing keys — see sales-channel-manager-integration-id-search.png on the Sales page); and the Channel Manager block at the top of Account Settings > Integrations for account-wide Short-term iCal Max Date and bulk apply actions. Platform credentials, toggles, and optional Pricing Markup live on the Integrations page; use Sales when you are reconciling availability or links per listing.

Change history

An in-sidebar audit trail on property and unit setup editors in Listings (entityChangeLogEntries): human-readable log lines with timestamp and author for operator-initiated field edits (including formatted admin fee tier diffs when tiers change) — not every default populated at create time (#2093 stops untouched defaults and normalized fields from appearing as phantom edits in the booking Changelog too). It does not cover the Vivin-internal Property Details / Listing Details booking-engine layer — see Booking engine details. On bookings, the Changelog section inside Contract Info → Check-in & Check-out serves a similar role for milestone dates and booking field changes — when more than four events exist, View all (N) opens the full changelog modal with search. Three audit surfaces operators confuse: booking Changelog (reservation edits), Listings Change history (building/unit setup), and Tools → Audit (cross-portfolio manual blocks and discounts). Operator troubleshooting when create-time defaults seem “missing”: FAQ — Booking Changelog scope. See Bookings > Timeline (booking change log) and Manual block hygiene.

Property edit sidebar — Change history with recent field edits, timestamps, and author

Booking detail — Contract Info, Changelog View all modal with search and full event list

Check-in The event of a tenant physically moving into a unit. Managed through the Operations > Check-in & Check-out tab and the Managing a Check-in workflow.

Check-out The event of a tenant physically leaving a unit. Involves inspection and deposit handling; booking status then updates automatically based on dates. See the Managing a Check-out workflow.

Check-out final utilities handoff

Full hub: Check-out final utilities handoff (final supplier bills → Payment Plan overage → Ready To Refund, Pending receipt mesh, symptom table, and per-guide/module mesh).

Managing a Check-out Step 6 blocks deposit release until every charge — including final utility overages — is settled. Entering Monthly Utility Bills Steps 2–4 post landlord bills and tenant overage lines on Payment Plan before Step 5 — distinct from mid-stay Utility overage collections and rent Check-out collections before refund. Pair End-of-Booking cost split when Charge Time defers posting until checkout (utilities-allocations-review-flow.mp4).

Check-out collections before refund

Full hub: Check-out collections before refund (rent/fee Payment Plan arrears → collections → Ready To Refund, Pending receipt mesh, symptom table, and per-guide/module mesh).

Managing a Check-out Step 6 blocks deposit release until every scheduled charge is settled — including rent and fee arrears on Payment Plan. Handling a Late Payment Steps 1–4 collect departure-week rent/fee In Debt before Step 5 — distinct from utility Check-out final utilities handoff, duplicate Check-out ledger cleanup before refund, and pre-cancel Cancellation collections before void.

Check-out ledger cleanup before refund

Full hub: Check-out ledger cleanup before refund (duplicate departure transfers → Reject / Revert on TransactionsReady To Refund, Pending receipt mesh, symptom table, and per-guide/module mesh).

Managing a Check-out Step 6 and Step 6b can show In Debt or a wrong Est. Refund when the tenant paid correctly but the ledger holds duplicate departure transfers — not unpaid rent (Check-out collections before refund) or utility overages (Check-out final utilities handoff). Reject/revert mistaken receipts Reject / Revert clears phantom balances before Ready To Refund.

Cancellation collections before void

Full hub: Cancellation collections before void (pre-cancel rent/fee Payment Plan arrears → collections → Cancel booking, Pending receipt mesh, symptom table, and per-guide/module mesh).

Cancelling a Booking Step 2 blocks Cancel booking on Step 4 until every rent/fee line on Payment Plan is settled — including Upcoming and Ongoing stays voided under policy. Handling a Late Payment Steps 1–4 collect pre-cancel rent/fee In Debt before the refund-type dialog — distinct from departure-week Check-out collections before refund, duplicate Check-out ledger cleanup before refund, and utility Utility overage collections on Canceled stays.

Lifecycle check-in email

The default Check-in template under Account Settings → Emails → Booking lifecycle emails. Vivin evaluates your chosen check-in trigger when move-in payments post, when the tenant completes digital contract signing in the Tenant Portal (signedContractPath), or on daily cron for date-based triggers — then sends at most one automatic message per booking (checkInEmailSentAt). Uploading a signed PDF on Contract Info does not count as portal signing for this automation; use Send Check-in email on Contract Info → Check-in & Check-out after manual upload when move-in requirements are met — see Emails — Operator upload vs portal signing. Automatic send is skipped when check-in day is more than 15 days in the past or the booking is Canceled. Optional Only for Nuki access requires Nuki access points before send. When tenants never reach portal Sign, pair FAQ — Tenant contract signing blocked with Processing a New Booking — Step 4 — hub: Common Workflows — Confirmation to check-in handoff (do not start Managing a Check-in — Step 1 until contract + confirmation charges clear). Full trigger matrix: When lifecycle check-in emails send. Operator troubleshooting: FAQ — automatic check-in email.

Booking detail — Contract Info Check-in & Check-out card with Send and Resend check-in email actions

Cleaning Fee A charge for cleaning services, either recurring (Every Month — one line per contract month) or one-time (One-Time Fee at Booking Confirmation or One-Time Fee at Move-in). Default frequency is configured in the property's Payments tab (Contract Information section); individual bookings can override it on Contract Info.

Confirmation Payment The payment(s) a tenant must make to confirm their booking — typically a deposit, first rent, or both. Confirmation payments on Contract Info flag Layer 1 lines for booking confirmation with due date min(booking created, check-in date). Defaults are set during property creation Step 4; operators can override per booking without changing property defaults. See Payment allocation — Confirmation vs move-in due dates and Bookings — Confirmation payments and check-in payments.

Check-in Payment Charges due on the booking’s check-in date — configured as Check-in payments on Contract Info (move-in requirement). Common combinations include Deposit and last rent when confirmation already collected first rent. Same overlap rules as confirmation payments; see Payment allocation.

Communication Rules

Automated tenant message rules configured under Account Settings → Emails → Communication Rules (/settings/communications). Each rule defines a trigger (event, offset, send time, balance and audience filters), subject/body (with {VariableName} placeholders), and whether it is enabled. Audience can include Require Nuki tenant ID, Smart locks, Booking tags, and Tenant categories — the last three share No filter / Include only / Exclude modes (include = booking carries at least one selected value; exclude = none of the selected values). Row actions include Edit, Test, Send now / Schedule (when the role has communication.send_now — on an inactive Now rule, Send now opens a recipient preview with deliverable counts before you confirm and activate; on an active Now rule, play deactivates), and enable/disable. See Emails.

Communication schedule

The All schedules modal opened from the calendar icon on the Communication Rules toolbar (or from a single rule’s View sent/scheduled messages control). Lists queued and sent messages with recipient, subject, status, and scheduled/sent timestamps; supports search and Export (CSV/Excel). Clicking a row opens the related booking in the Booking detail sidebar. See Communication schedule (calendar).

Contract Date The date a rental agreement legally begins, used for payment scheduling. May differ from the Occupancy Date (move-in date). See Getting Started > Dates.

Contract Value A single scheduled charge in a booking's payment plan — the "expected" side of the financial picture. See Payment Allocation.

Effective contract

The contract template Vivin uses when generating a tenant PDF for a given unit or property. Resolution follows a fallback chain: unit template (when uploaded on the unit) → property templateaccount default. The effective contract card on Listings property and unit editors shows the resolved source and lets operators preview the PDF before bookings inherit it. Changing templates on a property does not retroactively replace PDFs already generated on active bookings.

Mandatory for contract signing

Account-level toggles under Account Settings → Preferences → Tenant Portal that require specific Your Details fields in the Tenant Portal before digital contract signature (name, phone, nationality, identification and fiscal data, IBAN, and ID metadata). Each enabled toggle is enforced in the portal UI and server-side on sign — tenants cannot bypass a gate by calling the sign API directly. Defaults are Off for every field. Configure: Preferences — Mandatory fields before contract signing. Tenants see asterisk labels on the Your Details step of the Digital contract signing wizard. Operator troubleshooting when Sign contract is blocked: FAQ — Tenant contract signing blocked (settings-preferences-tenant-portal-contract-signing-required.png).

Account Settings — Preferences, Mandatory for contract signing toggles on the Tenant Portal card

Coliving / flex living

Pair with other glossary clusters

Operating models where multiple unrelated tenants share a property or building with shared spaces and services (coliving) or where stay length and channel mix vary across mid-term and short-term demand (flex living). Vivin’s product language and workflows assume multi-unit portfolios, turnover, and channel distribution — see Getting Started and Integrations & Distribution.

Create New The + Create New control in the left sidebar (shown from medium-width layouts upward) opens a slide-out of quick-create actions: People, Listings, Reservations, Operations, Payments, plus Tools (utility bill upload) for Vivin @vivin.app accounts. See the Create New Menu reference.

Cost Allocation A category assigned to a cash flow entry for expense reporting. Configured in Settings > Categories > Cashflows and applied when you create or edit rows on the Operations > Cash Flows tab. On a maintenance Ticket, the Cost allocation sidebar panel also classifies who bears repair cost (Owner, Tenant, Internal) and can link existing cash flows so the ticket’s signed total reflects linked ledger lines.

Credit note warning (reject/revert)

Full hub: Credit note warning (reject/revert) (modal banner surfaces, Not issued credit note queue symptom table, and per-guide mesh).

Red banner on Reject Payment and blue info on Revert payment when Finance may already have invoiced the charge — the in-product cue to clear the Not issued credit note queue on Finance → Transactions. Accounting vocabulary: Credit note (payment reject/revert).

Credit note (payment reject/revert)

Modal banners and queue triage: Credit note warning (reject/revert). Full hub: Reject/revert mistaken receipts hub · Credit note warning (reject/revert) hub. Hub matrix: Common Workflows — Reject/revert mistaken receipts. Per-guide mesh: Processing a New Booking — Reject/revert mistaken receipts, Handling a Late Payment — Reject/revert mistaken receipts, Cancelling a Booking — Reject/revert mistaken receipts, Managing a Check-in — Reject/revert mistaken receipts, Portfolio KPI review — Reject/revert mistaken receipts, Managing a Check-out — Reject/revert mistaken receipts, Entering Monthly Utility Bills — Reject/revert mistaken receipts, Notification triage — Reject/revert mistaken receipts, Manual block hygiene — Reject/revert mistaken receipts, Onboarding a New Property — Reject/revert mistaken receipts, Using in-app support — Reject/revert mistaken receipts, Resetting a Management User Password — Reject/revert mistaken receipts. Pair Common Workflows — Finance debt receivables triage when Total Debt / Top debtors look high until approved duplicates are Reverted (finance-overview-income-chart-debt-aging.png). Pair Common Workflows — Bulk Hostkit invoicing when Issue credit notes (N) on Hostkit accounts paces like Issue allocation. Pair Rent reduction after invoicing when invoiced floor blocks in-product rent cuts — external credit notes follow the same accounting path as reject/revert on invoiced receipts.

Accounting follow-up copy Vivin shows when you reject or revert an in-payment that may already be invoiced through your integration (for example Invoice-xpress). Reject payment (on pending rows on booking Transactions, or Reject selected on Finance → Transactions) opens a confirmation modal with a red banner: Warning: this may require a credit note and invoice follow-up. Revert payment (on confirmed or rejected rows) shows a blue info banner: Info: this may require invoice or credit note updates afterwards. Vivin removes or rolls back the allocation in-product and creates credit-note reversal rows when needed. Issue those documents from Finance → Transactions — use the invoice filter pills beside Export (All / Invoiced / Not Invoiced / Not issued credit note / Issued credit note), filter Not issued credit note, then Issue credit notes (N) on the bulk bar or Issue credit note to provider on each reversal allocation in transaction detail — or mark reversals Set manual when accounting handles the nota de crédito outside Vivin. Operator walkthrough: FAQ — Reject or revert an incoming payment (bookings-detail-transactions-reject-modal-credit-note-banner.png, bookings-payment-row-actions-flow.mp4).

Booking detail Transactions — Reject payment confirmation with red credit-note warning banner

Booking detail Transactions — Revert payment confirmation with blue invoice follow-up info banner The same reject modal appears from Processing a New Booking, Handling a Late Payment, Managing a Check-in, Entering Monthly Utility Bills, Managing a Check-out (duplicate final payment during settlement), and Cancelling a Booking. Cancelling with already-invoiced schedule lines also requires credit notes outside Vivin — see Cancelling a Booking — Step 2b. Rent edits below the invoiced floor need the same external follow-up. Hub matrix: Common Workflows — Reject/revert mistaken receipts. Concept reference: Payment Allocation — Correcting mistaken receipts. Module reference: Bookings > Transactions row actions, Finance > Row actions, Finance — Issuing credit notes, Notification triage, Portfolio KPI review — Step 7, FAQ — Reject or revert an incoming payment.

D

Pair with other glossary clusters

D deposit and directory UX terms pair F (Finance Deposits date range), N (notification navigation), and FAQ — Payments & Finance.

Draft ticket (display status)

On Operations → Tickets, Draft is a display-only label — not a separate API status you assign manually. When a ticket’s Schedule date is more than 30 days in the future, the list shows a Draft badge and the Draft KPI card counts it, even though the saved workflow value remains Unassigned or In progress in the sidebar. Far-future scheduled work therefore stays out of the actionable Unassigned / In progress buckets until the schedule date moves inside the window. Use the Draft summary card or status pill to review long-lead jobs without mixing them into today’s queue.

Ticket — linked cash flows

On a maintenance ticket sidebar, the Cost allocation panel connects repair work to the Operations → Cash Flows ledger: link existing inflow/outflow rows, review a signed total, and click a linked row to open the Cash flow detail sidebar without leaving the ticket. Use this when contractor invoices should reconcile with ticket-level spend — for example turnover cleaning paid to a supplier or damage repairs during Managing a Check-out. See Operations — Linking cash flows to a ticket.

Dashboard The first screen shown upon login, providing a real-time overview of KPI cards (Listings, Today, Total Debt, Monthly Revenue), plus Occupancy Forecast, Cash Flow Forecast, and Vacant Units. See Dashboard module.

Deep link (management frontend) A direct https://platform.vivin.app/… URL that opens a specific module, tab, or editor state (for example Listings on a unit with filters applied, or the booking-engine details layer via query flags). Use them in bookmarks, runbooks, and hand-offs between operators. Route patterns and caveats are listed in Management Frontend Deep Links.

Demand Forecasting A general industry term for projecting future booking demand. In Vivin, forward-looking occupancy is visualised with the Occupancy forecast chart on the Dashboard and on Sales > Overview; operators still set rents manually in Sales > Pricing. See Visual quick reference — Occupancy Forecast (Dashboard).

Deposit Refund Deadline The number of days after a booking ends by which the security deposit must be returned. Configured in Settings > Payments.

Deposit Refund (payment type) A manual outgoing in-payment recorded when an operator refunds a security deposit from Bookings → Deposit (permission bookings.refund). Appears on Finance → Transactions under the Manual Transactions group (Deposit Refund sub-card) and as a scheduled line on the booking Payment plan with subtitle Deposit Refund and a minus-prefixed Deposit amount. Distinct from Deposit collection lines (tenant pay-in) and from Mark refunded on Finance → Deposits (status tracking after the external bank transfer).

Deposit lifecycle status

Full hub: Deposit lifecycle status (payment-driven depositStatus pill vocabulary, lifecycle state table, symptom table, surfaces, and per-guide/module mesh).

When payment-driven lifecycle is enabled (#781), Vivin stores a single depositStatus on each booking and mirrors it as a lifecycle pill on the Deposit tab and on matching Finance → Deposits rows (distinct from the amber Partially paid collection badge, which compares Paid vs Amount on the same tab).

Status (English UI)Typical meaning
Not PaidNo deposit allocation recorded yet.
Partial PaidSome deposit collected but below the configured Amount.
Fully PaidDeposit collected in full; pre-refund — Refund / dispute actions apply here.
Ready to RefundOperations marked Ready To Refund (when required) — finance can queue the bank return.
DisputedDeposit dispute freeze — refund actions blocked until resolved.
RefundedOutbound deposit return recorded in Vivin (bank transfer still happens outside the platform).

Portfolio triage uses Finance → Deposits Deposit lifecycle status cards plus Other filters → Deposit status on Bookings and Finance — see Finance — Deposit status filter. Child topics: Partly collected security deposit (Partial Paid shortfall), Deposit dispute (Disputed freeze), Finance Deposits date range (toolbar window hides lifecycle card counts), Deposit refund summary (tenant-facing) (portal Payments net display after Mark refunded, #2295).

Deposit refund summary (tenant-facing)

After operators record Mark refunded, Vivin stores a booking_deposit_refund row and returns a DepositRefundSummary to the tenant portal (#2295). The portal Payments tab uses this summary — not the contract deposit amount — for the Deposit Refund transaction line.

FieldMeaning
grossReversedFull deposit amount reversed on the ledger
appliedToChargesPortion retained against outstanding charges
netToTenantCash returned to the tenant (what the portal displays)
status: refundedBank return to this tenant
status: transferredBalance moved to another booking (netToTenant = 0)

Transaction search on the portal accepts signed amounts-610 matches a €610 refund line (#2301). Operator workflow: Managing a Check-out — Step 5. FAQ: Tenant portal deposit refund amount.

WhatsApp Genius (operator)

Landlord-side WhatsApp Genius lets team members message an AI assistant from a personal Phone Number linked on Account Settings → Users (Edit card — not Add Team Member; #2311). Authorization uses property_manager.phone — the sender acts as their real user and MCP tool permissions follow that role. Replies are WhatsApp-shaped (no markdown tables; language matches the user; honest read/write tool surface — #2323–#2325). Money answers use Finance-sourced portfolio metrics (get-finance-overview, get-revenue-summary) so figures match Finance → Overview, not Analytics ADR/RevPAR (#3183). Distinct from the tenant-facing ChatBot (tenant WhatsApp/email) and in-browser AI Chat. Setup and troubleshooting: Users — WhatsApp Genius phone linking, Automation & AI — WhatsApp Genius, FAQ — Genius does not recognize my number, FAQ — Genius revenue vs Analytics.

Deposit dispute

Full hub: Deposit dispute (contested retention on Fully Paid deposits, Mark as Disputed / Resolve Dispute, symptom table, and per-guide/module mesh).

A Fully Paid (pre-refund) security deposit flagged while your team investigates damage claims or tenant pushback on deductions. Requires Enable deposit disputes and bookings.dispute. Managing a Check-out Step 5 and Cancelling a Booking Step 3 freeze outbound deposit returns when retention is contested — distinct from rent Check-out collections before refund, partly collected Partly collected security deposit shortfalls, and Deposit missing on Finance Deposits toolbar date range hiding older rows.

Partly collected security deposit

Full hub: Partly collected security deposit (deposit Partial paid card vs rent Payment Plan, symptom table, surfaces, and per-guide/module mesh).

A security deposit where Paid is above zero but still below Amount — lifecycle pill Partial Paid on depositStatus. Distinct from Partial Paid rent rows on Payment Plan. Portfolio triage: Finance → Deposits Partial paid lifecycle card or Other filters → Deposit status → Partial paid — distinct from Deposit dispute freeze on Fully Paid deposits and Deposit missing on Finance Deposits toolbar date range hiding rows.

Finance Deposits date range

Full hub: Finance Deposits date range (default ~3 months toolbar window, intersection rule on check-in / check-out / Refund Due Date, symptom table, surfaces, and per-guide/module mesh). Operator symptom mesh: Deposit missing on Finance Deposits hub.

On Finance → Deposits, the toolbar date range defaults to roughly the last three months through today. A deposit row appears when check-in, check-out, or Refund Due Date intersects the window — clear or widen before triaging older move-outs, dispute row chips, lifecycle card counts, or Export. Distinct from Partly collected security deposit shortfalls and Deposit dispute freeze on Fully Paid deposits.

Discount (booking)

A reduction applied to a scheduled charge on a booking’s payment plan — either per line (fixed € or % on one rent, fee, or service row) or booking-scoped (percentage or fixed total across the whole reservation or a selected scope). Discounts lower the net amount allocations compare against; the original amount column on Contract Values stays for audit. Operators add them on Bookings → Contract Values (Discounts row action or Apply booking discount toolbar pill) with permission bookings.add_discounts; deposit lines cannot be discounted. Portfolio triage uses Other filters → Booking → Discounts (With / Without) on the Bookings list and Finance drawer (same API field), or the dedicated Audit — Discounts tab (/audit/discounts) for KPI summary, export, and cross-portfolio review. See Discounts and payment adjustments.

Dual pricing / Local rent cap Account-level option on Payments, Invoicing & Utilities → Payments that splits each monthly Rent line on new bookings into a capped Rent portion and an Others line for the remainder (accommodation services). Requires Enable Dual Pricing, an Others category, and a per-unit Local Rent Cap in Listings. Frozen on the booking at create; see Payment allocation — Dual pricing rent split and Bookings — Dual pricing.

Due Date The date by which a scheduled payment must be made. Calculated from the charge date plus the Tenant Due Days configured in Settings > Payments. Individual properties can override this value.

Dynamic Pricing Industry term for rates that change with demand or rules. Vivin’s Sales > Pricing tab is where operators edit monthly rent per unit and month (with bulk tools); the product does not auto-rewrite your published rates from an in-app “dynamic pricing engine.” See Sales module.

E

Pair with other glossary clusters

E export, effective contract, and end-of-list terms pair I (infinite scroll), F (fixed invoice date), and FAQ — Navigation & shortcuts.

External listing ID The identifier a third-party marketplace (for example Airbnb or Booking.com) uses for a published listing. In Vivin, each unit is linked to that ID (and to channel URLs where applicable) on the Listings → Channels tab so imported bookings and calendar sync map to the right row in your portfolio. Marketplace enablement and account credentials live under Settings > Integrations.

Email Template A customizable email sent automatically to tenants at lifecycle events (onboarding, check-in, check-out) or based on rules (payment reminders). Configured in Settings > Emails. Lifecycle check-in send rules (portal signing vs paper upload, 15-day cutoff, Nuki-only toggle) are documented under Lifecycle check-in email and When lifecycle check-in emails send.

End of list

A subtle footer line some large directories show after the app has loaded every row that matches the current filters (search, status segment, tags, and so on). It confirms there is nothing left to fetch — not a button. Appears on full-page lists such as Listings portfolio, Listings archived, Tenants, Audit — Manual Blocks, the Notifications module (capture refreshed 2026-06-22notifications-module-end-of-list.png), and the full Support inbox at /settings/support. The Bookings list, Bookings Timeline unit axis, Dashboard notifications bell slide-over, and Help & Support drawer also load in chunks on scroll but do not show this marker; use /notifications when you need the explicit end-of-history line on notifications — see Notification triage — Step 5.

Infinite scroll (directory loading)

Pattern used when a module’s primary table or card grid is server-paged: the first request loads a batch sized for the viewport, and scrolling near the bottom triggers the next batch automatically (no Load more button). While the next batch is in flight, the UI shows skeleton or spinner placeholders at the bottom. Changing filters or search resets the list and starts again from the first batch. On most directory modules, Export still reflects the full filtered result set even when you have not scrolled through every chunk (for example Bookings — Exporting the list). Operations (Tickets, Cash Flows) and Utilities → Connections export only rows already loaded — scroll to the end of the list first when you need a complete spreadsheet. Documented in Listings, Bookings (list view) and Bookings Timeline (unit rows on the Gantt chart), Audit — Manual Blocks, Tenants, Notifications, Sales (Multi-calendar and Channels), Finance (Contract Values, Transactions, Payouts, DepositsExport on Contract Values and Transactions still uses the full filtered set), Operations (Tickets and Cash Flows), Utilities — Connections, the Dashboard bell slide-over, and in-app Support (drawer and full inbox).

Export and download failures

When a CSV/Excel export, bulk PDF download, or similar file action fails (network timeout, HTTP 4xx/5xx, or assembly error), Vivin surfaces the failure instead of closing the menu with no file:

SurfaceHow the failure appears
Bookings listInline red alert under the toolbar
Tenants, Listings, Sales (Pricing / Channels), AuditToast (for example Failed to export.)
Utilities → Bills Download selectedToast when one or more PDFs in the batch fail
Utilities → Timeline bill previewToast when a stored bill PDF cannot be opened

Retry after checking connectivity or narrowing filters. An empty filtered list still produces no file by design — that is not an error state.

Directory list load failures

Full hub: Directory list load failures (surface/symptom tables, per-guide mesh, and notifications-module-load-failure.png, audit-manual-blocks-load-failure.png, dashboard-partial-data-load-failure.png, analytics-kpi-load-failure.png).

When the first request for a large directory or dashboard aggregate fails (network drop, timeout, or HTTP 4xx/5xx), Vivin shows an explicit error instead of an empty table that looks like “no data”:

SurfaceHow the failure appears
Bookings listInline alert cardFailed to load bookings. Please try again. + Retry
Bookings Timeline (/bookings/timeline)Centered chart error panel — Couldn't load the timeline bookings. + Retry (re-fetches listing axis and bars; distinct from list-view failure)
Tenants directorySame card pattern — Failed to load tenants. Please try again.
Listings portfolioSame card pattern — Failed to load listings. Please try again.
Sales (Pricing / Channels / whole module)Module-level alert card — Failed to load sales data. Please try again. + Retry (blocks all four tabs until recovery)
Sales Overview free-unit popoverInline text in the day/bar popover — Failed to load free units — KPI strip and availability charts still render; close the popover or pick another day
Operations Tickets / Cash FlowsTab-level alert — Failed to load tickets. / Failed to load cash flows. + Retry
Notifications (/notifications)Red message in the main panel — Failed to load notifications. + Try again
Support inbox (/settings/support)Alert card — Failed to load support tickets + Retry
Dashboard (/)Banner under the page header — Some dashboard data failed to load. + Retry (other widgets may still render from cache)
Audit Manual BlocksAlert card — Failed to load manual blocks. + Retry
Analytics KPI workspace (/analytics)Red inline alert — We couldn't load your portfolio KPIs + Try again (not blank charts that imply zero performance)
Utilities (each tab)Tab-level alert — Overview / Connections / Bills / Timeline / Allocations show Retry; Cost map shows Failed to load data. (refresh the tab)
Settings → Services Requests queueInline alert — Could not load pending approvals. + Retry

Hub matrix: Common Workflows — Directory list load failures · Directory list load failures hub · FAQ — Directory list load failures hub. Per-guide mesh: Manual block hygiene — Directory list load failures, Cancelling a Booking — Directory list load failures, Managing a Check-out — Directory list load failures, Onboarding a New Property — Directory list load failures, Processing a New Booking — Directory list load failures, Entering Monthly Utility Bills — Directory list load failures, Handling a Late Payment — Directory list load failures, Managing a Check-in — Directory list load failures, Notification triage — Directory list load failures, Resetting a Management User Password — Directory list load failures, Using in-app support — Directory list load failures, Portfolio KPI review — Directory list load failures. Refresh the page or use Retry / Try again after connectivity recovers. A successful fetch that returns zero rows for your filters is not this state — that is the normal empty state. Step-by-step: FAQ — Directory list load failures (notifications-module-load-failure.png, audit-manual-blocks-load-failure.png, dashboard-partial-data-load-failure.png, analytics-kpi-load-failure.png).

Booking detail sidebar tab load failures

Full hub: Booking sidebar tab load failures hub (surface table, symptom/decision tables, and per-guide mesh).

Hub matrix: Common Workflows — Booking sidebar tab load failures · Booking sidebar tab load failures hub. Per-guide mesh: Manual block hygiene — Booking sidebar tab load failures, Cancelling a Booking — Booking sidebar tab load failures, Managing a Check-out — Booking sidebar tab load failures, Onboarding a New Property — Booking sidebar tab load failures, Processing a New Booking — Booking sidebar tab load failures, Handling a Late Payment — Booking sidebar tab load failures, Managing a Check-in — Booking sidebar tab load failures, Entering Monthly Utility Bills — Booking sidebar tab load failures, Notification triage — Booking sidebar tab load failures, Resetting a Management User Password — Booking sidebar tab load failures, Using in-app support — Booking sidebar tab load failures. Inside the booking detail sidebar, each tab loads its own API slice. A failure on one tab does not block the others — switch tabs or close and reopen the booking while you retry.

TabHow the failure appearsRecovery
CommunicationTitle Could not load messages with short body copyRefresh in the booking sidebar header toolbar (visible while Communication is active)
TicketsRed banner — Could not load tickets. Try again.Retry on the banner

These are tab-scoped errors, not whole-module directory failures. See FAQ — Communication or Tickets load failure and Directory list load failures for list pages such as Bookings, Tenants, and Notifications.

Booking detail — Communication tab with Refresh in the sidebar header while WhatsApp is active

Settings and profile load failures (toast)

Some Account Settings tabs and My Profile surface load failures as toasts or inline alerts instead of a full-page directory card:

SurfaceHow the failure appears
Tenant categories listError toastFailed to load tenant categories. — refresh the tab or reopen Account Settings
Emails Communication Rules tabInline banner — Couldn't load communication rules with Try again (saved rules are unchanged)
Integrations Other providersConnections fetch failure shows an error toast (for example Failed to load integrations.) and an empty provider list — refresh before assuming no Nuki / Hostkit / Invoice-xpress connections. Remove connection delete failures also show an error toast while the confirmation modal stays open
Invoicing Tax codes (while editing)Amber alert — Could not load tax options: + server detail and Retry link
My Profile (/profile)Inline message — We could not load your profile details right now. — refresh the page

Notification read actions

On /notifications and the Dashboard bell slide-over, Mark all as read clears unread for every notification matching the current filter (full page) or the loaded inbox slice (bell). Mark as read on a single row clears that item only.

OutcomeFeedback
Mark all as read succeedsSuccess toastAll notifications marked as read.
Mark all as read failsError toastFailed to mark all notifications as read. Please retry. — unread badges stay unchanged
Mark as read on one row (button) succeedsSuccess toastNotification marked as read.
Mark as read failsError toastFailed to mark notification as read. Please retry.
Row click marks unreadNo success toast (same as before); failures still surface as a toast

See Notifications module and Notification triage.

Notification row navigation

Full hub: Notification row navigation (surface table, target-field symptom table, and per-guide mesh).

On the full Notifications page at /notifications, clicking a row does more than update read status when the platform attached a navigation target:

  1. If the row is still Unread, it is marked read in the background (no success toast).
  2. The app navigates using the first match in this order: backend link, then bookingId, tenantId, listingId, or propertyId.
Target fieldTypical outcome
bookingIdOpens the booking detail sidebar on Bookings (/bookings/list/:id)
tenantIdOpens the tenant profile on Tenants
listingIdOpens the unit editor on Listings
propertyIdOpens the property editor on Listings
linkFollows the backend deep link (for example Inbox or Communication)
(none set)Marks read when applicable; you stay on the inbox

This behaviour applies to the full module only. On desktop Dashboard, the header bell opens Notification detail inside the panel for most General rows, or navigates when the row carries a link (Inbox message rows jump to /inbox or booking Communication). Use /notifications when you want search, All / Unread / Read filters, and one-click triage into Bookings, Tenants, or Listings from payment and ticket alerts.

Notifications module — inbox row ready to open the related booking

Bookings — detail opened after clicking a payment notification row on /notifications

Hub matrix: Common Workflows — Notification row-click navigation. Per-guide mesh: Processing a New Booking — Notification row-click navigation, Cancelling a Booking — Notification row-click navigation, Managing a Check-in — Notification row-click navigation, Managing a Check-out — Notification row-click navigation, Entering Monthly Utility Bills — Notification row-click navigation, Handling a Late Payment — Notification row-click navigation, Portfolio KPI review — Notification row-click navigation, Notification triage — Notification row-click navigation, Manual block hygiene — Notification row-click navigation, Onboarding a New Property — Notification row-click navigation, Using in-app support — Notification row-click navigation, Resetting a Management User Password — Notification row-click navigation. link targets on message rows open Inbox or booking Communication — pair Common Workflows — WhatsApp per-booking messaging (inbox-module-overview.png, bookings-detail-communication-tab-whatsapp-thread.png). Pending manual in-payment alerts row-click into booking Transactions for Approve payment — pair Common Workflows — Pending manual receipt approval (notifications-row-navigate-to-booking-detail.png, finance-transactions-pending-approve-flow.mp4). See FAQ — Notification row-click navigation, FAQ — Pending manual in-payment on /notifications, Notifications module — Open the related booking, Notification triage — Step 4, Deep Links — Notifications, Dashboard — Notifications bell (desktop) (bell General rows stay in-panel), Portfolio KPI review — Dashboard Total Debt subtitle, Handling a Late Payment — Step 1, Common Workflows — Finance debt receivables triage, and Deep Links — Broken entity deep links when a target id no longer exists.

Directory search ranking

When a large directory’s toolbar Search matches more than one field on the same row, Vivin may re-rank results so the most likely match appears first. Behaviour differs by module:

ModuleRanking when search is active
BookingsUnit internal name first, then tenant name or email, then rows that matched only on property, platform, IBAN, internal notes, or other columns.
Operations → TicketsUnit / room hits and property internal name hits share the top tier (#2089); title, description, category-only matches rank below. With an active Property filter and default sort, property-level rows (building name only — no unit suffix) float first; explicit column sort opts out. Paste the full sequential ticket ID (for example S259, T27) to jump to one row (#2074).
Operations → Check-in & Check-outUnit / listing name first, then tenant name or email, then property-only matches (client-side on the loaded date slice).
Operations → Cash FlowsUnit / listing name first, then title, description, or property-only matches (server search + client buffer re-rank).
ListingsNo ranking — matching properties stay sorted A–Z by internal name.
TenantsNo ranking — server returns matches in the directory’s current sort order (name, balance, and so on).

Use at least two characters on Bookings search (single-character input is ignored). Paste a unit code on Bookings or Operations when you want the room reservation, ticket, handover event, or cash flow first; on Operations → Tickets, a property code shares the same top relevance tier as unit hits (#2089) — use it for common area or building-wide tickets. Paste the full ticket ID on Operations → Tickets when email or support references #S259 / T27 — see FAQ — Find a ticket by its ID (#2074); use fiscal ID or identification ID on Tenants when paperwork references tax or passport numbers instead of display names.

End-of-Booking cost split

When Account Settings → Utilities → Charge Time is End of Booking, Vivin calculates daily utility overage per property but defers posting an allocation row for each stay until that booking’s check-out date has passed. Glossary hub parity: Utility overage collections. Hub matrix: Common Workflows — Utility overage collections (Entering Monthly Utility Bills — Step 4Handling a Late Payment — Steps 1–4; utilities-allocations-row-breakdown-expanded.png, finance-contract-values-in-debt-filter.png, utilities-allocations-review-flow.mp4) · Common Workflows — Check-out final utilities handoff (Entering Monthly Utility Bills — Step 4Managing a Check-out — Step 6 before deposit release). During the stay, the unit still occupies the listing — and for cost-splitting purposes it still counts in the denominator for every day it is occupied (#2111). That prevents a tenant who checks out mid-year from absorbing the share of roommates who remain for later months.

Example — A coliving house has two active rooms in March. Tenant A checks out 1 June; tenant B stays through 1 August. A March electricity overage is split equally across both rooms for each day both were occupied. Tenant A’s allocation row appears only after A’s checkout; tenant B’s row appears after B’s checkout. A is not charged for B’s weeks after A has left.

Notification triage — Utility overage collections, Onboarding a New Property — Utility overage collections, Cancelling a Booking — Utility overage collections, Manual block hygiene — Utility overage collections, Using in-app support — Utility overage collections, Resetting a Management User Password — Utility overage collections, Processing a New Booking — Utility overage collections, Managing a Check-in — Utility overage collections, Managing a Check-out — Utility overage collections, Handling a Late Payment — Utility overage collections, Entering Monthly Utility Bills — Utility overage collections, Portfolio KPI review — Utility overage collections, Notification triage — Check-out final utilities handoff, Onboarding a New Property — Check-out final utilities handoff, Cancelling a Booking — Check-out final utilities handoff, Manual block hygiene — Check-out final utilities handoff, Using in-app support — Check-out final utilities handoff, Resetting a Management User Password — Check-out final utilities handoff, Processing a New Booking — Check-out final utilities handoff, Managing a Check-in — Check-out final utilities handoff, Managing a Check-out — Check-out final utilities handoff, Handling a Late Payment — Check-out final utilities handoff, Entering Monthly Utility Bills — Check-out final utilities handoff, Portfolio KPI review — Check-out final utilities handoff. Pair with Utilities → Allocations review (utilities-allocations-review-flow.mp4), Entering Monthly Utility Bills, and Managing a Check-out — Step 6 when month-end true-ups look high for departing tenants — hub: Common Workflows — Check-out final utilities handoff. Contrast with Every Month charge time, which includes active bookings in the billing month without waiting for checkout.

Multi-word tenant names — On Tenants, Bookings, and Utilities → Allocations search, a query that spans first and last name (for example Maria Silva) also matches the concatenated full name, not only each name column on its own. This keeps directory search aligned with how operators type names from paperwork.

Tenants table expand

In Tenants table view, each tenant occupies one summary row. Click the chevron area to expand or collapse an inline sub-table of linked bookings (Unit, Rent, Created, Status, Period, Balance, Src, CT). Click the tenant name to open the tenant detail sidebar (/tenants/<id>) without leaving the directory; click a booking sub-row to open the booking sidebar in place (same pattern as grid cards).

Use table view when you need column sort and a quick per-tenant booking roll-up without opening every profile. Pair with the With Debt status pill or toolbar Search (including fiscal ID / identification ID) during collections triage — see Handling a Late Payment — Step 1. Grid view stays better when debt badges and multi-status booking previews matter at a glance.

Tenants — table view with one row expanded showing Unit / Rent / Balance booking sub-table

Table expand capture refreshed 2026-06-20 19:08 UTC (VIVIN_DOCS_BASE_URL=http://localhost:5173 VIVIN_DOCS_RECORD_API=$VITE_API_BASE_URL npx tsx tools/capture-tenants-table-expanded-screenshots.ts). Walkthrough MP4: tenants-table-expand-flow.mp4 on Tenants — Table view.

Server-driven search picker

Compact searchable dropdown used when a form must link to a large portfolio entity (tenant, property, listing, or booking) without loading the full account list up front. When you open the control, Vivin prefetches a small first page (about 10 rows), runs debounced server search as you type, and loads the next page when you scroll near the bottom of the menu — the same chunked pattern as infinite scroll (directory loading), but inside a popover. Property pickers call GET /properties/search (archived buildings excluded by default; owner scope mirrors other property routes). The legacy bulk GET /properties list was removed in the June 2026 performance pass — pickers always page. Row labels show the primary name; a secondary line can show email or address. Listing (unit) pickers are property-scoped: the server only returns units for the property you selected first; changing property clears the unit and resets the listing menu. When labels are property or unit internal names, options are ordered with natural numeric sort. With an active search query, property and listing (unit) pickers on Add booking apply name-first relevance before pagination: an internalName hit (exact, then prefix, then substring) ranks above a row that matched only on address, postal code, tags, or room number — so typing António surfaces Casa António I before buildings whose address contains “António” but whose code does not (#1880). Without a query, ordering is unchanged (natural numeric internalName only). See Picker search ranking. Documented examples: Add booking — tenant, property, and unit pickers, Sales Multi-calendar — Select properties, Finance — Other filters → Property (multi-select chips, owner-scoped server search), and Utilities — Select properties (module toolbar on Connections, Cost map, and other tabs).

Server-driven picker (directory select)

Compact dropdown used when a form or filter must reference one tenant, property, or similar entity from a large account without loading the full list up front. Behaviour matches the infinite-scroll directories, scaled to a popover:

  • Prefetch — opening the menu loads an initial page (typically about ten rows).
  • Search — typing debounces to a server search endpoint; results replace the list.
  • Infinite scroll — scrolling to the bottom of the menu fetches the next page until exhausted.
  • States — explicit empty and error messaging when search returns nothing or the request fails.

In product today: Select tenant on Add booking (TenantPickerSelect), Select properties on Sales → Pricing (PropertyPickerSelect), the multi-select Property control in Finance → Other filters (PropertyMultiPickerSelect, owner-scoped when owners are selected), Property in Operations → Other filters (PropertyPickerSelect, add-to-multi-select), Select properties on Utilities tabs (PropertyMultiPickerSelect), Properties audience on Settings → Emails — Communication Rules (PropertyMultiPickerSelect), and Properties scope on Settings → Services (PropertyMultiPickerSelect). The Bookings list Select properties toolbar control is a multi-select fed from portfolio filter metadata (distinct property names on the account), not the paged search endpoint — additional picker components exist for listings in other filter surfaces.

Picker search ranking

When a server-driven search picker has an active query, property and unit menus backed by GET /properties/search (and property-scoped listing pickers) rank matches before slicing the page — including Add booking, Finance → Other filters → Property, Operations → Other filters, Utilities → Select properties, Communication Rules → Properties, and Services → Properties scope:

TierMatch on internalName (property or unit)
0Exact equals query
1Name starts with query
2Name contains query
3Matched only on a secondary field (address, postal code, property tags, room number, …)

Within the same tier, rows keep natural numeric internalName order. Ranking runs on the full matched set before pagination so a name hit on page two of an alphabetical sort still appears on page one when you search — the same “unit / name first” idea as Directory search ranking on large lists, applied inside picker popovers (#1880).

Examples: search António on Add booking → Property, Finance → Other filters → Property, Operations → Other filters → Property, Utilities → Select properties, Communication Rules → Properties, or Services → PropertiesCasa António I and Casa António II appear above AA-11-5D (matched only because the address line contains “António”). Captures: bookings-add-booking-property-picker-search-rank.png (Bookings — Creating a new booking), finance-other-filters-property-picker-search-rank.png (Finance — Property & Listing filters), operations-other-filters-property-picker-search-rank.png (Operations — Overview tab), utilities-select-properties-picker-search-rank.png (Utilities — Portfolio scoping), settings-emails-communication-rule-property-picker-search-rank.png (Communication Rules — Audience: Properties), and settings-tenant-services-properties-picker-search-rank.png (Services — Properties scope).

Server-driven picker

Searchable dropdown used when loading every row in the account at once would be slow or unreliable on large portfolios. When you open the control, the app prefetches about 10 matches, runs debounced server search as you type, and loads the next page when you scroll to the bottom of the dropdown list — the same chunked pattern as infinite scroll, but inside a form or filter field. Empty and error states are shown explicitly in the panel. Examples today include the tenant field on Add booking (Bookings), property filters on Sales > Pricing, the Property multi-select in Finance > Other filters, Property in Operations > Other filters, Select properties on Utilities, Properties on Settings > Emails — Communication Rules, and Properties scope on Settings > Services.

F

Pair with other glossary clusters

F finance and fee vocabulary pairs P (payment allocation, portfolio filters), I (invoiced floor), and the Financial & payments cluster.

Fixed Rent A rent amount that remains constant for all bookings on a unit, regardless of season or demand. The alternative is Variable Rent. Configured in the unit's Rent Value tab.

At booking level, Vivin may still store isRentFixed = true when the listing is variable but every calendar month covered by the reservation’s contract dates shares the same configured rent — payment amounts are unchanged; only the booking-level flag and headline rent field reflect the constant value. The unit’s Rent Value tab stays variable for future stays. After Add booking, confirm Contract Info → Monthly rent — see Processing a New Booking — Step 3. Legacy bookings created before that inference shipped were backfilled to match the same rule. Operator-facing detail: Bookings > Fixed rent on a variable unit and FAQ — Fixed rent on variable unit.

Fixed invoice date reminder

Full hub: Fixed invoice date reminder (amber banner surfaces on Finance → Transactions and transaction detail, symptom table, and per-guide mesh).

Amber status banner Vivin shows when Use today as invoice date is off and a fixed Invoice date is saved under Settings > Invoicing — inline above Finance → Transactions search, compact in the bulk invoice toolbar beside Issue allocation / Invoice selected, and in transaction detail above allocations. Accounting setting: Fixed invoice date. Month-end workflow: Month-end invoicing (fixed date).

Fixed invoice date

An account-wide calendar date used on every invoice Vivin issues while Use today as invoice date is off under Settings > Invoicing. Operators see the amber Fixed invoice date reminder on Finance → Transactions (inline strip above search) and, when relevant, in the transaction detail sidebar (compact toolbar layout). Turn the toggle back on to return to day-of-issue dating. Glossary hub parity: Fixed invoice date reminder · Month-end invoicing (fixed date). Hub matrix: Common Workflows — Month-end invoicing (fixed date). Pair Common Workflows — Bulk Hostkit invoicing when Hostkit Issue allocation runs on the same bulk toolbar (finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png). Per-guide mesh: Portfolio KPI review — Month-end invoicing (fixed date), Onboarding a New Property — Month-end invoicing (fixed date), Cancelling a Booking — Month-end invoicing (fixed date), Processing a New Booking — Month-end invoicing (fixed date), Handling a Late Payment — Month-end invoicing (fixed date), Managing a Check-in — Month-end invoicing (fixed date), Notification triage — Month-end invoicing (fixed date), Managing a Check-out — Month-end invoicing (fixed date), Entering Monthly Utility Bills — Month-end invoicing (fixed date), Manual block hygiene — Month-end invoicing (fixed date). Month-end sign-off: Portfolio KPI review — Step 7.

Month-end invoicing (fixed date)

Full hub: Month-end invoicing (fixed date) (save fixed Invoice date → bulk Issue allocation / Invoice selected → reset Use today as invoice date, symptom table, and per-guide mesh).

When month-end close requires every invoice in a batch to share one posting date, turn Use today as invoice date off under Settings > Invoicing, save a fixed Invoice date, bulk-export on Finance → Transactions, then turn the toggle back on. Pair the amber Fixed invoice date reminder on Transactions and Bulk Hostkit invoicing when Hostkit Issue allocation paces the same toolbar.

Uncovered Debt

Full hub: Uncovered Debt (seven-card KPI strip compare, deposit-coverage symptom table, and per-guide mesh).

Hub matrix: Common Workflows — Uncovered Debt KPI · Finance debt receivables triage. On Finance → Overview, Uncovered Debt is an all-time KPI beside Total Debt. Total Debt sums tenant underpayment across bookings; Uncovered Debt is the portion of that balance not covered by security deposits the portfolio still holds — receivables where deposit offsets are insufficient. Use it with Finance Debt Aging (Finance Overview) (Top debtors, overdue buckets) and the In debt segment on the Income chart (Finance income status) when prioritizing collections — including after Notification triage — Step 4 opens a booking from a payment alert. The Dashboard Total Debt card uses the same balance rules but only for ongoing bookings and does not show Uncovered Debt — see FAQ — Dashboard Total Debt subtitle and Common Workflows — Finance debt receivables triage. See Finance > KPI strip, FAQ — Uncovered Debt KPI, and Handling a Late Payment — Step 1.

Finance Debt Aging (Finance Overview)

Hub matrix: Common Workflows — Finance debt receivables triage. Per-guide mesh: Processing a New Booking — Finance debt receivables triage, Cancelling a Booking — Finance debt receivables triage, Managing a Check-in — Finance debt receivables triage, Managing a Check-out — Finance debt receivables triage, Entering Monthly Utility Bills — Finance debt receivables triage, Handling a Late Payment — Finance debt receivables triage, Portfolio KPI review — Finance debt receivables triage, Notification triage — Finance debt receivables triage, Manual block hygiene — Finance debt receivables triage, Onboarding a New Property — Finance debt receivables triage, Using in-app support — Finance debt receivables triage, Resetting a Management User Password — Finance debt receivables triage. Pair Common Workflows — Handling a Late Payment collections hub when triage surfaces identified a debtor and you need Steps 1–6 outreach / receipt habits. Pair Common Workflows — Reject/revert mistaken receipts when Top debtors still list a tenant who double-paid — Revert duplicate before collections (bookings-detail-transactions-revert-modal-info-banner.png). Pair Common Workflows — Pending manual receipt approval when Total Debt lags because operator-recorded transfers are still pending (finance-transactions-pending-pill.png). When arrears cluster on one segment, add Other filters → Tenant category before you expand overdue bands — Common Workflows — Portfolio segmentation by tenant category. On Finance → Overview, the right-column Debt Aging panel triages receivables: expand overdue bands (0–15 d through +60 d) for inline tenant · unit rows, or pick a line under Top debtors to open the booking sidebar. Pair with FAQ — Bookings that owe money (finance-overview-debt-aging-expanded-bucket.png), Common Workflows — Finance debt receivables triage, the Uncovered Debt and Total Debt KPIs above the charts, the In debt segment on the stacked Income chart (Finance income status), and Notification triage — Step 4 when payment alerts deep-link into a booking. Collections follow-through: Handling a Late Payment — Step 1. Month-end reconciliation: Portfolio KPI review — Step 7.

Full listing feed Partner-shaped JSON catalogue export (GET /{platform}-integration/:landlordKey/listings/full) used when a marketplace ingests rich listing create/update payloads (descriptions, amenities, photos). Distinct from the partial GET …/listings calendar contract. Platforms with full feeds today include Uniplaces, Spotahome, Housing Anywhere, and Inlife. See Full listing feeds.

G

Pair with other glossary clusters

G general platform terms pair M (management session), W (webhook), and Concepts.

Full integration pill The Listings sidebar pill (alongside Setup and Photos) that opens the Property Details / Listing Details editor for marketplace and booking-engine payloads — the same surface documented under Booking engine details editor in this glossary. Property and unit edit sidebars merged operational setup, marketplace payload, and gallery into these three pills (#2082), replacing the older header Go to details shortcut. An amber dot on the pill means required partner fields are still missing. See Property edit sidebar pills, Property & listing details (booking engine), and FAQ — Properties & Listings.

Gap Analysis A general term for finding empty nights or short holes between stays. In Vivin, inspect free periods on Sales > Overview — Availability over time and occupancy behind prices on Sales > Pricing; closing gaps remains an operational decision (rates, minimum stay, channels).

Hostkit

Full hub: Hostkit (per-listing Listing keys, FR invoice series, document {series}/{id} identity, and see invoice surfaces).

Portuguese invoicing provider connected under Settings > Integrations. Unlike Nuki or Invoice-xpress account keys, Hostkit uses one API key per listing, entered via Listing keys on the Hostkit card — the modal searches server-side and infinite-scrolls about 20 rows per request (GET /listings/hostkit-keys). Set Hostkit invoice series on Settings > Invoicing (Fatura-Recibo / FR) to the exact code from Hostkit Faturação → Séries — Hostkit identifies each document by series + numeric id together; Vivin stores {series}/{id} references and resolves PDF links from Hostkit's permalink for that pair. Only one invoicing provider (Hostkit or Invoice-xpress) can be active per account. Bulk export pacing: Bulk Hostkit invoicing — Vivin paces Hostkit requests and retries HTTP 429 with backoff on Issue allocation, Invoice selected, and Issue credit notes (N).

Listing options (management API)

Thin account-wide unit list the management app loads from GET /listings/options — each row exposes id, internal name, listing tags, and property without the full listing payload. Use cases include Change listing on a booking’s Contract Info tab and other multi-selects that only need labels and ids. The legacy management GET /listings load-all endpoint was removed in the June 2026 performance pass; pickers that only need id + label use /listings/options instead. This route is not the partner partial GET /listings calendar/pricing feed documented in Integration Swagger for marketplace integrations. Related slim endpoints: GET /listings/tags (distinct tag strings for Finance filters) and GET /listings/hostkit-keys (paginated Hostkit key rows). Landlord MCP list-listings wraps GET /listings/options — see Landlord MCP.

I

Pair with other glossary clusters

I integration and invoicing terms pair Webhook under W, Hostkit under H (FAQ — Bulk Hostkit invoicing slow), and FAQ — Integrations & Distribution.

iCal A standard calendar format used to synchronize availability between Vivin and external platforms. Each unit can export an outbound feed at {Core API host}/ical-integration/listings/{listingId}/iCal.ics that other platforms subscribe to. Operators copy links from Sales > ChannelsCopy iCal per row, integration wizards, or Export for bulk URLs; API behaviour (headers, retrofeed, horizon) is documented in API Reference — iCal feeds. Account-wide Short-term iCal Max Date is configured under Settings > Integrations.

Incoming Payment A real payment received from a tenant. Recorded in the Finance module and allocated to scheduled charges.

Impairment loss

A negative adjustment on a scheduled charge line (impairment_loss in product data) that reduces what the tenant owes without deleting the underlying schedule row. Appears on Payment plan breakdowns and in Finance transaction Type when recorded — distinct from a discount (operator-applied reduction) and return of value (Vivin-internal credit against allocated amounts). See Discounts and payment adjustments and Payment allocation — Adjustments.

Invoiced floor (rent)

Full hub: Invoiced floor (rent) (booking modal surfaces, symptom table, and per-guide mesh).

When Finance has already invoiced rent for a calendar month, lowering the scheduled net below that invoiced total would break accounting alignment. Vivin enforces an invoiced floor: on Contract Info → Change monthly rent, months where the new amount would fall below the invoiced total are clamped to the invoiced value (blue Already invoiced months banner). On Contract Values → Edit amount, the same floor blocks Save when net would drop below invoiced+draft totals on that line (red inline validation). When you truly need to reduce invoiced rent below that floor, issue credit notes or manual adjustments in your accounting system — Vivin will not save a lower net on an already-exported month. Workflow hub: Rent reduction after invoicing.

Booking detail — Change monthly rent modal with Already invoiced months info banner

Booking Contract Values — Edit Payment Amount modal with Already invoiced helper and net-below-invoiced validation error

Integration A connection between Vivin and an external platform (for example Airbnb, Booking.com, Nuki, Hostkit, Invoice-xpress) that enables automatic data synchronization. Account-wide credentials, enable toggles, optional Pricing Markup, Short-term iCal Max Date, and non-marketplace providers are configured on Settings > Integrations. Per-unit marketplace listing IDs, channel URLs, and import wiring for each row in your portfolio live under Listings > Channels — turn a platform on in Integrations first, then link each unit on Channels (see the tip at the top of the Integrations settings page).

In-App Support Permission-gated support inside the management hub for creating and tracking tickets with the Vivin team (distinct from operational maintenance tickets in Operations). The Help & Support drawer and the full /settings/support inbox both use server-side search, sort, and infinite scroll (chunked loading, about 20 tickets per request). Default sort Last updated orders by ticket updatedAt (recent activity), not workflow status group. The full page adds a table layout, Showing X of Y, End of list, and a default assignee for new tickets. See Using in-app support and Get Help & Support.

Invoice A tax document generated when a payment is recorded, typically through an integration with Invoice-xpress or Hostkit. VAT rates for each charge type are configured in Settings > Invoicing; Hostkit accounts also set Hostkit invoice series.

K

Pair with other glossary clusters

K KPI abbreviations pair ADR, RevPAR, and Analytics module.

KPI (Key Performance Indicator) A real-time metric displayed on the Dashboard, such as Listings, Today (free rooms), Total Debt, and Monthly Revenue. See the Dashboard KPI cards row in Visual quick reference for card-by-card definitions and PNG closeups (distinct from the seven-card Finance → Overview strip).

L

Pair with other glossary clusters

L lease and listing terms pair B (booking), P (portfolio filter catalog), and Listings module.

Landlord MCP The account-scoped Model Context Protocol server that exposes typed portfolio tools to external AI clients (same permission model as the management app; Core API–backed). See Landlord MCP. For booking-scoped tenant automation, see Tenant MCP.

landlordKey Path segment in full listing feed URLs (GET /{platform}-integration/:landlordKey/listings/full) and in some inbound webhook routes. For full feeds, Vivin resolves the segment to an account when it matches either the stored account landlordKey or that account’s integration email for the platform (the email on the platform card under Integrations). Webhooks still require the account landlordKey in the path, not the integration email. See Full listing feeds.

Lease purpose (booking)

An optional classification for why a tenant is renting (for example Tourism, Studies, Work, Internship). Enable allowed values under Settings → Categories → Lease purpose; operators pick from the chip list on Add booking and Contract Info, and tenants may be required to choose on the portal Review step when Make Lease Purpose mandatory is on. Values outside the configured list are rejected on save. Portfolio filters do not expose lease purpose today — use booking detail or exports for reporting.

Listing See Unit. In the Listings module, "Unit" and "Listing" are used interchangeably.

Listing tag (filter)

A label from Settings > Categories > Listing Categories applied to properties and units in Listings. The same vocabulary powers portfolio filters: Tags on the Listings Portfolio toolbar, Select tags on Sales Multicalendar / Pricing, and Select categories under Property & Listing in Finance → Other filters (GET /listings/tags). Distinct from Booking Tag on reservations.

Listing type (filter)

A label from Settings > Categories > Listing Types describing property or unit shape (for example Studio, Room). Used in Types on the Listings Portfolio toolbar and Select listing types on Sales Multicalendar and Sales Pricingsales-pricing-active-tag-type-chips.png — not on Finance ledger filters today.

Listing channels (per unit) The Channels tab on a property’s unit in the Listings module: external listing IDs, marketplace URLs, and calendar/booking import links for that unit. This is not the same screen as Account Settings > Integrations (account credentials and account-wide channel rules). Operators usually configure Integrations once, then complete or audit channel links per unit in Listings; for a consolidated grid of connection status, use Sales > Channel Manager.

M

Pair with other glossary clusters

M maintenance, MCP, and management session terms pair O (operations tickets), T (tenant portal), and Automation & AI.

Management session

The signed-in state for a management platform user (platform.vivin.app). After login, Vivin stores a short-lived access token in the browser and keeps a secure httpOnly refresh cookie for silent renewal — API calls that hit an expired access token are retried once after POST /auth/refresh succeeds. Logout in the sidebar user section calls POST /auth/logout, revokes the refresh token server-side, and clears local sign-in state (use this on shared computers). Closing a tab alone does not immediately end the session; you see Your session expired. Please log in again. only when refresh can no longer continue (logout elsewhere, revoked access, or expired refresh cookie). See Getting Started — Staying signed in and logging out and FAQ — Management Account Access.

Market Intelligence Industry term for external benchmarks and competitor context. Portfolio Analytics (/analytics, when your role has analytics.module) surfaces KPI trends separate from Sales; for your live availability and rents, use Sales and Dashboard.

Marketplace (Tenant Services) A feature that allows operators to offer extra services and add-ons to tenants (cleaning, gym memberships, insurance, transportation, etc.), integrated into the booking and billing workflow. See Services Marketplace.

Manual unavailability (manual block)

Hub matrix: Common Workflows — Occupancy KPI to block hygiene handoff. An operator-defined hold on a unit’s calendar (renovations, owner stays, maintenance windows) added from Add unavailability in the unit’s Calendar. Distinct from booked nights and from channel-imported blocks; it affects Vacant Units and availability shown to channels according to your rules — unless Vacant Unit Preference is Include manual blocks (#1427), in which case manual holds still count as free on Dashboard/Sales vacancy surfaces. When Analytics Occupancy or RevPAR dips without a rate change, pair Portfolio KPI review with Common Workflows — Occupancy KPI to block hygiene handoff before you lower rent in Sales → Pricing. For a portfolio-wide table of manual blocks (same underlying records), use Tools → Audit (/audit) when your role has Listings access — see Modules — Audit and Deep Links — Audit. Per-guide mesh: Portfolio KPI review — Occupancy KPI to block hygiene handoff, Manual block hygiene — Occupancy KPI to block hygiene handoff, Processing a New Booking — Occupancy KPI to block hygiene handoff, Onboarding a New Property — Occupancy KPI to block hygiene handoff, Managing a Check-in — Occupancy KPI to block hygiene handoff, Managing a Check-out — Occupancy KPI to block hygiene handoff, Cancelling a Booking — Occupancy KPI to block hygiene handoff, Entering Monthly Utility Bills — Occupancy KPI to block hygiene handoff, Notification triage — Occupancy KPI to block hygiene handoff, Resetting a Management User Password — Occupancy KPI to block hygiene handoff, Using in-app support — Occupancy KPI to block hygiene handoff, Handling a Late Payment — Occupancy KPI to block hygiene handoff.

Model Context Protocol (MCP) An open standard for connecting AI clients to tools and data over HTTP (streamable transport in VIVIN’s servers). The product ships two servers: Landlord MCP (account-scoped operator tools) and Tenant MCP (booking-scoped tenant automation). See Automation & AI.

Move-in The date a tenant physically enters the property. Also called the Occupancy Date or Check-in Date. Tracked in Operations > Check-in & Check-out.

Move-out The date a tenant physically leaves the property. Also called the Check-out Date. Tracked in Operations > Check-in & Check-out.

N

Pair with other glossary clusters

N notification vocabulary pairs Inbox module, Bot reasoning (audit) under B, and FAQ — Notifications & alerts.

Natural numeric sort

Ordering used wherever Vivin sorts internal property or unit names in lists and Select dropdowns (for example Room 2 before Room 10, or AA-11-5D-R2 before AA-11-5D-R10). This replaces plain alphabetic order, which would place Room 10 above Room 2. Sentinel options such as All properties stay at the top of filter menus. Documented examples: Listings — unit order within an expanded property, Operations — Tickets property filter, and Server-driven search picker option lists.

Notifications Alerts for bookings, payments, tickets, and other events. On desktop Dashboard, the header bell opens a slide-over with recent items and Mark all as read; the full Notifications module at /notifications adds search and All / Unread / Read filters (labels follow Interface language) and complete history — open it from the URL or a bookmark; there is no separate Notifications item in the left sidebar. See Deep Links — Notifications. Payment received operator alerts (email + in-app, per-user opt-in) are documented under Payment notification (operator).

Nuki A smart lock integration that allows Vivin to generate temporary access codes for tenants automatically. Connected via API key in Settings > Integrations and linked to properties in the Access Lockers tab.

O

Pair with other glossary clusters

O operations and overpayment terms pair T under T, D under D, and Operations module.

Occupancy Date The date a tenant physically moves into the unit. May differ from the Contract Date. See Getting Started > Dates.

Ongoing (booking status) The management UI label for a stay that is active today — API value current, between move-in/start and end/check-out per your account’s status date basis. List filters often say Ongoing while exports and integrations may still use current. See Booking lifecycle and Bookings — Status Filter Cards.

Owner A person or legal entity entitled to revenue from one or more properties. Owners are registered in Settings > Owners and can be linked when you create or edit a property so payouts and reporting stay aligned with your portfolio structure.

Overage The amount by which a utility bill exceeds the Bills Included ceiling. Automatically charged to tenants when utility bills are entered. See Utilities module.

Overpayment When a tenant pays more than the outstanding amount. The excess becomes a credit applied to future charges. See Payment Allocation.

P

Pair with other glossary clusters

P payment and portal terms pair Credit note (payment reject/revert) under C, Allocation under A, and Payment Allocation.

Operations-only phone shell (management UI)

On an actual mobile phone user agent (iPhone, Android phone, etc.), operators whose role includes the Operations module get a route guard that redirects non-Operations URLs to /operations and limits the mobile drawer to Operations only. iPads, tablets, and desktop browsers resized narrow are not locked — only phone-class user agents trigger the redirect. This is separate from the 768px bottom tab bar inside Operations (width-based on any device). Use a tablet or desktop browser when you need Listings, Bookings, Finance, or other modules from a phone-class device. /settings/support and /notifications still open when bookmarked. Pair with FAQ — Phone shows Operations only, Getting Started — Mobile phones (operations-only shell), Operations — Mobile and narrow layouts, and Deep Links — Operations.

Permission denied toast (management UI)

Red error toast when a signed-in operator triggers an API action their role cannot perform. English copy: You do not have permission to perform this action. (localized per interface language). Replaces generic Forbidden resource 403 responses from the RBAC guard; domain-specific denials keep their own API messages. + Create New greys out disallowed rows up front (Create New menu — Permissions); Finance hides Transactions / Payouts / Deposits without Approve payments (Finance — Access tabs and toolbar). Other buttons may still look clickable until save time. Administrators fix roles in Users and roles — Role Permissions; changes apply on the next page load. Pair with FAQ — Permission denied toast, Error Handling — Authentication errors, and Using in-app support when external clients hit the same 403.

Pause bot (Communication tab)

On Bookings → booking detail → Communication (WhatsApp filter), a Pause bot toggle appears when Vivin has configured a pause label on your WhatsApp business line (chatBotPauseLabelId). Turning it on applies that label so automated bot replies stop for this booking until you turn it off or remove the label. Distinct from manual Add label chips for other tags. See Bookings — Communication tab.

Partial listing feed The shared ListingDto JSON pull (GET /{platform}-integration/listings and GET …/listings/:externalId) — calendar blocks, pricing, availability windows, and booking-oriented fields. Poll every 15–30 minutes for sync and booking import. Housing Anywhere partial rows add a costs array. See Listings & Availability.

Payout An outgoing payment from your company to a property owner (or to the account’s consolidated bank destination) for revenue distribution. Tracked in the Finance > Payouts tab. Batch creation and whether new payouts require manual approval are configured under Settings > Payments — Out Payments (Approval type, Payout Type).

Penalty A late payment fee applied when a tenant misses a due date. Penalty rules (type, frequency, value) are configured in Settings > Payments, but must be manually applied as charges. See the Handling a Late Payment workflow.

Pending manual in-payment (Finance)

Operator-recorded receipt (pending / processing) until Approve payments confirms it — distinct from automatic vIBAN / card rails that post without approval. Full hub: Pending manual receipt approval hub · Pending manual in-payment (Finance) hub (symptom table, surfaces, and per-guide mesh).

Hub matrix: Common Workflows — Pending manual receipt approval. Per-guide mesh: Processing a New Booking — Pending manual receipt approval, Handling a Late Payment — Pending manual receipt approval, Cancelling a Booking — Pending manual receipt approval, Managing a Check-in — Pending manual receipt approval, Portfolio KPI review — Pending manual receipt approval, Managing a Check-out — Pending manual receipt approval, Entering Monthly Utility Bills — Pending manual receipt approval, Notification triage — Pending manual receipt approval, Manual block hygiene — Pending manual receipt approval, Onboarding a New Property — Pending manual receipt approval, Using in-app support — Pending manual receipt approval, Resetting a Management User Password — Pending manual receipt approval. Pair Common Workflows — Finance debt receivables triage when Total Debt or Debt Aging look high until Approve clears the queue (finance-transactions-pending-pill.png, finance-overview-income-chart-debt-aging.png). Pair Common Workflows — Reject/revert mistaken receipts when a duplicate sits in the amber Pending queue — Reject selected, not Approve (finance-transactions-bulk-reject-selected-bar.png). Alert-driven entry: Common Workflows — Notification row-click navigation (/notifications row-click → booking Transactions). When an operator records a receipt with Add Payment (bank transfer, cash, platform, deposit refund, and other manual rails), the row often stays pending until a user with Approve payments confirms it on Finance → Transactions — click the amber Pending chip on the All type-summary card to filter the ledger (Pending pill). Booking Transactions exposes the same queue per reservation. The Manual Payments KPI on Finance → Overview totals every non-rejected manual in-payment in the selected month — including pending rows — so a non-zero figure does not by itself mean the approval queue is clear. The card opens a month drill-down of all manual rails; isolate pending on Finance → Transactions. Until approval, Total Debt, In debt contract lines, and related Dashboard Total Debt (headline and >15 days subtitle — hover the card info icon; see Portfolio KPI review — Dashboard Total Debt subtitle) may still show the pre-receipt balance. On the ledger, Reject is bulk-only — tick rows and use Reject selected (no per-row reject icon); booking Transactions still exposes per-row reject. Reject and Revert modals warn about credit notes when Finance may already have invoiced the charge. Pair with FAQ — Pending manual in-payment on /notifications when the in-app alert outlasts the bank deposit, Notifications — Pending manual in-payments, Glossary — Payment notification (operator) (distinct row types on /notifications), Notification triage — Step 4 when payment alerts arrive before approval, Notification triage — Step 5 after balances reconcile, Payment Allocation — Pending manual approval for the full month-end habit matrix, Processing a New Booking — Step 5b after you record a confirmation receipt, Handling a Late Payment — Step 4b after you record a tenant payment, Managing a Check-in — Step 3b on arrival-week move-in receipts, Entering Monthly Utility Bills — Step 4b after utility overage receipts, Cancelling a Booking — Step 2a after settlement receipts, Portfolio KPI review — Step 7 during month-end Finance reconciliation, and FAQ — Manual receipt still pending.

Finance Transactions — All card with amber Pending chip active and filtered ledger rows

Finance Overview — Manual Payments KPI beside Total Debt (monthly manual total; triage pending rows on Transactions)

Finance Transactions — bulk selection bar with Approve selected and Reject selected

Walkthrough: Finance → Transactions — amber Pending chip → Approve payment (cancel before saving).

Payment notification (operator)

Full hub: Payment notification (operator) (symptom table, surfaces, and per-guide mesh).

Email and in-app alerts to operators when a tenant payment is received (summary like Payment received from tenant … on /notifications and the Dashboard bell) or when a scheduled charge is overdue (balance alerts that row-click into Handling a Late Payment — Steps 1–3 via Notification triage — Step 4 / Step 5 — hub matrix: Common Workflows — Payment notification (operator) (notifications-row-navigate-to-booking-detail.png, notifications-row-navigation-flow.mp4, finance-overview-debt-aging-walkthrough-flow.mp4, handling-a-late-payment-collections-flow.mp4). Per-guide mesh: Processing a New Booking — Payment notification (operator), Cancelling a Booking — Payment notification (operator), Managing a Check-in — Payment notification (operator), Managing a Check-out — Payment notification (operator), Entering Monthly Utility Bills — Payment notification (operator), Handling a Late Payment — Payment notification (operator), Portfolio KPI review — Payment notification (operator), Notification triage — Payment notification (operator), Manual block hygiene — Payment notification (operator), Onboarding a New Property — Payment notification (operator), Using in-app support — Payment notification (operator), Resetting a Management User Password — Payment notification (operator). A separate in-app row type, Pending manual in-payment, appears when an operator-recorded receipt still awaits Approve payments — row-click opens booking Transactions per Common Workflows — Notification row-click navigation and Common Workflows — Pending manual receipt approval; see FAQ — Pending manual in-payment on /notifications and FAQ — Manual receipt still pending. Email delivery requires both: (1) the account-level Receive payment notifications switch in Preferences → Notifications & Emails, and (2) each recipient’s Payment notification emails toggle on Personal Settings (/settings/personal). In-app payment rows add: (3) account Preferences → In-app notifications → Payments master On, and (4) your Your in-app notifications → Payments opt-out On (default). In-app rows are also scoped to opted-in property manager user IDs (visibleToPropertyManagerIds); teammates who did not opt in on Payment notification emails will not see those rows. If the account switch is off, personal opt-in has no effect until an administrator enables it. See also Notifications module, In-app notification preferences, Notification triage, and FAQ & Troubleshooting — Notifications & alerts.

Portfolio filter catalog

Account-wide distinct values that power multi-select and dropdown filters on large directory modules — for example booking tags, property internal names, listing types, property owners, and Others Items categories. The catalog is not recomputed from only the rows already loaded on screen; it reflects your whole account (or the current owner scope where that applies).

ModuleHow the catalog loads
ListingsOnce per session from GET /properties/portfolio/filter-options (tags, types, capacities). Each scroll page still calls GET /properties/portfolio for rows only.
BookingsUsually attached to GET /bookings/portfolio as meta.filterOptions. A dedicated GET /bookings/portfolio/filter-options endpoint returns the same owner/tag/property vocabulary without loading a page of bookings. Tenant category segment names load from the same catalog on Bookings and Tenants.
FinanceTenant category in Other filters is built from categories on bookings already in the Finance cache — not the full account-wide catalog. See FAQ — Finance tenant category filter parity.

On Bookings with the default Unit Name sort, meta.filterOptions.owners can be empty even when Settings → Owners lists owners — the in-memory fallback only sees owner names on loaded row DTOs, which often omit the relation. Workaround: change sort once (for example click Created or pick Creation Date from Sort By) so the response uses the SQL-backed catalog, then reopen Other filters. Finance owner filters use the same owner registry but narrow the Property picker server-side when owners are selected first.

Preparation Days The number of buffer days between a check-out and the next check-in, allowing time for cleaning and inspection. Separate values for mid-term and short-term stays. Configured in Settings > Preferences — Booking Defaults (times and preparation).

Legacy /properties URLs Older /properties bookmarks in the browser; they redirect into Listings (portfolio + property/unit editing). There is no separate card-only workspace. See the dedicated doc (guide subsection index).

Property A physical building or location in your portfolio (e.g., "Central Apartment Building"). Contains one or more units. Managed in the Listings module.

R

Pair with other glossary clusters

R rent, RevPAR, and return-of-value terms pair F (fixed rent), I under I, and FAQ — Bookings.

Rent (Fixed) See Fixed Rent.

Rent (Variable) See Variable Rent.

Rent reduction after invoicing

Full hub: Rent reduction after invoicing (Change monthly rent / Edit amount invoiced-floor blocks, external credit notes relief, Issue credit notes pacing, symptom table, and per-guide mesh).

When Finance has already invoiced rent for a calendar month, repricing below the exported total is blocked in the booking workspace — Contract Info → Change monthly rent clamps exported months (blue Already invoiced months banner) and Contract Values → Edit amount disables Save when net would drop below invoiced+draft totals. Issue external credit notes or manual adjustments first, then push Issue credit notes (N) on Finance → Transactions with the same Hostkit pacing as Bulk Hostkit invoicing. Pair Invoiced floor (rent) for the accounting rule and Month-end invoicing (fixed date) when repricing follows bulk export (bookings-rent-reduction-invoiced-floor-flow.mp4).

RevPAR

Revenue per available room/night — on the Analytics tab RevPAR at /analytics/revpar, the product uses total revenue divided by available nights in the selected month range (see the tab’s information tooltip beside the date range for the exact definition). Same chart layout as Revenue and ADR; distinct from the Dashboard occupancy legend’s ADR (€), which averages monthly rent among occupied units on a single day. See Deep Links — Analytics.

Return of value

A Vivin-internal adjustment on Contract Values that credits value back against an existing allocation on a line (capped by invoiced headroom and remaining allocation). Requires money already allocated; permission bookings.add_return_of_value on Vivin internal accounts only — not a standard operator discount. Pairs with a negative allocation in Finance. See Discounts and payment adjustments and Users and roles.

Role A permission level assigned to a team member that determines which modules and actions they can access. Available roles: Super Admin, Admin, Finance, Sales, Operations Admin, Operations. Configured in Settings > Users.

S

Pair with other glossary clusters

S sales, schedule, and short-term iCal terms pair I under I, O under O, and Sales module.

Same-day turnover

Hub matrix: Common Workflows — Same-day turnover coordination. When a check-out and a check-in fall on the same calendar day for the same unit, operators must coordinate cleaning, inspection, key handover, and (on departure) deposit settlement without assuming the unit is vacant between guests.

SurfaceUse it for
Operations → Check-in & Check-outWeek-ahead lists grouped by day — switch Check-ins / Check-outs, use Next 7 days or Custom, and paste the unit internal name in Search (unit hits rank first).
Operations → TicketsTurnover cleaning and inspection — assign a tight due date before the incoming arrival; far-future jobs may show Draft until the schedule date nears (Draft ticket (display status)).
Bookings → Timeline (/bookings/timeline)Portfolio Gantt — paste the unit in toolbar Search, use Week or Month scale, clear Only bookings when channel or manual blocks share the row.
Sales → Multicalendar (/sales/multicalendar)Sales-scoped Gantt without rent cells — same overlap check while you stay in pricing/availability context; click a bar to open booking detail from Sales.

On departure day, plan deposit settlement (including deposit disputes when deductions are contested) so the incoming guest’s check-in is not blocked by an unresolved refund queue — see Managing a Check-out — Step 5.

Step-by-step: Managing a Check-in and Managing a Check-out. Per-guide mesh: Managing a Check-in — Same-day turnover coordination, Managing a Check-out — Same-day turnover coordination, Processing a New Booking — Same-day turnover coordination, Onboarding a New Property — Same-day turnover coordination, Cancelling a Booking — Same-day turnover coordination, Entering Monthly Utility Bills — Same-day turnover coordination, Manual block hygiene — Same-day turnover coordination, Notification triage — Same-day turnover coordination, Portfolio KPI review — Same-day turnover coordination, Resetting a Management User Password — Same-day turnover coordination, Using in-app support — Same-day turnover coordination, Handling a Late Payment — Same-day turnover coordination. Hub matrix: Common Workflows — Same-day turnover coordination (one-day handover — Step 2 before Step 4; bookings-timeline-day-week-month-and-sidebar.mp4) · Check-in to check-out handoff (mid-stay → departure week). Per-guide mesh: Notification triage — Check-in to check-out handoff, Onboarding a New Property — Check-in to check-out handoff, Cancelling a Booking — Check-in to check-out handoff, Manual block hygiene — Check-in to check-out handoff, Using in-app support — Check-in to check-out handoff, Resetting a Management User Password — Check-in to check-out handoff, Processing a New Booking — Check-in to check-out handoff, Managing a Check-in — Check-in to check-out handoff, Managing a Check-out — Check-in to check-out handoff, Handling a Late Payment — Check-in to check-out handoff, Entering Monthly Utility Bills — Check-in to check-out handoff, Portfolio KPI review — Check-in to check-out handoff. Numbered operator habit: FAQ — Same-day turnovers (Check-in & Check-out → turnover ticket → Timeline / Multicalendar → access times).

Schedule (Operations)

The Vivin internal-only Schedule tab under Operations (/operations/schedule): a wide-screen Gantt-style chart of maintenance tickets by property, with bars spanning from schedule / created dates through due or closed. Use Today and the Day / Week zoom pills to scan ticket bars; click a bar to open Ticket details. Distinct from check-in and check-out events on the Check-in & Check-out tab.

Shared utility connection

When two or more properties use the same utility contract ID for a service (one physical meter or supplier account), Vivin links their Timeline and Cost map attribution. Partial Select properties filters on Cost map can trigger an amber Shared utility connections detected banner listing sibling buildings still out of scope — see the still on Utilities — Cost map tab (utilities-cost-map-shared-contract-alert.png). Maintain IDs on the Utilities > Connections grid and include every property on a shared contract before relying on Cost map colouring or Recalculate allocations. Month-end workflow: Entering Monthly Utility Bills — Step 3.

AI usage ledger

Vivin records each LLM invocation that flows through the metered Anthropic service as one row in ai_usage, scoped to an accountId with feature (landlord_chat for AI Chat, utility_bill_extraction for Utilities PDF extraction), token splits, and internal USD cost. Operators poll GET /ai-usage (paginated call log) and GET /ai-usage/summary (aggregates by feature and model) with a management JWT — see AI usage API and FAQ — AI token usage. There is no dedicated management-frontend screen for this ledger today; month-end habit: Portfolio KPI review — Step 7.

Scheduled Payment See Contract Value — what the tenant is expected to pay and when.

Security Deposit A refundable amount collected at confirmation or check-in, returned (fully or partially) at check-out. Can be fixed or variable (based on rent). Tracked portfolio-wide on Finance > Deposits and per booking on the Deposit tabTotal to refund there is max(0, effective deposit collected + payment-plan balance) before Refund is clicked; after refund, From security deposit / From overpayment balance lines show actual ledger payouts (or a No bank transfer notice when the deposit offset charges only).

Short-term A booking type characterized by nightly or weekly stays (e.g., Airbnb). Short-term bookings use the Short-term Preparation Days setting for turnaround buffers between stays.

Short-term iCal Max Date

Account-wide (and optionally per-listing) cutoff for how far ahead iCal availability is exported to short-term platforms such as Airbnb and Booking.com. Dates after the cutoff appear blocked on external feeds as a safety horizon. Configured under Account Settings > Integrations (Channel Manager block and Apply to all listings / Apply to selected listings on platform cards — see screenshots on that page); you can apply the same date to all units or only selected listings from there.

Short-term iCal pseudo check-in/out

Calendar-only iCal imports (for example Airbnb or Booking.com feeds without a deep API booking) can surface as arrival or departure rows on Operations > Check-in & Check-out even when no mid-term Vivin booking exists for that window. Labels often read Booking.com Reservation or the platform name instead of a tenant name — that is expected for short-stay channel blocks. Use Filters → Stay type → Mid-term when you only want long-stay handovers; use Short-term when reconciling channel turnover with Sales > Multicalendar or the unit Calendar in Listings (see Operations — Other filters, Stay type Short-term).

Operations Check-in &amp; Check-out — Other filters drawer with Stay type Mid-term selected

Operations Check-in &amp; Check-out — Other filters drawer with Stay type Short-term selected (iCal pseudo rows such as Booking.com Reservation visible in the list)

See Managing a Check-in and Managing a Check-out.

Source platform

The channel or origin recorded on a booking (integrationPlatform in the API), such as Uniplaces, Inlife, RoomLess (Spacest), Spotahome, Housing Anywhere, Erasmus Life Lisboa, Edu Portugal, Idealista, Coliving, Channex, Airbnb, Booking.com, the Vivin booking engine, Direct, or Long-stay (LS). On Finance > Transactions, open Other filters and use Select platforms in the Transactions section to narrow the ledger to one or more channels when reconciling bank inflows. Rows without a linked booking are treated as LS for this filter. See Other filters and Financial Reconciliation.

Subscription Your organisation’s Vivin platform billing: plan line items (such as per managed listing, virtual IBAN transfers, and booking-engine usage), payment method on file, and billing period history. Managed under Settings > Subscription; contact Vivin support for plan or payment-method changes.

Support permission The role capability (support.module) that unlocks Account Settings > Support, the floating Help & Support control on desktop, and bookmarkable /settings/support routes for Vivin support threads. In Users and roles, only Administrator and Super administrator roles can be assigned this capability in the matrix. Users with Support but no Account Settings tab permissions see a browse-only /settings shell (disabled tabs, active Support entry) — see Account Settings — Support-only browse layout. See Users and roles and Using in-app support.

Support ticket (Vivin) A conversation thread between your organisation and the Vivin product team, created from Account Settings > Support or the floating Help & Support control when your role has the Support permission. Attachments include images, videos (up to 100 MB each, with inline players in the thread), PDF, and Word documents. Distinct from an operational Ticket (maintenance, cleaning, etc.) in the Operations module. See Using in-app support and Attachments and inline video.

T

Pair with other glossary clusters

T tenant, ticket, and turnover terms pair S under S, D under D, and Tenant Portal.

Tag A classification label for filtering and reporting. Configure vocabulary under Settings > Categories. Apply listing tags on Listings — Tags Tab (Listing tag (filter)); apply booking tags via Bookings and Finance filters (Booking Tag). Property-level tags propagate to all units in the building.

Tenant The person renting a unit. Tenant profiles, activity, and debt visibility live in the Tenants module; each booking also stores tenant contact details for that stay.

Tenant category

Hub matrix: Common Workflows — Portfolio segmentation by tenant category. Per-guide mesh: Onboarding a New Property — Portfolio segmentation by tenant category, Processing a New Booking — Portfolio segmentation by tenant category, Managing a Check-in — Portfolio segmentation by tenant category, Notification triage — Portfolio segmentation by tenant category, Handling a Late Payment — Portfolio segmentation by tenant category, Portfolio KPI review — Portfolio segmentation by tenant category, Managing a Check-out — Portfolio segmentation by tenant category, Cancelling a Booking — Portfolio segmentation by tenant category. Pair FAQ — Finance tenant category filter parity when the Finance drawer omits a segment Bookings already lists.

An account-defined segment assigned to a tenant that controls Tenant Portal access, which portal modules and profile fields are available, Communications / Email behaviour, multiple concurrent bookings, and optional default for integration-created tenants. Configured under Settings > Tenant categories (/settings/tenantCategories); assigned on the Tenants profile (Tenant Info) — Add booking has no category field (FAQ — Assign tenant category for direct booking). Define segments during Onboarding a New Property — Step 4 before the first reservation; assign on direct bookings in Processing a New Booking — Step 2; verify on each arrival in Managing a Check-in — Step 1 before key handover. Portfolio filters: Tenants — Tenant category filter toolbar dropdown, Bookings — Other filters Tenant category multi-select, and Finance — Other filters tenant category on every Finance tab that honours Other filters (OR-combined with No tenant category on all three surfaces). Bookings and Tenants load segment names from the account-wide portfolio filter catalog; Finance builds its drawer list from categories on bookings already in the Finance cache — see the parity tip on Finance — Tenant category filter and FAQ — Finance tenant category filter parity. After you recategorize a tenant on Tenant Info, Vivin force-refreshes Finance caches so filter results catch up within seconds (#2088) — see Finance tenant category cache refresh. Month-end habit: Portfolio KPI review — Step 6 when Analytics ranking points at one segment; after Manual block hygiene when cleared holds still leave a segment-specific occupancy dip; during Entering Monthly Utility Bills — Step 4 when utility overages cluster on one segment; during Managing a Check-out — Step 6 when departure balances cluster before Ended; during Cancelling a Booking — Step 2 when settlement balances cluster before Cancel booking; and during Handling a Late Payment — Step 6 when repeated arrears on one profile type warrant account-wide rule changes. Distinct from booking tags on Categories. Modules hub overview: Modules — Bookings, Modules — Tenants, and Modules — Finance.

Tenant MCP The booking-scoped MCP server for tenant-facing automation: listings calendar, portal links, chatbot rules, maintenance, and related tools identified by tenant email, phone, and/or booking ID. See Tenant MCP. For portfolio-wide tools, see Landlord MCP.

Tenant Portal A web-based, white-labelled interface where tenants can view their payment schedule, contract details, access property information, submit maintenance requests with photos (if enabled), browse add-on services when enabled, and (if enabled) make payments. AI-assisted tenant support runs on external channels such as WhatsApp and email where configured — the portal web UI does not include an in-portal operator chat screen. Operator workflows: Processing a New Booking (portal access after creation), Common Workflows — Confirmation alert triage (Notification triage Step 4 / Step 5Step 5b / Step 6; notifications-row-navigation-flow.mp4, bookings-detail-transactions-approve-payment-modal.png). Per-guide mesh: Manual block hygiene — Confirmation alert triage, Cancelling a Booking — Confirmation alert triage, Managing a Check-out — Confirmation alert triage, Onboarding a New Property — Confirmation alert triage, Processing a New Booking — Confirmation alert triage, Handling a Late Payment — Confirmation alert triage, Managing a Check-in — Confirmation alert triage, Entering Monthly Utility Bills — Confirmation alert triage, Notification triage — Confirmation alert triage, Portfolio KPI review — Confirmation alert triage, Resetting a Management User Password — Confirmation alert triage, Using in-app support — Confirmation alert triage. Common Workflows — Confirmation to check-in handoff (Step 6 → Managing a Check-in — Step 1; bookings-detail-contract-method-of-payments.png, booking-lifecycle-status-tabs-flow.mp4), Managing a Check-in, Handling a Late Payment. See Tenant Portal.

Ticket An actionable operational task (maintenance, cleaning, inspection, tenant request) with priority, status, assignee, due date, and optional Schedule date. Managed in the Operations module. The ticket sidebar Cost allocation panel can link cash flows from the operational ledger and show a signed total. Far-future Schedule date values surface as Draft (display status) in the list — distinct from the saved workflow status. Not the same as a Support ticket (Vivin) to the Vivin team.

Turnover The process of preparing a unit between one tenant's check-out and the next tenant's check-in. Includes cleaning, inspection, repairs, and key changeover. Managed through Operations tickets and automatic maintenance configuration.

U

Pair with other glossary clusters

U uncovered debt and utility terms pair F under F, Utilities module, and FAQ — Utilities.

Unit An individual rentable space within a property (e.g., "Room 101," "Studio A"). Every unit belongs to exactly one property. Also referred to as a "Listing" in some contexts.

Utility overage collections

Full hub: Utility overage collections (bill posting → Payment Plan overage In Debt, Pending receipt mesh, symptom table, and per-guide/module mesh).

When landlord supplier bills post through Entering Monthly Utility Bills Steps 2–4, Vivin adds tenant utility overage lines on booking Payment Plan. When those lines stay Unpaid or Overdue, Handling a Late Payment Steps 1–4 collect the same way as rent arrears — distinct from departure-week Check-out final utilities handoff, rent Cancellation collections before void, and rent Check-out collections before refund. Pair End-of-Booking cost split when Charge Time defers posting until checkout (utilities-allocations-review-flow.mp4).

V

Pair with other glossary clusters

V virtual IBAN and vacancy terms pair P (payout destination), Dashboard module, and Finance module.

Variable Rent A rent amount that changes based on season, demand, or other factors. Different rent values can be configured for different date ranges on a unit. The alternative is Fixed Rent. Configured in the unit's Rent Value tab.

Vacant Unit Preference

Account setting on Preferences → Booking Defaults (#1427): whether a manual block (operator-added unavailability with no booking) still counts as vacant on Dashboard Today and Vacant Units, Sales → Overview Available Now, and Multicalendar / Pricing Available now / Date range filters.

OptionBehaviour
DefaultManual blocks exclude the unit from vacancy KPIs and availability filters (legacy behaviour).
Include manual blocksManually blocked but unbooked units count as free on the surfaces above. OTA/iCal blocks and booking-linked holds still occupy the unit.

Use Include manual blocks when maintenance buffers or owner holds should still appear on Vacant Units for physical-occupancy triage. Pair with Manual block hygiene when counts look wrong after clearing stale holds, and with Common Workflows — Occupancy KPI to block hygiene handoff when Portfolio KPI review — Step 3 Occupancy dips may be hold-driven (analytics-kpi-occupancy-tab.png). See FAQ — Vacant Unit Preference.

Vacant Units (Dashboard)

The bottom-right panel on the post-login Dashboard: listings that are free today — no active booking and no manual block (unless Vacant Unit Preference is Include manual blocks). The headline shows how many units are free; the list sorts by consecutive free days from today (longer projected availability first) with relative vacancy bars. Click a row to act on that unit: roles with Listings edit access open the listing edit sidebar in place; view-only access navigates to /listings/unit/:listingId. See the Vacant Units (Dashboard) row in Visual quick reference.

Visit (direct booking)

Pair with other glossary clusters

A scheduled in-person or remote viewing of a unit or property initiated from the white-label booking engine or connected flows — distinct from a tenant check-in or move-in. Availability and visit options depend on how your booking engine and listings are configured. See Integrations & Distribution.

VAT (Value Added Tax) A consumption tax applied to invoiced items. Rates are configured per charge type (rent, deposit, cleaning fee, admin fee) in Settings > Invoicing.

Virtual IBAN A unique bank account identifier assigned to each tenant for rent payments via bank transfer. Enables zero-commission collection with automatic payment matching — no manual reconciliation needed. See Finance > Automated Rent Collection.

W

Pair with other glossary clusters

W webhook and WhatsApp terms pair I (inbound integration webhooks), N (notifications), and API Reference — Webhooks.

Webhook

Pair with other glossary clusters

Webhook integration pairs with API Reference — Webhooks & notifications, Creating bookings, and Integrations & Distribution. Distinct from in-app Notifications rows. Full pairing matrix: Glossary hub cross-reference.

An HTTPS callback Vivin sends to your server when selected events occur (for example booking or payment lifecycle changes), so integrations can react without polling. Payload shape, signing, and retry behaviour are described in Webhooks & notifications.

Integration booking pipeline

The path from POST …/bookings (queued job, validations, then record creation) is documented for integrators in Creating bookings and Booking lifecycle & validations. That is separate from the computed bookingStatus values operators see in the hub (upcoming, current, ended, canceled — see Booking lifecycle).

White Label Booking Engine See Booking Engine (White Label). A branded booking interface embedded on your website for commission-free direct bookings.

Workflow Automation Rule-based triggers and automated pipelines that eliminate manual steps — from booking confirmation to contract signing, payment reminders, invoice generation, and status updates. See Automation & AI.

Y

Pair with other glossary clusters

Y yearly-average rent calculation pairs Payment Allocation, Bookings module, and Preferences — Cancellation & Rent.

Yearly Average (daily contract rent)

Under Preferences → Cancellation & Rent, Daily Contract — Rent Calculation can use Yearly Average (nightly) instead of Standard (monthly) when the product needs a nightly breakdown for daily-contract math (for example proration and cancellation windows). The alternative derives each night from a monthly rent figure. Affects how scheduled amounts are computed on affected bookings — coordinate with Payment allocation and booking Contract Values when you change the account default.

Glossary deep-dive index

Pair with other glossary clusters

These #### sub-entries expand letter-section terms with module pointers — start from Letter-section index when you know the first letter. Full pairing matrix: Glossary hub cross-reference.

Deep divePair with
Credit note (payment reject/revert)Common Workflows — Reject/revert mistaken receipts, FAQ — Reject or revert an incoming payment (decision table), Payment Allocation — Correcting mistaken receipts, Common Workflows — Pending manual receipt approval, Common Workflows — Rent reduction after invoicing, Finance — Issuing credit notes, Bookings — Row actions on in-payment rows, Finance — Row actions on in-payment rows, Finance — Delete payment on the ledger, Portfolio KPI review — Step 7 (bookings-detail-transactions-reject-modal-credit-note-banner.png, bookings-detail-transactions-revert-modal-info-banner.png, finance-transactions-bulk-reject-selected-bar.png, bookings-payment-row-actions-flow.mp4)
Credit note warning (reject/revert)Glossary — Credit note warning (reject/revert) hub, FAQ — Credit note warning (reject/revert) hub, Glossary — Credit note (payment reject/revert), Common Workflows — Reject/revert mistaken receipts, Common Workflows — Bulk Hostkit invoicing, Finance — Issuing credit notes, Payment Allocation — Correcting mistaken receipts (bookings-detail-transactions-reject-modal-credit-note-banner.png, bookings-detail-transactions-revert-modal-info-banner.png, finance-transactions-bulk-reject-selected-bar.png, bookings-payment-row-actions-flow.mp4)
Invoiced floor (rent)Glossary — Invoiced floor (rent) hub, FAQ — Invoiced floor (rent) hub, Common Workflows — Rent reduction after invoicing, Common Workflows — Bulk Hostkit invoicing (Issue credit notes after external rent relief), FAQ — Lower rent below invoiced, Common Workflows — Reject/revert mistaken receipts, Glossary — Hostkit hub, Bookings — Changing contract dates and rent, Contract Values tab, Finance — Invoiced floor and rent edits, Finance — Issuing credit notes, Processing a New Booking — Rent reduction after invoicing, Handling a Late Payment — Rent reduction after invoicing, Portfolio KPI review — Rent reduction after invoicing, Portfolio KPI review — Step 7 (bookings-detail-change-monthly-rent-modal.png, bookings-detail-contract-values-invoiced-floor-edit-amount.png, bookings-rent-reduction-invoiced-floor-flow.mp4, finance-transactions-bulk-selection-bar.png)
HostkitGlossary — Hostkit hub, FAQ — Hostkit hub, Common Workflows — Bulk Hostkit invoicing, FAQ — Bulk Hostkit invoicing hub, FAQ — Bulk Hostkit invoicing slow, Integrations — Hostkit API pacing, Settings > Invoicing — Hostkit invoice series, Finance — Hostkit invoice links, Finance — Invoice automation (settings-invoicing-hostkit-series.png, finance-transactions-bulk-selection-bar.png)
Tenant categoryCommon Workflows — Portfolio segmentation by tenant category, Common Workflows — Finance debt receivables triage (segment-scoped Top debtors), FAQ — Assign tenant category for direct booking, FAQ — Finance tenant category filter parity, Settings > Tenant categories, Tenants — Tenant Info, Bookings — Other filters, Finance — Tenant category filter, Glossary — Finance tenant category cache refresh, Portfolio KPI review — Step 6, Handling a Late Payment — Step 1 (bookings-list-other-filters-tenant-category.png, finance-other-filters-tenant-category.png, tenants-list-tenant-category-filter.png)
Notification row navigationGlossary — Notification row navigation hub, FAQ — Notification row-click navigation hub, Common Workflows — Notification row-click navigation, Notifications module — Open the related booking, Bookings — Notification row-click navigation, Finance — Notification row-click navigation, Notification triage — Step 4, Glossary — Payment notification (operator), Deep Links — Notifications, Dashboard — Notifications bell (desktop) (notifications-module-row-click-target.png, notifications-row-navigate-to-booking-detail.png, notifications-row-navigation-flow.mp4)
Payment notification (operator)Glossary — Payment notification (operator) hub, FAQ — Payment notification (operator) hub, FAQ — Payment notifications enabled but no email, FAQ — Payment emails but no in-app row, Notifications — Payment received alerts, Notifications — Payment overdue alerts, Common Workflows — Payment alert to receivables triage, Common Workflows — Confirmation alert triage, Glossary — Pending manual in-payment (Finance), Notification triage — Step 4 (notifications-row-navigate-to-booking-detail.png, notifications-row-navigation-flow.mp4)
Pending manual in-payment (Finance)Common Workflows — Pending manual receipt approval, Glossary — Pending manual in-payment (Finance) hub, FAQ — Pending manual receipt approval hub, FAQ — Pending manual in-payment on /notifications, FAQ — Manual receipt still pending, Notifications — Pending manual in-payments, Glossary — Payment notification (operator), Glossary — Payment notification (operator) hub, FAQ — Payment notification (operator) hub, Notification triage — Step 4, Notification triage — Step 5, Bookings > Transactions — Row actions, Payment Allocation — Pending manual approval, Finance — Pending manual payments, FAQ — Dashboard Total Debt subtitle, Portfolio KPI review — Step 7 (finance-transactions-pending-pill.png, finance-overview-kpi-cards.png, finance-transactions-bulk-reject-selected-bar.png, finance-transactions-pending-approve-flow.mp4)
Booking detail sidebar tab load failuresGlossary — Booking sidebar tab load failures hub, Common Workflows — Booking sidebar tab load failures, Common Workflows — Directory list load failures, FAQ — Communication or Tickets load failure, FAQ — Booking sidebar tab load failures hub, Bookings — Sidebar tab load failures, Directory list load failures, Common Workflows — WhatsApp per-booking messaging, Glossary — WhatsApp per-booking messaging hub, Notification triage — Step 4, Handling a Late Payment — Step 3 (bookings-detail-communication-tab-whatsapp-thread.png, bookings-detail-tickets-tab.png)
Directory list load failuresGlossary — Directory list load failures hub, Common Workflows — Directory list load failures, Common Workflows — Booking sidebar tab load failures, FAQ — Directory list load failures hub, FAQ — Directory list load failures, Booking detail sidebar tab load failures, Using in-app support — Inbox load failures, Utilities — Tab load failures, Dashboard — Partial data load failures (notifications-module-load-failure.png, analytics-kpi-load-failure.png)
Vacant Unit PreferenceFAQ — Vacant Unit Preference, Preferences — Vacant Unit Preference, Dashboard — Vacant Units, Manual block hygiene
Deposit lifecycle statusCommon Workflows — Deposit lifecycle status, FAQ — Deposit lifecycle status hub, Finance — Deposit lifecycle status cards, Bookings — Deposit tab, Managing a Check-out — Step 5, Partly collected security deposit, Deposit dispute, Finance Deposits date range (finance-deposits-status-cards.png, bookings-detail-deposit-tab.png, bookings-detail-deposit-tab-ready-to-refund-toggle.png, finance-deposits-tab-mark-refunded-flow.mp4)
Deposit disputeCommon Workflows — Managing a Check-out — Step 5, Cancelling a Booking — Step 3, FAQ — Deposit dispute hub, FAQ — Deposit missing on Finance Deposits, Glossary — Deposit lifecycle status, Glossary — Finance Deposits date range (bookings-detail-deposit-tab-mark-disputed-button.png, bookings-detail-deposit-tab-disputed-state.png, finance-deposits-mark-disputed-row-action.png, finance-deposits-resolve-dispute-row-action.png, deposit-dispute-mark-and-resolve-flow.mp4)
Partly collected security depositCommon Workflows — Partly collected security deposit, Processing a New Booking — Step 5, Managing a Check-in — Step 3, FAQ — Partly collected security deposit hub, FAQ — Partly collected security deposit, Glossary — Deposit lifecycle status, Glossary — Finance Deposits date range, Glossary — Deposit dispute (shortfall vs dispute freeze contrast) (finance-deposits-lifecycle-partial-paid-card.png, bookings-detail-deposit-tab-partial-badge.png, finance-deposits-partial-collection-walkthrough.mp4)
Deposit missing on Finance DepositsCommon Workflows — Deposit missing on Finance Deposits, FAQ — Deposit missing on Finance Deposits hub, FAQ — Deposit missing on Finance Deposits, Glossary — Finance Deposits date range hub, Managing a Check-out — Step 5, Glossary — Partly collected security deposit (empty Partial paid card until range clears) (finance-deposits-date-range-toolbar-default.png, finance-deposits-date-range-toolbar-cleared.png, finance-deposits-date-range-clear-flow.mp4)
Finance Deposits date rangeCommon Workflows — Deposit missing on Finance Deposits, Deposit missing on Finance Deposits hub, FAQ — Deposit missing on Finance Deposits hub, FAQ — Deposit missing on Finance Deposits, Managing a Check-out — Step 5, Glossary — Deposit dispute, Glossary — Partly collected security deposit (empty Partial paid card until range clears) (finance-deposits-date-range-toolbar-default.png, finance-deposits-date-range-toolbar-cleared.png, finance-deposits-date-range-clear-flow.mp4)
Mandatory for contract signingFAQ — Tenant contract signing blocked, Preferences — Mandatory fields before contract signing
Finance income status (Finance Overview)Common Workflows — Finance debt receivables triage, FAQ — Finance Income status drill-down, Finance — Income status drill-down, FAQ — Bookings that owe money, Glossary — Finance Debt Aging, Handling a Late Payment — Step 1, Portfolio KPI review — Step 7 (finance-overview-income-chart-debt-aging.png, finance-overview-income-status-in-debt-modal.png)
Finance Debt Aging (Finance Overview)Common Workflows — Finance debt receivables triage, FAQ — Bookings that owe money, FAQ — Finance Income status drill-down, Finance — Debt Aging panel, Handling a Late Payment — Step 1, FAQ — Uncovered Debt KPI, Portfolio KPI review — Step 7 (finance-overview-debt-aging-expanded-bucket.png, finance-overview-debt-aging-walkthrough-flow.mp4)
Same-day turnoverFAQ — Same-day turnovers, Operations — Check-in & Check-out, Bookings — Timeline, Sales — Multicalendar, Managing a Check-in, Managing a Check-out
Bulk Hostkit invoicingGlossary — Bulk Hostkit invoicing, Glossary — Hostkit hub, Common Workflows — Bulk Hostkit invoicing, Glossary — Hostkit, Month-end invoicing (fixed date), Glossary — Fixed invoice date reminder hub, FAQ — Bulk Hostkit invoicing hub, FAQ — Bulk Hostkit invoicing slow, Finance — Invoice automation (finance-transactions-bulk-selection-bar.png, finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png, settings-invoicing-hostkit-series.png)
Fixed invoice date reminderGlossary — Fixed invoice date reminder hub, FAQ — Fixed invoice date reminder hub, Glossary — Fixed invoice date, Month-end invoicing (fixed date), Common Workflows — Month-end invoicing (fixed date), Bulk Hostkit invoicing, Settings > Invoicing — Default invoice date (finance-transactions-fixed-invoice-date-banner.png, finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png, finance-transaction-detail-fixed-invoice-date-banner.png)
Month-end invoicing (fixed date)Common Workflows — Month-end invoicing (fixed date), Glossary — Fixed invoice date reminder hub, Glossary — Fixed invoice date, Bulk Hostkit invoicing, FAQ — Month-end invoicing (fixed date) hub, FAQ — Fixed invoice date reminder hub, Settings > Invoicing — Default invoice date (settings-invoicing-invoice-date-toggle.png, finance-transactions-fixed-invoice-date-banner.png, finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png, finance-transaction-detail-fixed-invoice-date-banner.png)
Rent reduction after invoicingCommon Workflows — Rent reduction after invoicing, Glossary — Invoiced floor (rent), Bulk Hostkit invoicing (Issue credit notes after external rent relief), FAQ — Rent reduction after invoicing hub, FAQ — Lower rent below invoiced, Bookings — Changing contract dates and rent (bookings-detail-change-monthly-rent-modal.png, bookings-detail-contract-values-invoiced-floor-edit-amount.png, bookings-rent-reduction-invoiced-floor-flow.mp4)
Utility overage collectionsCommon Workflows — Utility overage collections, Glossary — End-of-Booking cost split, Check-out final utilities handoff, FAQ — Utility overage collections hub, Entering Monthly Utility Bills — Step 4, Handling a Late Payment — Step 1 (utilities-allocations-row-breakdown-expanded.png, finance-contract-values-in-debt-filter.png, utilities-allocations-review-flow.mp4)
Check-out final utilities handoffCommon Workflows — Check-out final utilities handoff, Glossary — End-of-Booking cost split, Utility overage collections, FAQ — Check-out final utilities handoff hub, Entering Monthly Utility Bills — Step 4, Managing a Check-out — Step 6 (bookings-detail-payment-plan-tab-schedule.png, utilities-bills-tab-missing-toggle.png, utilities-allocations-review-flow.mp4, bookings-detail-deposit-tab-ready-to-refund-toggle.png)
Check-out collections before refundCommon Workflows — Check-out collections before refund, Check-out final utilities handoff, Check-out ledger cleanup before refund, FAQ — Check-out collections before refund hub, Managing a Check-out — Step 6, Handling a Late Payment — Step 1 (workflows-check-out-coordination-flow.mp4, bookings-detail-payment-plan-tab-schedule.png, finance-contract-values-in-debt-filter.png, bookings-detail-deposit-tab-ready-to-refund-toggle.png)
Check-out ledger cleanup before refundCommon Workflows — Check-out ledger cleanup before refund, Reject/revert mistaken receipts, Check-out collections before refund, FAQ — Check-out ledger cleanup before refund hub, Managing a Check-out — Step 6b (bookings-detail-transactions-revert-modal-info-banner.png, finance-transactions-bulk-reject-selected-bar.png, bookings-detail-deposit-tab-ready-to-refund-toggle.png, bookings-payment-row-actions-flow.mp4)
Cancellation collections before voidCommon Workflows — Cancellation collections before void, Cancelling a Booking — Step 2, Handling a Late Payment — Steps 1–4, FAQ — Cancellation collections before void hub, Check-out collections before refund (departure-week contrast), Check-out ledger cleanup before refund (duplicate settlement contrast) (finance-contract-values-in-debt-filter.png, bookings-detail-payment-plan-tab-schedule.png, bookings-cancel-booking-modal-refund-types.png, workflows-cancel-booking-refund-modal-flow.mp4)
Communication scheduleGetting Started — Tenant communication & lifecycle emails, Settings > Emails
Portfolio filter catalogBookings — Property & Listing filters, Glossary — Directory search ranking
Portfolio retirement decisionsGlossary — Portfolio retirement decisions hub, Common Workflows — Portfolio retirement decisions, Cancel Booking vs Delete Booking, Glossary — Archived property, Glossary — Archived booking ledger visibility, FAQ — Portfolio retirement decisions hub, Manual block hygiene (listings-archived-populated-table.png, listings-archived-unarchive-sidebar.png, bookings-cancel-booking-modal-refund-types.png, finance-transactions-type-summary-cards.png)
FAQ — Portfolio retirement decisionsThree-way table — Archive property (building) vs Cancel booking vs Delete Booking (reservation soft-archive)
Provider platform Delete Booking guardGlossary — Provider platform Delete Booking guard hub, Common Workflows — Provider platform Delete Booking guard, FAQ — Delete Booking on integration reservation hub, Bookings — Provider platform payment, Cancel Booking vs Delete Booking, Bookings — Delete Booking (soft archive), Processing a New Booking — Step 1 (bookings-detail-provider-platform-payment-field.png, bookings-detail-delete-booking-provider-platform-error-toast.png, bookings-provider-platform-reject-delete-flow.mp4)
FAQ — Delete Booking on integration reservationProvider platform Delete Booking guard hubReject or assign provider platform in-payment before soft-archive (#2076)
Wrong tenant on a bookingCommon Workflows — Wrong tenant on a booking, Bookings — Change tenant, Common Workflows — Cancel Booking vs Delete Booking (duplicate row → Delete, not Change tenant), Glossary — Wrong tenant on a booking hub, FAQ — Wrong tenant on a booking hub, Processing a New Booking — Step 6 (bookings-detail-change-tenant-control.png, bookings-detail-change-tenant-modal.png, bookings-detail-change-tenant-flow.mp4)
Cancel Booking vs Delete BookingCommon Workflows — Cancel Booking vs Delete Booking, Bookings — Delete Booking (soft archive), Wrong tenant on a booking (Change tenant vs Delete contrast), Glossary — Cancel Booking vs Delete Booking hub, Glossary — Archived booking ledger visibility (#1897), FAQ — Cancel Booking vs Delete Booking hub, Processing a New Booking — Step 1 (bookings-cancel-booking-modal-refund-types.png, bookings-list-canceled-tab.png, workflows-cancel-booking-refund-modal-flow.mp4)
FAQ — Cancel Booking vs Delete BookingDecision table — Cancel for real stays; Delete soft-archives mistaken rows (#1897 / #2076); bookings-cancel-booking-modal-refund-types.png, bookings-list-canceled-tab.png, workflows-cancel-booking-refund-modal-flow.mp4
Archived propertyGlossary — Archive property (building-level) hub, Common Workflows — Archive property (building-level), FAQ — Archive a property, Listings — Archived properties, Portfolio retirement decisions, Legacy /properties URLs — Archived portfolio, Manual block hygiene (portfolio sunsetting) (listings-archived-populated-table.png, listings-archived-unarchive-sidebar.png)
Archived booking ledger visibilityGlossary — Archived booking ledger visibility hub, Common Workflows — Archived booking ledger visibility, FAQ — Manual payments after Delete Booking hub, Finance — Archived bookings on the ledger, Finance — Type summary cards, Cancel Booking vs Delete Booking, Bookings — Delete Booking (soft archive), Portfolio KPI review — Archived booking ledger visibility (finance-transactions-type-summary-cards.png)
FAQ — Manual payments after Delete BookingArchived booking ledger visibility hubSystem vs Manual Transactions after soft-archive (#1897)
WebhookAPI Reference — Webhooks & notifications, Integrations & Distribution

Glossary cluster cross-reference

Pair with other glossary clusters

Cluster rows pair illustrated terms in Visual quick reference with FAQ sections, concepts, and modules. Setup labels: Setup sequence vocabulary. Full hub map: the Finding your way tip at the top of this page.

Use this table when one term naturally leads into a related cluster — each row links to the FAQ sections, concepts, or modules that expand the definition.

ClusterRepresentative termsPair with
Financial & paymentsCredit note (payment reject/revert), Credit note warning (reject/revert), Invoiced floor (rent), Hostkit, Bulk Hostkit invoicing, Month-end invoicing (fixed date), Rent reduction after invoicing, Deposit lifecycle status, Deposit dispute, Partly collected security deposit, Deposit missing on Finance Deposits, Finance Deposits date range, Uncovered Debt, Pending manual in-payment (Finance), Check-out collections before refund, Check-out ledger cleanup before refund, Cancellation collections before void, Archived booking ledger visibilityFAQ — Payments & Finance, FAQ — Credit note warning (reject/revert) hub, FAQ — Bulk Hostkit invoicing hub, FAQ — Month-end invoicing (fixed date) hub, FAQ — Rent reduction after invoicing hub, FAQ — Deposit lifecycle status hub, FAQ — Deposit dispute hub, FAQ — Partly collected security deposit hub, FAQ — Deposit missing on Finance Deposits hub, FAQ — Pending manual receipt approval hub, FAQ — Check-out collections before refund hub, FAQ — Check-out ledger cleanup before refund hub, FAQ — Cancellation collections before void hub, FAQ — Manual payments after Delete Booking, FAQ — Reject or revert an incoming payment, FAQ — Lower rent below invoiced, FAQ — Bulk Hostkit invoicing slow, FAQ — Dashboard Total Debt subtitle, FAQ — Uncovered Debt KPI, FAQ — Pending manual in-payment on /notifications, FAQ — Manual receipt still pending, FAQ — Deposit missing on Finance Deposits, FAQ — Partly collected security deposit, Payment Allocation, Finance — Invoice automation, Finance — Deposit lifecycle status cards, Finance — Archived bookings on the ledger
Bookings & lifecycleBooking, Lease purpose (booking), Fixed Rent, Invoiced floor (rent), Rent reduction after invoicing, Same-day turnover, Check-out collections before refund, Check-out ledger cleanup before refund, Cancellation collections before void, Deposit dispute, Wrong tenant on a booking, Cancel Booking vs Delete Booking, Portfolio retirement decisions, Provider platform Delete Booking guard hub, Archived booking ledger visibility hub, Archived propertyFAQ — Bookings, FAQ — Wrong tenant on a booking hub, FAQ — Cancel Booking vs Delete Booking, FAQ — Portfolio retirement decisions, FAQ — Delete Booking on integration reservation, Rent reduction after invoicing hub, FAQ — Deposit dispute hub, FAQ — Partly collected security deposit hub, FAQ — Pending manual receipt approval hub, FAQ — Check-out collections before refund hub, FAQ — Check-out ledger cleanup before refund hub, FAQ — Cancellation collections before void hub, FAQ — Manual payments after Delete Booking, FAQ — Fixed rent on variable unit, FAQ — Lower rent below invoiced, FAQ — Archive a property, Booking Lifecycle, Bookings — Change tenant, Bookings — Fixed rent on a variable unit, Listings — Rent Value tab, Bookings — Provider platform payment (#2076), Bookings — Delete Booking (soft archive), Listings — Archived properties
Directory & search UXInfinite scroll (directory loading), Directory list load failures hub, Directory list load failures, Booking sidebar tab load failures hub, Booking detail sidebar tab load failures, Directory search ranking, Portfolio filter catalogCommon Workflows — Directory list load failures, Common Workflows — Booking sidebar tab load failures, FAQ — Directory list load failures, FAQ — Booking sidebar tab load failures hub, FAQ — Communication or Tickets load failure, FAQ — Navigation & shortcuts, Getting Started — Working with Tables, Operations — Tickets toolbar search (#2089 property-level ranking)
Utilities & overagesEnd-of-Booking cost split, Utility overage collections, Check-out final utilities handoff, shared utility connection (visual table)Settings — Charge Time, FAQ — Utility overage collections hub, FAQ — Check-out final utilities handoff hub, FAQ — Entering Monthly Utility Bills hub, Utilities — Smart Cost Distribution, Entering Monthly Utility Bills — Step 3 (#2111)
Navigation & mobile shellOperations-only phone shellFAQ — Phone shows Operations only, Operations — Mobile and narrow layouts, Getting Started — Mobile phones (operations-only shell), Deep Links — Operations
Notifications & messagingNotification row navigation, Payment notification (operator), Bot reasoning (audit), WhatsApp per-booking messaging hub, Booking Communication tab (visual row)Glossary — WhatsApp per-booking messaging hub, Common Workflows — WhatsApp per-booking messaging, Common Workflows — Notification row-click navigation, FAQ — WhatsApp per-booking messaging hub, FAQ — WhatsApp and email per booking, FAQ — Notification row-click navigation, FAQ — Notification row-click navigation hub, FAQ — Notifications & alerts, Glossary — Notification row navigation hub, FAQ — Payment notification (operator) hub, Notifications module — Open the related booking, Notification triage — Step 2, Notification triage — Step 4, Deep Links — Notifications, Inbox module, Bookings — Communication tab
Integrations & APIWebhook, Hostkit, Short-term iCal Max Date, partial vs full feeds (visual table)Glossary — Hostkit hub, FAQ — Hostkit hub, FAQ — Integrations & Distribution, FAQ — Bulk Hostkit invoicing slow, Integrations — Hostkit API pacing, API Reference hub
Automation & AI meteringAI usage ledger (visual table row)FAQ — AI token usage, AI usage API, Automation & AI, AI Chat module, Utilities — AI Invoice Reader
Operations & ticketsDraft ticket (display status), Ticket — linked cash flows, Schedule (Operations), Per-booking maintenance ticket opt-out (#1140)FAQ — Operations, FAQ — Skip automatic tickets for one booking, Operations module, Listings — Maintenances tab, Bookings — Creating a New Booking
Analytics KPIsADR, RevPAR, Analytics (KPI workspace)FAQ — Analytics (KPI workspace), Analytics module, Portfolio KPI review, Dashboard module, Sales module, Manual block hygiene
Dashboard & forecastsDashboard KPI cards, Occupancy Forecast (Dashboard), Cash Flow Forecast (Dashboard), Vacant Units (Dashboard), Vacant Unit Preference (#1427) (visual table rows); ADR (€) legend on occupancy chartFAQ — Dashboard Total Debt subtitle, FAQ — Analytics (KPI workspace), FAQ — Vacant Unit Preference, Preferences — Vacant Unit Preference, Dashboard module, Portfolio KPI review, Analytics module, Visual quick reference
Finance Overview chartsFinance income status, Cash flow forecast (Finance Overview) (visual table rows); seven-card KPI stripFinance module, Portfolio KPI review, Visual quick reference, FAQ — Payments & Finance, FAQ — Uncovered Debt KPI, FAQ — Dashboard Total Debt subtitle
Tenant experienceHostkitGlossary — Hostkit hub, FAQ — Hostkit hub, Common Workflows — Bulk Hostkit invoicing, FAQ — Bulk Hostkit invoicing hub, FAQ — Bulk Hostkit invoicing slow, Integrations — Hostkit API pacing, Settings > Invoicing — Hostkit invoice series, Finance — Hostkit invoice links, Finance — Invoice automation (settings-invoicing-hostkit-series.png, finance-transactions-bulk-selection-bar.png)
Tenant category, Mandatory for contract signing, Lifecycle check-in email, Tenant Portal entries, services catalogueFAQ — Assign tenant category for direct booking, FAQ — Tenant Portal, FAQ — Tenant contract signing blocked, FAQ — Automatic check-in email, Tenant Portal — Digital contract signing, Emails — When lifecycle check-in emails send, Settings > Tenant categories, Bookings — Other filters, Services Marketplace
Listings & portfolioArchive property (building-level) hub, Archived property, Property edit sidebar pills, Infinite scroll (directory loading) (Portfolio + Archived)FAQ — Properties & Listings, FAQ — Archive a property, Listings — Archived properties, Onboarding a New Property, Manual block hygiene
First-time setupManagement session (sign-in), Permission denied toast, Property edit sidebar pills, Tenant category, Communication schedule, Deposit dispute, Draft ticket (display status), Finance Deposits date range, Per-booking maintenance ticket opt-out (#1140)Getting Started — Recommended Setup Sequence (steps 1–15 hub; step 3 Users prevents permission toasts), Users and roles — Role Permissions, Create New menu — Permissions, Listings — Editing Properties (#2082 pills), Listings — Maintenances tab, Account Settings — Recommended setup order (steps 1–12 tab map), FAQ — Permission denied toast, Onboarding a New Property (guided steps 4–12)

Step-by-step setup procedures: Getting Started — Recommended Setup Sequence (steps 1–12 tab map: Account Settings — Recommended setup order). Troubleshooting when a term does not match on-screen behaviour: FAQ & Troubleshooting (hub: FAQ — Section cross-reference, FAQ subsection cross-reference).

Glossary hub cross-reference

Pair with other glossary clusters

This table pairs Related subsections below with setup, modules, and escalation hubs. Term clusters: Glossary cluster cross-reference above. Full hub map: the Finding your way tip at the top of this page.

Use this table when one glossary hub topic naturally leads into another — each row links to the sections you should read before or after the primary topic.

| Section | Pair with these sections | | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Letter-section index | Visual quick reference (illustrated terms), Glossary deep-dive index (#### sub-entries), Glossary cluster cross-reference (topic clusters) | | Glossary deep-dive index | Letter-section index (A–Y jump table), Getting Started hub subsection index (onboarding sections), Concepts hub subsection index (underlying models), Modules hub subsection index (screen workspaces), Common Workflows hub subsection index (operational procedures), Account Settings hub subsection index (setup tabs), FAQ subsection cross-reference (troubleshooting pairs), Glossary cluster cross-reference | | Setup sequence after go-live | Getting Started — Recommended Setup Sequence (steps 1–15), Onboarding a New Property — Step 7, Support — Setup sequence escalation, Setup sequence vocabulary | | Documentation map & escalation | Introduction — Section cross-reference, Introduction hub subsection index, Getting Started hub subsection index, Concepts hub subsection index, Modules hub subsection index, API hub subsection index, FAQ — Section cross-reference, Support — Section cross-reference, Common Workflows section cross-reference, Using in-app support | | Navigation & bookmarks | Management Frontend Deep Links, Create New menu, Getting Started — Bookmarkable routes, Settings > Interface language | | Setup sequence vocabulary | Getting Started — Recommended Setup Sequence, Account Settings — Recommended setup order, Glossary cluster cross-reference (first-time setup row) | | FAQ quick reference | FAQ — Section cross-reference, FAQ — Navigation & shortcuts, FAQ — Payments & Finance, FAQ — Bookings | | Concepts & integrations | Payment Allocation, Tenant Portal, API Reference hub, Integrations & Distribution | | Settings vocabulary | Account Settings — Tab cross-reference, Settings > Emails, Settings > Integrations, Settings > Categories | | Operator workflows | Common Workflows — Workflow cross-reference, Portfolio KPI review, Notification triage, Managing a Check-out & Deposit Refund | | Deeper workflow reads | Portfolio KPI review, Manual block hygiene, Managing a Check-out | | Key glossary terms | Glossary cluster cross-reference, Visual quick reference, FAQ — Key glossary terms, Support — Key glossary terms | | Lockout catch-up after password recovery | Sign-in restored after password reset; onboarding, alert, or month-end backlog accumulated during lockout | Glossary — Lockout catch-up after password recovery hub, FAQ — Lockout catch-up after password recovery hub, Common Workflows — Lockout catch-up after password recovery, Getting Started — Lockout catch-up after password recovery, Resetting a Management User Password, Pending manual receipt approval, Directory list load failures hub (workflows-login-reset-password-link.png, notifications-row-navigate-to-booking-detail.png, finance-transactions-pending-pill.png) | | Walkthrough media | MP4 walkthroughs beside PNG screenshots | Common Workflows — Walkthrough media, Modules, Account Settings | | Notification row-click navigation | /notifications row-click into modules before bulk mark-read | Glossary — Notification row navigation hub, FAQ — Notification row-click navigation hub, Common Workflows — Notification row-click navigation, Glossary — Notification row navigation, Notifications module, Notification triage — Step 4, FAQ — Notification row-click (notifications-module-row-click-target.png, notifications-row-navigation-flow.mp4) | | Directory list load failures | First-fetch directory or dashboard aggregate failure — Failed to load … + Retry / Try again; distinct from filter-empty zero rows and booking-sidebar tab errors | Glossary — Directory list load failures hub, FAQ — Directory list load failures hub, Common Workflows — Directory list load failures, Glossary — Booking sidebar tab load failures hub, Glossary — Booking detail sidebar tab load failures, FAQ — Booking sidebar tab load failures hub (notifications-module-load-failure.png, audit-manual-blocks-load-failure.png, dashboard-partial-data-load-failure.png, analytics-kpi-load-failure.png) | | Booking sidebar tab load failures | Tab-scoped Refresh / Retry inside one booking when Communication or Tickets fail — Payment Plan may still load | Glossary — Booking sidebar tab load failures hub, FAQ — Booking sidebar tab load failures hub, Common Workflows — Booking sidebar tab load failures, Glossary — Booking detail sidebar tab load failures, Glossary — Directory list load failures hub, Glossary — WhatsApp per-booking messaging hub, Bookings — Sidebar tab load failures (bookings-detail-communication-tab-whatsapp-thread.png, bookings-detail-tickets-tab.png) | | WhatsApp per-booking messaging | Inbox, bell Inbox, or Bookings → Communication for tenant WhatsApp / email — same UAZAPI state, different triage scope | Glossary — WhatsApp per-booking messaging hub, FAQ — WhatsApp per-booking messaging hub, Common Workflows — WhatsApp per-booking messaging, FAQ — WhatsApp and email per booking, Glossary — Notification row navigation hub, Bookings — Communication tab, Inbox module (bookings-detail-communication-tab-whatsapp-thread.png, inbox-module-overview.png, inbox-module-triage-flow.mp4) | | Bot reasoning (audit) | Expand Reasoning under Bot bubbles on Communication → WhatsApp — read-only audit vs ChatBot persona / IF/THEN edits | Glossary — Bot reasoning (audit) hub, FAQ — Bot reasoning (audit) hub, Common Workflows — Bot reasoning (audit), Glossary — ChatBot settings hub, ChatBot settings, Bookings — Communication tab (bookings-detail-communication-tab-bot-reasoning-expanded.png) | | ChatBot settings | Persona, IF/THEN rules, and Status Bot WhatsApp pairing — distinct from operator AI Chat | Glossary — ChatBot settings hub, FAQ — ChatBot settings hub, Common Workflows — ChatBot settings, Glossary — Bot reasoning (audit) hub, ChatBot settings, Inbox — Chatbot gating (settings-chatbot-tab-overview.png, settings-chatbot-status-bot-connected.png, settings-chatbot-save-rule-flow.mp4) | | Payment notification (operator) | Operator payment received / payment overdue email + in-app opt-in layers and row-type triage | Glossary — Payment notification (operator) hub, FAQ — Payment notification (operator) hub, Notifications — Payment received alerts, Notifications — Payment overdue alerts, Common Workflows — Payment alert to receivables triage, Common Workflows — Confirmation alert triage, Glossary — Pending manual in-payment (Finance) | | Payment notification (operator) | Operator payment received / payment overdue email + in-app opt-in layers and row-type triage | Glossary — Payment notification (operator) hub, FAQ — Payment notification (operator) hub, Notifications — Payment received alerts, Notifications — Payment overdue alerts, Common Workflows — Payment alert to receivables triage, Common Workflows — Confirmation alert triage, Glossary — Pending manual in-payment (Finance) | | Payment alert to receivables triage | Ongoing/Ended payment overdue alerts → receivables before collections | Glossary — Payment alert to receivables triage hub, FAQ — Payment alert to receivables triage hub, Common Workflows — Payment alert to receivables triage, Glossary — Payment notification (operator), Finance module, Handling a Late Payment — Step 1 (notifications-row-navigate-to-booking-detail.png, notifications-row-navigation-flow.mp4) | | Confirmation alert triage | Upcoming Booking created / Payment received before mark-read | Glossary — Confirmation alert triage hub, FAQ — Confirmation alert triage hub, Common Workflows — Confirmation alert triage, Glossary — Pending manual in-payment (Finance), Processing a New Booking — Step 5b / Step 6 (notifications-row-navigate-to-booking-detail.png, bookings-detail-transactions-approve-payment-modal.png, notifications-row-navigation-flow.mp4) | | Finance debt receivables triage | Portfolio Total Debt, Debt Aging Top debtors, and Uncovered Debt after alert triage | Glossary — Finance debt receivables triage hub, Glossary — Handling a Late Payment collections hub, Glossary — Uncovered Debt hub, FAQ — Finance debt receivables triage hub, FAQ — Handling a Late Payment collections hub, FAQ — Uncovered Debt KPI hub, Common Workflows — Finance debt receivables triage, Common Workflows — Handling a Late Payment collections hub, Common Workflows — Uncovered Debt KPI, Glossary — Finance Debt Aging (Finance Overview), Finance module — Finance debt receivables triage, Handling a Late Payment — Step 1 (finance-overview-income-chart-debt-aging.png, finance-overview-debt-aging-walkthrough-flow.mp4, finance-overview-kpi-cards.png) | | Handling a Late Payment collections | Receivables triage surfaces → Handling a Late Payment Steps 1–6 collections follow-through after Debt Aging / alert row-click | Glossary — Handling a Late Payment collections hub, FAQ — Handling a Late Payment collections hub, Common Workflows — Handling a Late Payment collections hub, Finance debt receivables triage, Payment alert to receivables triage, Pending manual receipt approval, Handling a Late Payment — Step 1 (finance-overview-income-chart-debt-aging.png, notifications-row-navigate-to-booking-detail.png, finance-overview-debt-aging-walkthrough-flow.mp4) | | Uncovered Debt | Finance Total Debt minus deposit offsets — thin coverage when Uncovered DebtTotal Debt | Glossary — Uncovered Debt hub, FAQ — Uncovered Debt KPI hub, Common Workflows — Uncovered Debt KPI, Finance debt receivables triage, Glossary — Partly collected security deposit, Portfolio KPI review — Step 7 (finance-overview-kpi-cards.png, finance-overview-debt-aging-expanded-bucket.png, dashboard-kpi-total-debt-tooltip.png) | | Finance Income status drill-down | Income chart Paid / Scheduled / In debt segment-click vs Debt Aging | Glossary — Finance Income status drill-down hub, FAQ — Finance Income status drill-down hub, Common Workflows — Finance Income status drill-down, Glossary — Finance income status (Finance Overview), Finance module — Income status drill-down (finance-overview-income-status-in-debt-modal.png, finance-overview-income-drill-down-flow.mp4) | | Cash flow forecast drill-down | Finance Cash flow forecast collections bar-click — not Dashboard rent due chart | Glossary — Cash flow forecast drill-down hub, FAQ — Cash flow forecast drill-down hub, Common Workflows — Cash flow forecast drill-down, Glossary — Cash flow forecast (Finance Overview), Finance module — Income chart and cash flow forecast (finance-overview-cash-flow-all-payments-modal.png, finance-overview-cash-flow-drill-down-flow.mp4) | | Same-day turnover coordination | Shared-unit check-out + check-in on one calendar day — departure Steps 1–2 before incoming key handover | Glossary — Same-day turnover coordination hub, Common Workflows — Same-day turnover coordination, Glossary — Same-day turnover, Operations module — Same-day turnover coordination, FAQ — Same-day turnover coordination, FAQ — Same-day turnovers (operations-check-in-out-check-outs-next-7-days.png, operations-add-ticket-modal.png, bookings-timeline-day-week-month-and-sidebar.mp4) | | Hostkit | Per-listing Listing keys + FR invoice series before Issue allocation / see invoice | Glossary — Hostkit hub, FAQ — Hostkit hub, Integrations — Hostkit API pacing, Settings > Invoicing — Hostkit invoice series, Finance — Hostkit invoice links (settings-invoicing-hostkit-series.png, finance-transactions-bulk-selection-bar.png) | | Bulk Hostkit invoicing | Month-end Issue allocation / Invoice selected paces Hostkit — refresh Transactions before re-issue | Common Workflows — Bulk Hostkit invoicing, Glossary — Bulk Hostkit invoicing hub, Glossary — Hostkit hub, Glossary — Hostkit, Month-end invoicing (fixed date), Settings > Integrations — Hostkit API pacing, FAQ — Bulk Hostkit invoicing hub, FAQ — Bulk Hostkit invoicing slow | | Month-end invoicing (fixed date) | Fixed Invoice date before bulk Issue allocation — toggle Use today back on after batch | Common Workflows — Month-end invoicing (fixed date), Glossary — Fixed invoice date reminder hub, FAQ — Fixed invoice date reminder hub, FAQ — Month-end invoicing (fixed date) hub, Bulk Hostkit invoicing (settings-invoicing-invoice-date-toggle.png, finance-transactions-fixed-invoice-date-banner.png, finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png) | | Fixed invoice date reminder | Amber banner on Finance → Transactions and transaction detail when fixed Invoice date is saved | Glossary — Fixed invoice date reminder hub, FAQ — Fixed invoice date reminder hub, Month-end invoicing (fixed date), Invoicing — Default invoice date (finance-transactions-fixed-invoice-date-banner.png, finance-transaction-detail-fixed-invoice-date-banner.png) | | Rent reduction after invoicing | Change monthly rent / Edit amount blocked below exported rent — external credit notes then Issue credit notes | Common Workflows — Rent reduction after invoicing, Glossary — Invoiced floor (rent), Bookings module — Rent reduction after invoicing, FAQ — Rent reduction after invoicing hub, FAQ — Lower rent below invoiced | | Occupancy KPI to block hygiene handoff | Analytics Occupancy / RevPAR dip without rate change — stale manual holds before category or pricing edits | Glossary — Occupancy KPI to block hygiene handoff hub, Common Workflows — Occupancy KPI to block hygiene handoff, Glossary — Manual unavailability (manual block), Glossary — Vacant Unit Preference, Audit module, FAQ — Occupancy KPI to block hygiene handoff hub (analytics-kpi-occupancy-tab.png, audit-manual-blocks-workspace.png, audit-manual-blocks-filter-scroll.mp4) | | Utility overage collections | Unpaid utility overage on Payment Plan after bill posting — not departure-week final bills alone | Common Workflows — Utility overage collections, Glossary — End-of-Booking cost split, Entering Monthly Utility Bills — Step 4, FAQ — Utility overage collections (utilities-allocations-row-breakdown-expanded.png, finance-contract-values-in-debt-filter.png, utilities-allocations-review-flow.mp4) | | Check-out final utilities handoff | Final supplier bills + utility overage on Payment Plan before Ready To Refund | Common Workflows — Check-out final utilities handoff, Glossary — End-of-Booking cost split, Entering Monthly Utility Bills — Step 4, FAQ — Check-out final utilities handoff (utilities-allocations-review-flow.mp4) | | Check-out collections before refund | Rent/fee In Debt on Payment Plan blocks deposit release — not utility overage alone | Common Workflows — Check-out collections before refund, Managing a Check-out — Step 6, Handling a Late Payment — Step 1, FAQ — Check-out collections before refund (workflows-check-out-coordination-flow.mp4, bookings-detail-payment-plan-tab-schedule.png, finance-contract-values-in-debt-filter.png, bookings-detail-deposit-tab-ready-to-refund-toggle.png) | | Cancellation collections before void | Pre-cancel rent/fee In Debt blocks Cancel booking until Payment Plan settles — not departure-week refund mesh | Common Workflows — Cancellation collections before void, Cancelling a Booking — Step 2, Handling a Late Payment — Steps 1–4, FAQ — Cancellation collections before void hub (finance-contract-values-in-debt-filter.png, bookings-detail-payment-plan-tab-schedule.png, bookings-cancel-booking-modal-refund-types.png, workflows-cancel-booking-refund-modal-flow.mp4) | | Deposit lifecycle status | Payment-driven depositStatus pill on booking Deposit tab and Finance → Deposits lifecycle cards — parent vocabulary for shortfall, dispute, and refund meshes | Common Workflows — Deposit lifecycle status, FAQ — Deposit lifecycle status hub, Finance — Deposit lifecycle status cards, Partly collected security deposit (Partial Paid), Deposit dispute (Disputed), Finance Deposits date range (card counts scoped to toolbar window) (finance-deposits-status-cards.png, bookings-detail-deposit-tab.png, finance-deposits-tab-mark-refunded-flow.mp4) | | Deposit dispute | Contested retention on Fully Paid deposit blocks Refund / Mark refunded until Resolve Dispute — not rent Check-out collections before refund or deposit shortfall mesh | Managing a Check-out — Step 5, Cancelling a Booking — Step 3, FAQ — Deposit dispute hub, Glossary — Deposit lifecycle status, Partly collected security deposit (shortfall contrast) (bookings-detail-deposit-tab-mark-disputed-button.png, bookings-detail-deposit-tab-disputed-state.png, finance-deposits-mark-disputed-row-action.png, finance-deposits-resolve-dispute-row-action.png, deposit-dispute-mark-and-resolve-flow.mp4) | | Partly collected security deposit | Paid above zero but below Amount on security deposit — distinct from rent Partial Paid on Payment Plan and Deposit dispute freeze on Fully Paid deposits | Common Workflows — Partly collected security deposit, Processing a New Booking — Step 5, Managing a Check-in — Step 3, FAQ — Partly collected security deposit hub, Glossary — Deposit lifecycle status, Deposit dispute (dispute freeze contrast) (finance-deposits-lifecycle-partial-paid-card.png, bookings-detail-deposit-tab-partial-badge.png, finance-deposits-partial-collection-walkthrough.mp4) | | Deposit missing on Finance Deposits | Booking Deposit tab shows data but Finance → Deposits row is hidden — default ~3 months toolbar date range | Common Workflows — Deposit missing on Finance Deposits, FAQ — Deposit missing on Finance Deposits hub, Glossary — Finance Deposits date range hub, Partly collected security deposit (empty Partial paid card until range clears), Deposit dispute (dispute chips hidden on filtered rows) (finance-deposits-date-range-toolbar-default.png, finance-deposits-date-range-toolbar-cleared.png, finance-deposits-date-range-clear-flow.mp4) | | Finance Deposits date range | Default ~3 months toolbar window on Finance → Deposits — row, lifecycle counts, dispute chips, and Export hide until clear or widen | Common Workflows — Deposit missing on Finance Deposits, Deposit missing on Finance Deposits hub, FAQ — Deposit missing on Finance Deposits hub, Managing a Check-out — Step 5, Partly collected security deposit (empty Partial paid card until range clears), Deposit dispute (dispute chips hidden on filtered rows) (finance-deposits-date-range-toolbar-default.png, finance-deposits-date-range-toolbar-cleared.png, finance-deposits-date-range-clear-flow.mp4) | | Wrong tenant on a booking | Valid Upcoming reservation linked to wrong tenant profile — Change tenant on Contract Info, not duplicate-row Delete Booking or Cancel booking | Glossary — Wrong tenant on a booking hub, Common Workflows — Wrong tenant on a booking, FAQ — Wrong tenant on a booking hub, Bookings — Change tenant, Common Workflows — Cancel Booking vs Delete Booking, Processing a New Booking — Step 6 (bookings-detail-change-tenant-control.png, bookings-detail-change-tenant-modal.png, bookings-detail-change-tenant-flow.mp4) | | Cancel Booking vs Delete Booking | Real stay voided under policy → Cancel booking (refund dialog, Canceled filter, full ledger); mistaken/test row → Delete Booking soft-archive (Manual Transactions hidden — #1897); clear provider platform in-payment before Delete (#2076) | Glossary — Cancel Booking vs Delete Booking hub, Common Workflows — Cancel Booking vs Delete Booking, Cancelling a Booking — Step 4, Bookings — Delete Booking (soft archive), Wrong tenant on a booking (Change tenant contrast), FAQ — Cancel Booking vs Delete Booking hub (bookings-cancel-booking-modal-refund-types.png, bookings-list-canceled-tab.png, workflows-cancel-booking-refund-modal-flow.mp4) | | Check-out vs cancellation | Completed stay → Ended (Managing a Check-out — Step 7) vs policy void → Canceled (Cancelling a Booking — Step 4) — not Delete Booking for mistaken rows | Glossary — Check-out vs cancellation hub, Common Workflows — Check-out vs cancellation, FAQ — Check-out vs cancellation, Cancel Booking vs Delete Booking, Cancellation collections before void, Check-out collections before refund (workflows-cancel-booking-refund-modal-flow.mp4, bookings-cancel-booking-modal-refund-types.png, bookings-list-canceled-tab.png, bookings-detail-deposit-tab-ready-to-refund-toggle.png) | | Portfolio retirement decisions | Building Archive vs reservation Cancel vs Delete Booking — three scopes with different list visibility and ledger outcomes | Glossary — Portfolio retirement decisions hub, Glossary — Archive property (building-level) hub, Common Workflows — Portfolio retirement decisions, Common Workflows — Archive property (building-level), Cancel Booking vs Delete Booking, Glossary — Archived property, Glossary — Archived booking ledger visibility, FAQ — Portfolio retirement decisions hub, FAQ — Archive a property (listings-archived-populated-table.png, listings-archived-unarchive-sidebar.png, bookings-cancel-booking-modal-refund-types.png, finance-transactions-type-summary-cards.png) | | Provider platform Delete Booking guard | Integration bookings with pending provider platform in-payment block Delete Booking until Rejected or assigned (#2076) | Glossary — Provider platform Delete Booking guard hub, Common Workflows — Provider platform Delete Booking guard, FAQ — Delete Booking on integration reservation hub, Bookings — Provider platform payment, Cancel Booking vs Delete Booking, Bookings — Delete Booking (soft archive), Processing a New Booking — Step 1 (bookings-detail-provider-platform-payment-field.png, bookings-detail-delete-booking-provider-platform-error-toast.png, bookings-provider-platform-reject-delete-flow.mp4) | | Archived booking ledger visibility | After Delete Booking, Finance → Transactions hides Manual Transactions for that reservation; System Transactions (vIBAN, credit card) stay (#1897) | Glossary — Archived booking ledger visibility hub, Common Workflows — Archived booking ledger visibility, FAQ — Manual payments after Delete Booking hub, Finance — Archived bookings on the ledger, Finance — Type summary cards, Cancel Booking vs Delete Booking, Portfolio retirement decisions, Bookings — Delete Booking (soft archive), Portfolio KPI review — Step 7 (finance-transactions-type-summary-cards.png) | | Check-out ledger cleanup before refund | Tenant paid once but duplicate transfer leaves phantom In Debt before refund | Common Workflows — Check-out ledger cleanup before refund, Reject/revert mistaken receipts, Managing a Check-out — Step 6b, FAQ — Check-out ledger cleanup before refund (bookings-detail-transactions-revert-modal-info-banner.png, finance-transactions-bulk-reject-selected-bar.png, bookings-detail-deposit-tab-ready-to-refund-toggle.png, bookings-payment-row-actions-flow.mp4) | | New inventory to first booking handoff | Property wizard (Steps 1–7) → first Upcoming reservation on new inventory | Common Workflows — New inventory to first booking handoff, Onboarding — Step 7Processing a New Booking — Step 1 / Step 6, FAQ — New inventory to first booking handoff (listings-module-overview.png, bookings-add-booking-modal.png, workflows-onboarding-property-wizard.mp4) | | Property setup to first arrival handoff | Go-live inventory (Steps 1–7) → first arrival week ~7 days before move-in | Common Workflows — Property setup to first arrival handoff, Onboarding — Step 7Managing a Check-in — Step 1, FAQ — Property setup to first arrival handoff (listings-property-edit-access-lockers-tab.png, workflows-onboarding-property-wizard.mp4, workflows-operations-check-in-out-planning-view.png) | | Confirmation to check-in handoff | Upcoming portal gates → arrival-week planning ~7 days before move-in | Glossary — Confirmation to check-in handoff hub, FAQ — Confirmation to check-in handoff, Common Workflows — Confirmation to check-in handoff, Processing a New Booking — Step 6Managing a Check-in — Step 1 (bookings-detail-contract-method-of-payments.png, booking-lifecycle-status-tabs-flow.mp4, workflows-operations-check-in-out-planning-view.png) | | Check-in to check-out handoff | Mid-stay Ongoing after keys handed over — switch to departure-week workflow ~7 days before checkout | Glossary — Check-in to check-out handoff hub, FAQ — Check-in to check-out handoff, Common Workflows — Check-in to check-out handoff, Managing a Check-in — Step 4Managing a Check-out — Step 1 (operations-check-in-out-check-outs-next-7-days.png, bookings-timeline-view.png) | | Portfolio segmentation by tenant category | Review only corporate, short-stay, or unassigned tenants across reservations, receivables, and profiles | Glossary — Portfolio segmentation by tenant category hub, Common Workflows — Portfolio segmentation by tenant category, Settings > Tenant categories, Glossary — Tenant category, FAQ — Portfolio segmentation by tenant category hub, FAQ — Finance tenant category filter parity (bookings-list-other-filters-tenant-category.png, finance-other-filters-tenant-category.png, tenants-list-tenant-category-filter.png) | | Pending manual receipt approval | Recorded bank transfers still pending until Approve paymentsTotal Debt / In debt lag | Glossary — Pending manual receipt approval hub, FAQ — Pending manual receipt approval hub, Common Workflows — Pending manual receipt approval, Glossary — Pending manual in-payment (Finance) hub, Payment Allocation, FAQ — Manual receipt still pending (finance-transactions-pending-pill.png, finance-transactions-pending-approve-flow.mp4) | | Reject/revert mistaken receipts | Duplicate bank transfer or wrong booking — Reject while pending; Revert after Approve; Issue credit notes when Finance already invoiced | Glossary — Reject/revert mistaken receipts hub, FAQ — Reject/revert mistaken receipts hub, Common Workflows — Reject/revert mistaken receipts, Credit note warning (reject/revert), Glossary — Credit note warning (reject/revert) hub, Payment Allocation — Correcting mistaken receipts, FAQ — Reject or revert an incoming payment (bookings-detail-transactions-reject-modal-credit-note-banner.png, bookings-payment-row-actions-flow.mp4) | | Module documentation hubs | Modules — Module cross-reference, Finance module, Bookings module, Support — Module documentation hubs |

Pair with other glossary clusters

Related below links term definitions to setup, modules, workflows, and escalation paths. Pair Setup sequence after go-live with Getting Started — Recommended Setup Sequence; pair Documentation map & escalation with FAQ — Section cross-reference. Each Related subsection has a row in Glossary hub cross-reference above. Full pairing matrix: Glossary hub cross-reference.

Setup sequence after go-live

Pair with other glossary clusters

Post-go-live pairing starts with Getting Started — Recommended Setup Sequence (steps 1–15) and Setup sequence vocabulary. When a definition still disagrees with the live product, continue to Support — Setup sequence escalation. Full pairing matrix: Glossary hub cross-reference.

Documentation map & escalation

Pair with other glossary clusters

Setup sequence vocabulary

Pair with other glossary clusters

FAQ quick reference

Pair with other glossary clusters

FAQ sections expand illustrated terms in Visual quick reference and Glossary cluster cross-reference. Full pairing matrix: Glossary hub cross-reference.

Concepts & integrations

Pair with other glossary clusters

Concept reads pair with Integrations & API cluster rows and API Reference hub. Tenant-facing: Tenant Portal. Full pairing matrix: Glossary hub cross-reference.

  • Management Frontend Deep Links — Bookmarkable routes for modules and tabs named in definitions
  • Payment Allocation — Two-layer receipts, invoiced-floor rent edits, and credit note reject/revert vocabulary
  • Tenant Portal — Booking-scoped tenant self-service vocabulary (payments, contract signing, Requests)
  • Services Marketplace — Ancillary tenant revenue catalogue and portal purchases
  • Tenant MCP — Booking-scoped automation vocabulary paired with portal and chatbot terms
  • Create New menu — Operator quick-create vocabulary used in several glossary entries
  • API Reference — Integrator terminology (partial vs full feeds, webhooks, landlordKey)

Settings vocabulary

Pair with other glossary clusters

Settings tabs here pair with Account Settings — Tab cross-reference and letter-section definitions in this glossary. Full pairing matrix: Glossary hub cross-reference.

Operator workflows

Pair with other glossary clusters

Workflow bullets apply glossary terms in daily operator work — pair with Common Workflows — Workflow cross-reference. Month-end: Portfolio KPI review. Full pairing matrix: Glossary hub cross-reference.

Deeper workflow reads

Pair with other glossary clusters

Workflow reads apply glossary terms in daily operator work — pair with Operator workflows and Common Workflows — Workflow cross-reference. Meta-hubs reciprocate: FAQ — Deeper workflow reads, Support — Deeper workflow reads. Full pairing matrix: Glossary hub cross-reference.

Module documentation hubs

Pair with other glossary clusters

Module hub rows pair with Modules — Module cross-reference and individual glossary entries that link into each module. Full pairing matrix: Glossary hub cross-reference.

Notification row-click navigation

Payment alert to receivables triage

Confirmation alert triage

Pair with other Glossary hub sections

Finance debt receivables triage

Handling a Late Payment collections

Receivables triage surfaces answer “who owes?” — Handling a Late Payment — Steps 1–6 answer “what do I do next?” Full hub: Handling a Late Payment collections hub.

Finance Income status drill-down

Pair with other Glossary hub sections

Cash flow forecast drill-down

Pair with other Glossary hub sections

Collections vocabulary pairs with Glossary — Cash flow forecast (Finance Overview) and Cash Flow Forecast (Dashboard) — three distinct forecast surfaces. Hub parity: Common Workflows — Cash flow forecast drill-down. Full pairing matrix: Glossary hub cross-reference.

Occupancy KPI to block hygiene handoff

When Analytics Occupancy or RevPAR dips without a rate change, run Portfolio KPI review Step 3 before you edit Settings → Tenant categories or Sales → Pricing — then Manual block hygiene Steps 1–5 clear stale operator holds. Contrast with Portfolio segmentation by tenant category (segment filters look unhealthy on Step 6) and Same-day turnover coordination hub (shared-unit one-day overlap — distinct triage).

SurfaceUse it for
Analytics — OccupancyRanking roll-up and seasonality heatmap when rates are unchanged (analytics-kpi-occupancy-tab.png)
Tools → Audit — Manual BlocksPortfolio-wide hold table — Created by, Reason, End columns (audit-manual-blocks-workspace.png)
Portfolio KPI review — Step 3Upstream dip signal before block hygiene
Manual block hygiene — Steps 1–5Downstream Audit pass + unit Calendar edit (audit-manual-blocks-filter-scroll.mp4)
Listings — CalendarRow-click from Audit → edit or remove hold on unit Calendar
Sales — MulticalendarMystery blocks before Pricing edits — month-end reconciliation on Step 7
Dashboard — Vacant UnitsPhysical vacancy lower than Analytics after holds suppress nights
SymptomLikely causeFix
Occupancy / RevPAR dip without rate changeStale manual holdsPortfolio KPI review — Step 3Manual block hygiene — Step 1 (analytics-kpi-occupancy-tab.png)
Ranking concentrates on one unitHold on high-suppression unitManual block hygiene — Step 2 Search — not Sales → Pricing yet
Segment filters look healthy on Step 6Category-driven dip — not holdsEdit Settings → Tenant categories — contrast Portfolio segmentation by tenant category
Dashboard Vacant Units lower than AnalyticsHolds suppressing available nightsPortfolio KPI review — Step 7Manual block hygiene — Step 5
Sales Multicalendar mystery blocks after go-liveForgotten onboarding holdsOnboarding — Step 7Manual block hygiene — Step 4
Timeline overlap on channel importHold vs duplicate bookingProcessing a New Booking — Step 1 — clear holds before Add booking
Calendar bars persist after Ended departurePost-checkout hold not removedManaging a Check-out — Step 7Manual block hygiene — Step 4
Availability not restored after cancellation voidHold left after CanceledCancelling a Booking — Step 5Multicalendar before repricing
Unit looks vacant but collections triage shows arrearsRent debt — not a hold issueHandling a Late Payment — Step 1 — distinguish holds from rent debt
Calendar edit blocked after hold cleanupPermission or integration blockManual block hygiene — Step 6Using in-app support
Lockout-delayed occupancy KPI reviewPassword recovery backlogResetting a Management User Password — Step 3 → hub Lockout catch-up after password recovery
Shared-unit Timeline overlap on turnover daySame-day turnover — not portfolio holdsSame-day turnover coordination hub — distinct triage path

Analytics — Occupancy tab with monthly trend, Ranking roll-up, and seasonality heatmap for the selected range

Audit — Manual Blocks tab with portfolio-wide table, filters, and management shell

Walkthrough: read an Analytics → Occupancy dip, search Audit → Manual Blocks, remove the stale hold on unit Calendar, then re-read Occupancy Ranking (demo uses a temporary hold removed during capture).

Hub matrix: Common Workflows — Occupancy KPI to block hygiene handoff · Occupancy KPI to block hygiene handoff hub (analytics-kpi-occupancy-tab.png, audit-manual-blocks-workspace.png, occupancy-kpi-to-block-hygiene-handoff-flow.mp4, audit-manual-blocks-filter-scroll.mp4). Per-guide mesh: Portfolio KPI review — Occupancy KPI to block hygiene handoff, Manual block hygiene — Occupancy KPI to block hygiene handoff, Processing a New Booking — Occupancy KPI to block hygiene handoff, Onboarding a New Property — Occupancy KPI to block hygiene handoff, Managing a Check-in — Occupancy KPI to block hygiene handoff, Managing a Check-out — Occupancy KPI to block hygiene handoff, Cancelling a Booking — Occupancy KPI to block hygiene handoff, Entering Monthly Utility Bills — Occupancy KPI to block hygiene handoff, Handling a Late Payment — Occupancy KPI to block hygiene handoff, Notification triage — Occupancy KPI to block hygiene handoff, Resetting a Management User Password — Occupancy KPI to block hygiene handoff, Using in-app support — Occupancy KPI to block hygiene handoff.

Occupancy KPI to block hygiene handoff

Same-day turnover coordination

When a check-out and check-in share the same calendar day on one unit, run Managing a Check-out Steps 1–2 on the departing stay before Managing a Check-in Step 4 hands keys to the incoming guest. Contrast with Check-in to check-out handoff (mid-stay Ongoing → departure week) and Confirmation to check-in handoff (Upcoming portal gates before arrival week).

SurfaceUse it for
Operations — Check-in & Check-outCheck-outs / Check-ins pills + Next 7 days — paste unit in Search to spot shared turnover (operations-check-in-out-check-outs-next-7-days.png)
Operations — TicketsTurnover cleaning ticket — assign tight due date before incoming Step 4 (operations-add-ticket-modal.png)
Bookings — TimelineWeek scale overlap on one unit row — departure bar adjacent to arrival bar (bookings-timeline-view.png)
Sales — MulticalendarSales-scoped Gantt overlap without rent cells — month-end turnover gap scan
Managing a Check-out — Step 2Canonical turnover ticket due date before incoming arrival
Managing a Check-in — Step 4Key handover only after outgoing turnover due date passes and stay is Ended
SymptomLikely causeFix
Incoming guest waiting but unit not readyTurnover ticket still UnassignedManaging a Check-out — Step 2 before Managing a Check-in — Step 4 (operations-add-ticket-modal.png)
Same unit shows two bookings on Timeline Week scaleSame-day turnover — not duplicate importBookings — Timeline — paste unit in toolbar Search (same-day-turnover-coordination-flow.mp4, bookings-timeline-day-week-month-and-sidebar.mp4)
Outgoing tenant still In Debt on Payment PlanRent/fee arrears block key handoverHandling a Late Payment — Step 1Check-out collections before refund before incoming Step 4
Keys handed before outgoing checkout EndedHandover before departure workflow closedManaging a Check-out — Step 7 before incoming Step 4
Turnover ticket shows Draft far from due dateSchedule date too far in futureOperations → Tickets — assign tight due date before incoming arrival
Arrival/access alert before turnover ticket doneBell scan skipped turnover weekNotification triage — Step 4 row-click before bulk mark-read
Multicalendar gap on turnover day at month-endHigh-churn unit turnover backlogPortfolio KPI review — Step 7 before rate cuts
Lockout-delayed turnover catch-upPassword recovery backlogResetting a Management User Password — Step 3 → hub Lockout catch-up after password recovery
Turnover coordination blocked after self-serve checksEscalation path skippedUsing in-app support — New Support Ticket modal — not tenant notify-landlord
Final utilities not posted before deposit release on turnover dayDeparture-week overage gapCheck-out final utilities handoff — outgoing Step 6 before incoming Step 4
Mid-stay Ongoing entering departure weekDistinct from same-calendar-day turnoverCheck-in to check-out handoff hub — ~7 days before checkout, not one-day overlap

Operations — Check-in &amp; Check-out tab, Check-outs pill with Next 7 days and grouped departure rows

Operations — Add ticket modal with property, unit, category, and due date fields

End-to-end walkthrough: Operations → Check-in & Check-out — filter Check-outs and Check-ins on one unit → Create New → New Ticket turnover modal → Bookings → Timeline Week overlap check.

Hub matrix: Common Workflows — Same-day turnover coordination · Same-day turnover coordination hub (operations-check-in-out-check-outs-next-7-days.png, operations-add-ticket-modal.png, same-day-turnover-coordination-flow.mp4, bookings-timeline-day-week-month-and-sidebar.mp4). Per-guide mesh: Managing a Check-in — Same-day turnover coordination, Managing a Check-out — Same-day turnover coordination, Processing a New Booking — Same-day turnover coordination, Notification triage — Same-day turnover coordination, Handling a Late Payment — Same-day turnover coordination, Cancelling a Booking — Same-day turnover coordination, Onboarding a New Property — Same-day turnover coordination, Portfolio KPI review — Same-day turnover coordination, Manual block hygiene — Same-day turnover coordination, Entering Monthly Utility Bills — Same-day turnover coordination, Resetting a Management User Password — Same-day turnover coordination, Using in-app support — Same-day turnover coordination.

Same-day turnover coordination

Hostkit

Pair with other Glossary hub sections

Portuguese invoicing provider connected under Settings > Integrations. Unlike Nuki or Invoice-xpress account keys, Hostkit uses one API key per listing — add the provider under Other providers, then open Listing keys on the Hostkit card to paste keys per unit. Save Hostkit invoice series on Settings > Invoicing before Vivin calls Hostkit to create documents. Only one invoicing provider (Hostkit or Invoice-xpress) can be active per account.

SurfaceSetup / retrieval behaviourBest for
Settings > Integrations — Hostkit Listing keysServer search + ~20-row infinite scroll (GET /listings/hostkit-keys); per-row Save without losing scroll positionPer-listing API keys before first Issue allocation
Settings > Invoicing — Hostkit invoice seriesRequired FR code from Hostkit Faturação → Séries — empty series triggers a toastAccount-wide series before any Hostkit document create
Finance → Transactions bulk toolbarIssue allocation / Invoice selected; Issue credit notes (N) after invoiced cleanupMonth-end export (finance-transactions-bulk-selection-bar.png)
Finance → Transactions allocation rowsee invoice opens Hostkit permalink for {series}/{id}Post-export PDF retrieval
Booking → Files tabInvoice_ PDF tiles when allocation is invoicedTenant-facing document copy
SymptomLikely causeFix
Hostkit invoice series is not configured toastBlank FR series on accountSave exact series from Hostkit Faturação → Sériessettings-invoicing-hostkit-series.png
Rows stay Failed after refreshMissing Listing keys for unitIntegrations → Hostkit → Listing keys — search unit, paste key, Save
see invoice disabled or 404Series typo or wrong {series}/{id} pairMatch Invoicing series to live Hostkit FR code
Batch stays Pending for minutesHostkit API pacing — not setupBulk Hostkit invoicing — leave batch running; refresh Transactions before re-issue
Not issued credit note after Reject / RevertInvoiced charge reversed in VivinIssue credit notes (N) — same Hostkit pacing as Issue allocation
Wrong document date on issued invoicesFixed Invoice date still activeFixed invoice date reminder hub · Month-end invoicing (fixed date) — turn Use today back on after batch
Rent cut blocked below exported monthInvoiced floor — distinct from Hostkit setupExternal credit notes first — Rent reduction after invoicing

Account Settings Invoicing — Hostkit invoice series (FR) field

Finance Transactions — bulk selection bar with Issue allocation and Invoice selected actions

Hub matrix: Common Workflows — Bulk Hostkit invoicing · Hostkit hub (settings-invoicing-hostkit-series.png, finance-transactions-bulk-selection-bar.png). Per-guide mesh: Processing a New Booking — Bulk Hostkit invoicing, Handling a Late Payment — Bulk Hostkit invoicing, Cancelling a Booking — Bulk Hostkit invoicing, Managing a Check-in — Bulk Hostkit invoicing, Portfolio KPI review — Bulk Hostkit invoicing, Managing a Check-out — Bulk Hostkit invoicing, Entering Monthly Utility Bills — Bulk Hostkit invoicing, Notification triage — Bulk Hostkit invoicing, Manual block hygiene — Bulk Hostkit invoicing, Onboarding a New Property — Bulk Hostkit invoicing, Using in-app support — Bulk Hostkit invoicing, Resetting a Management User Password — Bulk Hostkit invoicing.

Bulk Hostkit invoicing

When month-end Issue allocation or Invoice selected runs on many Finance → Transactions rows, Vivin paces Hostkit API calls per listing key and retries HTTP 429 with backoff — large batches can take several minutes even though the UI stays responsive. The same bulk toolbar pushes Issue credit notes (N) after invoiced floor rent relief or invoiced Reject / Revert cleanup.

SurfaceUse it for
Finance → Transactions bulk toolbarTick rows → Issue allocation / Invoice selected for first-time export; Issue credit notes (N) on Not issued credit note filter rows
Settings > Invoicing — Hostkit invoice seriesSave exact FR code from Hostkit Faturação → Séries before bulk export — empty series triggers a toast
Settings > Integrations — Hostkit Listing keysOne API key per listing — missing keys cause Failed rows after refresh
Month-end invoicing (fixed date)Save fixed Invoice date before bulk Issue allocation when every document must share one posting date (finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png)
SymptomLikely causeFix
Rows stay Pending / Failed for several minutesHostkit rate limit — Vivin paces per listing keyLeave batch running; refresh Transactions before duplicate Issue allocation
Same rows still Failed after refreshMissing Listing keys or blank Hostkit invoice seriesIntegrations — Hostkit + Invoicing — Hostkit series
Hostkit invoice series is not configured toastSeries field emptySave exact FR code from Hostkit Faturação → Séries
Wrong document date on issued invoicesFixed Invoice date still activeMonth-end invoicing (fixed date) — turn Use today back on after batch
Not issued credit note queue after Reject / RevertInvoiced charge reversed in VivinIssue credit notes (N) — same Hostkit pacing as Issue allocation
Change monthly rent clamped below exported totalInvoiced floor — not Hostkit slownessExternal credit notes first — Rent reduction after invoicing
Month-end export blocked by Pending receiptsDuplicate or confirmation transfers still pendingPending manual receipt approval — finish Pending mesh before Issue allocation
Support ticket cites slow Hostkit batchSelf-serve pacing before escalationFAQ — Bulk Hostkit invoicing slow before filing

Finance Transactions — bulk selection bar with Issue allocation and Invoice selected actions

Finance Transactions — bulk toolbar with fixed invoice-date reminder beside Issue allocation

Account Settings Invoicing — Hostkit invoice series (FR) field

Hub matrix: Common Workflows — Bulk Hostkit invoicing · Bulk Hostkit invoicing hub · FAQ — Bulk Hostkit invoicing hub (finance-transactions-bulk-selection-bar.png, finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png, settings-invoicing-hostkit-series.png). Per-guide mesh: Processing a New Booking — Bulk Hostkit invoicing, Handling a Late Payment — Bulk Hostkit invoicing, Cancelling a Booking — Bulk Hostkit invoicing, Managing a Check-in — Bulk Hostkit invoicing, Portfolio KPI review — Bulk Hostkit invoicing, Managing a Check-out — Bulk Hostkit invoicing, Entering Monthly Utility Bills — Bulk Hostkit invoicing, Notification triage — Bulk Hostkit invoicing, Manual block hygiene — Bulk Hostkit invoicing, Onboarding a New Property — Bulk Hostkit invoicing, Using in-app support — Bulk Hostkit invoicing, Resetting a Management User Password — Bulk Hostkit invoicing.

Fixed invoice date reminder

When Use today as invoice date is off and a fixed Invoice date is saved under Settings > Invoicing, Vivin surfaces an amber status banner on Finance screens so operators confirm the posting date before Issue allocation / Invoice selected. The banner is informational — it does not block export — but missing it usually means the toggle is still on or the date was not saved.

SurfaceBanner layoutBest for
Finance → Transactions inline stripFull-width above search and invoice filter pillsConfirm saved date before filtering or selecting rows (finance-transactions-fixed-invoice-date-banner.png)
Finance → Transactions bulk toolbarCompact beside Issue allocation / Invoice selected when selected rows include pending/failed allocationsMonth-end bulk export (finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png)
Finance — Transaction detail sidebarCompact above allocation rows on one payment lineSingle-row Invoice selected before you issue (finance-transaction-detail-fixed-invoice-date-banner.png)
Settings > Invoicing — Default invoice dateToggle off + date picker — no banner hereSource of truth before banners appear on Transactions (settings-invoicing-invoice-date-toggle.png)
SymptomLikely causeFix
No amber banner on TransactionsUse today still on or date unsavedTurn toggle off, pick Invoice date, Save, reload Transactions
Banner shows wrong calendar dateStale session or unsaved pickerRe-open Invoicing, confirm date, Save, hard-refresh Transactions
Issued invoices show wrong document dateFixed date still active after batchTurn Use today as invoice date back onMonth-end invoicing (fixed date)
Bulk toolbar banner missingNo allocatable rows selectedTick rows with Pending / Failed invoicing — banner appears with bulk bar
Bulk Pending for minutes with banner visibleHostkit API pacing — not banner bugBulk Hostkit invoicing — leave batch running; refresh before re-issue
Support ticket cites wrong document dateSelf-serve toggle check skippedUsing in-app support — Month-end invoicing (fixed date) before filing

Finance Transactions — amber custom invoice date banner above search and invoice filter pills

Finance Transactions — bulk toolbar with fixed invoice-date reminder beside Issue allocation

Finance Transactions — transaction detail sidebar with fixed invoice-date reminder above allocations

Hub matrix: Common Workflows — Month-end invoicing (fixed date) · Fixed invoice date reminder hub (settings-invoicing-invoice-date-toggle.png, finance-transactions-fixed-invoice-date-banner.png, finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png, finance-transaction-detail-fixed-invoice-date-banner.png). Per-guide mesh: Processing a New Booking — Month-end invoicing (fixed date), Handling a Late Payment — Month-end invoicing (fixed date), Cancelling a Booking — Month-end invoicing (fixed date), Managing a Check-in — Month-end invoicing (fixed date), Portfolio KPI review — Month-end invoicing (fixed date), Managing a Check-out — Month-end invoicing (fixed date), Entering Monthly Utility Bills — Month-end invoicing (fixed date), Notification triage — Month-end invoicing (fixed date), Manual block hygiene — Month-end invoicing (fixed date), Onboarding a New Property — Month-end invoicing (fixed date), Using in-app support — Month-end invoicing (fixed date), Resetting a Management User Password — Month-end invoicing (fixed date).

Month-end invoicing (fixed date)

When month-end close requires every Fatura or Invoice-xpress document in a batch to share one posting date (for example the last calendar day of the month), save a fixed Invoice date under Settings → Invoicing before bulk Issue allocation / Invoice selected on Finance → Transactions. Turn Use today as invoice date back on after the batch so day-of-issue dating resumes for one-off invoices.

SurfaceUse it for
Settings > Invoicing — Default invoice dateTurn Use today off, pick Invoice date, Save — applies to every invoice until toggle returns on
Finance → Transactions inline bannerAmber reminder above search confirms saved fixed date before you filter or bulk-export (finance-transactions-fixed-invoice-date-banner.png)
Finance → Transactions bulk toolbarAmber banner beside Issue allocation / Invoice selected when selected rows include pending/failed allocations (finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png)
Transaction detail sidebarCompact fixed-date reminder above allocations on a single row (finance-transaction-detail-fixed-invoice-date-banner.png)
Bulk Hostkit invoicingHostkit Issue allocation pacing on the same toolbar — slow Pending is usually API pacing, not wrong date
SymptomLikely causeFix
Issued invoices show wrong document dateFixed Invoice date still activeInvoicing — Default invoice date — turn toggle on after batch
No amber banner on TransactionsToggle still on or unsaved dateSave fixed date in Invoicing, reload Transactions
Bulk Pending on Hostkit — not a date issueAPI pacingBulk Hostkit invoicing — leave batch running; refresh before re-issue
Forgot to reset after month-endNext day's invoices use saved dateTurn Use today as invoice date back on
Month-end export blocked by Pending meshConfirmation or duplicate receiptsPending manual receipt approval — finish workflow Step 6b before Issue allocation
Support ticket cites wrong document dateSelf-serve toggle check skippedUsing in-app support — Month-end invoicing (fixed date) before filing

Account Settings — Invoicing section with Use today as invoice date off and Invoice date picker visible

Finance Transactions — amber custom invoice date banner above search and invoice filter pills

Finance Transactions — bulk toolbar with fixed invoice-date reminder beside Issue allocation

Finance Transactions — transaction detail sidebar with fixed invoice-date reminder above allocations

Hub matrix: Common Workflows — Month-end invoicing (fixed date) · Month-end invoicing (fixed date) hub · FAQ — Month-end invoicing (fixed date) hub (settings-invoicing-invoice-date-toggle.png, finance-transactions-fixed-invoice-date-banner.png, finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png, finance-transaction-detail-fixed-invoice-date-banner.png). Per-guide mesh: Processing a New Booking — Month-end invoicing (fixed date), Handling a Late Payment — Month-end invoicing (fixed date), Cancelling a Booking — Month-end invoicing (fixed date), Managing a Check-in — Month-end invoicing (fixed date), Portfolio KPI review — Month-end invoicing (fixed date), Managing a Check-out — Month-end invoicing (fixed date), Entering Monthly Utility Bills — Month-end invoicing (fixed date), Notification triage — Month-end invoicing (fixed date), Manual block hygiene — Month-end invoicing (fixed date), Onboarding a New Property — Month-end invoicing (fixed date), Using in-app support — Month-end invoicing (fixed date), Resetting a Management User Password — Month-end invoicing (fixed date).

Invoiced floor (rent)

When Finance has already invoiced rent for a calendar month, Vivin enforces an invoiced floor in the booking workspace — lowering scheduled net below the exported total is blocked on Contract Info → Change monthly rent (months clamp to invoiced value) and Contract Values → Edit amount (Save disabled when net would drop below invoiced+draft totals). Repricing does not start on Finance → Transactions; external credit notes or manual adjustments are required before Vivin can reflect goodwill below exported rent, then Issue credit notes (N) on Transactions with the same Hostkit pacing as Bulk Hostkit invoicing.

SurfaceModal / queue behaviourBest for
Bookings — Contract Info → Change monthly rentMonths below exported totals clamp to invoiced value (blue Already invoiced months banner)Portfolio-wide repricing (bookings-detail-change-monthly-rent-modal.png)
Bookings — Contract Values → Edit amountSave disabled when net would drop below invoiced+draft totals (red inline validation)Per-line net edit (bookings-detail-contract-values-invoiced-floor-edit-amount.png)
Finance → Transactions Not issued credit note filterAfter external rent relief registers in Vivin — bulk Issue credit notes (N)Post-accounting rent relief (finance-transactions-bulk-selection-bar.png)
Bulk Hostkit invoicingHostkit Issue credit notes pacing after external rent reliefMonth-end reversal batch — slow Pending is API pacing, not floor block
Month-end invoicing (fixed date)Fixed Invoice date before first Issue allocationRepricing during same month-end batch as export
SymptomLikely causeFix
Month saves at invoiced amount, not your lower entryInvoiced floor on exported monthChange monthly rent — clamped months keep exported totals; other months save at your amount
Save disabled under New net amountNet below invoiced+draft on lineContract Values → Edit amount — external credit notes first
Need goodwill discount below exported rentAccounting alignment ruleIssue credit notes in Hostkit/accounting — Vivin will not persist lower nets on exported months
Hostkit Not issued credit note after rent reliefCredit note registered in VivinIssue credit notes (N) — same pacing as Bulk Hostkit invoicing
Batch stays Pending on TransactionsHostkit API pacingFloor unrelated — check booking modals; refresh Transactions before duplicate Hostkit run
Repricing after equal-month inference on variable unitFixed rent headline on variable unitPair FAQ — Fixed rent on variable unit
Red banner on Reject / blue info on RevertReceipt cleanup — not rent floorCredit note warning (reject/revert) — distinct from rent edit blocks
Support ticket cites blocked rent cutSelf-serve modal check skippedUsing in-app support — Rent reduction after invoicing before filing

Booking detail — Change monthly rent modal with Already invoiced months info banner

Booking Contract Values — Edit Payment Amount modal with Already invoiced helper and net-below-invoiced validation error

Walkthrough: open Contract Info → Change monthly rent, then Contract Values → Edit amount when Finance already exported rent.

Hub matrix: Common Workflows — Rent reduction after invoicing · Invoiced floor (rent) hub (bookings-detail-change-monthly-rent-modal.png, bookings-detail-contract-values-invoiced-floor-edit-amount.png, bookings-rent-reduction-invoiced-floor-flow.mp4). Per-guide mesh: Processing a New Booking — Rent reduction after invoicing, Handling a Late Payment — Rent reduction after invoicing, Cancelling a Booking — Rent reduction after invoicing, Managing a Check-in — Rent reduction after invoicing, Portfolio KPI review — Rent reduction after invoicing, Managing a Check-out — Rent reduction after invoicing, Entering Monthly Utility Bills — Rent reduction after invoicing, Notification triage — Rent reduction after invoicing, Manual block hygiene — Rent reduction after invoicing, Onboarding a New Property — Rent reduction after invoicing, Using in-app support — Rent reduction after invoicing, Resetting a Management User Password — Rent reduction after invoicing.

Rent reduction after invoicing

When Finance has already invoiced rent for a calendar month, Vivin enforces an invoiced floor — lowering scheduled net below the exported total is blocked in the booking workspace (Contract Info → Change monthly rent or Contract Values → Edit amount), not on Finance → Transactions. To reduce below exported rent, issue external credit notes or manual adjustments, then push Issue credit notes (N) on Transactions with the same Hostkit pacing as Bulk Hostkit invoicing.

SurfaceUse it for
Bookings — Contract Info → Change monthly rentPortfolio-wide repricing — months below exported totals clamp to invoiced value (blue Already invoiced months banner — bookings-detail-change-monthly-rent-modal.png)
Bookings — Contract Values → Edit amountPer-line net edit — Save disabled when net would drop below invoiced+draft totals (red inline validation — bookings-detail-contract-values-invoiced-floor-edit-amount.png)
Finance → Transactions Not issued credit note filterAfter external rent relief registers in Vivin — bulk Issue credit notes (N) (finance-transactions-bulk-selection-bar.png)
Bulk Hostkit invoicingHostkit Issue credit notes pacing after external rent relief — slow Pending is API pacing, not invoiced-floor block
Month-end invoicing (fixed date)Fixed Invoice date before first Issue allocation when repricing follows month-end export
SymptomLikely causeFix
Month saves at invoiced amount, not your lower entryInvoiced floor on exported monthChange monthly rent — clamped months keep exported totals; other months save at your amount
Save disabled under New net amountNet below invoiced+draft on lineContract Values → Edit amount — external credit notes first
Need goodwill discount below exported rentAccounting alignment ruleIssue credit notes in Hostkit/accounting — Vivin will not persist lower nets on exported months
Hostkit Not issued credit note after rent reliefCredit note registered in VivinIssue credit notes (N) — same pacing as Bulk Hostkit invoicing
Batch stays Pending on TransactionsHostkit API pacingFloor unrelated — check booking modals; refresh Transactions before duplicate Hostkit run
Repricing after equal-month inference on variable unitFixed rent headline on variable unitPair FAQ — Fixed rent on variable unit
Support ticket cites blocked rent cutSelf-serve modal check skippedUsing in-app support — Rent reduction after invoicing before filing

Booking detail — Change monthly rent modal with Already invoiced months info banner

Booking Contract Values — Edit Payment Amount modal with Already invoiced helper and net-below-invoiced validation error

Walkthrough: open Contract Info → Change monthly rent, then Contract Values → Edit amount when Finance already exported rent.

Hub matrix: Common Workflows — Rent reduction after invoicing · Rent reduction after invoicing hub · FAQ — Rent reduction after invoicing hub (bookings-detail-change-monthly-rent-modal.png, bookings-detail-contract-values-invoiced-floor-edit-amount.png, bookings-rent-reduction-invoiced-floor-flow.mp4). Per-guide mesh: Processing a New Booking — Rent reduction after invoicing, Handling a Late Payment — Rent reduction after invoicing, Cancelling a Booking — Rent reduction after invoicing, Managing a Check-in — Rent reduction after invoicing, Portfolio KPI review — Rent reduction after invoicing, Managing a Check-out — Rent reduction after invoicing, Entering Monthly Utility Bills — Rent reduction after invoicing, Notification triage — Rent reduction after invoicing, Manual block hygiene — Rent reduction after invoicing, Onboarding a New Property — Rent reduction after invoicing, Using in-app support — Rent reduction after invoicing, Resetting a Management User Password — Rent reduction after invoicing.

Utility overage collections

When landlord supplier bills post through Entering Monthly Utility Bills Steps 2–4, Vivin adds tenant utility overage lines on booking Payment Plan. When those lines stay Unpaid or Overdue, Handling a Late Payment Steps 1–4 collect the same way as rent arrears — distinct from departure-week Check-out final utilities handoff, rent Cancellation collections before void, and rent Check-out collections before refund.

SurfaceUse it for
Utilities → AllocationsConfirm overage posted per stay after supplier bill (utilities-allocations-row-breakdown-expanded.png)
Bookings — Payment PlanOverage schedule lines tenant owes after bill posting
Finance → Contract Values In Debt filterPortfolio-ranked overage arrears — distinct from rent Top debtors alone (finance-contract-values-in-debt-filter.png)
/notifications row-clickpayment overdue after monthly bill cycle → booking before outreach
Finance → Transactions / booking TransactionsPending overage receipts — Approve payment (bookings-detail-transactions-approve-payment-modal.png, finance-transactions-pending-pill.png)
SymptomLikely causeFix
In Debt includes utility-type line on Contract ValuesOverage posted after bill cycleStep 4Step 1
Payment overdue alert after monthly bill cycleUnpaid overage on Payment PlanRow-click → Step 4 before Step 1
Overage receipt still Pending at month-endManual bank transfer not approvedStep 4b
Tenant insists they paid — duplicate on ledgerDuplicate overage transferReject/revert mistaken receipts on Step 4b
End of Booking — line not visible yetDeferred postingEnd-of-Booking cost split — wait until checkout
Rent line mistaken for utility overageWrong line type on Payment PlanCheck-out collections before refund contrast — not utility mesh alone
Support ticket cites utility overage on Payment PlanSelf-serve triage skippedUsing in-app support — Utility overage collections before filing
Lockout-delayed overage payment overdue backlogPassword recovery delayed triageResetting a Management User Password — Step 3Step 4 (utilities-allocations-review-flow.mp4)

Utilities Allocations — expanded row breakdown showing tenant overage per stay

Finance Contract Values — In Debt filter highlighting utility overage lines

Walkthrough: post supplier bills in Utilities, verify overage on Allocations, then collect on booking Payment Plan.

Hub matrix: Common Workflows — Utility overage collections · Utility overage collections hub · FAQ — Utility overage collections hub (utilities-allocations-row-breakdown-expanded.png, bookings-detail-transactions-approve-payment-modal.png, finance-contract-values-in-debt-filter.png, utilities-allocations-review-flow.mp4). Per-guide mesh: Notification triage — Utility overage collections, Onboarding a New Property — Utility overage collections, Cancelling a Booking — Utility overage collections, Manual block hygiene — Utility overage collections, Using in-app support — Utility overage collections, Resetting a Management User Password — Utility overage collections, Processing a New Booking — Utility overage collections, Managing a Check-in — Utility overage collections, Managing a Check-out — Utility overage collections, Handling a Late Payment — Utility overage collections, Entering Monthly Utility Bills — Utility overage collections, Portfolio KPI review — Utility overage collections.

Check-out final utilities handoff

Pair with other Glossary hub sections

Managing a Check-out Step 6 blocks deposit release until every charge — including final utility overages — is settled. Entering Monthly Utility Bills Steps 2–4 post landlord bills and tenant overage lines on Payment Plan before Step 5 — distinct from mid-stay Utility overage collections and rent Check-out collections before refund.

SurfaceUse it for
Utilities → BillsEnter final supplier bills + Missing toggle gaps (utilities-bills-tab-missing-toggle.png)
Utilities → AllocationsReview calculated final-cycle overage per stay (utilities-allocations-row-breakdown-expanded.png)
Bookings — Payment PlanFinal overage schedule lines blocking settlement (bookings-detail-payment-plan-tab-schedule.png)
Bookings — DepositReady To Refund / Est. Refund gated until overage clears (bookings-detail-deposit-tab-ready-to-refund-toggle.png)
/notifications row-clickDeparture-week utility payment overdue → booking before refund queue
Finance → Transactions / booking TransactionsPending final overage receipts — Approve payment (bookings-detail-transactions-approve-payment-modal.png, finance-transactions-pending-pill.png)
SymptomLikely causeFix
Final utility overage unpaid on Payment PlanBill posted but line still UnpaidStep 4Step 6
Ready To Refund blocked by overageOverage line still In DebtStep 4Step 1Step 6
Overage paid but Ready To Refund greyedReceipt still PendingStep 4bStep 6b
End of Booking — overage not visible yetDeferred posting until checkoutEnd-of-Booking cost splitStep 7 then re-check Step 6
Month-end Missing bills on departing unitsSupplier bill not enteredStep 5Portfolio KPI review — Step 7
Rent + utility both block Ready To RefundMixed line types on Payment PlanUtility overage collections (utility line) · Check-out collections before refund (rent/fee lines)
Same-day turnover blocked by outgoing overageOutgoing final overages unsettledManaging a Check-out — Step 6 before Managing a Check-in — Step 4
Support ticket cites final overage blocking Ready To RefundSelf-serve triage skippedUsing in-app support — Check-out final utilities handoff before filing
Lockout-delayed departure-week utility backlogPassword recovery delayed triageResetting a Management User Password — Step 3Managing a Check-out — Step 6 (utilities-allocations-review-flow.mp4)

Booking detail — Payment Plan tab with schedule rows to verify before deposit release

Utilities — Bills tab with Missing toggle showing expected-period gaps

Bookings — Deposit tab with Ready To Refund toggle enabled before the external bank transfer

Walkthrough: review calculated utility allocations, confirm overage lines on tenant Payment Plan, then verify settlement in Managing a Check-out — Step 6 before deposit release.

Hub matrix: Common Workflows — Check-out final utilities handoff · Check-out final utilities handoff hub · FAQ — Check-out final utilities handoff hub (bookings-detail-payment-plan-tab-schedule.png, utilities-bills-tab-missing-toggle.png, utilities-allocations-review-flow.mp4, bookings-detail-deposit-tab-ready-to-refund-toggle.png). Per-guide mesh: Managing a Check-in — Check-out final utilities handoff, Managing a Check-out — Check-out final utilities handoff, Processing a New Booking — Check-out final utilities handoff, Notification triage — Check-out final utilities handoff, Handling a Late Payment — Check-out final utilities handoff, Cancelling a Booking — Check-out final utilities handoff, Onboarding a New Property — Check-out final utilities handoff, Portfolio KPI review — Check-out final utilities handoff, Manual block hygiene — Check-out final utilities handoff, Entering Monthly Utility Bills — Check-out final utilities handoff, Resetting a Management User Password — Check-out final utilities handoff, Using in-app support — Check-out final utilities handoff.

Check-out collections before refund

Managing a Check-out Step 6 blocks deposit release until every scheduled charge is settled — including rent and fee arrears on Payment Plan. Handling a Late Payment Steps 1–4 collect departure-week rent/fee In Debt before Step 5 — distinct from utility Check-out final utilities handoff, duplicate Check-out ledger cleanup before refund, and pre-cancel Cancellation collections before void.

SurfaceUse it for
Bookings — Payment PlanRent/fee schedule lines blocking settlement (bookings-detail-payment-plan-tab-schedule.png)
Bookings — DepositReady To Refund / Est. Refund gated until arrears clear (bookings-detail-deposit-tab-ready-to-refund-toggle.png)
Finance → Contract ValuesPortfolio In Debt filter for departure-week arrears (finance-contract-values-in-debt-filter.png)
/notifications row-clickDeparture-week payment overdue → booking before collections outreach
Finance → Transactions / booking TransactionsPending departure receipts — Approve payment (finance-transactions-pending-pill.png, bookings-detail-transactions-approve-payment-modal.png)
Finance → DepositsDeposit shortfall vs rent In Debt — not rent collections mesh (Partly collected security deposit)
SymptomLikely causeFix
Ready To Refund greyed / In Debt on rentUnpaid rent/fee on Payment PlanStep 1Step 4Step 6
Tenant paid once, balance still UnpaidDuplicate transfer on ledgerCheck-out ledger cleanup before refundRevert duplicate
Unpaid line is utility overageWrong line type on Payment PlanCheck-out final utilities handoff
Departure transfer still PendingReceipt not approvedStep 6bPending manual receipt approval
Shortfall is deposit collection, not rentDeposit not fully collectedPartly collected security depositFinance → Deposits Partial paid
Rent + utility both block Ready To RefundMixed line types on Payment PlanUtility overage collections (utility line) · Check-out collections before refund (rent/fee lines)
Same-day turnover blocked by outgoing arrearsOutgoing rent In Debt unsettledManaging a Check-out — Step 6 before Managing a Check-in — Step 4
Departure-week payment overdue alertRow-click before collectionsStep 4Step 1Step 6
Support ticket cites Ready To Refund blocked by arrearsSelf-serve triage skippedUsing in-app support — Check-out collections before refund before filing
Lockout-delayed departure-week collections backlogPassword recovery delayed triageResetting a Management User Password — Step 3Step 1 (workflows-check-out-coordination-flow.mp4)

Booking detail — Payment Plan tab with rent/fee schedule rows blocking deposit release

Finance Contract Values — In Debt filter highlighting departure-week rent arrears

Bookings — Deposit tab with Ready To Refund toggle enabled before the external bank transfer

Walkthrough: verify Payment Plan arrears, collect departure-week rent on Handling a Late Payment, then confirm settlement in Managing a Check-out — Step 6 before deposit release.

Hub matrix: Common Workflows — Check-out collections before refund · Check-out collections before refund hub · FAQ — Check-out collections before refund hub (workflows-check-out-coordination-flow.mp4, bookings-detail-payment-plan-tab-schedule.png, finance-contract-values-in-debt-filter.png, bookings-detail-deposit-tab-ready-to-refund-toggle.png). Per-guide mesh: Managing a Check-in — Check-out collections before refund, Managing a Check-out — Check-out collections before refund, Processing a New Booking — Check-out collections before refund, Notification triage — Check-out collections before refund, Handling a Late Payment — Check-out collections before refund, Cancelling a Booking — Check-out collections before refund, Onboarding a New Property — Check-out collections before refund, Portfolio KPI review — Check-out collections before refund, Manual block hygiene — Check-out collections before refund, Entering Monthly Utility Bills — Check-out collections before refund, Resetting a Management User Password — Check-out collections before refund, Using in-app support — Check-out collections before refund.

Cancellation collections before void

Cancelling a Booking Step 2 blocks Cancel booking on Step 4 until every rent/fee line on Payment Plan is settled — including Upcoming and Ongoing stays voided under policy. Handling a Late Payment Steps 1–4 collect pre-cancel rent/fee In Debt before the refund-type dialog — distinct from departure-week Check-out collections before refund, duplicate Check-out ledger cleanup before refund, and utility Utility overage collections on Canceled stays.

SurfaceUse it for
Bookings — Payment PlanRent/fee schedule lines blocking Cancel booking (bookings-detail-payment-plan-tab-schedule.png)
Bookings — Contract InfoCancel booking control gated by In Debt until settlement (bookings-cancel-booking-modal-refund-types.png)
Finance → Contract ValuesPortfolio In Debt filter for pre-cancel arrears (finance-contract-values-in-debt-filter.png)
/notifications row-clickPre-cancel payment overdue → booking before collections outreach
Finance → Transactions / booking TransactionsSettlement receipts still PendingApprove payment (finance-transactions-pending-pill.png, bookings-detail-transactions-approve-payment-modal.png)
Bookings — DepositDeposit shortfall vs rent In Debt — not rent pre-cancel mesh (Partly collected security deposit)
SymptomLikely causeFix
Cancel booking blocked by In DebtUnpaid rent/fee on Payment PlanStep 2Steps 1–4Step 4
Tenant paid once, balance still UnpaidDuplicate settlement transferCheck-out ledger cleanup before refundRevert duplicate during Step 2
Unpaid line is utility overageWrong line type on Payment PlanUtility overage collections — not rent pre-cancel mesh
Settlement receipt still Pending at cancelReceipt not approvedStep 2aPending manual receipt approval
Shortfall is deposit collection, not rentDeposit not fully collectedPartly collected security depositFinance → Deposits Partial paid
Tenant backs out before arrivalDeparture-week mesh mistakenManaging a Check-in hub move-in arrears → Step 4 — not Step 6
Pre-cancel payment overdue alert on Upcoming stayRow-click before collectionsStep 4Step 1Step 2
Support ticket cites In Debt blocking Cancel bookingSelf-serve triage skippedUsing in-app support — Cancellation collections before void before filing
Lockout-delayed pre-cancel collections backlogPassword recovery delayed triageResetting a Management User Password — Step 3Step 2
Month-end pre-cancel arrears at KPI sign-offVoid queue with open In DebtPortfolio KPI review — Step 7 — settle before policy void batch

Finance Contract Values — In Debt filter highlighting pre-cancel rent arrears

Booking detail — Payment Plan tab with rent/fee schedule rows blocking Cancel booking

Bookings — Cancel booking dialog with full refund, no refund, and partial refund options

Booking detail Transactions — Approve payment modal for settlement receipts before void

Walkthrough: settle Payment Plan arrears on Cancelling a Booking — Step 2, then open Contract InfoCancel booking and review refund types on Step 4 (clip closes without confirming).
Walkthrough: triage pre-cancel arrears on Finance → Contract Values (In Debt filter), confirm Payment Plan and Communication on the booking, then open Cancel booking refund types on Contract Info (clip closes without confirming).

Hub matrix: Common Workflows — Cancellation collections before void · Cancellation collections before void hub · FAQ — Cancellation collections before void hub (finance-contract-values-in-debt-filter.png, bookings-detail-payment-plan-tab-schedule.png, bookings-cancel-booking-modal-refund-types.png, bookings-detail-transactions-approve-payment-modal.png, workflows-cancel-booking-refund-modal-flow.mp4, cancellation-collections-before-void-flow.mp4). Per-guide mesh: Managing a Check-in — Cancellation collections before void, Managing a Check-out — Cancellation collections before void, Processing a New Booking — Cancellation collections before void, Notification triage — Cancellation collections before void, Handling a Late Payment — Cancellation collections before void, Cancelling a Booking — Cancellation collections before void, Onboarding a New Property — Cancellation collections before void, Portfolio KPI review — Cancellation collections before void, Manual block hygiene — Cancellation collections before void, Entering Monthly Utility Bills — Cancellation collections before void, Resetting a Management User Password — Cancellation collections before void, Using in-app support — Cancellation collections before void.

Wrong tenant on a booking

Pair with other Glossary hub sections

Wrong-tenant reassignment vocabulary pairs with Cancel Booking vs Delete Booking (duplicate import row → Delete, not Change tenant), Glossary — Archived booking ledger visibility, and Bookings & lifecycle cluster rows. Hub parity: Wrong tenant on a booking hub · Common Workflows — Wrong tenant on a booking · FAQ — Wrong tenant on a booking hub. Full pairing matrix: Glossary hub cross-reference.

When the reservation is valid but linked to the wrong tenant profile (duplicate email/NIF picker mistake, channel import matched the wrong person), use Change tenant on Contract Info — not Delete Booking or Cancel booking. Requires bookings.edit_items, Upcoming status, future check-in, no signed contract, and no paid + invoiced allocation blocking reassignment.

QuestionUseNotes
Wrong person on valid upcoming stayChange tenantUpcoming, future check-in, no signed contract
Entire row is duplicate import / testDelete BookingCancel Booking vs Delete Booking
Real stay voided under policyCancel bookingRefund dialog — not profile reassignment
SurfaceUse it for
Bookings — Contract InfoChange tenant swap icon on Tenant card — Upcoming only (bookings-detail-change-tenant-control.png)
Bookings — Change tenant modalSearchable picker + audit warning before Reassign booking (bookings-detail-change-tenant-modal.png)
Tenants moduleTenant master-data edit does not reassign an existing reservation
Finance modulePaid + invoiced guard blocks reassignment — invoices stay on original tenant
SymptomLikely wrong controlFix
Need different tenant, booking otherwise correctDelete Booking or editing tenant master data in placeChange tenant swap icon on Contract Info
Duplicate channel import for same datesChange tenantDelete Booking after Processing a New Booking — Step 1 duplicate check
Change tenant greyed outSigned contract or check-in passedCannot reassign — see Bookings — Change tenant guards
Reassign booking rejected on confirmPaid + invoiced allocation on bookingExpected — past invoices stay on original tenant for audit
Month-end used Delete when profile was wrongDelete Booking on valid stayChange tenant on Upcoming rows — Portfolio KPI review — Step 7
Alert row-click shows wrong Tenant cardTenant master-data editChange tenant after Notification triage — Step 4
Utility overage on wrong guest bookingEdit tenant profile in TenantsChange tenant while still UpcomingEntering Monthly Utility Bills — Step 4

Booking detail — Contract Info tenant card with Change tenant control (upcoming booking)

Change tenant modal — current tenant, searchable new tenant picker, and audit warning before Reassign booking

Walkthrough: open Change tenant, search for another tenant in the account, review the audit warning (demo cancels without reassigning).

Hub matrix: Common Workflows — Wrong tenant on a booking · Wrong tenant on a booking hub · Cancel Booking vs Delete Booking (bookings-detail-change-tenant-control.png, bookings-detail-change-tenant-modal.png, bookings-detail-change-tenant-flow.mp4). Per-guide mesh: Processing a New Booking — Wrong tenant on a booking, Handling a Late Payment — Wrong tenant on a booking, Cancelling a Booking — Wrong tenant on a booking, Managing a Check-in — Wrong tenant on a booking, Portfolio KPI review — Wrong tenant on a booking, Managing a Check-out — Wrong tenant on a booking, Entering Monthly Utility Bills — Wrong tenant on a booking, Notification triage — Wrong tenant on a booking, Manual block hygiene — Wrong tenant on a booking, Onboarding a New Property — Wrong tenant on a booking, Using in-app support — Wrong tenant on a booking, Resetting a Management User Password — Wrong tenant on a booking.

Wrong tenant on a booking

Pair with other Glossary hub sections

Wrong-tenant reassignment vocabulary pairs with FAQ — Cancel Booking vs Delete Booking (duplicate import row → Delete, not Change tenant), Glossary — Archived booking ledger visibility, and Bookings & lifecycle cluster rows. Hub parity: Wrong tenant on a booking hub · Common Workflows — Wrong tenant on a booking · FAQ — Wrong tenant on a booking hub. Full pairing matrix: Glossary hub cross-reference.

Cancel Booking vs Delete Booking

Pair with other Glossary hub sections

Cancel-vs-delete vocabulary pairs with Wrong tenant on a booking (valid stay with wrong profile → Change tenant, not Delete), Glossary — Archived booking ledger visibility (Manual Transactions hidden after soft-archive — #1897), Cancellation collections before void (settlement before Cancel booking), and Bookings & lifecycle cluster rows. Hub parity: Cancel Booking vs Delete Booking hub · Common Workflows — Cancel Booking vs Delete Booking · FAQ — Cancel Booking vs Delete Booking hub. Full pairing matrix: Glossary hub cross-reference.

Cancel booking runs policy settlement and keeps the reservation in Canceled filters with full Finance → Transactions history. Delete Booking soft-archives mistaken or test rows and drops them from default Bookings lists — Manual Transactions hide on the ledger while System Transactions (vIBAN, credit card) stay (#1897). Clear provider platform in-payment before Delete on integration bookings (#2076).

QuestionUseFinance → Transactions after action
Real stay voided under policyCancel booking on Contract InfoAll payment types stay visible — filter Canceled
Duplicate import or training rowDelete Booking (soft-archive)Manual Transactions hidden; System Transactions stay (#1897)
Wrong person on valid upcoming stayChange tenant — not this hubWrong tenant on a booking (bookings-detail-change-tenant-modal.png)
Whole building leaves pickersArchive property — not this hubPortfolio retirement decisions
SurfaceUse it for
Bookings — Contract InfoCancel booking refund dialog vs Delete Booking soft-archive on Check-in & Check-out (bookings-cancel-booking-modal-refund-types.png)
Bookings — Delete Booking (soft archive)Mistaken/test rows — clear provider platform in-payment first (#2076)
Bookings list — Canceled tabVoided stays still searchable after Cancel booking (bookings-list-canceled-tab.png)
Finance — Type summary cardsSystem vs Manual Transactions buckets affected by Delete (#1897) (finance-transactions-type-summary-cards.png)
SymptomLikely wrong controlFix
Need refund dialog and settlement historyDelete BookingCancel bookingCancelling a Booking — Step 4
Manual receipts vanished from FinanceDelete Booking on reconciled stayExpected #1897 — use Cancel when ledger history matters
Delete Booking blocked with toastprovider platform in-payment still presentReject or assign first (#2076) — FAQ — Delete Booking on integration reservation
Need different tenant, not a duplicate rowDelete Booking on valid stayChange tenantWrong tenant on a booking
Duplicate channel import on same datesCancel bookingDelete Booking on Processing a New Booking — Step 1
Month-end totals short after soft-archive cleanupCancel when Manual Transactions must stay visiblePortfolio KPI review — Step 7

Bookings — Cancel booking dialog with full refund, no refund, and partial refund options

Bookings list — Canceled tab showing voided reservations still searchable in the directory

Finance Transactions — type summary cards showing System vs Manual Transactions buckets affected by soft-archive

Walkthrough: Contract InfoCancel booking → review refund types (contrast with Delete Booking, which has no refund dialog).

Hub matrix: Common Workflows — Cancel Booking vs Delete Booking · Cancel Booking vs Delete Booking hub · Wrong tenant on a booking (bookings-cancel-booking-modal-refund-types.png, bookings-list-canceled-tab.png, finance-transactions-type-summary-cards.png, workflows-cancel-booking-refund-modal-flow.mp4). Per-guide mesh: Processing a New Booking — Cancel Booking vs Delete Booking, Handling a Late Payment — Cancel Booking vs Delete Booking, Cancelling a Booking — Cancel Booking vs Delete Booking, Managing a Check-in — Cancel Booking vs Delete Booking, Portfolio KPI review — Cancel Booking vs Delete Booking, Managing a Check-out — Cancel Booking vs Delete Booking, Entering Monthly Utility Bills — Cancel Booking vs Delete Booking, Notification triage — Cancel Booking vs Delete Booking, Manual block hygiene — Cancel Booking vs Delete Booking, Onboarding a New Property — Cancel Booking vs Delete Booking, Using in-app support — Cancel Booking vs Delete Booking, Resetting a Management User Password — Cancel Booking vs Delete Booking.

Cancel Booking vs Delete Booking

Pair with other Glossary hub sections

Cancel-vs-delete vocabulary pairs with Wrong tenant on a booking (valid stay with wrong profile → Change tenant, not Delete), Glossary — Archived booking ledger visibility (Manual Transactions hidden after soft-archive — #1897), Cancellation collections before void (settlement before Cancel booking), and Bookings & lifecycle cluster rows. Hub parity: Cancel Booking vs Delete Booking hub · Common Workflows — Cancel Booking vs Delete Booking · FAQ — Cancel Booking vs Delete Booking hub. Full pairing matrix: Glossary hub cross-reference.

Check-out vs cancellation

Pair with other Glossary hub sections

Lifecycle-exit vocabulary pairs with Cancel Booking vs Delete Booking (mistaken row → Delete Booking, not policy void), Cancellation collections before void (pre-cancel rent arrears on Canceled path), Check-out collections before refund (departure-week arrears on Ended path), Glossary — Deposit lifecycle status, and Bookings & lifecycle cluster rows. Hub parity: Check-out vs cancellation hub · Common Workflows — Check-out vs cancellation · FAQ — Check-out vs cancellation. Full pairing matrix: Glossary hub cross-reference.

When a stay ends, pick Managing a Check-out for completed occupancy that should reach Ended status — or Cancelling a Booking when the reservation is voided under your cancellation policy and should appear in Canceled filters. Neither replaces Delete Booking for mistaken or test rows.

QuestionCancellation workflowCheck-out workflow
Tenant backs out before arrival (Upcoming)Cancelling a Booking — Steps 1–4Not Step 1 — guest never moved in
Mid-stay early termination (Ongoing)Step 4 refund-type dialogStep 3 inspection + Step 5 when stay completes normally
Need Canceled filter + full ledger historyStep 4bookings-list-canceled-tab.pngEnded status — Step 7
Mistaken Add booking / training duplicateDelete BookingCancel Booking vs Delete BookingNot cancellation or check-out
Last-resort collections failedHandling a Late Payment — Step 6 → cancelStep 6 collections before refund
SurfaceUse it for
Bookings — Contract InfoCancel booking refund dialog vs Ended closure on completed stays (bookings-cancel-booking-modal-refund-types.png)
Bookings list — Canceled tabVoided stays still searchable after Cancel booking (bookings-list-canceled-tab.png)
Bookings — Deposit tabReady To Refund on departure-week Ended path (bookings-detail-deposit-tab-ready-to-refund-toggle.png)
Finance → DepositsRefund queue on both lifecycle exits — deposit settlement steps overlap
SymptomLikely wrong pathFix
Guest never moved in but operator ran check-out flowManaging a Check-out EndedCancelling a Booking — Step 4Canceled filter
Mid-stay policy void but operator used EndedStep 7 on voided stayCancelling a Booking — Step 4
Completed stay but Cancel booking was usedCanceled filter + refund dialogManaging a Check-out — Step 7Ended status
Ready To Refund blocked on policy voidCheck-out collections before refund meshCancellation collections before voidStep 2 before Step 4
Utility overage on Canceled stayManaging a Check-out — Step 6Entering Monthly Utility Bills — Step 4

Bookings — Cancel booking modal with Full refund, No refund, and Partial refund options

Bookings list — Canceled tab showing voided stays with full ledger history

Bookings — Deposit tab with Ready To Refund toggle enabled before the external bank transfer

Walkthrough: open Cancel booking, review refund types (example closes without confirming) — contrast with Ended closure on a completed stay per Managing a Check-out — Step 7.
Walkthrough: Bookings → Ended (completed stay) vs Cancelled (policy void) — status filters that distinguish Step 7 from Step 4.

Hub matrix: Common Workflows — Check-out vs cancellation · Check-out vs cancellation hub · FAQ — Check-out vs cancellation (check-out-vs-cancellation-ended-closure-flow.mp4, workflows-cancel-booking-refund-modal-flow.mp4, bookings-cancel-booking-modal-refund-types.png, bookings-list-canceled-tab.png, bookings-detail-deposit-tab-ready-to-refund-toggle.png). Per-guide mesh: Managing a Check-out — Check-out vs cancellation, Cancelling a Booking — Check-out vs cancellation, Processing a New Booking — Check-out vs cancellation, Managing a Check-in — Check-out vs cancellation, Handling a Late Payment — Check-out vs cancellation, Portfolio KPI review — Check-out vs cancellation, Notification triage — Check-out vs cancellation, Entering Monthly Utility Bills — Check-out vs cancellation, Onboarding a New Property — Check-out vs cancellation, Manual block hygiene — Check-out vs cancellation, Resetting a Management User Password — Check-out vs cancellation, Using in-app support — Check-out vs cancellation.

Check-out vs cancellation

Completed occupancy → Ended (Managing a Check-out — Step 7) vs policy void → Canceled (Cancelling a Booking — Step 4) — distinct from Cancel Booking vs Delete Booking (mistaken row cleanup). Full hub: Check-out vs cancellation hub.

Portfolio retirement decisions

Pair with other Glossary hub sections

Portfolio-retirement vocabulary pairs with Cancel Booking vs Delete Booking (reservation void vs soft-archive — #1897 / #2076), Glossary — Archived property (building-level Archive), Glossary — Archived booking ledger visibility (Manual Transactions hidden after Delete), and Bookings & lifecycle cluster rows. Hub parity: Portfolio retirement decisions hub · Common Workflows — Portfolio retirement decisions · FAQ — Portfolio retirement decisions hub. Full pairing matrix: Glossary hub cross-reference.

Three controls retire inventory at different scopes — pick the one that matches your goal before you Archive property, Cancel booking, or Delete Booking:

GoalControlScopeList visibilityFinance → Transactions
Sunset a whole buildingArchive propertyBuildingListings → Archived tab; hidden from default pickersAll booking history and payment rows stay visible
Void a real stay under policyCancel bookingOne reservationCanceled filter / statusAll payment types stay visible
Remove mistaken/test reservationDelete BookingOne reservationDrops from default Bookings lists (soft-archive)System Transactions (vIBAN, credit card) stay; Manual Transactions hidden (#1897)
SurfaceUse it for
Listings — Archived propertiesBuilding Archive / Unarchive on property edit sidebar (listings-archived-populated-table.png, listings-archived-unarchive-sidebar.png)
Bookings — Cancel Booking vs Delete BookingReservation void vs soft-archive on Contract Info → Check-in & Check-out (bookings-cancel-booking-modal-refund-types.png)
Finance — Type summary cardsSystem vs Manual Transactions buckets affected by Delete (#1897) (finance-transactions-type-summary-cards.png)
Common Workflows — Archive property (building-level)Building sunsetting after holds and departures are cleared
SymptomLikely wrong controlFix
Need full ledger for a voided real stayDelete BookingUse Cancel bookingCancelling a Booking — Step 4
Manual receipts vanished after cleanupDelete Booking on a stay you still reconcileExpected #1897 — use Cancel when you need manual rows; see FAQ — Manual payments after Delete Booking
Building should leave pickers but history staysDelete Booking on every reservationArchive property on Listings → PortfolioFAQ — Archive a property
Delete Booking blocked on OTA importPending provider platform in-paymentReject or assign first (#2076) — FAQ — Delete Booking on integration reservation
Reservation void needed but used DeleteNo refund dialog on soft-archiveCancel bookingCancel Booking vs Delete Booking
Building sunsetting via many Delete actionsReservations gone but building still in pickersArchive property — not per-reservation Delete

Listings — Archived tab with populated property cards and Archived badge count

Listings — Archived property edit sidebar with Unarchive in the danger zone

Bookings — Cancel booking dialog with full refund, no refund, and partial refund options

Finance Transactions — type summary cards showing System vs Manual Transactions buckets affected by soft-archive

Walkthrough: Listings → Portfolio property edit Archive (building scope) → Listings → Archived tab → Bookings → Upcoming Cancel booking refund dialog vs Delete Booking confirm (clip closes without confirming any action).

Hub matrix: Common Workflows — Portfolio retirement decisions · Portfolio retirement decisions hub · Cancel Booking vs Delete Booking (listings-archived-populated-table.png, listings-archived-unarchive-sidebar.png, bookings-cancel-booking-modal-refund-types.png, finance-transactions-type-summary-cards.png, portfolio-retirement-decisions-flow.mp4). Per-guide mesh: Portfolio KPI review — Portfolio retirement decisions, Manual block hygiene — Portfolio retirement decisions, Cancelling a Booking — Portfolio retirement decisions, Managing a Check-out — Portfolio retirement decisions, Onboarding a New Property — Portfolio retirement decisions, Processing a New Booking — Portfolio retirement decisions, Entering Monthly Utility Bills — Portfolio retirement decisions, Handling a Late Payment — Portfolio retirement decisions, Managing a Check-in — Portfolio retirement decisions, Notification triage — Portfolio retirement decisions, Resetting a Management User Password — Portfolio retirement decisions, Using in-app support — Portfolio retirement decisions.

Portfolio retirement decisions

Pair with other Glossary hub sections

Portfolio-retirement vocabulary pairs with Cancel Booking vs Delete Booking (reservation void vs soft-archive — #1897 / #2076), Glossary — Archived property (building-level Archive), Glossary — Archived booking ledger visibility (Manual Transactions hidden after Delete), and Bookings & lifecycle cluster rows. Hub parity: Portfolio retirement decisions hub · Common Workflows — Portfolio retirement decisions · FAQ — Portfolio retirement decisions hub. Full pairing matrix: Glossary hub cross-reference.

Provider platform Delete Booking guard

Pair with other Glossary hub sections

Provider-platform Delete guard vocabulary pairs with Cancel Booking vs Delete Booking (when Delete is appropriate vs Cancel booking — #1897), Portfolio retirement decisions (building Archive does not clear in-payment), Glossary — Archived booking ledger visibility (Manual Transactions after soft-archive), and Bookings & lifecycle cluster rows. Hub parity: Provider platform Delete Booking guard hub · Common Workflows — Provider platform Delete Booking guard · FAQ — Delete Booking on integration reservation hub. Full pairing matrix: Glossary hub cross-reference.

Integration reservations with a non-rejected provider platform in-payment cannot be soft-archived until that row is Rejected or assigned (#2076). Open booking Transactions or Finance → Transactions, clear the in-payment, then retry Delete Booking on Contract Info → Check-in & Check-out.

SurfaceUse it for
Bookings — Provider platform paymentRead-only Provider platform payment field on integration bookings (bookings-detail-provider-platform-payment-field.png)
Bookings — Delete Booking (soft archive)Soft-archive control on Contract Info → Check-in & Check-out — blocked until in-payment cleared (#2076)
Finance — Row actions on in-payment rowsReject pending provider platform rows — Delete payment stays disabled on this rail (#2076)
Finance — Assign a payment to another bookingMove in-payment to another reservation when invoicing rules allow — alternative to Reject
SymptomLikely wrong controlFix
Delete Booking blocked with toastprovider platform in-payment still presentReject or assign on booking Transactions / Finance → Transactions — then retry Delete Booking
Tried Delete payment on provider-platform rowLedger rail does not support deleteReject or assign — see Bookings — Provider platform payment
Real void needs full ledger historyDelete Booking on integration stayCancel bookingCancelling a Booking — Step 4
Month-end ledger gaps after DeleteSoft-archive on reconciled stayUse Cancel when Manual Transactions must stay — Archived booking ledger visibility (#1897)
Duplicate channel import on same datesDelete before clearing in-paymentProcessing a New Booking — Step 1Reject first (#2076)
Test Upcoming row before key handoverDelete blocked on integration importManaging a Check-in — Step 1 — clear in-payment then Delete
Go-live test booking on new inventoryDelete blocked after Step 7Onboarding a New Property — Provider platform Delete Booking guard
Alert row-click — Delete on integration importPending provider platform in-paymentNotification triage — Step 4Reject before Delete
Lockout catch-up duplicate importsDelete blocked during Step 3 catch-upResetting a Management User Password — Provider platform Delete Booking guard
Guard persists after correct Reject / assignProduct defectUsing in-app support — Provider platform Delete Booking guard — module Bookings ticket

Booking detail — Provider platform payment read-only field on integration booking

Booking detail — Delete Booking blocked while provider platform payment is present

Walkthrough: open booking Transactions, Reject the provider platform in-payment, then retry Delete Booking on Contract Info.

Hub matrix: Common Workflows — Provider platform Delete Booking guard · Provider platform Delete Booking guard hub · Cancel Booking vs Delete Booking (bookings-detail-provider-platform-payment-field.png, bookings-detail-delete-booking-provider-platform-error-toast.png, bookings-provider-platform-reject-delete-flow.mp4). Per-guide mesh: Processing a New Booking — Provider platform Delete Booking guard, Cancelling a Booking — Provider platform Delete Booking guard, Managing a Check-in — Provider platform Delete Booking guard, Managing a Check-out — Provider platform Delete Booking guard, Handling a Late Payment — Provider platform Delete Booking guard, Entering Monthly Utility Bills — Provider platform Delete Booking guard, Portfolio KPI review — Provider platform Delete Booking guard, Manual block hygiene — Provider platform Delete Booking guard, Onboarding a New Property — Provider platform Delete Booking guard, Notification triage — Provider platform Delete Booking guard, Resetting a Management User Password — Provider platform Delete Booking guard, Using in-app support — Provider platform Delete Booking guard.

Provider platform Delete Booking guard

Pair with other Glossary hub sections

Provider-platform Delete guard vocabulary pairs with Cancel Booking vs Delete Booking (when Delete is appropriate vs Cancel booking — #1897), Portfolio retirement decisions (three-way scope — building Archive does not clear in-payment), Glossary — Archived booking ledger visibility (Manual Transactions after soft-archive), and Bookings & lifecycle cluster rows. Hub parity: Provider platform Delete Booking guard hub · Common Workflows — Provider platform Delete Booking guard · FAQ — Delete Booking on integration reservation hub. Full pairing matrix: Glossary hub cross-reference.

Archived booking ledger visibility

Pair with other Glossary hub sections

Archived-ledger visibility vocabulary pairs with Cancel Booking vs Delete Booking (use Cancel when Manual Transactions must stay — #1897), Portfolio retirement decisions (Delete ledger gaps during building sunsetting), Provider platform Delete Booking guard (clear in-payment before Delete — #2076), and Financial & payments cluster rows. Hub parity: Archived booking ledger visibility hub · Common Workflows — Archived booking ledger visibility · FAQ — Manual payments after Delete Booking hub. Full pairing matrix: Glossary hub cross-reference.

Delete Booking soft-archives the reservation. On Finance → Transactions, Manual Transactions rows tied to that booking — transfer, cash, deposit refund, provider platform, and similar operator-recorded types — are hidden so test or mistaken stays do not clutter the portfolio ledger (#1897). System Transactions (vIBAN, credit card) stay visible for bank/card reconciliation. Canceled bookings that are not archived keep every transaction type visible.

SurfaceUse it for
Finance — Type summary cardsSystem vs Manual Transactions buckets on the ledger (finance-transactions-type-summary-cards.png)
Finance — Archived bookings on the ledgerVisibility table after soft-archive — which rails stay vs hide (#1897)
Bookings — Delete Booking (soft archive)Soft-archive control on Contract Info → Check-in & Check-out
Bookings list — Canceled tabCancel booking keeps voided stays searchable with full ledger — contrast with Delete
SymptomLikely wrong controlFix
Manual receipts vanished after cleanupDelete Booking on reconciled stayUse Cancel when Manual Transactions must stay — Cancel Booking vs Delete Booking (#1897)
Month-end totals short after training-row cleanupDelete Booking on stays you still reconcilePortfolio KPI review — Step 7 — use Cancel when history matters
Need full ledger for voided real stayDelete BookingCancel bookingCancelling a Booking — Step 4
vIBAN / credit card rows still visibleExpected — not a sync bugSystem Transactions stay for reconciliation (#1897)
Building sunsetting ledger gapsPer-reservation Delete vs ArchivePortfolio retirement decisionsArchive property keeps all ledger rows
Duplicate import cleanup on Step 1Delete hides manual rows afterwardProcessing a New Booking — Step 1 — expected for test rows (#1897)
Collections escalation needs policy voidDelete Booking on real arrearsCancel booking on Step 6 when manual receipts matter
Utility close missing overage manual rowsDelete on reconciled stayEntering Monthly Utility Bills — Step 5 — use Cancel when history matters (#1897)
Reconciled Ended departureDelete Booking when manual receipts neededLeave Ended or CancelManaging a Check-out — Step 7
Test Upcoming row before key handoverDelete hides manual rows afterwardManaging a Check-in — Step 1 — expected for mistaken rows (#1897)
Lockout catch-up cleanup used DeleteLedger gaps after soft-archiveResetting a Management User Password — Step 3 — prefer Cancel when history matters
Ledger rows vanish unexpectedlyProduct confusion vs expected #1897Using in-app support — Archived booking ledger visibility — module Bookings when behaviour differs

Finance Transactions — type summary cards showing System Transactions (Virtual Iban, Credit Card) vs Manual Transactions (Transfer, Cash, Deposit Refund, Platform)

Finance Transactions — soft-archived booking still listing Virtual Iban rows after Delete Booking; Manual Transactions for that reservation are hidden (#1897)

Walkthrough: Finance → Transactions manual transfer row → booking Transactions tab → Delete Booking → manual row disappears from the portfolio ledger while System Transactions (Virtual Iban) stay for reconciliation (#1897).

Hub matrix: Common Workflows — Archived booking ledger visibility · Archived booking ledger visibility hub · Cancel Booking vs Delete Booking (finance-transactions-type-summary-cards.png, finance-transactions-archived-booking-ledger.png, archived-booking-ledger-visibility-flow.mp4). Per-guide mesh: Processing a New Booking — Archived booking ledger visibility, Cancelling a Booking — Archived booking ledger visibility, Managing a Check-in — Archived booking ledger visibility, Managing a Check-out — Archived booking ledger visibility, Handling a Late Payment — Archived booking ledger visibility, Entering Monthly Utility Bills — Archived booking ledger visibility, Portfolio KPI review — Archived booking ledger visibility, Manual block hygiene — Archived booking ledger visibility, Onboarding a New Property — Archived booking ledger visibility, Notification triage — Archived booking ledger visibility, Resetting a Management User Password — Archived booking ledger visibility, Using in-app support — Archived booking ledger visibility.

Archived booking ledger visibility

Pair with other Glossary hub sections

Archived-ledger visibility vocabulary pairs with Cancel Booking vs Delete Booking (use Cancel when Manual Transactions must stay — #1897), Portfolio retirement decisions (Delete ledger gaps during building sunsetting), Provider platform Delete Booking guard (clear in-payment before Delete — #2076), and Financial & payments cluster rows. Hub parity: Archived booking ledger visibility hub · Common Workflows — Archived booking ledger visibility · FAQ — Manual payments after Delete Booking hub. Full pairing matrix: Glossary hub cross-reference.

Archive property (building-level)

Pair with other Glossary hub sections

Building Archive vocabulary pairs with Portfolio retirement decisions (three-way Archive vs Cancel vs Delete), Glossary — Archived property (letter definition), Glossary — Archived booking ledger visibility (Delete hides manual rows — building Archive does not), and Listings & portfolio cluster rows. Hub parity: Archive property (building-level) hub · Common Workflows — Archive property (building-level) · FAQ — Archive a property. Full pairing matrix: Glossary hub cross-reference.

When a whole building leaves the portfolio for good, retire it from active pickers without deleting booking or finance history — distinct from per-reservation Cancel Booking vs Delete Booking and the three-way scope table in Portfolio retirement decisions.

SurfaceUse it for
Listings — Archived propertiesArchive / Unarchive on property edit sidebar (listings-archived-populated-table.png, listings-archived-unarchive-sidebar.png)
Listings — PortfolioDanger zone Archive after holds and departures are cleared
Sales moduleArchived buildings drop from active pricing/channel grids — historical bookings remain
Bookings moduleHistorical reservation rows stay searchable — building Archive does not remove them
SymptomLikely wrong controlFix
Building still in pickers after deleting every reservationDelete Booking on each stayArchive property on Listings → PortfolioFAQ — Archive a property
Property missing from Portfolio after setup mistakeAccidental Archive during go-liveUnarchive from Listings → ArchivedOnboarding a New Property — Step 7
Used Delete Booking to clean duplicate importsReservation scope onlyDelete Booking on Processing a New Booking — Step 1 — not building Archive
Unsure whether to Archive, Cancel, or DeleteScope confusionPortfolio retirement decisions — three-way decision table
Archive / Unarchive guard defect despite correct stepsProduct bugUsing in-app support — Archive property (building-level) — module Listings
Month-end sunsetting before last departureArchive while Upcoming remainManaging a Check-out — Step 7 — finish departures first
Stale holds block sunsettingArchive with active manual blocksManual block hygiene — Step 5 — clear holds first
Lockout-delayed sunsetting backlogDeferred building ArchiveResetting a Management User Password — Step 3 — hub Lockout catch-up
Collections still open on buildingArchive before arrears settledHandling a Late Payment — Step 6 — settle or Cancel stays first
Utility month not closed before sunsettingBuilding Archive mid-cycleEntering Monthly Utility Bills — Step 5 — finish utility close first

Listings — Archived tab with populated property cards and Archived badge count

Listings — Archived property edit sidebar with Unarchive in the danger zone

Walkthrough: Listings → Portfolio property edit → danger zone Archive (confirm dialog) → Listings → Archived tab → archived property edit → Unarchive (confirm dialog) for go-live recovery.

Hub matrix: Common Workflows — Archive property (building-level) · Archive property (building-level) hub · Portfolio retirement decisions (listings-archived-populated-table.png, listings-archived-unarchive-sidebar.png, archive-property-building-level-flow.mp4). Per-guide mesh: Manual block hygiene — Archive property (building-level), Managing a Check-out — Archive property (building-level), Managing a Check-in — Archive property (building-level), Onboarding a New Property — Archive property (building-level), Processing a New Booking — Archive property (building-level), Portfolio KPI review — Archive property (building-level), Cancelling a Booking — Archive property (building-level), Handling a Late Payment — Archive property (building-level), Entering Monthly Utility Bills — Archive property (building-level), Notification triage — Archive property (building-level), Resetting a Management User Password — Archive property (building-level), Using in-app support — Archive property (building-level).

Archive property (building-level)

Pair with other Glossary hub sections

Building Archive vocabulary pairs with Portfolio retirement decisions (three-way Archive vs Cancel vs Delete), Glossary — Archived property (letter definition), Glossary — Archived booking ledger visibility (Delete hides manual rows — building Archive does not), and Listings & portfolio cluster rows. Hub parity: Archive property (building-level) hub · Common Workflows — Archive property (building-level) · FAQ — Archive a property. Full pairing matrix: Glossary hub cross-reference.

Directory list load failures

Pair with other Glossary hub sections

Directory load-failure vocabulary pairs with Booking detail sidebar tab load failures (tab-scoped Refresh / Retry inside one booking), Glossary — Settings and profile load failures (toast-scoped Account Settings patterns), Infinite scroll (directory loading), and Directory & search UX cluster rows. Hub parity: Directory list load failures hub · Common Workflows — Directory list load failures · FAQ — Directory list load failures hub. Full pairing matrix: Glossary hub cross-reference.

When the first request for a large directory or dashboard aggregate fails (network drop, timeout, or HTTP 4xx/5xx), Vivin shows an explicit Failed to load … alert with Retry / Try again — distinct from filter-empty zero rows and from tab-scoped errors inside one booking sidebar.

SurfaceHow the failure appears
Bookings listInline alert cardFailed to load bookings. Please try again. + Retry
Bookings Timeline (/bookings/timeline)Centered chart error panel — Couldn't load the timeline bookings. + Retry (re-fetches listing axis and bars; distinct from list-view failure)
Tenants directorySame card pattern — Failed to load tenants. Please try again.
Listings portfolioSame card pattern — Failed to load listings. Please try again.
Sales (Pricing / Channels / whole module)Module-level alert card — Failed to load sales data. Please try again. + Retry (blocks all four tabs until recovery)
Sales Overview free-unit popoverInline text in the day/bar popover — Failed to load free units — KPI strip and availability charts still render; close the popover or pick another day
Operations Tickets / Cash FlowsTab-level alert — Failed to load tickets. / Failed to load cash flows. + Retry
Notifications (/notifications)Red message in the main panel — Failed to load notifications. + Try again
Support inbox (/settings/support)Alert card — Failed to load support tickets + Retry
Dashboard (/)Banner under the page header — Some dashboard data failed to load. + Retry (other widgets may still render from cache)
Audit Manual BlocksAlert card — Failed to load manual blocks. + Retry
Analytics KPI workspace (/analytics)Red inline alert — We couldn't load your portfolio KPIs + Try again (not blank charts that imply zero performance)
Utilities (each tab)Tab-level alert — Overview / Connections / Bills / Timeline / Allocations show Retry; Cost map shows Failed to load data. (refresh the tab)
Settings → Services Requests queueInline alert — Could not load pending approvals. + Retry
SymptomLikely causeFix
Failed to load bookings/tenants/listings… + RetryNetwork drop, timeout, or HTTP error on first fetchRetry / Try again, or refresh after connectivity recovers
Empty table with no error bannerSuccessful fetch returned zero rows for your filtersNormal empty state — widen filters or clear search
Some dashboard data failed to load. under headerPartial / aggregate failureRetry on banner — other KPI widgets may still render
Could not load messages inside one bookingTab-scoped API slice failedRefresh (Communication) or Retry (Tickets) — Booking detail sidebar tab load failures
Sales Overview popover Failed to load free unitsDay/bar popover only — charts still loadedClose popover or pick another day — not whole-module failure
Opened booking from alert but one tab redTab-scoped slice failedBooking detail sidebar tab load failuresPayment Plan may still work
/settings/support or drawer cannot load ticketsSame data layer as directory listsUsing in-app support — Inbox load failures
Retry persists after connectivity returnsProduct defect or session issueHard-refresh, sign out/in, or Using in-app support — not tab-scoped Refresh
QuestionWhole-module directoryTab inside one booking
Where does it fail?Bookings / Tenants / Notifications list cardCommunication or Tickets inside sidebar
Recovery controlRetry / Try again on list cardRefresh (Communication) or Retry (Tickets)
Other tabs still work?Whole module blocked until retryContract Info / Payment Plan stay usable

Notifications module — initial load failure with Try again control

Audit — Manual Blocks tab load failure with Retry after simulated API error

Dashboard — partial overview-stats load failure banner with Retry under the page header

Analytics — portfolio KPI workspace load failure with Try again

Walkthrough: whole-module Bookings list Retry after Failed to load bookings, then tab-scoped Communication header Refresh while Payment Plan still loads — distinct recovery scopes.

Hub matrix: Common Workflows — Directory list load failures · Directory list load failures hub · FAQ — Directory list load failures hub (notifications-module-load-failure.png, audit-manual-blocks-load-failure.png, dashboard-partial-data-load-failure.png, analytics-kpi-load-failure.png, directory-list-load-failures-recovery-flow.mp4). Per-guide mesh: Manual block hygiene — Directory list load failures, Cancelling a Booking — Directory list load failures, Managing a Check-out — Directory list load failures, Onboarding a New Property — Directory list load failures, Processing a New Booking — Directory list load failures, Entering Monthly Utility Bills — Directory list load failures, Handling a Late Payment — Directory list load failures, Managing a Check-in — Directory list load failures, Notification triage — Directory list load failures, Resetting a Management User Password — Directory list load failures, Using in-app support — Directory list load failures, Portfolio KPI review — Directory list load failures.

Booking sidebar tab load failures

Pair with other Glossary hub sections

Inside the booking detail sidebar, each tab loads its own API slice. A failure on one tab does not block Contract Info, Payment Plan, Deposit, or other tabs — use tab-scoped recovery, not whole-module Bookings list Retry.

TabHow the failure appearsRecovery
CommunicationCould not load messagesSomething went wrong loading the conversation. Try again.Refresh in the booking sidebar header toolbar (visible while Communication is active)
TicketsRed banner — Could not load tickets. Try again.Retry on the banner inside the tab
SymptomLikely causeFix
Failed to load bookings… on list cardWhole-module directory failureDirectory list load failures hub — list Retry, not tab Refresh
Could not load messages inside one bookingTab-scoped Communication sliceHeader Refresh — other sidebar tabs stay usable
Could not load tickets inside one bookingTab-scoped Tickets sliceBanner Retry — switch to Payment Plan while retrying
Opened booking from alert but one tab redTab-scoped slice failedNotification triage — Step 4 — tab recovery, not /notifications Try again
Refresh / Retry never recoversProduct defect or stale sessionClose and reopen booking; then Using in-app support if still failing
QuestionWhole-module directoryTab inside one booking
Where does it fail?Bookings list inline alert cardCommunication or Tickets inside sidebar
Recovery controlRetry on list cardRefresh (Communication) or Retry (Tickets)
Other tabs still work?Whole list blocked until retryContract Info / Payment Plan stay usable

Booking detail — Communication tab with WhatsApp thread and Refresh in the sidebar header toolbar

Booking detail — Tickets tab in normal loaded state (Retry appears on the red banner when fetch fails)

Walkthrough: open a booking, simulate Communication tab load failure, switch to Payment Plan while other tabs stay usable, then header Refresh recovers — distinct from whole-module Bookings list Retry (directory-list-load-failures-recovery-flow.mp4).

Hub matrix: Common Workflows — Booking sidebar tab load failures · Booking sidebar tab load failures hub · FAQ — Booking sidebar tab load failures hub (bookings-detail-communication-tab-whatsapp-thread.png, bookings-detail-tickets-tab.png, booking-sidebar-tab-load-failures-recovery-flow.mp4). Per-guide mesh: Manual block hygiene — Booking sidebar tab load failures, Cancelling a Booking — Booking sidebar tab load failures, Managing a Check-out — Booking sidebar tab load failures, Onboarding a New Property — Booking sidebar tab load failures, Processing a New Booking — Booking sidebar tab load failures, Handling a Late Payment — Booking sidebar tab load failures, Managing a Check-in — Booking sidebar tab load failures, Entering Monthly Utility Bills — Booking sidebar tab load failures, Notification triage — Booking sidebar tab load failures, Resetting a Management User Password — Booking sidebar tab load failures, Using in-app support — Booking sidebar tab load failures, Portfolio KPI review — Booking sidebar tab load failures.

WhatsApp per-booking messaging

Pair with other Glossary hub sections

Three surfaces share the same UAZAPI chat state — pick the one that matches your triage scope:

SurfaceUse it forNotes
Tools → Inbox (/inbox) or bell Inbox sub-tabCross-booking triage, unknown numbers, alert-driven entryClick tenant name for Tenant sidebar; composer for quick replies
Bookings → CommunicationOne reservation with Payment Plan, Tickets, and Files contextWhatsApp composer + read-only Email; header Refresh
/notifications or bell GeneralPayment or ticket alerts — not message threadsSwitch to Inbox when summary reads New WhatsApp message from …
SymptomLikely causeFix
Bell ping reads New WhatsApp message from …Message alert on General or /notificationsOpen bell Inbox sub-tab or Tools → Inbox
Need Payment Plan while replyingCross-booking Inbox lacks booking contextBookings → Communication for that reservation
Unlock your communication historyChatbot not enabled (isTenantChatBotEnabled)ChatBot settings — Status Bot
Could not load messages on CommunicationTab-scoped fetch failureHeader RefreshBooking sidebar tab load failures hub
New WhatsApp message from … on /notificationsMessage alert on full inboxBell Inbox or row with linkNotification row navigation hub
Row-click landed on booking, thread emptybookingId target without linkOpen Communication tab manually
QuestionMessage threadPayment / ticket alert
Dashboard entryBell Inbox sub-tabBell General or /notifications
Reply with Payment Plan visibleBookings → CommunicationRow-click → booking — Notification row navigation hub
Cross-booking triageTools → Inbox (/inbox)/notifications filters + row-click

Booking detail — Communication tab, WhatsApp filter with tenant / Bot / You bubbles and channel pills

Booking detail — Communication tab, WhatsApp composer for operator replies

Inbox module — conversation list and thread composer for portfolio-wide WhatsApp triage

Walkthrough: open Inbox, pick a conversation, reply, and jump to booking Communication when you need reservation context.

Hub matrix: Common Workflows — WhatsApp per-booking messaging · WhatsApp per-booking messaging hub · FAQ — WhatsApp per-booking messaging hub (bookings-detail-communication-tab-whatsapp-thread.png, bookings-detail-communication-tab-whatsapp-composer.png, inbox-module-overview.png, inbox-module-triage-flow.mp4). Per-guide mesh: Notification triage — WhatsApp per-booking messaging, Handling a Late Payment — WhatsApp per-booking messaging, Managing a Check-in — WhatsApp per-booking messaging, Managing a Check-out — WhatsApp per-booking messaging, Processing a New Booking — WhatsApp per-booking messaging, Cancelling a Booking — WhatsApp per-booking messaging, Entering Monthly Utility Bills — WhatsApp per-booking messaging, Portfolio KPI review — WhatsApp per-booking messaging, Manual block hygiene — WhatsApp per-booking messaging, Onboarding a New Property — WhatsApp per-booking messaging, Using in-app support — WhatsApp per-booking messaging, Resetting a Management User Password — WhatsApp per-booking messaging.

Bot reasoning (audit)

Pair with other Glossary hub sections

Bot audit vocabulary pairs with Glossary — ChatBot settings hub (edit persona / IF/THEN after thread review), Glossary — WhatsApp per-booking messaging hub (Communication thread context), and Notifications & messaging cluster rows. Hub parity: Bot reasoning (audit) hub · Common Workflows — Bot reasoning (audit) · FAQ — Bot reasoning (audit) hub. Full pairing matrix: Glossary hub cross-reference.

Two surfaces answer “why did the bot say that?” — configure rules in one place, audit a specific reply in another:

SurfaceUse it forNotes
Bookings → Communication → Bot bubble → ReasoningAudit one automated reply Vivin already sentRead-only; expands internal explanation (italic text in parentheses)
Account Settings → ChatBotChange future behaviour — Persona tone and IF/THEN rulesDoes not rewrite past messages on the thread
Bookings → Communication → Pause botStop automation for one reservationPer-booking; global rules unchanged
SymptomLikely causeFix
Bot gave a generic or wrong answerBroad IF/THEN If phrase firedExpand Reasoning on thread → narrow rule at ChatBot settings
No Reasoning control under Bot bubbleVivin did not store reasoning for that sendNot a UI bug — only some automated replies include audit text
Need to change tone across channelsPersona too vague or missingChatBot — Persona — max 500 characters
Tenant still gets bot replies after you intervenedPause bot not applied on bookingCommunication → WhatsApp toggle when chatBotPauseLabelId is configured
Supplier got an automated tenant replyShared WhatsApp business lineDedicated tenant number — Automation & AI — WhatsApp Support
QuestionThread Reasoning (audit)ChatBot settings (configure)
Changes past messages?No — read-onlyNo — affects future replies only
Which bubbles show control?Mint Bot onlyN/A — settings are account-wide
Pair with collections triage?Communication on bookingIF/THEN escalation to Operations
External automation read access?N/ATenant MCP — chatbot rules

Booking detail — Communication tab, Bot message with expanded Reasoning audit text under the reply

Walkthrough: expand Reasoning on a Bot bubble, then open ChatBot → Special Rules to tune IF/THEN rows after the thread audit.

Hub matrix: Common Workflows — Bot reasoning (audit) · Bot reasoning (audit) hub · FAQ — Bot reasoning (audit) hub (bookings-detail-communication-tab-bot-reasoning-expanded.png, bot-reasoning-audit-expand-flow.mp4). Per-guide mesh: Notification triage — Bot reasoning (audit), Handling a Late Payment — Bot reasoning (audit), Managing a Check-in — Bot reasoning (audit), Managing a Check-out — Bot reasoning (audit), Processing a New Booking — Bot reasoning (audit), Cancelling a Booking — Bot reasoning (audit), Entering Monthly Utility Bills — Bot reasoning (audit), Portfolio KPI review — Bot reasoning (audit), Manual block hygiene — Bot reasoning (audit), Onboarding a New Property — Bot reasoning (audit), Using in-app support — Bot reasoning (audit), Resetting a Management User Password — Bot reasoning (audit).

ChatBot settings

Pair with other Glossary hub sections

ChatBot configuration vocabulary pairs with Glossary — Bot reasoning (audit) hub (thread audit after rule edits), Glossary — WhatsApp per-booking messaging hub (Inbox / Communication gating), and Tenant experience cluster rows. Hub parity: ChatBot settings hub · Common Workflows — ChatBot settings · FAQ — ChatBot settings hub. Full pairing matrix: Glossary hub cross-reference.

Account Settings → ChatBot configures the tenant-facing assistant — distinct from operator AI Chat (/ai-chat) and Landlord MCP:

Subtab / surfaceUse it forNotes
Persona subtabTone, languages, topics to avoidMax 500 characters; applies across WhatsApp and email
Special Rules subtabSituation-specific bot behaviour (max 20 IF/THEN rules)Narrow If phrases — broad rules fire on almost every message
Bot Status subtabWhatsApp UAZAPI pairing (Connected / Disconnected / QR)Gates Inbox, bell Inbox, and Communication composer
Bookings → CommunicationLive threads, Pause bot, read-only Reasoning auditPair with WhatsApp per-booking messaging hub
SymptomLikely causeFix
Inbox nav greyed outisTenantChatBotEnabled false or not pairedBot StatusConnect WhatsApp → scan QR until Connected
Unlock your communication history on bookingChatbot not enabled for workspaceContact Vivin to enable integration; then pair Bot Status
Bot replies on almost every tenant messageCatch-all IF/THEN ruleReplace with specific If situations — IF/THEN rules
WhatsApp composer missing on CommunicationOutbound WhatsApp not provisionedThread may load; bottom shows WhatsApp replies aren't available yet
Rules saved but tenant still sees old toneEdited wrong account or read-only Super AdminWho can edit ChatBot settings
Need to verify a specific automated replyConfiguration alone does not show past logicBot reasoning (audit) hubReasoning on Bot bubble
QR expired before scanSession timed out on phoneRefresh QR code on Bot Status
QuestionChatBot settingsBookings → Communication
Edit future bot behaviour?Persona + Special RulesPause bot per booking only
Portfolio-wide message triage?Bot Status must be ConnectedUse Inbox or bell Inbox
Audit one sent reply?N/AReasoning under Bot bubble
External read-only automation?Tenant MCPN/A

Account Settings — ChatBot → Persona subtab with persona text, IF/THEN rules preview, and rule count

Account Settings — ChatBot → Bot Status with Connected badge and live WhatsApp (UAZAPI) session

Account Settings — ChatBot → Bot Status with QR code and Awaiting scan badge during WhatsApp pairing

Walkthrough: Bot Status → Connect WhatsApp, confirm after the warning countdown, then scan the QR until Connected.
Walkthrough: open ChatBot settings, enter edit mode, add a narrow IF/THEN rule, Save, and return to read-only preview.

Hub matrix: Common Workflows — ChatBot settings · ChatBot settings hub · FAQ — ChatBot settings hub (settings-chatbot-tab-overview.png, settings-chatbot-status-bot-connected.png, settings-chatbot-status-bot-qr-pairing.png, settings-chatbot-status-bot-pairing-flow.mp4, settings-chatbot-tab-edit-mode.png, settings-chatbot-save-rule-flow.mp4). Per-guide mesh: Onboarding a New Property — ChatBot settings, Notification triage — ChatBot settings, Processing a New Booking — ChatBot settings, Handling a Late Payment — ChatBot settings, Managing a Check-in — ChatBot settings, Managing a Check-out — ChatBot settings, Portfolio KPI review — ChatBot settings, Using in-app support — ChatBot settings, Resetting a Management User Password — ChatBot settings, Cancelling a Booking — ChatBot settings, Entering Monthly Utility Bills — ChatBot settings, Manual block hygiene — ChatBot settings.

Check-out ledger cleanup before refund

Managing a Check-out Step 6 and Step 6b can show In Debt or a wrong Est. Refund when the tenant paid correctly but the ledger holds duplicate departure transfers — not unpaid rent (Check-out collections before refund) or utility overages (Check-out final utilities handoff). Reject/revert mistaken receipts Reject / Revert clears phantom balances before Ready To Refund:

SurfaceUse it for
Bookings — TransactionsPer-row Reject payment / Revert payment on duplicate departure transfers (bookings-detail-transactions-revert-modal-info-banner.png, bookings-detail-transactions-reject-modal-credit-note-banner.png)
Finance → TransactionsPortfolio bulk Reject selected / Revert on duplicate pairs (finance-transactions-bulk-reject-selected-bar.png)
Bookings — DepositReady To Refund / Est. Refund gated until duplicate cleanup (bookings-detail-deposit-tab-ready-to-refund-toggle.png)
/notifications row-clickDuplicate Pending manual in-payment alert → booking before Approve both rows
Finance → Contract ValuesTop debtors inflated by duplicate — confirm pair on Transactions, not collections outreach
Finance → TransactionsNot issued credit note queue after invoiced Reject / RevertBulk Hostkit invoicing pacing
SymptomLikely causeFix
Ready To Refund blocked despite tenant paidDuplicate approved transferRevert duplicate on TransactionsStep 6 before Step 5
In Debt after tenant paid departure rentDuplicate pair on ledgerRevert duplicate — not Handling a Late Payment — Step 3 collections outreach
Two identical transfers, one PendingWrong approval pathReject selected on pending duplicate — Step 6bPending manual receipt approval
Two identical transfers, both approvedDuplicate approved rowRevert payment on duplicate — Reject/revert mistaken receipts
Est. Refund inflated by duplicateExtra receipt counted toward creditRevert duplicate before Step 5
Red / blue modal after Reject / RevertInvoiced charge needs credit noteIssue credit notesBulk Hostkit invoicing pacing, then re-check Deposit tab
Unpaid rent line on Payment PlanReal arrears — not duplicateCheck-out collections before refund — tenant has not paid
Unpaid utility overage lineFinal bill not settledCheck-out final utilities handoff — not ledger cleanup mesh
Duplicate Pending manual in-payment during departure weekRow-click before triageStep 4Reject selected before Approve both (finance-transactions-bulk-reject-selected-bar.png)
Support ticket — tenant paid but Ready To Refund blockedSelf-serve triage skippedUsing in-app support — Check-out ledger cleanup before refund before filing
Month-end duplicate pairs at KPI sign-offApprove both mistakenPortfolio KPI review — Step 7Reject selected / Revert before export

Booking detail Transactions — Revert payment confirmation with blue invoice follow-up info banner

Booking detail Transactions — Reject payment confirmation with red credit-note warning banner

Finance Transactions — bulk selection bar with Approve selected and Reject selected

Bookings — Deposit tab with Ready To Refund toggle enabled before the external bank transfer

Walkthrough: open booking Transactions row actions, review Reject payment / Revert payment modals, then confirm Ready To Refund on the Deposit tab after duplicate cleanup.
Walkthrough: Finance → Transactions Reject selected on duplicate Pending rows, Revert payment on an approved duplicate (clip closes without confirming), then Finance → DepositsDeposit Ready To Refund after ledger cleanup.

Hub matrix: Common Workflows — Check-out ledger cleanup before refund · Check-out ledger cleanup before refund hub · FAQ — Check-out ledger cleanup before refund hub (bookings-detail-transactions-revert-modal-info-banner.png, finance-transactions-bulk-reject-selected-bar.png, bookings-detail-deposit-tab-ready-to-refund-toggle.png, bookings-payment-row-actions-flow.mp4, check-out-ledger-cleanup-before-refund-flow.mp4). Per-guide mesh: Managing a Check-in — Check-out ledger cleanup before refund, Managing a Check-out — Check-out ledger cleanup before refund, Processing a New Booking — Check-out ledger cleanup before refund, Notification triage — Check-out ledger cleanup before refund, Handling a Late Payment — Check-out ledger cleanup before refund, Cancelling a Booking — Check-out ledger cleanup before refund, Onboarding a New Property — Check-out ledger cleanup before refund, Portfolio KPI review — Check-out ledger cleanup before refund, Manual block hygiene — Check-out ledger cleanup before refund, Entering Monthly Utility Bills — Check-out ledger cleanup before refund, Resetting a Management User Password — Check-out ledger cleanup before refund, Using in-app support — Check-out ledger cleanup before refund.

Deposit lifecycle status

When payment-driven lifecycle is enabled (#781), Vivin stores a single depositStatus on each booking. The lifecycle pill on the booking Deposit tab and matching Finance → Deposits row chips use the same vocabulary — distinct from the amber Partially paid collection badge (which compares Paid vs Amount on the same tab).

SurfaceUse it for
Bookings — DepositLifecycle pill on Initial DepositNot Paid through Refunded (bookings-detail-deposit-tab.png, bookings-detail-deposit-tab-unpaid-badge.png, bookings-detail-deposit-tab-paid-badge.png)
Finance → DepositsDeposit lifecycle status row — click Partial paid, Ready to refund, Refunded, or other cards for portfolio triage (finance-deposits-status-cards.png)
Other filters → Deposit statusSame lifecycle slice on Bookings or FinanceFinance — Deposit status filter (bookings-list-other-filters-deposit-status.png, finance-other-filters-deposit-status.png)
Settings → Preferences — Deposit lifecycleAccount toggles for payment-driven lifecycle and Require "Ready to Refund" step (settings-preferences-deposit-lifecycle-toggles.png)
Finance → Deposits toolbar date rangeLifecycle card counts scope to the active date window — Finance Deposits date range
SymptomLikely causeFix
Lifecycle pill Partial Paid but rent line also amberRent Payment Plan vs depositOpen booking Deposit tab — security deposit shortfall, not scheduled rent — Partly collected security deposit
Partial paid lifecycle card shows zero rowsToolbar date range excludes stayDeposit missing on Finance Deposits — clear range first
Ready To Refund toggle disabled at departureRent/fee arrears on Payment PlanCheck-out collections before refund — not deposit shortfall alone
Refund / Mark refunded greyed on Deposit tabActive Disputed freezeDeposit disputeResolve Dispute after internal review
Pill stuck on Fully Paid at check-outReady To Refund step requiredManaging a Check-out — Step 5 — toggle Ready To Refund (bookings-detail-deposit-tab-ready-to-refund-toggle.png)
Month-end KPI finds wrong lifecycle mixCard counts scoped to date windowPortfolio KPI review — Step 7 — clear toolbar range; triage Partial paid, Ready to refund, Disputed
Deposit shortfall at confirmation or move-inFirst transfer below AmountProcessing a New Booking — Step 5 / Managing a Check-in — Step 3
Lockout-delayed deposit triagePassword recovery delayed catch-upResetting a Management User Password — Step 3Finance → Deposits lifecycle cards
Partially paid badge or lifecycle pill defectsProduct defect after self-serveUsing in-app support — Deposit lifecycle statusFinance module ticket

Finance Deposits — Deposit lifecycle status row with Partial paid, Ready to refund, and Refunded cards

Booking detail — Deposit tab with lifecycle pill and Initial Deposit row

Booking detail — Deposit tab Ready To Refund toggle after charges are settled

Walkthrough: Finance → Deposits Deposit lifecycle status cards (Ready to refund, Refunded, Not paid) — row-open to booking Deposit tab lifecycle pill contrast.
Walkthrough: toggle Ready To Refund on the booking Deposit tab, then Mark refunded on Finance → Deposits after the external bank transfer.

Hub matrix: Common Workflows — Deposit lifecycle status · Deposit lifecycle status hub · FAQ — Deposit lifecycle status hub (finance-deposits-status-cards.png, bookings-detail-deposit-tab.png, bookings-detail-deposit-tab-ready-to-refund-toggle.png, deposit-lifecycle-status-flow.mp4, finance-deposits-tab-mark-refunded-flow.mp4). Per-guide mesh: Processing a New Booking — Deposit lifecycle status, Managing a Check-in — Deposit lifecycle status, Handling a Late Payment — Deposit lifecycle status, Cancelling a Booking — Deposit lifecycle status, Portfolio KPI review — Deposit lifecycle status, Managing a Check-out — Deposit lifecycle status, Notification triage — Deposit lifecycle status, Onboarding a New Property — Deposit lifecycle status, Manual block hygiene — Deposit lifecycle status, Resetting a Management User Password — Deposit lifecycle status, Entering Monthly Utility Bills — Deposit lifecycle status, Using in-app support — Deposit lifecycle status.

Deposit dispute

Managing a Check-out Step 5 and Cancelling a Booking Step 3 freeze outbound deposit returns when retention is contested — distinct from rent Check-out collections before refund, partly collected Partly collected security deposit shortfalls, and Deposit missing on Finance Deposits toolbar date range hiding older rows.

SurfaceUse it for
Bookings — DepositMark as Disputed / Resolve Dispute on a Fully Paid deposit (bookings-detail-deposit-tab-mark-disputed-button.png, bookings-detail-deposit-tab-disputed-state.png)
Finance → DepositsPortfolio Mark disputed / Resolve dispute row chips (finance-deposits-mark-disputed-row-action.png, finance-deposits-resolve-dispute-row-action.png)
Settings → Preferences — Enable deposit disputesAccount toggle required before dispute controls appear
Other filters → Deposit status → DisputedPortfolio triage on Bookings or FinanceFinance — Deposit status filter
Operations — TicketsDamage claims and linked cash flows documented before Resolve Dispute
InboxTenant WhatsApp pushback on deductions — confirm ledger state before chat reassurance
SymptomLikely causeFix
Refund / Mark refunded greyed on Deposit tabActive Disputed freezeResolve Dispute after internal review — Step 5
Mark as Disputed missing on booking Deposit tabToggle off or missing permissionEnable deposit disputes + bookings.dispute on role
Mark disputed chip missing on Finance → DepositsRow outside toolbar date rangeClear date rangeFAQ — Deposit missing on Finance Deposits
Deposit not Fully Paid yetWrong lifecycle state for disputePartly collected security deposit — collect shortfall first
Tenant contests retention during cancellationPolicy void deposit pathCancelling a Booking — Step 3Mark as Disputed before Mark refunded
Ready To Refund blocked despite settled chargesUnresolved Disputed flagResolve Dispute — not Check-out collections before refund rent mesh
Month-end KPI sign-off finds contested refundsDispute queue not triagedPortfolio KPI review — Step 7Disputed filter
Tenant WhatsApp contest before operator actionChat reassurance without ledgerInbox → booking Deposit tab — confirm Disputed state
Lockout-delayed dispute backlogPassword recovery delayed triageResetting a Management User Password — Step 3Finance → Deposits Disputed filter
Support ticket — refund blocked by disputeSelf-serve triage skippedManaging a Check-out — Step 5 before filing

Bookings — Deposit tab with Mark as Disputed beside Refund on a fully collected deposit

Bookings — Deposit tab Refund Disputed with dispute warning and Resolve Dispute (refund blocked)

Finance Deposits — Mark disputed row chip on a fully collected deposit

Finance Deposits — Resolve dispute row chip while the deposit lifecycle is Disputed

Walkthrough: Mark as Disputed on the booking Deposit tab, review the blocked Refund state, spot the matching Resolve dispute row on Finance → Deposits, then Resolve Dispute to restore the refund queue.

Hub matrix: Managing a Check-out — Step 5 · Deposit dispute hub · FAQ — Deposit dispute hub (bookings-detail-deposit-tab-mark-disputed-button.png, bookings-detail-deposit-tab-disputed-state.png, finance-deposits-mark-disputed-row-action.png, finance-deposits-resolve-dispute-row-action.png, deposit-dispute-mark-and-resolve-flow.mp4). Per-guide mesh: Managing a Check-out — Step 5, Cancelling a Booking — Step 3, Portfolio KPI review — Step 7, Notification triage — Step 4, Resetting a Management User Password — Step 3.

Partly collected security deposit

Pair with other Glossary hub sections

When a tenant pays less than the full security deposit in one transfer, Vivin marks the deposit Partially paidPaid above zero but below Amount on the booking Deposit tab (Partial Paid on depositStatus). This is distinct from Partial Paid rent rows on Payment Plan and from Deposit dispute freeze on Fully Paid deposits.

SurfaceUse it for
Finance → DepositsClick Partial paid in the Deposit lifecycle status row for portfolio triage (finance-deposits-lifecycle-partial-paid-card.png)
Bookings — DepositAmber Partially paid badge and remaining helper on Initial Deposit (bookings-detail-deposit-tab-partial-badge.png)
Other filters → Deposit status → Partial paidSame lifecycle slice on Bookings or FinanceFinance — Deposit status filter
Finance → Contract ValuesPortfolio filter without opening Deposits first — pairs with lifecycle card
Handling a Late Payment — Step 1Contrast deposit shortfall vs rent In Debt before collections outreach
SymptomLikely causeFix
Amber badge on Payment Plan rent lineRent collections meshOpen booking Deposit tab — security deposit, not scheduled rent
Partial paid lifecycle card shows zero rowsToolbar date range excludes stayDeposit missing on Finance Depositsclear range first
Ready To Refund toggle disabled at departureRent/fee arrears on Payment PlanCheck-out collections before refund — not deposit shortfall alone
Mark as Disputed attempted on shortfall depositWrong lifecycle state for disputeDeposit dispute — collect to Fully Paid first
Deposit shortfall at move-inDeparture inspection meshManaging a Check-in — Step 3 — chase remaining before key handover
Confirmation deposit shortfall after go-liveFirst transfer below AmountProcessing a New Booking — Step 5 — before Step 6 portal gates
Month-end KPI finds deposit shortfallsPartial paid card not triagedPortfolio KPI review — Step 7
Lockout-delayed deposit triagePassword recovery delayed catch-upResetting a Management User Password — Step 3Finance → Deposits Partial paid card
Partially paid badge or partial filter defectsProduct defect after self-serveUsing in-app support — Partly collected security depositFinance module ticket

Finance Deposits — Partial paid lifecycle card selected, narrowing rows to partly collected deposits

Booking detail — Deposit tab Initial Deposit row with amber Partially paid badge and remaining helper

Walkthrough: click the Partial paid lifecycle card on Finance → Deposits, open a partly collected row, then review the amber Partially paid badge on the booking Deposit tab.

Hub matrix: Common Workflows — Partly collected security deposit · Partly collected security deposit hub · FAQ — Partly collected security deposit hub (finance-deposits-lifecycle-partial-paid-card.png, bookings-detail-deposit-tab-partial-badge.png, finance-deposits-partial-collection-walkthrough.mp4). Per-guide mesh: Processing a New Booking — Partly collected security deposit, Managing a Check-in — Partly collected security deposit, Handling a Late Payment — Partly collected security deposit, Cancelling a Booking — Partly collected security deposit, Portfolio KPI review — Partly collected security deposit, Managing a Check-out — Partly collected security deposit, Notification triage — Partly collected security deposit, Resetting a Management User Password — Partly collected security deposit.

Finance Deposits date range

On Finance → Deposits, the toolbar date range (same control family as Transactions and Payouts) defaults to roughly the last three months through today. A deposit row is included when any of these dates intersects the active window:

  • Check-in / contract start
  • Check-out / contract end
  • Refund Due Date (from your account’s deposit refund limit in Settings → Payments)

The filter does not key off booking creation date. Ended stays whose move-out or refund due date fell before the default window often disappear from the table, status summary card counts, row chips (Mark disputed / Resolve dispute), and Export until you widen from / to or click Clear date range selection on the toolbar.

SurfaceUse it for
Finance → Deposits toolbar date rangeDefault ~3 months window; Clear date range selection widens portfolio triage (finance-deposits-date-range-toolbar-default.png, finance-deposits-date-range-toolbar-cleared.png)
Finance → Deposits lifecycle rowStatus summary card counts scope to the active date window — clear range before month-end sign-off
Finance → Deposits row chipsMark disputed / Resolve dispute only render on visible rows — widen range before dispute triage on older check-outs
Bookings — Deposit tabBooking-level deposit data can exist while the Finance portfolio row is hidden by the toolbar filter
Settings → PaymentsRefund Due Date on each deposit row derives from your account deposit refund limit
SymptomLikely causeFix
Tenant or unit missing from Deposits after an older move-outDefault ~3 months excludes check-out / Refund Due DateClear date range selection or widen from / to, then Search (finance-deposits-date-range-clear-flow.mp4)
Mark disputed / Resolve dispute chips missing on FinanceDispute actions only render on visible rowsClear or widen the toolbar range before portfolio dispute triage
Lifecycle card counts look too lowCards scope to the active date windowClear the range before month-end deposit sign-off — Portfolio KPI review — Step 7
Row visible on booking Deposit but never on FinanceDates still outside a widened windowConfirm Initial Deposit on booking Deposit; then clear range and search by tenant
Partial paid card empty but booking Deposit shows shortfallRange excludes the stay — not “no shortfalls”Clear range first, then Partly collected security deposit
Older move-outs surfaced during lockout catch-upDelayed refund/dispute triageLockout catch-up after password recovery — clear toolbar range before Partial paid card
Support ticket — deposit row missing on FinanceSelf-serve triage skippedUsing in-app support — Deposit missing on Finance Deposits before filing
Triage order

When a tenant or unit is missing from Deposits, clear the date range first, then use Search — before assuming the booking has no deposit record. The same rule applies when deposit disputes row actions do not appear for an older check-out.

Finance Deposits — default date range on the toolbar (about the last three months)

Finance Deposits — date range cleared so portfolio triage includes older move-outs

Walkthrough: open Finance → Deposits with the default toolbar range, click Clear date range selection, then review the widened portfolio table.

Date-range toolbar captures refreshed 2026-06-21 00:12 UTC (VIVIN_DOCS_BASE_URL=http://localhost:5173 VIVIN_DOCS_RECORD_API=$VITE_API_BASE_URL npx tsx tools/capture-finance-deposits-date-range-screenshot.ts).

Hub matrix: Common Workflows — Deposit missing on Finance Deposits · Finance Deposits date range hub · Deposit missing on Finance Deposits hub · FAQ — Deposit missing on Finance Deposits hub (finance-deposits-date-range-toolbar-default.png, finance-deposits-date-range-toolbar-cleared.png, finance-deposits-date-range-clear-flow.mp4). Per-guide mesh: Managing a Check-out — Deposit missing on Finance Deposits, Cancelling a Booking — Deposit missing on Finance Deposits, Portfolio KPI review — Deposit missing on Finance Deposits, Resetting a Management User Password — Deposit missing on Finance Deposits, Processing a New Booking — Deposit missing on Finance Deposits, Handling a Late Payment — Deposit missing on Finance Deposits, Managing a Check-in — Deposit missing on Finance Deposits, Notification triage — Deposit missing on Finance Deposits, Onboarding a New Property — Deposit missing on Finance Deposits, Entering Monthly Utility Bills — Deposit missing on Finance Deposits, Manual block hygiene — Deposit missing on Finance Deposits, Using in-app support — Deposit missing on Finance Deposits.

Deposit missing on Finance Deposits

A booking can show deposit data on the Deposit tab while Finance → Deposits hides the portfolio row — usually because the toolbar date range (default ~3 months) excludes check-in, check-out, or Refund Due Date. Clear date range selection or widen from / to before refund triage, dispute chips, lifecycle card counts, or Export.

SurfaceUse it for
Finance → Deposits toolbar date rangeDefault ~3 months window — Clear date range selection widens portfolio triage (finance-deposits-date-range-toolbar-default.png, finance-deposits-date-range-toolbar-cleared.png)
Bookings — Deposit tabPer-booking Initial Deposit can exist while Finance portfolio row is filtered out
Finance → Deposits lifecycle rowPartial paid / Ready to refund card counts scope to active range — clear before month-end sign-off
Finance → Deposits row chipsMark disputed / Resolve dispute only on visible rows — widen range for older check-outs
/notifications row-clickPayment alert opens booking but Finance row hidden — clear range on Step 4 before mark-read
SymptomLikely causeFix
Row on booking Deposit but missing on Finance → DepositsDefault ~3 months toolbar date rangeClear date range selection or widen from / to, then Search (finance-deposits-date-range-clear-flow.mp4)
Mark disputed / Resolve dispute chips missingDispute actions only render on visible rowsClear or widen toolbar range before portfolio dispute triage
Lifecycle card counts look too lowCards scope to the active date windowClear range before month-end deposit sign-off — Portfolio KPI review — Step 7
Partial paid card empty but booking Deposit shows shortfallRange excludes the stay — not “no shortfalls”Clear range first, then Partly collected security deposit
Older move-outs surfaced during lockout catch-upDelayed refund/dispute triageLockout catch-up after password recoveryClear toolbar range before Partial paid card
Support ticket — deposit row missing on FinanceSelf-serve triage skippedUsing in-app support — Deposit missing on Finance Deposits before filing

Finance Deposits — default date range on the toolbar (about the last three months)

Finance Deposits — date range cleared so portfolio triage includes older move-outs

Walkthrough: booking Deposit tab shows deposit data → Finance → Deposits default toolbar range with tenant search (row hidden) → Clear date range selection → portfolio row appears.

Hub matrix: Common Workflows — Deposit missing on Finance Deposits · Deposit missing on Finance Deposits hub · FAQ — Deposit missing on Finance Deposits hub (finance-deposits-date-range-toolbar-default.png, finance-deposits-date-range-toolbar-cleared.png, finance-deposits-date-range-clear-flow.mp4, deposit-missing-on-finance-deposits-triage-flow.mp4). Per-guide mesh: Managing a Check-out — Deposit missing on Finance Deposits, Cancelling a Booking — Deposit missing on Finance Deposits, Portfolio KPI review — Deposit missing on Finance Deposits, Resetting a Management User Password — Deposit missing on Finance Deposits, Processing a New Booking — Deposit missing on Finance Deposits, Handling a Late Payment — Deposit missing on Finance Deposits, Managing a Check-in — Deposit missing on Finance Deposits, Notification triage — Deposit missing on Finance Deposits, Onboarding a New Property — Deposit missing on Finance Deposits, Entering Monthly Utility Bills — Deposit missing on Finance Deposits, Manual block hygiene — Deposit missing on Finance Deposits, Using in-app support — Deposit missing on Finance Deposits.

Notification row navigation

On /notifications, row click marks unread then navigates using the first match among backend fields — distinguish this from Dashboard bell General rows that open in-panel detail.

SurfaceRow-click behaviourBest for
/notificationsOpens link, then bookingId, tenantId, listingId, propertyId (first match)Payment alerts, ticket pings, search and All / Unread / Read filters
Dashboard bell — GeneralOpens Notification detail in-panel; rarely jumps to BookingsQuick scan of recent events on desktop
Dashboard bell — InboxFollows link to /inbox or booking CommunicationWhatsApp / inbox message pings
MobileBell hidden — bookmark /notificationsSame row-click navigation as desktop full page
Target fieldTypical outcome
bookingIdOpens booking detail sidebar on Bookings (/bookings/list/:id)
tenantIdOpens tenant profile on Tenants
listingIdOpens unit editor on Listings
propertyIdOpens property editor on Listings
linkFollows backend deep link (for example Inbox or Communication)
(none set)Marks read when applicable; you stay on the inbox
SymptomLikely causeFix
Bell General row did not open BookingsIn-panel detail is defaultUse /notifications for row-click triage
Pending manual in-payment alert will not clearReceipt still pending on ledgerRow-click → TransactionsApprovePending manual in-payment (Finance)
Payment overdue row opened booking but debt unclearAlert deep-linked reservation onlyPayment Plan / Debt AgingPayment alert to receivables triage
New WhatsApp message from … on /notificationsMessage alert mixed with payment rowsBell Inbox sub-tab or Tools → InboxWhatsApp per-booking messaging hub
Row-click opened booking but Communication / Tickets redTab-scoped fetch failureBooking detail sidebar tab load failures — header Refresh
Deep link opens empty or 404Target entity archived or deletedDeep Links — Broken entity deep links
Bulk Mark all as read before triageSkipped row-click on actionable alertsNotification triage — Step 4 before Step 5

Notifications module — inbox row ready to open the related booking

Bookings — detail opened after clicking a payment notification row on /notifications

Walkthrough: click a payment alert on /notifications, land on the related booking, then return to clear unread.

Hub matrix: Common Workflows — Notification row-click navigation · Notification row navigation hub (notifications-module-row-click-target.png, notifications-row-navigate-to-booking-detail.png, notifications-row-navigation-flow.mp4). Per-guide mesh: Processing a New Booking — Notification row-click navigation, Cancelling a Booking — Notification row-click navigation, Managing a Check-in — Notification row-click navigation, Managing a Check-out — Notification row-click navigation, Entering Monthly Utility Bills — Notification row-click navigation, Handling a Late Payment — Notification row-click navigation, Portfolio KPI review — Notification row-click navigation, Notification triage — Notification row-click navigation, Manual block hygiene — Notification row-click navigation, Onboarding a New Property — Notification row-click navigation, Using in-app support — Notification row-click navigation, Resetting a Management User Password — Notification row-click navigation.

Payment notification (operator)

Email and in-app alerts tell operators when tenant money lands or balances fall behind. Three in-app row families often confuse triage — distinguish them before bulk mark-read on /notifications.

SurfaceUse it for
Preferences → Notifications & EmailsAccount Receive payment notifications master — required before any recipient gets mailbox email
Personal Settings → Your email preferencesPer-user Payment notification emails — same toggle gates your email and whether you join the in-app payment-row audience (/settings/personal)
Preferences → In-app notifications → PaymentsAccount master for Payments category rows on the Dashboard bell and /notifications
Personal Settings → Your in-app notifications → PaymentsPer-user opt-out (default On) — turn Off to hide Payments rows for your session only
/notificationsFull history, search, All / Unread / Read filters — canonical row-click navigation (notifications-module-row-click-target.png)
Dashboard bellRecent slide-over — no search; pair with /notifications for backlog triage
Row typeTypical summaryNext step
Payment receivedPayment received from tenant …Row-click → booking TransactionsApprove when status is still pending (Pending manual receipt approval)
Pending manual in-paymentOperator-recorded receipt still pendingRow-click → Approve paymentPending manual in-payment (Finance)
Payment overdueScheduled charge or balance past duePayment alert to receivables triageOngoing/Ended before Debt Aging
SymptomLikely causeFix
No email when tenant paysAccount or personal opt-in offReceive payment notifications on Preferences and Payment notification emails on Personal Settings
Email but no in-app rowIn-app master or personal opt-outPreferences → In-app notifications → Payments On + your Payments opt-out On
Teammate missing payment rowsPer-PM audience scopingThey must enable Payment notification emails on /settings/personal — rows use visibleToPropertyManagerIds
Payment received but Total Debt unchangedReceipt still pendingPending manual in-payment (Finance) — not a missing notification
Opened Debt Aging from payment overdue too earlySkipped single-booking triagePayment alert to receivables triage — row-click → Payment Plan / Transactions first
Upcoming alert treated as collectionsWrong lifecycle bandConfirmation alert triage — contrast Upcoming vs Ongoing/Ended payment overdue

Notifications module — row-click target on a payment alert opening the related booking

Walkthrough: /notifications row-click opens the related booking before bulk mark-read.

Hub matrix: Common Workflows — Payment notification (operator) · Payment notification (operator) hub (notifications-row-navigate-to-booking-detail.png, notifications-row-navigation-flow.mp4). Per-guide mesh: Processing a New Booking — Payment notification (operator), Handling a Late Payment — Payment notification (operator), Cancelling a Booking — Payment notification (operator), Managing a Check-in — Payment notification (operator), Managing a Check-out — Payment notification (operator), Entering Monthly Utility Bills — Payment notification (operator), Portfolio KPI review — Payment notification (operator), Notification triage — Payment notification (operator), Manual block hygiene — Payment notification (operator), Onboarding a New Property — Payment notification (operator), Using in-app support — Payment notification (operator), Resetting a Management User Password — Payment notification (operator).

Payment alert to receivables triage

Ongoing/Ended payment overdue alerts on /notifications deep-link one booking — triage balance on Payment Plan or Transactions before you open portfolio Debt Aging or start collections outreach. Contrast Upcoming confirmation-week alerts on Confirmation alert triage.

SurfaceUse it for
/notifications — Payment overdueRow-click → booking Payment Plan — canonical alert-driven entry (notifications-row-navigate-to-booking-detail.png)
Bookings — Payment PlanSingle-booking arrears after alert row-click
Bookings — TransactionsPayment received / Pending manual in-payment alerts — Approve before mark-read
Finance → Overview — Debt AgingRanked Top debtors when alert batch needs portfolio context (finance-overview-income-chart-debt-aging.png)
Finance → TransactionsAmber Pending chip — clear queue before Debt Aging sign-off (finance-transactions-pending-pill.png)
Dashboard — Total DebtHeadline KPI after single-booking triage — not a booking list
SymptomLikely causeFix
Bulk Mark all as read before opening each rowSkipped row-click on actionable alertsNotification triage — Step 4 — row-click every payment overdue alert first
Payment overdue on /notificationsAlert deep-linked reservation onlyRow-click → Payment Plan — then Handling a Late Payment — Step 1 or Top debtors
Pending manual in-payment on alertReceipt still pending on ledgerTransactionsApprove — not Debt Aging until queue clears — Pending manual receipt approval
Payment received from tenant … still unreadTransfer not approved yetTransactions — confirm ledger → Approve if still pendingNotification triage — Step 5
Total Debt high after alert triageAmber Pending or duplicate transfersFinance debt receivables triageRevert duplicates before collections
Upcoming Booking created / Payment received insteadConfirmation-week alert pathConfirmation alert triage — contrast Upcoming vs Ongoing/Ended payment overdue
Opened Debt Aging from payment overdue too earlySkipped single-booking triageRow-click → Payment Plan / Transactions first — hub: Common Workflows — Payment alert to receivables triage
Lockout-delayed payment overdue backlogPassword recovery delayed catch-upResetting a Management User Password — Step 3Notification triage — Steps 4–5

Notifications — row-click from payment alert opens booking detail for balance review

Finance Overview — Debt Aging panel with overdue buckets beside the Income chart

Walkthrough: row-click a payment overdue alert on /notifications, confirm balance on the opened booking, then clear unread in Step 5.
Walkthrough: when alert triage needs portfolio context, expand a Debt Aging bucket and open a booking from Top debtors.

Hub matrix: Common Workflows — Payment alert to receivables triage · Payment alert to receivables triage hub (notifications-row-navigate-to-booking-detail.png, notifications-row-navigation-flow.mp4, finance-overview-debt-aging-walkthrough-flow.mp4). Per-guide mesh: Processing a New Booking — Payment alert to receivables triage, Cancelling a Booking — Payment alert to receivables triage, Managing a Check-in — Payment alert to receivables triage, Managing a Check-out — Payment alert to receivables triage, Entering Monthly Utility Bills — Payment alert to receivables triage, Handling a Late Payment — Payment alert to receivables triage, Portfolio KPI review — Payment alert to receivables triage, Notification triage — Payment alert to receivables triage, Manual block hygiene — Payment alert to receivables triage, Onboarding a New Property — Payment alert to receivables triage, Using in-app support — Payment alert to receivables triage, Resetting a Management User Password — Payment alert to receivables triage.

Finance debt receivables triage

After single-booking alert triage on Payment alert to receivables triage, choose the right portfolio surface on Finance → Overview or post-login / — clear amber Pending receipts and Revert duplicate transfers before Top debtors collections or support escalation.

SurfaceUse it for
Dashboard — Total DebtPost-login headline KPI for ongoing stays — not a booking list (dashboard-kpi-total-debt-tooltip.png)
Finance → Overview — Debt AgingRanked Top debtors and overdue buckets — canonical collections triage (finance-overview-debt-aging-expanded-bucket.png)
Finance → Overview — Income chartPaid / Scheduled / In debt payment-line modal — month-scoped, not booking rows (finance-overview-income-status-in-debt-modal.png)
Finance → Overview — KPI stripTotal Debt, Uncovered Debt, and Manual Payments for all-booking receivables (finance-overview-kpi-cards.png)
Finance → TransactionsAmber Pending chip — clear queue before Debt Aging sign-off (finance-transactions-pending-pill.png)
/notifications row-clickUpstream alert triage before portfolio surfaces — Notification row-click navigation
SymptomLikely causeFix
Total Debt unchanged after Add PaymentReceipt still pendingPending manual receipt approvalApprove before Debt Aging (finance-transactions-pending-pill.png)
Top debtors still high after tenant paidDuplicate transfer approvedReject/revert mistaken receiptsRevert duplicate (bookings-detail-transactions-revert-modal-info-banner.png)
Opened Income → In debt modal, need booking rowsWrong surface — payment-line scopeDebt Aging Top debtorsFinance Income status drill-down
Dashboard Total Debt not clickableHeadline only on /Open Finance → Overview for Top debtors and Uncovered Debt
Uncovered DebtTotal DebtThin deposit offsetsPrioritize Top debtorsGlossary — Uncovered Debt
Payment overdue alert but portfolio rank neededSkipped single-booking triagePayment alert to receivables triage — row-click first, then Debt Aging
Top debtors skewed to one segmentMixed portfolio in default viewsPortfolio segmentation by tenant categoryFinance → Other filters → Tenant category
Utility overage In Debt after bill cycleRent vs utility scopeUtility overage collectionsContract Values filter, not rent Top debtors alone

Finance Overview — stacked Income chart with Paid, Scheduled, and In debt segments beside Debt Aging panel

Finance Overview — Debt Aging bucket expanded to show tenant · unit rows for an overdue band

Dashboard — Total Debt KPI card with portfolio debt headline and overdue (&gt;15 days) subtitle

Walkthrough: expand a Debt Aging overdue bucket on Finance → Overview and open a booking from Top debtors.
Walkthrough: expand a Debt Aging overdue bucket on Finance → Overview and open a booking from Top debtors.
Walkthrough: compare Total Debt and Uncovered Debt on the KPI strip, rank debtors in Debt Aging, then contrast the month-scoped Income → In debt payment-line modal.

Hub matrix: Common Workflows — Finance debt receivables triage · Finance debt receivables triage hub (finance-overview-income-chart-debt-aging.png, finance-overview-debt-aging-expanded-bucket.png, dashboard-kpi-total-debt-tooltip.png, finance-overview-debt-aging-walkthrough-flow.mp4, finance-debt-receivables-triage-flow.mp4). Per-guide mesh: Processing a New Booking — Finance debt receivables triage, Cancelling a Booking — Finance debt receivables triage, Managing a Check-in — Finance debt receivables triage, Managing a Check-out — Finance debt receivables triage, Entering Monthly Utility Bills — Finance debt receivables triage, Handling a Late Payment — Finance debt receivables triage, Portfolio KPI review — Finance debt receivables triage, Notification triage — Finance debt receivables triage, Manual block hygiene — Finance debt receivables triage, Onboarding a New Property — Finance debt receivables triage, Using in-app support — Finance debt receivables triage, Resetting a Management User Password — Finance debt receivables triage.

Handling a Late Payment collections

Receivables triage surfaces answer “who owes?” — Handling a Late Payment Steps 1–6 answer “what do I do next?” After Finance debt receivables triage or Payment alert to receivables triage, clear amber Pending receipts and Revert duplicate transfers before tenant outreach on Step 3.

QuestionStart with receivables triageStart with collections workflow
Need ranked debtors with days overdueFinance → Overview → Debt AgingFinance debt receivables triageHandling a Late Payment — Step 1 after you pick a booking
Payment overdue alert row-clickConfirm balance on opened booking — Notification row-click navigationStep 3 outreach after Step 2
Tenant paid but Total Debt unchangedPending manual receipt approvalApprove firstStep 4 / Step 4b
Tenant insists they paid twiceReject/revert mistaken receiptsRevert duplicateRe-open Debt Aging — not Step 3 until ledger is clean
Month-end Pending collections receiptsAmber Pending chip — Pending manual receipt approvalStep 6b mesh
Segment-wide arrears after self-serve Steps 1–5Portfolio segmentation by tenant categoryStep 6 Vivin support ticket
SurfaceUse it for
Finance → Overview — Debt AgingRanked Top debtors — canonical triage before Step 1 (finance-overview-income-chart-debt-aging.png)
Bookings — Payment PlanPer-booking In Debt lines after alert row-click (bookings-detail-payment-plan-tab-schedule.png)
Bookings — TransactionsAdd Payment, Approve payment, Revert on Steps 4–4b (bookings-detail-transactions-approve-payment-modal.png)
/notifications row-clickUpstream payment overdue alert before portfolio surfaces — Payment alert to receivables triage (notifications-row-navigate-to-booking-detail.png)
Finance → TransactionsAmber Pending chip — clear queue before Step 3 (finance-transactions-pending-pill.png)
Finance → DepositsPartial paid deposit shortfall — Partly collected security deposit, not rent collections
SymptomTriage surfaceCollections step
Opened Income → In debt modal, need tenant rowsDebt Aging buckets — not payment-line modalStep 1
Dashboard Total Debt not clickableFinance → OverviewStep 1
Balance unclear after alert row-clickPayment Plan / Transactions on sidebarStep 1 confirm before Step 3
Partly collected deposit, not rent arrearsFinance → Deposits Partial paid cardPartly collected security deposit — not rent collections

Finance Overview — Debt Aging panel with overdue buckets and top debtors for prioritizing late payments

Notifications — row-click from payment alert opens booking detail for Transactions approval

Walkthrough: expand a Debt Aging overdue bucket on Finance → Overview, open a booking from Top debtors, then continue collections on Handling a Late Payment — Step 1.
Walkthrough: open an arrears booking, confirm Payment Plan overdue pills, use Communication for tenant outreach, record a manual receipt via Transaction (Add Payment modal), then approve pending rows when your role allows.

Hub matrix: Common Workflows — Handling a Late Payment collections hub · Handling a Late Payment collections hub · FAQ — Handling a Late Payment collections hub (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). Per-guide mesh: API Reference — Handling a Late Payment collections, Account Settings — Handling a Late Payment collections, Processing a New Booking — Handling a Late Payment collections, Cancelling a Booking — Handling a Late Payment collections, Managing a Check-in — Handling a Late Payment collections, Managing a Check-out — Handling a Late Payment collections, Entering Monthly Utility Bills — Handling a Late Payment collections, Handling a Late Payment — Handling a Late Payment collections, Portfolio KPI review — Handling a Late Payment collections, Notification triage — Handling a Late Payment collections, Manual block hygiene — Handling a Late Payment collections, Onboarding a New Property — Handling a Late Payment collections, Using in-app support — Handling a Late Payment collections, Resetting a Management User Password — Handling a Late Payment collections

Uncovered Debt

On Finance → Overview, Uncovered Debt sits on the seven-card KPI strip beside Total Debt — it is the portion of portfolio underpayment not offset by security deposits you still hold. When Uncovered Debt tracks Total Debt closely, deposit cushions are thin — rank Debt Aging Top debtors before rate changes in Sales or bulk notification clears. The Dashboard Total Debt card covers ongoing bookings only and does not show Uncovered Debt.

SurfaceUse it for
Finance → Overview — KPI stripCompare Total Debt vs Uncovered Debt for deposit coverage (finance-overview-kpi-cards.png)
Finance → Overview — Debt AgingRanked Top debtors when thin deposit offsets need collections priority (finance-overview-debt-aging-expanded-bucket.png)
Dashboard — Total DebtPost-login headline for ongoing stays — not Uncovered Debt (dashboard-kpi-total-debt-tooltip.png)
Bookings — Deposit tabPer-booking deposit collection vs Partial Paid shortfall — distinct from portfolio KPI (bookings-detail-deposit-tab.png)
Finance → DepositsLifecycle cards when deposit shortfall clusters — pair with Partial paid (finance-deposits-status-cards.png)
Finance → TransactionsAmber Pending chip — KPIs lag until Approve (finance-transactions-pending-pill.png)
SymptomLikely causeFix
Uncovered DebtTotal DebtThin deposit offsets on debtorsPrioritize Top debtorsFinance debt receivables triage (finance-overview-debt-aging-expanded-bucket.png)
Looking for Uncovered Debt on /Dashboard shows ongoing Total Debt onlyOpen Finance → Overview seven-card strip (finance-overview-kpi-cards.png)
Total Debt high but Uncovered Debt much lowerStrong deposit cushions heldCollections still possible — focus Top debtors with highest absolute balance
Uncovered Debt unchanged after Add PaymentReceipt still pendingPending manual receipt approvalApprove before KPI sign-off (finance-transactions-pending-pill.png)
Top debtors inflated after tenant paidDuplicate transfer approvedReject/revert mistaken receiptsRevert duplicate (bookings-detail-transactions-revert-modal-info-banner.png)
Month-end Step 7 debt looks thin on depositsEnded stays still in Total DebtFinance → Overview all-booking KPIs — not Dashboard ongoing card alone — Portfolio KPI review — Step 7
Confirmation deposit below AmountPartial Paid on booking DepositPartly collected security deposit — distinct from portfolio Uncovered Debt KPI
Payment overdue alert but coverage rank neededSkipped single-booking triagePayment alert to receivables triage — row-click first, then KPI strip compare

Finance Overview — seven KPI cards including Total Debt and Uncovered Debt

Finance Overview — Debt Aging bucket expanded to show tenant · unit rows for an overdue band

Dashboard — Total Debt KPI card with portfolio debt headline and overdue (&gt;15 days) subtitle

Walkthrough: compare Total Debt and Uncovered Debt on the Finance → Overview KPI strip, then expand Debt Aging Top debtors when deposit coverage is thin.

Hub matrix: Common Workflows — Uncovered Debt KPI · Uncovered Debt hub (finance-overview-kpi-cards.png, finance-overview-debt-aging-expanded-bucket.png, dashboard-kpi-total-debt-tooltip.png, finance-uncovered-debt-kpi-triage-flow.mp4). Per-guide mesh: Processing a New Booking — Uncovered Debt KPI, Cancelling a Booking — Uncovered Debt KPI, Managing a Check-in — Uncovered Debt KPI, Managing a Check-out — Uncovered Debt KPI, Entering Monthly Utility Bills — Uncovered Debt KPI, Handling a Late Payment — Uncovered Debt KPI, Portfolio KPI review — Uncovered Debt KPI, Notification triage — Uncovered Debt KPI, Manual block hygiene — Uncovered Debt KPI, Onboarding a New Property — Uncovered Debt KPI, Using in-app support — Uncovered Debt KPI, Resetting a Management User Password — Uncovered Debt KPI.

Finance Income status drill-down

On Finance → Overview, the stacked Income chart splits each calendar month into Paid, Scheduled, and In debt. Click a coloured segment (or a row in its hover tooltip) for a payment-line modal scoped to that month and status — use View booking on a line when you need the reservation sidebar. For booking-level receivables (ranked debtors, days overdue), use the Debt Aging panel on the right — not the payment-line modal alone.

SurfaceUse it for
Finance → Overview — Income chartPaid / Scheduled / In debt segment-click — month-scoped payment-line modal (finance-overview-income-status-in-debt-modal.png)
Finance → Overview — Debt AgingRanked Top debtors and overdue buckets — booking-level rows (finance-overview-debt-aging-expanded-bucket.png)
Finance → Overview — Cash flow forecastConfirmed collections per period — not status segments (finance-overview-cash-flow-all-payments-modal.png)
Dashboard — Cash Flow ForecastRent due timing on post-login / — not collections or status segments (dashboard-cash-flow-forecast-chart.png)
Finance → TransactionsAmber Pending chip — Scheduled / In debt lag until Approve (finance-transactions-pending-pill.png)
/notifications row-clickSingle-booking triage before portfolio segment read — Notification row-click navigation
SymptomLikely causeFix
Opened Income → In debt modal, need ranked debtorsWrong surface — payment-line scopeDebt Aging Top debtorsFinance debt receivables triage (finance-overview-debt-aging-expanded-bucket.png)
Scheduled high but bank shows collectionsStatus vs cash-history mismatchCash flow forecast All payments modal — Cash flow forecast drill-down (finance-overview-cash-flow-all-payments-modal.png)
Paid segment disagrees with month-end KPIsAnalytics vs Finance scope driftPortfolio KPI review — Step 7 (finance-overview-income-drill-down-flow.mp4)
Income → In debt unchanged after Add PaymentReceipt still pendingPending manual receipt approvalApprove before re-reading segments (finance-transactions-pending-pill.png)
Income → In debt inflated after tenant paidDuplicate transfer approvedReject/revert mistaken receiptsRevert duplicate (bookings-detail-transactions-revert-modal-info-banner.png)
Confused rent due with Scheduled segmentDashboard vs Finance chart mix-upGlossary — Cash Flow Forecast (Dashboard) — rent due dates, not status segments
Payment overdue alert but segment rank neededSkipped single-booking triagePayment alert to receivables triage — row-click first, then Debt Aging or Income segment
Utility overage In Debt in month modalRent vs utility scopeUtility overage collectionsContract Values filter, not rent Top debtors alone

Finance Overview — stacked Income chart with Paid, Scheduled, and In debt segments beside Debt Aging panel

Finance Overview — In debt payment-line drill-down modal for a selected month

Walkthrough: click the red In debt segment on the stacked Income chart to open the month-scoped payment-line modal.
Walkthrough: Paid / Scheduled / In debt segment drill-down on Finance → Overview — payment-line modal, View booking, then contrast Debt Aging Top debtors for month-end Step 7 reconciliation.

Hub matrix: Common Workflows — Finance Income status drill-down · Finance Income status drill-down hub (finance-overview-income-chart-debt-aging.png, finance-overview-income-status-in-debt-modal.png, finance-overview-income-drill-down-flow.mp4). Per-guide mesh: Processing a New Booking — Finance Income status drill-down, Cancelling a Booking — Finance Income status drill-down, Managing a Check-in — Finance Income status drill-down, Managing a Check-out — Finance Income status drill-down, Entering Monthly Utility Bills — Finance Income status drill-down, Handling a Late Payment — Finance Income status drill-down, Portfolio KPI review — Finance Income status drill-down, Notification triage — Finance Income status drill-down, Manual block hygiene — Finance Income status drill-down, Onboarding a New Property — Finance Income status drill-down, Using in-app support — Finance Income status drill-down, Resetting a Management User Password — Finance Income status drill-down.

Cash flow forecast drill-down

On Finance → Overview, the Cash flow forecast chart below Income shows actual cash received per period (confirmed in-payments only — no Scheduled or In debt amounts). Toggle Month vs Day on the chart header. Click a bar to open an All payments drill-down listing every collection in that period — use View booking on a row when you need the reservation sidebar. For status-scoped payment lines (Paid / Scheduled / In debt), use the stacked Income chart above — not the collections chart alone.

SurfaceUse it for
Finance → Overview — Cash flow forecastMonth / Day bar-click — All payments modal (finance-overview-cash-flow-all-payments-modal.png, finance-overview-cash-flow-day-view.png)
Finance → Overview — Income chartPaid / Scheduled / In debt segment-click — status-scoped payment lines, not collections history (finance-overview-income-status-in-debt-modal.png)
Dashboard — Cash Flow ForecastRent due timing on post-login / — not collections or status segments (dashboard-cash-flow-forecast-chart.png)
Finance → Overview — Debt AgingRanked Top debtors when you need booking-level receivables, not payment-line lists (finance-overview-debt-aging-expanded-bucket.png)
Finance → TransactionsAmber Pending chip — month bars lag until Approve (finance-transactions-pending-pill.png)
/notifications row-clickSingle-booking triage before portfolio collections read — Notification row-click navigation
SymptomLikely causeFix
Bank received cash but Income → Paid looks lowStatus vs cash-history mismatchCash flow forecast All payments modal — confirmed collections only (finance-overview-cash-flow-all-payments-modal.png)
Opened Dashboard Cash Flow Forecast by mistakeDashboard vs Finance chart mix-upFinance Cash flow forecast on Finance → Overview — rent due is on / (Glossary — Cash Flow Forecast (Dashboard))
Scheduled high but bank shows collectionsLooking at status, not cash historyCash flow forecast bar click — contrast Income segments on Finance Income status drill-down
Month bar missing a transfer tenant insists they paidReceipt still pendingPending manual receipt approvalApprove before month bars update (finance-transactions-pending-pill.png)
Month-end collections vs Analytics mismatchMonth aggregation hides timingDay view on Cash flow forecastPortfolio KPI review — Step 7 (finance-overview-cash-flow-drill-down-flow.mp4)
Month bars inflated after tenant paid onceDuplicate transfer approvedReject/revert mistaken receiptsRevert duplicate before re-reading All payments (bookings-detail-transactions-revert-modal-info-banner.png)
Need ranked debtors, not payment-line listWrong surface — collections scopeDebt Aging Top debtorsFinance debt receivables triage (finance-overview-debt-aging-expanded-bucket.png)
Utility overage payment not visible in rent modalRent vs utility scopeUtility overage collectionsContract Values filter, not rent Top debtors alone
Payment received alert but portfolio total unclearSkipped single-booking triagePayment alert to receivables triage — row-click first, then Cash flow forecast month bar

Finance Overview — Cash flow forecast chart with Month and Day toggle on Finance Overview

Finance Overview — All payments drill-down modal for a selected month bar

Walkthrough: toggle Month / Day on Finance → Overview Cash flow forecast, click a bar to open the All payments modal, then contrast with Income status segments for scheduled vs collected.

Hub matrix: Common Workflows — Cash flow forecast drill-down · Cash flow forecast drill-down hub (finance-overview-cash-flow-all-payments-modal.png, finance-overview-cash-flow-day-view.png, finance-overview-cash-flow-drill-down-flow.mp4). Per-guide mesh: Processing a New Booking — Cash flow forecast drill-down, Cancelling a Booking — Cash flow forecast drill-down, Managing a Check-in — Cash flow forecast drill-down, Managing a Check-out — Cash flow forecast drill-down, Entering Monthly Utility Bills — Cash flow forecast drill-down, Handling a Late Payment — Cash flow forecast drill-down, Portfolio KPI review — Cash flow forecast drill-down, Notification triage — Cash flow forecast drill-down, Manual block hygiene — Cash flow forecast drill-down, Onboarding a New Property — Cash flow forecast drill-down, Using in-app support — Cash flow forecast drill-down, Resetting a Management User Password — Cash flow forecast drill-down.

Confirmation alert triage

Upcoming Booking created / Payment received / Pending manual in-payment alerts on /notifications deep-link one Upcoming booking — finish confirmation gates on Transactions or Contract Info before you bulk Mark all as read. Contrast Ongoing/Ended payment overdue alerts on Payment alert to receivables triage.

SurfaceUse it for
/notifications — Booking created / Payment receivedRow-click → Upcoming booking Transactions or Contract Info — canonical alert-driven entry (notifications-row-navigate-to-booking-detail.png)
Bookings — TransactionsPayment received / Pending manual in-paymentApprove payment before mark-read (bookings-detail-transactions-approve-payment-modal.png)
Bookings — Contract InfoBooking created alert — portal gates and Tenant category on Upcoming imports
Finance → TransactionsAmber Pending chip on confirmation imports — clear queue before Overview KPI sign-off (finance-transactions-pending-pill.png)
Dashboard — notifications bellPost-login Upcoming alert backlog — use /notifications for full triage with search and filters
Operations — Check-in & Check-outTurnover prep after confirmation receipts approved — not key handover until Managing a Check-in — Step 4
SymptomLikely causeFix
Bulk Mark all as read before opening each rowSkipped row-click on actionable alertsNotification triage — Step 4 — row-click every Upcoming alert first
Payment received but Payment Plan still unpaidTransfer still pending on ledgerProcessing a New Booking — Step 5bApprove payment on Transactions
Booking created on already-confirmed stayPortal gates not finishedProcessing a New Booking — Step 6 — not Managing a Check-in — Step 1 until ~7 days out
Pending manual in-payment on Upcoming importReceipt still pendingPending manual receipt approvalApprove before Notification triage — Step 5
Ongoing/Ended payment overdue insteadWrong lifecycle bandPayment alert to receivables triage — contrast Upcoming vs Ongoing/Ended payment overdue
Upcoming payment overdue before voidPre-cancel settlement neededCancelling a Booking — Step 2Payment Plan before void
Month-end lingering Pending on confirmation importsLingering confirmation receiptsProcessing a New Booking — Step 6b during Portfolio KPI review — Step 7
Stale Upcoming after calendar hold cleanupHold cleanup left orphan alertsManual block hygiene — Step 5 before bulk-clear
Lockout-delayed confirmation backlogPassword recovery delayed catch-upResetting a Management User Password — Step 3Notification triage — Steps 4–5

Notifications — row-click from confirmation alert opens booking detail for Transactions approval

Booking detail Transactions — Approve payment confirmation modal

Walkthrough: row-click a confirmation-week payment alert on /notifications, approve on Transactions, then clear unread in Step 5.

Hub matrix: Common Workflows — Confirmation alert triage · Confirmation alert triage hub (notifications-row-navigate-to-booking-detail.png, bookings-detail-transactions-approve-payment-modal.png, notifications-row-navigation-flow.mp4). Per-guide mesh: Processing a New Booking — Confirmation alert triage, Cancelling a Booking — Confirmation alert triage, Managing a Check-in — Confirmation alert triage, Managing a Check-out — Confirmation alert triage, Entering Monthly Utility Bills — Confirmation alert triage, Handling a Late Payment — Confirmation alert triage, Portfolio KPI review — Confirmation alert triage, Notification triage — Confirmation alert triage, Manual block hygiene — Confirmation alert triage, Onboarding a New Property — Confirmation alert triage, Using in-app support — Confirmation alert triage, Resetting a Management User Password — Confirmation alert triage.

Pending manual in-payment (Finance)

When an operator records a receipt with Add Payment (bank transfer, cash, platform, deposit refund, and other manual rails), the row often stays pending until a user with Approve payments confirms it. This is distinct from payment overdue receivables mesh (Payment alert to receivables triage) and from duplicate-transfer cleanup (Reject/revert mistaken receipts).

SurfaceUse it for
Finance → TransactionsClick the amber Pending chip on the All type-summary card for portfolio triage (finance-transactions-pending-pill.png)
Bookings — TransactionsPer-row Approve payment on one reservation (bookings-detail-transactions-approve-payment-modal.png)
Finance → Overview — Manual PaymentsMonthly manual in-payment total including pending — clickable month drill-down is not the approval queue (finance-overview-manual-payments-drilldown-modal.png)
/notifications — Pending manual in-paymentAlert persists until ledger Approve — row-click opens booking Transactions (Notification row-click navigation)
Dashboard — Total DebtHeadline and >15 days subtitle may lag until Approve — ongoing bookings only
Finance → Transactions — bulk barApprove selected / Reject selected — ledger Reject is bulk-only (finance-transactions-bulk-reject-selected-bar.png)
SymptomLikely causeFix
Total Debt unchanged after Add PaymentReceipt still pendingAmber Pending chip → Approve paymentPending manual receipt approval
Manual Payments KPI non-zero but queue unclearKPI includes pending rowsTriage Finance → Transactions — Overview card opens all manual rails, not pending-only
Pending manual in-payment alert persists on /notificationsLedger not approved yetRow-click → booking TransactionsApproveNotification triage — Step 4
Income → Paid / Cash flow forecast bar lowTransfer not approved yetFinance Income status drill-down / Cash flow forecast drill-downApprove first
Duplicate bank transfer in amber Pending queueWrong-booking or double entryReject selected while pendingReject/revert mistaken receipts (not Approve both)
Reject / Revert modal warns about credit notesCharge already invoicedCredit note warning (reject/revert) — clear Not issued credit note queue on Finance → Transactions
Month-end KPIs disagree after lockoutPassword recovery delayed catch-upLockout catch-up after password recovery + workflow Steps 5b / 6b
Approve payments permission missingRole lacks Finance tab accessUsers and roles — Role Permissions — Finance tabs hidden without Approve payments
Confused with payment overdue alertReceivables vs pending receiptPayment alert to receivables triageOngoing/Ended overdue vs Pending manual in-payment
Month-end Pending on confirmation importsLingering confirmation receiptsProcessing a New Booking — Step 6b during Portfolio KPI review — Step 7

Finance Transactions — All card with amber Pending chip active and filtered ledger rows

Finance Overview — Manual Payments KPI beside Total Debt (monthly manual total; triage pending rows on Transactions)

Finance Transactions — bulk selection bar with Approve selected and Reject selected

Walkthrough: Finance → Transactions — amber Pending chip → Approve payment (cancel before saving).

Hub matrix: Common Workflows — Pending manual receipt approval · Pending manual receipt approval hub · Pending manual in-payment (Finance) hub (finance-transactions-pending-pill.png, finance-overview-kpi-cards.png, finance-transactions-pending-approve-flow.mp4). Per-guide mesh: Processing a New Booking — Pending manual receipt approval, Handling a Late Payment — Pending manual receipt approval, Cancelling a Booking — Pending manual receipt approval, Managing a Check-in — Pending manual receipt approval, Portfolio KPI review — Pending manual receipt approval, Managing a Check-out — Pending manual receipt approval, Entering Monthly Utility Bills — Pending manual receipt approval, Notification triage — Pending manual receipt approval, Manual block hygiene — Pending manual receipt approval, Onboarding a New Property — Pending manual receipt approval, Using in-app support — Pending manual receipt approval, Resetting a Management User Password — Pending manual receipt approval.

New inventory to first booking handoff

Pair with other Glossary hub sections

Property setup to first arrival handoff

Pair with other Glossary hub sections

Confirmation to check-in handoff

Upcoming portal gates on Processing a New Booking — Step 6 must clear before Managing a Check-in — Step 1 arrival-week planning ~7 days before move-in. Contrast premature key handover with Confirmation alert triage alert-driven entry and Handling a Late Payment — Step 1 on unpaid move-in charges.

SurfaceUse it for
Bookings — Contract InfoPortal gates — contract signed, Tenant category, Copy / Impersonate Tenant on Upcoming imports (bookings-detail-contract-method-of-payments.png)
Bookings — status tabsConfirm reservation stays Upcoming with portal-ready checks before arrival week (booking-lifecycle-status-tabs-flow.mp4)
Bookings — Contract Info — confirmation/check-inRead-only Confirmation payments vs Check-in payments timing before handoff (bookings-detail-contract-info-confirmation-checkin-payments-readonly.png)
Operations — Check-in & Check-outCheck-ins pill + Next 7 days — canonical arrival-week scan after portal gates (workflows-operations-check-in-out-planning-view.png)
Finance → TransactionsAmber Pending on confirmation imports — clear before you trust arrival-week debt reads (finance-transactions-pending-pill.png)
Processing a New Booking — Step 6Canonical upstream portal gate checklist before handoff
Managing a Check-in — Step 1Canonical downstream arrival-week entry ~7 days before move-in
SymptomLikely causeFix
Started Managing a Check-in — Step 1 weeks earlyHandoff before ~7 days outFinish Processing a New Booking — Step 6 portal gates first — not arrival-week prep until move-in is ~7 days away
Tenant Portal Copy / Impersonate Tenant blockedPortal gates not finishedProcessing a New Booking — Step 6 — contract + Tenant category; escalate via Using in-app support — Confirmation to check-in handoff only after checklist
Contract not signed on Upcoming importConfirmation workflow incompleteStep 4Step 5 before Managing a Check-in — Step 4
Confirmation bank transfer still PendingReceipt not approvedProcessing a New Booking — Step 5b — distinct from Managing a Check-in — Step 3b move-in receipts
Move-in week but unpaid Payment Plan pillsUnpaid confirmation/move-in chargesHandling a Late Payment — Step 1 before Managing a Check-in — Step 4
Tenant category wrong on portalCategory not set on Tenant InfoProcessing a New Booking — Step 2 / Tenant Info before handoff — Glossary — Tenant category
Deposit only partly collectedDeposit shortfall vs rent Partial PaidPartly collected security deposit — not rent collections mesh
Month-end lingering Pending on confirmation importsLingering confirmation receiptsProcessing a New Booking — Step 6b during Portfolio KPI review — Step 7
Payment overdue alert before arrivalUpcoming receivables at boundaryNotification triage — Step 4Managing a Check-in — Step 3 before keys
Alerts quiet but Operations emptyHandoff timing or wrong lifecycle bandFinish Confirmation alert triage first — then Managing a Check-in — Step 1 when move-in is ~7 days out

Booking detail — Contract Info Method of payments with Tenant Portal copy and Impersonate Tenant

Booking detail — Contract Info, Confirmation payments and Check-in payments (read-only)

Walkthrough: confirm an Upcoming reservation on Bookings status tabs before handing off to arrival-week planning.

Operations — Check-in &amp; Check-out tab with Next 7 days and check-in rows for weekly planning

Hub matrix: Common Workflows — Confirmation to check-in handoff · Confirmation to check-in handoff hub (bookings-detail-contract-method-of-payments.png, bookings-detail-contract-info-confirmation-checkin-payments-readonly.png, booking-lifecycle-status-tabs-flow.mp4, workflows-operations-check-in-out-planning-view.png). Per-guide mesh: Processing a New Booking — Confirmation to check-in handoff, Managing a Check-in — Confirmation to check-in handoff, Notification triage — Confirmation to check-in handoff, Handling a Late Payment — Confirmation to check-in handoff, Cancelling a Booking — Confirmation to check-in handoff, Managing a Check-out — Confirmation to check-in handoff, Onboarding a New Property — Confirmation to check-in handoff, Portfolio KPI review — Confirmation to check-in handoff, Manual block hygiene — Confirmation to check-in handoff, Entering Monthly Utility Bills — Confirmation to check-in handoff, Resetting a Management User Password — Confirmation to check-in handoff, Using in-app support — Confirmation to check-in handoff.

Confirmation to check-in handoff

Check-in to check-out handoff

Managing a Check-in Step 4 hands over keys and the stay becomes OngoingManaging a Check-out Step 1 begins about one week before departure. Contrast premature departure planning with Confirmation to check-in handoff on Upcoming imports and Same-day turnover coordination on shared-unit one-day overlap.

SurfaceUse it for
Operations — Check-in & Check-outCheck-outs pill + Next 7 days — canonical departure-week scan (operations-check-in-out-check-outs-next-7-days.png)
Bookings — TimelineDeparture bars on Ongoing rows — spot ~7-day window (bookings-timeline-view.png)
Bookings — status tabsConfirm stay is Ongoing after Step 4 before departure planning
Bookings — Payment PlanMid-stay rent/fee arrears blocking departure-week refund planning (bookings-detail-payment-plan-tab-schedule.png)
/notifications row-clickpayment overdue on Ongoing stay → booking before Step 1
Managing a Check-in — Step 4Canonical upstream keys handed over → Ongoing
Managing a Check-out — Step 1Canonical downstream departure-week entry ~7 days before checkout
SymptomLikely causeFix
Started Managing a Check-out — Step 1 weeks before departureHandoff before ~7 days outFinish Managing a Check-in — Step 4 first — departure-week planning ~7 days before checkout
Still running check-in prep on Ongoing stayMid-stay workflow not closedStep 5 confirms Ongoing — then scan Check-outs pill
Operations → Check-in & Check-out empty ~7 days outWrong lifecycle band or date rangeSwitch to Check-outs pill + Next 7 days (operations-check-in-out-check-outs-next-7-days.png) — not Check-ins
payment overdue on Ongoing stay at bellMid-stay arrears block refund pathHandling a Late Payment — Step 1 before Managing a Check-out — Step 5
Deposit only partly collected at move-inDeposit shortfall vs rent Partial PaidPartly collected security deposit — chase before Step 4
Same-day turnover on shared unitOne-day overlap meshSame-day turnover coordination hub — outgoing Step 2 before incoming Step 4
Booking still Ongoing after departure dayCheck-out workflow incompleteManaging a Check-out — Step 7 — not more check-in prep
Month-end Ongoing entering departure weekSign-off backlogPortfolio KPI review — Step 7Check-outs pill
Lockout-delayed departure-week planningPassword recovery catch-upResetting a Management User Password — Step 3 → hub Lockout catch-up after password recovery
Support ticket asks when to switch workflowsSelf-serve triage skippedUsing in-app support — Check-in to check-out handoff before filing

Operations — Check-in &amp; Check-out tab, Check-outs pill with Next 7 days and grouped departure rows

Bookings Timeline — Week scale with departure and arrival bars on one unit row

Walkthrough: Operations → Check-in & Check-out Check-outs pill + Next 7 daysBookings → Timeline Week departure bar → return to Check-outs planning (Managing a Check-out — Step 1).

Hub matrix: Common Workflows — Check-in to check-out handoff · Check-in to check-out handoff hub (operations-check-in-out-check-outs-next-7-days.png, bookings-timeline-view.png, check-in-to-check-out-handoff-flow.mp4). Per-guide mesh: Processing a New Booking — Check-in to check-out handoff, Managing a Check-in — Check-in to check-out handoff, Managing a Check-out — Check-in to check-out handoff, Notification triage — Check-in to check-out handoff, Handling a Late Payment — Check-in to check-out handoff, Cancelling a Booking — Check-in to check-out handoff, Onboarding a New Property — Check-in to check-out handoff, Portfolio KPI review — Check-in to check-out handoff, Manual block hygiene — Check-in to check-out handoff, Entering Monthly Utility Bills — Check-in to check-out handoff, Resetting a Management User Password — Check-in to check-out handoff, Using in-app support — Check-in to check-out handoff.

Check-in to check-out handoff

Pair with other Glossary hub sections

Lockout catch-up after password recovery

After Resetting a Management User Password — Step 3, operational backlog accumulated during sign-in lockout still needs triage — alerts on /notifications, amber Pending receipts, portal gates, month-end KPIs, and directory load failures are common. Canonical ordered mesh: Getting Started — Lockout catch-up after password recovery.

SurfaceUse it for
Login — Reset your passwordSelf-service recovery before catch-up (workflows-login-reset-password-link.png)
/notifications row-clickAlert backlog triage — route payment overdue vs Upcoming before bulk mark-read (notifications-row-navigate-to-booking-detail.png)
Finance → TransactionsAmber Pending chip — Total Debt / In debt lag until Approve (finance-transactions-pending-pill.png)
Finance → OverviewMonth-end Total Debt / Debt Aging sign-off after Pending clears (finance-overview-income-chart-debt-aging.png, dashboard-kpi-total-debt-tooltip.png)
Bookings / Notifications listsFirst-fetch Retry when directories fail after lockout — Directory list load failures hub
Bookings → Communication / Tickets tabsTab-scoped Refresh when row-click opens booking but one tab is red — Booking sidebar tab load failures hub
SymptomLikely causeFix
Total Debt still high after alert triageReceipts still pending approvalPending manual receipt approval — Steps 6b (finance-transactions-pending-pill.png); duplicates → Reject/revert mistaken receipts before Debt Aging
Unread payment overdue vs Upcoming alerts mixedSkipped alert-type routingPayment alert to receivables triage vs Confirmation alert triageNotification triage — Step 4
/notifications or Bookings will not loadFirst-fetch directory failureDirectory list load failures hubRetry before row-click triage
Row-click opened booking but Communication redTab-scoped fetch onlyBooking sidebar tab load failures hub — header Refresh
Landlord MCP / AI Chat 403Stale management JWTRefresh credentials after Step 3Landlord MCP — How it connects
Setup wizard blocked mid-sequenceLockout delayed steps 4–15Getting Started — Lockout catch-up then Onboarding — Step 7
Partial paid card empty but booking Deposit shows shortfallToolbar date range excludes the stayDeposit missing on Finance Deposits — clear range, then Partly collected security deposit
Month-end KPIs disagree after catch-upPending mesh + skipped Step 7Portfolio KPI review — Step 7 after Pending manual receipt approval

Management sign-in — password reset entry point

Notifications — row-click from payment alert opens booking detail for Transactions approval

Finance Transactions — All card with amber Pending chip active and filtered ledger rows

Walkthrough: sign-in Forgot password? entry → /notifications row-click → Finance → Transactions amber Pending chip → Approve payment (cancel) → Finance → Overview debt sign-off.

Hub matrix: Common Workflows — Lockout catch-up after password recovery · Lockout catch-up after password recovery hub (workflows-login-reset-password-link.png, notifications-row-navigate-to-booking-detail.png, finance-transactions-pending-pill.png, lockout-catch-up-after-password-recovery-flow.mp4). Per-guide mesh: Resetting a Management User Password — Lockout catch-up after password recovery, Notification triage — Lockout catch-up after password recovery, Processing a New Booking — Lockout catch-up after password recovery, Handling a Late Payment — Lockout catch-up after password recovery, Portfolio KPI review — Lockout catch-up after password recovery, Managing a Check-out — Lockout catch-up after password recovery, Onboarding a New Property — Lockout catch-up after password recovery, Using in-app support — Lockout catch-up after password recovery, Manual block hygiene — Lockout catch-up after password recovery, Cancelling a Booking — Lockout catch-up after password recovery, Managing a Check-in — Lockout catch-up after password recovery, Entering Monthly Utility Bills — Lockout catch-up after password recovery.

Lockout catch-up after password recovery

Walkthrough media

Pair with other Glossary hub sections

MP4 clips complement PNG screenshots on workflow and module guides — start at Common Workflows — Walkthrough media. Hub parity: Common Workflows — Walkthrough media. Full pairing matrix: Glossary hub cross-reference.

Portfolio segmentation by tenant category

When KPI drift, collections concentration, or profile hygiene applies to only one tenant segment (corporate, short-stay, or Unassigned), apply Tenant category filters consistently on Bookings → Other filters, Finance → Other filters, and Tenants toolbar — then reconcile in Portfolio KPI review — Step 6. Contrast with Occupancy KPI to block hygiene handoff hub when segment filters look healthy but Occupancy / RevPAR still dip (stale manual holds — not category rules).

SurfaceUse it for
Bookings — Other filtersReservation list or Timeline by segment — full account-wide portfolio filter catalog (bookings-list-other-filters-tenant-category.png)
Finance — Tenant category filterReceivables, deposits, or Contract Values by segment — drawer lists segments on bookings in the Finance cache (finance-other-filters-tenant-category.png)
Tenants — Tenant category filterProfile counts and With Debt badges by segment (tenants-list-tenant-category-filter.png)
Settings → Tenant categoriesDefine segments, portal gates, and default for integration-created tenants
Analytics — Step 6Month-end segment outlier pass before account-wide rule changes
/notifications row-clickPayment alerts cluster on one cohort — add segment filter after Notification row-click navigation
SymptomLikely causeFix
Segment on Bookings but missing on Finance drawerFinance cache has no rows with that tenantCategoryId yetLoad Contract Values or mirror filter on Bookings / TenantsFAQ — Finance tenant category filter parity
Filter results stale after Tenants → Tenant Info recategorizationFinance caches warmingWait seconds — Finance tenant category cache refresh (#2088)
Direct booking has wrong portal modulesAdd booking has no category fieldAssign on Tenant Info before contract mail — FAQ — Assign tenant category for direct booking
Month-end KPIs skewed to one segmentMixed portfolio in default viewsPortfolio KPI review — Step 6 — align filters across modules
Collections concentrated on UnassignedIntegration default not setSettings > Tenant categories
Top debtors skewed to one segmentMixed portfolio in default Finance viewsFinance debt receivables triage — add Tenant category on Overview / Contract Values first
Segment filters healthy but Occupancy still dipsStale manual holds — not category rulesOccupancy KPI to block hygiene handoff hub — contrast category-driven vs hold-driven dips
Payment alerts cluster on one cohortSegment-scoped arrears/notifications row-click → Finance → Other filters → Tenant category before account-wide collections

Bookings list — Other filters drawer with Tenant category multi-select and one segment active

Finance Contract Values — Other filters drawer with Tenant category multi-select and one segment active

Tenants — toolbar tenant category filter with one segment active and narrowed directory

Tenants — toolbar tenant category filter with one segment active and narrowed directory

Walkthrough: Bookings → Filters → Tenant category (No tenant category) on one property → Finance → Contract Values → Other filters mirror → Tenants toolbar No category filter → Analytics for month-end segment review.

Hub matrix: Common Workflows — Portfolio segmentation by tenant category · Portfolio segmentation by tenant category hub (bookings-list-other-filters-tenant-category.png, finance-other-filters-tenant-category.png, tenants-list-tenant-category-filter.png, portfolio-segmentation-by-tenant-category-flow.mp4). Per-guide mesh: Onboarding a New Property — Portfolio segmentation by tenant category, Processing a New Booking — Portfolio segmentation by tenant category, Managing a Check-in — Portfolio segmentation by tenant category, Notification triage — Portfolio segmentation by tenant category, Handling a Late Payment — Portfolio segmentation by tenant category, Portfolio KPI review — Portfolio segmentation by tenant category, Managing a Check-out — Portfolio segmentation by tenant category, Cancelling a Booking — Portfolio segmentation by tenant category, Entering Monthly Utility Bills — Portfolio segmentation by tenant category, Manual block hygiene — Portfolio segmentation by tenant category, Resetting a Management User Password — Portfolio segmentation by tenant category, Using in-app support — Portfolio segmentation by tenant category.

Portfolio segmentation by tenant category

Pending manual receipt approval

Reject/revert mistaken receipts

Four ledger corrections share the same Transactions surfaces — pick the action that matches receipt status and whether Finance already invoiced the charge:

QuestionStart hereNotes
Duplicate still pending (never approved)Reject payment on booking Transactions, or Reject selected on Finance → TransactionsLedger Reject is bulk-only — no per-row reject icon on Finance
Duplicate already approvedRevert payment on booking Transactions or Finance row menuRolls allocations and balances back
Wrong row, not yet invoicedDelete payment on Finance → Transactions when enabledDisabled for vIBAN / provider platform or invoiced allocations
Reject / Revert on an invoiced chargeFinance → TransactionsNot issued credit note filter → Issue credit notes (N)Red / blue modals reference this queue — not a spreadsheet
SurfaceUse it for
Bookings — TransactionsPer-row Reject payment / Revert payment on one reservation (bookings-detail-transactions-reject-modal-credit-note-banner.png)
Finance → Transactions — bulk barReject selected — ledger Reject is bulk-only (finance-transactions-bulk-reject-selected-bar.png)
Finance → Transactions — invoice filter pillsNot issued credit note lists reversals still needing provider push
/notifications row-clickDuplicate Payment received alert → booking Transactions before Approve both rows
Finance → Contract ValuesTop debtors inflated by duplicate — confirm pair on Transactions, not collections outreach
SymptomLikely causeFix
Duplicate bank transfer still pendingNever approved — same ledger state as Pending manual receipt approvalReject payment / Reject selected — do not Approve
Duplicate already approvedWrong amount or wrong booking slipped through month-endRevert payment on booking Transactions or Finance row menu
Delete payment disabled on FinancevIBAN / provider platform rail or invoiced allocationRevert or Issue credit notes after reject/revert on invoiced charges
Red / blue modal after Reject / RevertFinance already invoiced the chargeNot issued credit note filter → Issue credit notes (N)
Total Debt unchanged after cleanupReceipt still pending or credit note not issuedPair Pending manual receipt approval + Finance — Issuing credit notes
Total Debt still high — duplicate never rejectedBoth rows approved by mistakeRevert the duplicate — then Finance debt receivables triage re-check Top debtors (bookings-detail-transactions-revert-modal-info-banner.png)
Amber Pending chip shows two identical transfersDuplicate before any ApproveReject selected on Finance → TransactionsPending manual receipt approval

Booking detail Transactions — Reject payment confirmation with red credit-note warning banner

Booking detail Transactions — Revert payment confirmation with blue invoice follow-up info banner

Finance Transactions — bulk selection bar with Approve selected and Reject selected

Walkthrough: booking Transactions — open Reject and Revert confirmation modals with credit-note banners (demo cancels each without saving).

Hub matrix: Common Workflows — Reject/revert mistaken receipts · Reject/revert mistaken receipts hub · Credit note warning (reject/revert) hub (bookings-detail-transactions-reject-modal-credit-note-banner.png, bookings-detail-transactions-revert-modal-info-banner.png, finance-transactions-bulk-reject-selected-bar.png, bookings-payment-row-actions-flow.mp4). Per-guide mesh: Processing a New Booking — Reject/revert mistaken receipts, Handling a Late Payment — Reject/revert mistaken receipts, Cancelling a Booking — Reject/revert mistaken receipts, Managing a Check-in — Reject/revert mistaken receipts, Portfolio KPI review — Reject/revert mistaken receipts, Managing a Check-out — Reject/revert mistaken receipts, Entering Monthly Utility Bills — Reject/revert mistaken receipts, Notification triage — Reject/revert mistaken receipts, Manual block hygiene — Reject/revert mistaken receipts, Onboarding a New Property — Reject/revert mistaken receipts, Using in-app support — Reject/revert mistaken receipts, Resetting a Management User Password — Reject/revert mistaken receipts.

Credit note warning (reject/revert)

When Finance may already have invoiced the charge, Reject payment and Revert payment confirmation modals surface accounting follow-up copy — a red credit note warning on Reject and a blue info banner on Revert. Vivin still rolls back the in-product allocation and creates credit-note reversal rows; the banners cue operators to clear the Not issued credit note queue on Finance → Transactions (or Set manual when accounting handles the nota de crédito outside Vivin).

SurfaceModal / queue behaviourBest for
Bookings — TransactionsPer-row Reject payment (red banner) or Revert payment (blue info)One reservation duplicate cleanup (bookings-detail-transactions-reject-modal-credit-note-banner.png)
Finance → Transactions — bulk barReject selected opens the same red-banner modal — ledger Reject is bulk-onlyPortfolio pending duplicates (finance-transactions-bulk-reject-selected-bar.png)
Finance → Transactions — invoice filter pillsNot issued credit note lists reversals still needing provider pushPost-Reject / Revert accounting queue
Finance → Transactions — bulk barIssue credit notes (N) — Hostkit pacing like Issue allocationMonth-end reversal batch after invoiced cleanup
Finance — Transaction detailIssue credit note to provider / Set manual per reversal allocationOne-off reversal when bulk bar is not appropriate
SymptomLikely causeFix
Red banner on Reject payment confirmCharge may already be invoicedProceed if duplicate is wrong — then filter Not issued credit note and Issue credit notes (N)
Blue info on Revert payment confirmApproved receipt tied to exported invoiceSame queue — Finance — Issuing credit notes
Not issued credit note filter empty after bannerReversal not created yet or already IssuedRefresh Finance → Transactions; check Issued credit note pill
Issue credit notes batch stays PendingHostkit rate limitSame pacing as Bulk Hostkit invoicingFAQ — Bulk Hostkit invoicing slow
Delete payment greyed out on Finance rowvIBAN / provider platform or invoiced allocationRevert instead — banners still apply when invoiced
Rent cut blocked below exported monthInvoiced floor — distinct from receipt cleanupExternal credit notes then Issue credit notesRent reduction after invoicing · Invoiced floor (rent) hub
Banner on Reject while row still pendingDuplicate never approvedExpected — Reject while pending; queue follow-up only if charge was invoiced before reject

Booking detail Transactions — Reject payment confirmation with red credit-note warning banner

Booking detail Transactions — Revert payment confirmation with blue invoice follow-up info banner

Finance Transactions — bulk selection bar with Approve selected and Reject selected

Walkthrough: booking Transactions — open Reject and Revert confirmation modals with credit-note banners (demo cancels each without saving).

Hub matrix: Common Workflows — Reject/revert mistaken receipts · Credit note warning (reject/revert) hub (bookings-detail-transactions-reject-modal-credit-note-banner.png, bookings-detail-transactions-revert-modal-info-banner.png, finance-transactions-bulk-reject-selected-bar.png, bookings-payment-row-actions-flow.mp4). Per-guide mesh: Processing a New Booking — Reject/revert mistaken receipts, Handling a Late Payment — Reject/revert mistaken receipts, Cancelling a Booking — Reject/revert mistaken receipts, Managing a Check-in — Reject/revert mistaken receipts, Portfolio KPI review — Reject/revert mistaken receipts, Managing a Check-out — Reject/revert mistaken receipts, Entering Monthly Utility Bills — Reject/revert mistaken receipts, Notification triage — Reject/revert mistaken receipts, Manual block hygiene — Reject/revert mistaken receipts, Onboarding a New Property — Reject/revert mistaken receipts, Using in-app support — Reject/revert mistaken receipts, Resetting a Management User Password — Reject/revert mistaken receipts.

Reject/revert mistaken receipts

Pair with other glossary clusters

Key glossary terms

Pair with other glossary clusters

High-traffic definitions pair with Glossary cluster cross-reference and hub parity on FAQ — Key glossary terms and Support — Key glossary terms. Full pairing matrix: Glossary hub cross-reference.