Concepts
Complete Getting Started — Recommended Setup Sequence (steps 1–12 on Account Settings tabs per Recommended setup order, then steps 13–15 in Listings, Bookings, and Tenants) and Onboarding a New Property — Step 7 go-live verification before you rely on concept deep dives for day-to-day troubleshooting. Guided walkthrough of settings steps 4–12: Onboarding a New Property. Each concept sub-guide opens with a First-time workspace setup tip tailored to that concept's setup prerequisites and a Finding your way in this guide tip with section anchors. When sign-in was restored mid-setup, see Getting Started — Lockout catch-up after password recovery. Concept reads that pair with optional setup sections: Payment Allocation (step 5+), Booking Lifecycle (step 14+), Tenant Portal and Integrations & Distribution (steps 11–12). Workflow pairing after go-live: Setup sequence after go-live (hub parity: Introduction — Setup sequence after go-live, Modules — Setup sequence after go-live, Account Settings — Setup sequence after go-live, Common Workflows — Setup sequence after go-live, Glossary — Setup sequence after go-live, FAQ — Setup sequence after go-live, Support — Setup sequence after go-live, API Reference — Setup sequence after go-live).
Skim Reference for bookmarkable routes, then Core Systems for lifecycle and ledger models. Tenant-facing behaviour: Tenant Experience; channels and automation: Platform Capabilities. Hub subsection map: Concepts hub subsection index (concept sections + Related subsections). Checklist-style procedures live in Common Workflows; screen-by-screen detail in Modules (hub: Modules hub subsection index). Each concept sub-guide opens with a First-time workspace setup tip tailored to that concept's setup prerequisites and a Finding your way in this guide tip with section anchors. Non-linear operator habits (Lockout catch-up, Notification row-click navigation, Payment alert to receivables triage, Finance debt receivables triage, Handling a Late Payment collections, Same-day turnover coordination, Check-out final utilities handoff, Check-out collections before refund, Check-out ledger cleanup before refund, Cancellation collections before void, Utility overage collections, Property setup to first arrival handoff, New inventory to first booking handoff, Confirmation to check-in handoff, Check-in to check-out handoff, Occupancy KPI to block hygiene handoff, Confirmation alert triage, Pending manual receipt approval, Reject/revert mistaken receipts, Portfolio segmentation by tenant category) have matching Related subsections on every concept sub-guide. Full pairing matrix: Concept cross-reference.
This section provides in-depth explanations of how Vivin's key systems work under the hood. While the Modules documentation describes what each screen does and the Common Workflows section shows how to complete specific tasks, the Concepts pages explain why things work the way they do — the underlying models, rules, and logic that drive the platform.
If you are new to Vivin, skim Getting Started first for interface layout, portfolio hierarchy, and shared terminology — then return here for deeper system behavior.
Read these pages when you want to understand the reasoning behind a feature's behavior, troubleshoot unexpected results, or make informed decisions about how to configure your account.
If you already know the behavior you need but want a checklist-style procedure, open Common Workflows. For short “why doesn’t this work?” answers across modules, use FAQ & Troubleshooting; for definitions of terms used on this site, see Glossary.
Many of the behaviors below surface in the same management hub you use every day. For example, the + Create New slide-out is a cross-module shortcut; which rows are enabled follows your role’s create permissions (see Create New Menu):
Reference
Bookmarkable routes here pair with Create New Menu (shortcut targets) and Core Systems module rows that expand each deep-link destination. Full pairing matrix: Concept cross-reference.
- Management Frontend Deep Links — Direct URL routes for platform.vivin.app. Use these links to open specific modules, tabs, or pages from emails, bookmarks, or shared links. The page pairs route tables with screenshots for Bookings, Tenants, Listings, and the full Notifications inbox so you can match a URL to what appears after sign-in. The same page documents Audit (
/audit) for manual availability blocks alongside other Tools routes. Route-to-module pairing: Management Frontend Deep Links section cross-reference. For how the Dashboard bell differs from/notifications, see Deep Links — Notifications and the Notifications module.
Core Systems
Lifecycle and ledger concepts here pair with Tenant Experience (portal self-service) and Platform Capabilities (channels and MCP). Screen docs: Modules. Full pairing matrix: Concept cross-reference.
- Booking Lifecycle — How bookings progress through statuses and what triggers each transition. Essential reading for understanding when and why to change a booking's status. Includes list status filter and Timeline walkthrough videos beside the lifecycle tab screenshots. Topic-to-module pairing: Booking Lifecycle section cross-reference.
- Payment Allocation — How the two-layer payment model works, including allocation priority, overpayment handling, correcting mistaken receipts (approve, reject, revert, and credit note follow-up when charges were invoiced), and invoiced floor (rent) when lowering scheduled rent below exported invoice totals. Read this before configuring payment priorities or investigating a payment discrepancy. Topic-to-module pairing: Payment Allocation section cross-reference.
- Utilities module — Bills Included ceiling model, supplier Connections, AI bill upload, and tenant overage charges on Payment plan. Pair with Entering Monthly Utility Bills for the monthly operator workflow (guide subsection index; section cross-reference; Deeper workflow reads; hub)
- Operations module — Maintenance tickets, operational cash flows, check-in/out queues, Draft ticket KPI filtering, and linked cash flows. Pair with Managing a Check-in and Managing a Check-out for turnover weeks (guide subsection index; section cross-reference; Deeper workflow reads; hub)
- Dashboard module — Post-login Today, Total debt, Vacant Units, and forecast KPI snapshot. Pair with Notification triage for bell alerts and Portfolio KPI review for month-end reconciliation (guide subsection index; section cross-reference; Deeper workflow reads; hub)
- Analytics module — Month-range KPI workspace (Overview, Revenue, Occupancy, ADR, RevPAR, Maintenance) with ranking tables and heatmaps. Requires Analytics module permission — see FAQ — How is Analytics different from the Dashboard? (guide subsection index; section cross-reference; Deeper workflow reads; hub)
- Listings module — Property wizard, Channels tab, Archived inventory, and unit management. Pair with Onboarding a New Property for the setup wizard (guide subsection index; section cross-reference; Deeper workflow reads; hub)
- Properties workspace — Legacy
/propertiesURL redirect table into Listings. Pair with Onboarding a New Property when old bookmarks land mid-setup (guide subsection index; section cross-reference; Deeper workflow reads; hub) - Booking engine details — Rich marketplace payload editor via the Full integration pill. Pair with Integrations & Distribution and Full listing feeds (guide subsection index; section cross-reference; Deeper workflow reads; hub)
- Finance module — Portfolio ledgers (Overview, Income, Contract Values, Transactions, Payouts, Deposits) with Approve payments permission gating. Pair with Handling a Late Payment and Payment Allocation (guide subsection index; section cross-reference; Deeper workflow reads; hub)
- Tenants module — Tenant directory, profile sidebars, With Debt segmentation, and table expand. Pair with Processing a New Booking for profile enrichment after reservation creation (guide subsection index; section cross-reference; Deeper workflow reads; hub)
- Sales module — Portfolio Overview KPIs, Multicalendar availability timeline, Pricing monthly rent grid, and Channels manager. Pair with Onboarding a New Property for marketplace linking and Integrations & Distribution for calendar sync strategy (guide subsection index; section cross-reference; Deeper workflow reads; hub)
- Inbox module — Portfolio-wide WhatsApp triage (
/inbox) with Dashboard bell Inbox sub-tab deep links. Pair with Notification triage and ChatBot settings (guide subsection index; section cross-reference; Deeper workflow reads; hub) - Notifications module — Full
/notificationsalert history with search and All / Unread / Read filters. Pair with Notification triage and Deep Links — Notifications (guide subsection index; section cross-reference; Deeper workflow reads; hub) - Audit module — Portfolio-wide Manual Blocks (unavailabilities) and Discounts (discounted contract values) with filters, export, and booking sidebar drill-down. Pair with Manual block hygiene and Portfolio KPI review (guide subsection index; section cross-reference; Deeper workflow reads; hub)
- AI Chat module — Vivin-internal AI Assistant using Landlord MCP tools for portfolio Q&A. Pair with Automation & AI and Landlord MCP (guide subsection index; section cross-reference; Deeper workflow reads; hub)
- Account Settings — Workspace-wide financial policies, user access, communication templates, integrations, and operational defaults. Pair with Onboarding a New Property and Getting Started — Recommended Setup Sequence.
- API Reference — Partner HTTP contracts (partial vs full listing feeds, booking import, webhooks, Swagger). Pair with Integrations & Distribution, Account Settings Integrations tab, and Integration field capability.
- Create New Menu — How the cross-module Create New entry points work from the management hub (tenants, bookings, properties, tickets, and more). Topic-to-category pairing: Create New Menu section cross-reference.
Tenant Experience
Portal and tenant-scoped automation pair with Payment Allocation (scheduled charges) and Settings > Tenant categories (segment gates). Booking-scoped MCP: Tenant MCP. Full pairing matrix: Concept cross-reference.
- Tenant Portal — What tenants see and can do in the web portal, how authentication works, and which settings control portal behavior. Tab-to-operator pairing: Tenant Portal section cross-reference.
- Tenant MCP — How the Tenant Model Context Protocol server exposes booking-scoped tools (data, portal links, chatbot rules, maintenance) to external AI clients — complementary to the web portal. Topic-to-tool pairing: Tenant MCP section cross-reference.
- Services Marketplace — How to offer extra services (cleaning, gym, insurance, etc.) to tenants and generate additional revenue through cross-selling and upselling. Topic-to-module pairing: Services Marketplace section cross-reference.
Platform Capabilities
Channels and automation here pair with API Reference (partner HTTP) and Landlord MCP (account-scoped external clients). Operator AI: AI Chat. Full pairing matrix: Concept cross-reference.
- Integrations & Distribution — How Vivin connects with every major European rental marketplace, Airbnb, Booking.com, and your own website via the white label booking engine. Covers calendar synchronisation, automatic booking import, and channel management. Topic-to-module pairing: Integrations & Distribution section cross-reference.
- Property & listing details (booking engine) — How rich property and unit fields are grouped for marketplace payloads and the booking engine; who can use the Full integration pill in Listings, tab reference, legacy URL redirects, and bookmarkable query params.
- Automation & AI — How Vivin uses artificial intelligence across the platform — from the tenant chatbot and smart invoice reading to predictive analytics, automated workflows, and external MCP clients (see Landlord and Tenant MCP below). Sales and Analytics surfaces combine charts and operator workflows; published rents are edited in Sales > Pricing, not by an in-app auto-pricing engine. Start with the channel map on that page when you need a single picture of how the management UI, MCP servers, and messaging channels all reach the Core API. Topic-to-surface pairing: Automation & AI section cross-reference.
- Analytics (KPI workspace) — Portfolio charts at
/analytics(Overview, Revenue, Occupancy, ADR, RevPAR, Maintenance) for a configurable month range — distinct from Sales calendars and per-listing rent grids. Requires Analytics module permission (analytics.module).
- AI Chat — The in-management AI Assistant for Vivin internal operators (
/ai-chat, Tools in the sidebar): natural-language portfolio Q&A using live account data. Distinct from the tenant chatbot under Account Settings → Chatbot and from Landlord/Tenant MCP servers. - Landlord MCP — How the Landlord Model Context Protocol server exposes Core API operations to external AI clients (tools, auth, permissions), and how it differs from tenant-scoped MCP. Topic-to-tool pairing: Landlord MCP section cross-reference.
Concept cross-reference
This table is the primary pairing matrix for concept pages — each sub-guide also opens with a First-time workspace setup tip, a Finding your way in this guide tip with section anchors, and its own section cross-reference anchor. Hub map: the Finding your way tip at the top of this page. Setup sequencing: Related — Setup sequence after go-live. Pair with individual sub-guide section cross-reference tables for longer matrices and Related subsection anchors (for example Booking Lifecycle — Turnover, cancellation, and collections workflows, Payment Allocation — Layer 2 receipts, approval, and corrections, Tenant Portal — Portal setup and tenant-facing workflows).
Use this table when one concept page naturally leads into another — each row links to the guides you should read before or after the primary topic. Each sub-guide also opens with a First-time workspace setup tip for that concept's setup prerequisites and a Finding your way in this guide tip with section anchors.
| Concept | Pair with these concepts |
| --------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Concepts hub subsection index | Modules hub subsection index (screen workspaces), Introduction hub subsection index (platform overview), Getting Started hub subsection index (onboarding sections), Common Workflows hub subsection index (operational procedures), Account Settings hub subsection index (setup tabs), API hub subsection index (partner HTTP guides), FAQ subsection cross-reference (troubleshooting deep-dives), Support hub subsection index (escalation steps), Glossary deep-dive index (term definitions), Core Systems (lifecycle and ledger models), Reference (bookmarkable routes) |
| Booking Lifecycle | Payment Allocation (scheduled charges and list filters), Tenant Portal (contract signing and check-in triggers), Integrations & Distribution (imported channel reservations), Notifications — Payment overdue alerts (Ongoing stays → Handling a Late Payment — Step 1). Topic table: Booking Lifecycle section cross-reference |
| Payment Allocation | Booking Lifecycle (status tabs on unpaid rows), Tenant Portal (tenant-initiated payments), Services Marketplace (add-on charges on the payment plan), Notifications — Payment overdue alerts, Handling a Late Payment — Step 1, Managing a Check-out — Step 6b (departure-week pending receipts), Payment Allocation — Correcting mistaken receipts, Common Workflows — Reject/revert mistaken receipts |
| Tenant Portal | Payment Allocation (portal payments and receipts), Services Marketplace (tenant add-on catalogue), Automation & AI (chatbot channel vs portal self-service), Settings > Tenant categories (portal modules and editable fields per segment), Glossary — Tenant category. Topic table: Tenant Portal section cross-reference |
| Tenant MCP | Landlord MCP (account-wide vs booking-scoped tools), Tenant Portal (portal links and booking context), Automation & AI (channel map and chatbot rules), Settings > Tenant categories (portal modules and Communications / Email per segment), Processing a New Booking (assign category before portal mail), Glossary — Tenant category. Topic table: Tenant MCP section cross-reference |
| Services Marketplace | Tenant Portal (visibility and purchase flows), Payment Allocation (Layer 1 schedule lines), Booking Lifecycle (timing: booking, check-in, or mid-stay), Settings > Tenant categories (Allow to see services and portal module gates per segment), Bookings — Other filters, Glossary — Tenant category. Topic table: Services Marketplace section cross-reference |
| Integrations & Distribution | API Reference (partner HTTP contracts), Deep Links (settings and channel-manager routes), Booking Lifecycle (imported reservation status), Settings > Tenant categories (default for integration-created tenants), Glossary — Tenant category. Topic table: Integrations & Distribution section cross-reference |
| Management Frontend Deep Links | Create New Menu (shortcut targets after create), Integrations & Distribution (/settings/integrations and channel tabs), Automation & AI (/ai-chat and /inbox routes), Settings > Tenant categories (/settings/tenantCategories), Bookings — Other filters, Finance — Tenant category filter, Tenants — Tenant category filter. Topic table: Management Frontend Deep Links section cross-reference |
| Create New Menu | Deep Links (bookmark module routes opened after create), Booking Lifecycle (new reservation status), Integrations & Distribution (channel imports vs manual Booking), Notifications — Payment overdue alerts, Handling a Late Payment — Step 1. Topic table: Create New Menu section cross-reference |
| Automation & AI | Landlord MCP (portfolio automation), Tenant MCP (booking-scoped automation), Tenant Portal (tenant self-service alongside chatbot), Settings > Tenant categories (Communication Rules audience and Communications / Email toggle), Emails — Audience tenant categories, Notifications — Payment overdue alerts, Handling a Late Payment — Step 1, Glossary — Tenant category. Topic table: Automation & AI section cross-reference |
| Landlord MCP | Tenant MCP (scope contrast), API Reference (auth and HTTP contracts), Automation & AI (channel map and AI Assistant), AI usage API (landlord_chat ledger), Settings > Tenant categories (default for integration-created tenants and create-booking follow-through), Processing a New Booking, FAQ — Assign tenant category for direct booking, Glossary — Tenant category. Topic table: Landlord MCP section cross-reference |
| Analytics (KPI workspace) | Dashboard (post-login KPI snapshot), Portfolio KPI review (month-end reconciliation), Sales (pricing vs occupancy charts), Finance — Tenant category filter, Bookings — Other filters, Portfolio KPI review — Step 6, Glossary — Tenant category. Topic table: Analytics section cross-reference |
| Dashboard | Analytics (month-range charts), Notification triage (bell vs /notifications), Booking Lifecycle (Today KPI and lifecycle mix). Topic table: Dashboard section cross-reference |
| Utilities | Payment Allocation (overage lines on Payment plan), Entering Monthly Utility Bills (monthly operator workflow), Listings (Bills Included ceilings at property level). Topic table: Utilities section cross-reference |
| Operations | Bookings (turnover and ticket context), Finance (tenant payments — not operational Cash Flows), Managing a Check-in / Managing a Check-out. Topic table: Operations section cross-reference |
| Finance | Payment Allocation (Layer 1 vs Layer 2), Bookings — Transactions, Handling a Late Payment, Finance — Tenant category filter, Bookings — Other filters, Glossary — Tenant category, FAQ — Finance tenant category filter parity. Topic table: Finance section cross-reference |
| Bookings | Booking Lifecycle (status filters and Timeline), Finance — Contract Values, Notification triage, Bookings — Other filters, Settings > Tenant categories, Glossary — Tenant category. Topic table: Bookings section cross-reference |
| Listings | Onboarding a New Property (property wizard), Integrations & Distribution (channel sync), Sales — Channels. Topic table: Listings section cross-reference |
| Properties workspace (legacy /properties) | Listings (redirect target), Legacy properties guide subsection index, Deep Links — Listings, Onboarding a New Property, Notifications — Payment overdue alerts, Handling a Late Payment — Step 1. Topic table: Legacy properties section cross-reference |
| Booking engine details | Listings (Full integration pill entry), Integrations & Distribution (white label + partner feeds), API Reference — Full listing feeds. Topic table: Booking engine details section cross-reference |
| Sales | Analytics (portfolio KPI charts vs pricing grids), Bookings — Timeline, Integrations & Distribution (calendar propagation). Topic table: Sales section cross-reference |
| Tenants | Handling a Late Payment (With Debt triage), Payment Allocation (reject/revert receipts), Bookings (contract-level actions), Tenants — Tenant category filter, Settings > Tenant categories, Glossary — Tenant category. Topic table: Tenants section cross-reference |
| Notifications | Notification triage (row-click routes), Dashboard (bell vs /notifications), Deep Links — Notifications, Notifications — Payment overdue alerts, Handling a Late Payment — Step 1. Topic table: Notifications section cross-reference |
| Inbox | Automation & AI (WhatsApp channel map), Bookings — Communication, Notification triage (Inbox bell sub-tab). Topic table: Inbox section cross-reference |
| Audit | Manual block hygiene, Portfolio KPI review, Bookings — Timeline. Topic table: Audit section cross-reference |
| AI Chat | Landlord MCP (shared tool surface), Automation & AI (channel map), AI usage API (landlord_chat ledger), Portfolio KPI review (verify assistant summaries). Topic table: AI Chat section cross-reference |
| Account Settings | Onboarding a New Property (go-live checklist), Integrations & Distribution (marketplace credentials), Payment Allocation (due dates and priorities). Tab matrix: Account Settings — Tab cross-reference |
| API Reference | Integrations & Distribution (partner distribution), Account Settings — Integrations (credentials UI), Booking engine details (rich payload editor). Topic table: API guide 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, FAQ — Settings & tenant communications, Onboarding a New Property (guided steps 4–12) |
| Documentation map & escalation | Introduction — Section cross-reference, 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, Settings > Interface language, FAQ — Navigation & shortcuts |
| Settings that shape concept behaviour | Account Settings — Tab cross-reference, Settings > Tenant categories, Settings > Emails, Support — Settings that shape escalations |
| Deeper workflow reads | Booking Lifecycle, Payment Allocation, Tenant Portal, Integrations & Distribution, Automation & AI, Landlord MCP, Tenant MCP, Onboarding a New Property |
| Recommended operator workflows | Common Workflows — Workflow cross-reference, Onboarding a New Property, Portfolio KPI review, Notification triage |
| Lockout catch-up after password recovery | Sign-in restored after password reset; onboarding, alert, or month-end backlog accumulated during lockout | Common Workflows — Lockout catch-up after password recovery, Getting Started — Lockout catch-up after password recovery, Resetting a Management User Password |
| Lockout catch-up after password recovery | Operational backlog mesh after sign-in recovery | Common Workflows — Lockout catch-up after password recovery, Getting Started — Lockout catch-up after password recovery, Resetting a Management User Password — Step 3 |
| Walkthrough media | MP4 walkthroughs beside PNG screenshots | Common Workflows — Walkthrough media, Modules, Account Settings |
| Notification row-click navigation | /notifications row-click into module routes from concept reads | Common Workflows — Notification row-click navigation, Deep Links — Notifications, Notifications module, Notification triage |
| Payment alert to receivables triage | payment overdue alerts on lifecycle and ledger concepts | Common Workflows — Payment alert to receivables triage, Payment Allocation, Booking Lifecycle, Handling a Late Payment — Step 1 |
| Finance debt receivables triage | Portfolio receivables surfaces after single-booking alert triage | Common Workflows — Finance debt receivables triage, Handling a Late Payment collections (Steps 1–6 after triage surfaces), Payment Allocation, Glossary — Finance Debt Aging, FAQ — Finance debt receivables triage hub |
| Handling a Late Payment collections | Receivables triage surfaces → Handling a Late Payment Steps 1–6 on ledger models | Common Workflows — Handling a Late Payment collections hub, Handling a Late Payment, Payment Allocation, FAQ — Handling a Late Payment hub (finance-overview-income-chart-debt-aging.png, notifications-row-navigate-to-booking-detail.png, finance-overview-debt-aging-walkthrough-flow.mp4) |
| Finance Income status drill-down | Income status segments on ledger concepts — payment-line modal vs booking receivables | Common Workflows — Finance Income status drill-down, Payment Allocation, FAQ — Finance Income status drill-down hub (finance-overview-income-status-in-debt-modal.png, finance-overview-income-drill-down-flow.mp4) |
| Cash flow forecast drill-down | Collections history vs scheduled receivables on ledger concepts | Common Workflows — Cash flow forecast drill-down, Finance Income status drill-down, Glossary — Cash flow forecast (Finance Overview) (finance-overview-cash-flow-all-payments-modal.png, finance-overview-cash-flow-drill-down-flow.mp4) |
| Same-day turnover coordination | Shared-unit departure + arrival overlap on lifecycle models | Common Workflows — Same-day turnover coordination, Booking Lifecycle, Glossary — Same-day turnover, FAQ — Same-day turnovers |
| Check-out final utilities handoff | Final-cycle utility overage models before deposit release | Common Workflows — Check-out final utilities handoff, Payment Allocation, Glossary — End-of-Booking cost split, FAQ — Check-out final utilities handoff |
| Check-out collections before refund | Departure-week rent/fee In Debt on ledger and allocation models before deposit release | Common Workflows — Check-out collections before refund, Payment Allocation, Handling a Late Payment, FAQ — Check-out collections before refund (workflows-check-out-coordination-flow.mp4, finance-contract-values-in-debt-filter.png) |
| Check-out ledger cleanup before refund | Duplicate departure transfers leave phantom In Debt on ledger models before refund | Common Workflows — Check-out ledger cleanup before refund, Payment Allocation — Correcting mistaken receipts, Reject/revert mistaken receipts, FAQ — Check-out ledger cleanup before refund (bookings-detail-transactions-revert-modal-info-banner.png, finance-transactions-bulk-reject-selected-bar.png) |
| Check-out vs cancellation | Completed stay → Ended vs policy void → Canceled on lifecycle models | Common Workflows — Check-out vs cancellation, Booking Lifecycle, Managing a Check-out, Cancelling a Booking, FAQ — Check-out vs cancellation (workflows-cancel-booking-refund-modal-flow.mp4, bookings-list-canceled-tab.png) |
| Cancellation collections before void | Pre-cancel rent/fee In Debt on ledger models before policy void | Common Workflows — Cancellation collections before void, Payment Allocation, Cancelling a Booking, FAQ — Cancellation collections before void (finance-contract-values-in-debt-filter.png, bookings-cancel-booking-modal-refund-types.png, workflows-cancel-booking-refund-modal-flow.mp4) |
| Wrong tenant on a booking | Booking–tenant profile link on lifecycle models — Change tenant vs Delete | Common Workflows — Wrong tenant on a booking, Booking Lifecycle, Bookings — Change tenant, FAQ — Wrong tenant on a booking (bookings-detail-change-tenant-control.png, bookings-detail-change-tenant-flow.mp4) |
| Cancel Booking vs Delete Booking | Soft-archive vs policy void on lifecycle and ledger models — Delete Booking vs Cancel booking | Common Workflows — Cancel Booking vs Delete Booking, Booking Lifecycle, Bookings module, FAQ — Cancel Booking vs Delete Booking (bookings-cancel-booking-modal-refund-types.png, workflows-cancel-booking-refund-modal-flow.mp4) |
| Portfolio retirement decisions | Building Archive vs reservation Cancel vs Delete on lifecycle and inventory models | Common Workflows — Portfolio retirement decisions, Listings — Archived properties, Bookings — Delete Booking, FAQ — Portfolio retirement decisions (listings-archived-populated-table.png, listings-archived-unarchive-sidebar.png, finance-transactions-type-summary-cards.png) |
| Archive property (building-level) | Building-level Archive / Unarchive on inventory models — history preserved | Common Workflows — Archive property (building-level), Listings — Archived properties, Glossary — Archived property, FAQ — Archive a property (listings-archived-populated-table.png, listings-archived-unarchive-sidebar.png) |
| Utility overage collections | Mid-stay utility overage arrears on ledger and allocation models | Common Workflows — Utility overage collections, Payment Allocation, Entering Monthly Utility Bills, Handling a Late Payment |
| Property setup to first arrival handoff | Go-live inventory → first arrival week on lifecycle and portal models | Common Workflows — Property setup to first arrival handoff, Booking Lifecycle, Glossary — Tenant category, FAQ — Property setup to first arrival handoff |
| New inventory to first booking handoff | Go-live inventory → first Upcoming reservation on lifecycle models | Common Workflows — New inventory to first booking handoff, Booking Lifecycle, Glossary — Tenant category, FAQ — New inventory to first booking handoff |
| Confirmation to check-in handoff | Upcoming portal and receipt models before arrival-week planning on lifecycle concepts | Common Workflows — Confirmation to check-in handoff, Booking Lifecycle, Tenant Portal, FAQ — Confirmation to check-in handoff (bookings-detail-contract-method-of-payments.png, workflows-operations-check-in-out-planning-view.png, booking-lifecycle-status-tabs-flow.mp4) |
| Check-in to check-out handoff | Ongoing mid-stay → departure-week planning on lifecycle and ledger models | Common Workflows — Check-in to check-out handoff, Booking Lifecycle, Managing a Check-in, Managing a Check-out, FAQ — Check-in to check-out handoff (operations-check-in-out-check-outs-next-7-days.png, bookings-timeline-view.png) |
| Occupancy KPI to block hygiene handoff | Analytics Occupancy / RevPAR dip without rate change on lifecycle and KPI models | Common Workflows — Occupancy KPI to block hygiene handoff, Booking Lifecycle, Glossary — Manual unavailability (manual block), FAQ — Occupancy KPI to block hygiene handoff hub (analytics-kpi-occupancy-tab.png, audit-manual-blocks-workspace.png) |
| Confirmation alert triage | Upcoming confirmation alerts on new reservations | Common Workflows — Confirmation alert triage, Booking Lifecycle, Processing a New Booking — Step 5b |
| Portfolio segmentation by tenant category | Review only corporate, short-stay, or unassigned tenants across reservations, receivables, and profiles | Common Workflows — Portfolio segmentation by tenant category, Settings > Tenant categories, Bookings — Other filters, Finance — Tenant category filter, Tenants — Tenant category filter, Glossary — Tenant category |
| Pending manual receipt approval | Common Workflows — Pending manual receipt approval, Finance — Pending manual payments, FAQ — Manual receipt still pending |
| Reject/revert mistaken receipts | Common Workflows — Reject/revert mistaken receipts, Payment Allocation — Correcting mistaken receipts, FAQ — Reject or revert an incoming payment |
| 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), Payment Allocation, Glossary — Fixed invoice date, FAQ — Month-end invoicing (fixed date) hub (settings-invoicing-invoice-date-toggle.png, finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png) |
| Bulk Hostkit invoicing | Month-end Issue allocation / Invoice selected paces Hostkit — refresh Transactions before re-issue | Common Workflows — Bulk Hostkit invoicing, Integrations & Distribution — Hostkit invoicing, Finance — Invoice automation, FAQ — Bulk Hostkit invoicing hub (finance-transactions-bulk-selection-bar.png, settings-invoicing-hostkit-series.png) |
| Rent reduction after invoicing | Invoiced floor blocks rent cuts — external credit notes then Issue credit notes | Common Workflows — Rent reduction after invoicing, Payment Allocation — Correcting mistaken receipts, Bookings — Rent reduction after invoicing, FAQ — Lower rent below invoiced (bookings-detail-change-monthly-rent-modal.png, bookings-rent-reduction-invoiced-floor-flow.mp4) |
| Modules where concepts surface | Modules — Module cross-reference, Bookings, Finance, Support — Module documentation hubs |
| Deeper concept reads | Booking Lifecycle, Payment Allocation, Tenant Portal, Integrations & Distribution, Automation & AI, Landlord MCP, Tenant MCP |
| Deeper API reads | Booking Lifecycle, Payment Allocation, Tenant Portal, Integrations & Distribution, Automation & AI, Landlord MCP, Tenant MCP, API hub subsection index; reciprocal links from API Reference — Deeper concept reads |
| Key glossary terms | Glossary cluster cross-reference, Glossary — Setup sequence vocabulary, Payment Allocation — Correcting mistaken receipts |
Concepts hub subsection index
This index pairs concept sections and Related hub subsections — use it when behaviour spans lifecycle models, tenant-facing surfaces, channels, or escalation hubs. Full pairing matrix: Concept cross-reference.
Related
Related below links concept reads to modules, workflows, settings, and escalation paths. Pair Setup sequence after go-live with Getting Started — Recommended Setup Sequence; pair Documentation map & escalation with Introduction — Section cross-reference. Each Related subsection has a row in Concept cross-reference above; each sub-guide Related block has matching anchors (for example Booking Lifecycle — Turnover, cancellation, and collections workflows, Payment Allocation — Layer 2 receipts, approval, and corrections, Tenant Portal — Portal setup and tenant-facing workflows, Booking Lifecycle — Deeper concept reads, Booking Lifecycle — Deeper API reads). Full pairing matrix: Concept cross-reference.
Setup sequence after go-live
Post-go-live pairing starts with Getting Started — Recommended Setup Sequence (steps 1–15) and Onboarding a New Property — Step 7. When a step is blocked, continue to Support — Setup sequence escalation. Full pairing matrix: Concept cross-reference.
- Setup steps 1–3 (General Information, Preferences, Users) — Complete before Onboarding a New Property; greyed-out + Create New rows usually mean step 3 permissions are missing (FAQ — Navigation & shortcuts)
- Setup steps 4–12 — Onboarding a New Property (property wizard Steps 1–6 mirror settings configuration; pair with Integrations & Distribution and Tenant Portal optional sections on Getting Started — Recommended Setup Sequence)
- Setup steps 13–15 (Listings, Bookings, Tenants) — First operational data; pair with Booking Lifecycle and Payment Allocation once reservations exist
- After steps 13–15 — Onboarding a New Property — Step 7 go-live verification before you escalate lifecycle or payment behaviour that disagrees with concept pages
- Optional setup sections on Getting Started — Recommended Setup Sequence map to concept reads: Payment Allocation and Booking Lifecycle (finance and reservations), Tenant Portal and Services Marketplace (portal add-ons), Integrations & Distribution and API Reference (channels), Automation & AI and Landlord MCP / Tenant MCP (external clients)
- When a settings tab, property wizard step, or module permission still blocks progress after self-serve docs, open Get Help & Support or Using in-app support — cite the matching setup step and pair with Support — Setup sequence escalation
Documentation map & escalation
Documentation-map bullets pair with Introduction — Section cross-reference and FAQ — Section cross-reference. Hub parity: Support — Section cross-reference, Common Workflows section cross-reference. Full pairing matrix: Concept cross-reference.
- Getting Started — Interface layout and Recommended Setup Sequence before deep dives; hub parity: Setup sequence after go-live
- Introduction — Platform overview and how documentation sections connect (Introduction — Section cross-reference); hub parity: Setup sequence after go-live
- Modules — Screen-by-screen reference for each management workspace (see Core Systems above for concept-to-module pairing); hub parity: Setup sequence after go-live
- Common Workflows — Procedures that apply these concepts in practice (hub: Common Workflows section cross-reference, Setup sequence after go-live)
- Account Settings — Workspace-wide financial policies, templates, integrations, and operational defaults; setup sequence tab map: Recommended setup order and Tab cross-reference; workflow pairing: Setup sequence after go-live
- API Reference — HTTP contracts when concepts meet external integrations (including partial vs full feeds); hub parity: Setup sequence after go-live
- Glossary — Short definitions for terms used on concept and module pages (hub: Glossary cluster cross-reference, Setup sequence vocabulary, Setup sequence after go-live)
- FAQ & Troubleshooting — Answers aligned with lifecycle, payments, and portal behaviour (hub: FAQ — Section cross-reference, Setup sequence after go-live)
- Get Help & Support — Escalation when concept behaviour does not match the live product (hub: Support — Section cross-reference, Setup sequence after go-live, Setup sequence escalation)
- Using in-app support — Vivin product tickets when concept behaviour is unclear (section cross-reference; Deeper workflow reads; hub)
Navigation & bookmarks
Bookmark routes pair with Management Frontend Deep Links and Reference deep-link docs. Missing records: Create New menu. Full pairing matrix: Concept cross-reference.
- Management Frontend Deep Links — Bookmarkable module routes, tab anchors,
/notificationsvs Dashboard bell, and booking-engine details query params - Create New menu — Global + slide-out shortcuts into module modals (tenants, bookings, properties, tickets, and more)
- FAQ — Permission denied toast — Red You do not have permission to perform this action. toast when RBAC blocks a save; fix in Users → Role Permissions
- Deep Links — Account Settings —
/settings/*tab routes paired with integration, notification, and portal concept behaviour - Settings > Interface language — Personal UI locale before you share deep links with multilingual operators
Settings that shape concept behaviour
Account-wide defaults here pair with Account Settings — Tab cross-reference and per-concept First-time workspace setup tips. Tenant segments: Settings > Tenant categories. Full pairing matrix: Concept cross-reference.
- Settings > Preferences — In-app notifications — Account-wide alert categories that gate notification surfaces referenced on concept pages
- Settings > Emails — Communication Rules and lifecycle templates across booking, portal, and collections concepts
- Settings > Chatbot — Tenant messaging channel paired with Automation & AI and Inbox
- Settings > Integration field capability — Partner payload matrix alongside Integrations & Distribution
- Settings > Invoicing & Payments — Due dates, deposit rules, and export providers that shape Payment Allocation
- Settings > Services — Tenant add-on catalogue configured with Services Marketplace
- Settings > Tenant categories — Portal segments, default for integrations, and portfolio filters on Bookings, Finance, and Tenants
Recommended operator workflows
Workflow bullets pair with Common Workflows — Workflow cross-reference and per-concept section cross-reference tables. Month-end: Portfolio KPI review. Full pairing matrix: Concept cross-reference.
- Onboarding a New Property — Apply lifecycle, payments, and integration concepts during the property wizard; pair with Getting Started — Recommended Setup Sequence (steps 1–3 before, steps 13–15 + Step 7 after) (section cross-reference; Deeper workflow reads; hub)
- Processing a New Booking — Booking lifecycle and payment allocation when a reservation is first created (section cross-reference; Deeper workflow reads; hub)
- Handling a Late Payment — Step 1 — Collections when payment allocation and portal visibility matter; upstream path from Notifications — Payment overdue alerts (section cross-reference; Deeper workflow reads; hub)
- Managing a Check-in — Arrival-week workflow after Upcoming lifecycle concepts (section cross-reference; Deeper workflow reads; hub)
- Managing a Check-out & Deposit Refund — Deposit settlement, deposit dispute, and Deposit lifecycle status after long stays (section cross-reference; Deeper workflow reads; hub)
- Cancelling a Booking — Termination workflow alongside Booking Lifecycle status rules (section cross-reference; Deeper workflow reads; hub)
- Entering Monthly Utility Bills — Monthly supplier billing paired with Bills Included and Utilities concepts (section cross-reference; Deeper workflow reads; hub)
- Portfolio KPI review — Reconciliation tying Analytics, Finance, and Operations signals together (section cross-reference; Deeper workflow reads; hub)
- Common Workflows — Reject/revert mistaken receipts — Hub matrix when duplicate or invoiced receipts need Reject / Revert
- Notification triage — Row-click routes from
/notificationsinto Deep Links module routes (section cross-reference; Deeper workflow reads; hub) - Manual block hygiene — Audit pass when occupancy deep links show unexpected blocks (section cross-reference; Deeper workflow reads; hub)
- Resetting a Management User Password — Recover access when a lockout blocks concept validation in the management app (section cross-reference; Deeper workflow reads; hub)
Lockout catch-up after password recovery
External automation after lockout pairs with Landlord MCP — How it connects (JWT refresh). Hub parity: Common Workflows — Lockout catch-up after password recovery. Full pairing matrix: Concept cross-reference.
- Common Workflows — Lockout catch-up after password recovery — Hub matrix when sign-in was restored mid-setup or mid month-end
- Getting Started — Lockout catch-up after password recovery — Canonical operational backlog mesh
- Resetting a Management User Password — Self-service recovery before catch-up
- Landlord MCP — How it connects — Refresh Bearer JWT (and
Mcp-Session-Idif needed) after password rotation - Payment Allocation — Pending approval mesh after lockout-delayed month-end
Notification row-click navigation
Concept reads that cite alerts pair with Deep Links — Notifications and Management Frontend Deep Links. Hub parity: Common Workflows — Notification row-click navigation. Full pairing matrix: Concept cross-reference.
- Common Workflows — Notification row-click navigation — Hub matrix (
notifications-module-row-click-target.png,notifications-row-navigation-flow.mp4) - Deep Links — Notifications — Bookmarkable
/notificationsroutes - Notifications module — Notification row-click navigation — Canonical module pairing
- Notification triage — Step 4 row-click path
- Payment Allocation — Ledger context after row-click opens booking Transactions
- Payment alert to receivables triage — Ongoing/Ended payment overdue row-click
- Finance debt receivables triage — Total Debt vs Debt Aging after alert triage
- Confirmation alert triage — Upcoming Booking created / Payment received row-click
Payment alert to receivables triage
Payment and lifecycle concepts pair with Payment Allocation and Booking Lifecycle when /notifications payment overdue rows row-click into bookings. Hub parity: Common Workflows — Payment alert to receivables triage. Full pairing matrix: Concept cross-reference.
- Common Workflows — Payment alert to receivables triage — Hub matrix (
notifications-row-navigate-to-booking-detail.png,finance-overview-debt-aging-walkthrough-flow.mp4) - Payment Allocation — Two-layer model after row-click opens booking Transactions
- Booking Lifecycle — Ongoing/Ended status on overdue rows
- Notifications — Payment overdue alerts — Alert source rows
- Handling a Late Payment — Step 1 — Collections follow-through
- Handling a Late Payment collections — Steps 1–6 after triage surfaces
- Notification row-click navigation — Row-click on
/notificationsbefore portfolio KPI read - Pending manual receipt approval — Amber Pending before Debt Aging sign-off
- Finance debt receivables triage — Portfolio Top debtors after single-booking triage
Finance debt receivables triage
Portfolio receivables concepts pair with Payment Allocation and Glossary — Finance Debt Aging when Total Debt stays high after single-booking alert triage. Hub parity: Common Workflows — Finance debt receivables triage. Full pairing matrix: Concept cross-reference.
- Common Workflows — Finance debt receivables triage — Hub matrix (
finance-overview-income-chart-debt-aging.png,finance-overview-debt-aging-walkthrough-flow.mp4) - Payment alert to receivables triage — Single-booking alert triage before portfolio surfaces
- Payment Allocation — Two-layer model behind Debt Aging rows
- Glossary — Finance Debt Aging — Top debtors vocabulary
- Glossary — Uncovered Debt — Deposit-cushioned vs thin coverage
- Finance module — Finance debt receivables triage — Debt Aging canonical surface
- Pending manual receipt approval — Clear amber Pending before Top debtors sign-off
- FAQ — Finance debt receivables triage hub — Four-surface symptom table
- Handling a Late Payment collections — Triage surfaces → collections Steps 1–6
Handling a Late Payment collections
Two-layer Payment Allocation shapes receivables triage surfaces — Handling a Late Payment — Steps 1–6 cover tenant outreach, receipt recording, penalties, and escalation after you pick a booking from Debt Aging or a payment overdue alert. Hub parity: Common Workflows — Handling a Late Payment collections hub. Full pairing matrix: Concept cross-reference.
| Symptom | Triage surface | Collections step |
|---|---|---|
| Payment overdue alert | Row-click on /notifications | Handling a Late Payment — Step 1 |
| Ranked debtors needed | Finance → Overview → Debt Aging | Step 1 after booking open |
| Balance unchanged after transfer | Pending manual receipt approval | Step 4b |
- Common Workflows — Handling a Late Payment collections hub — Hub matrix (
finance-overview-income-chart-debt-aging.png,notifications-row-navigate-to-booking-detail.png,finance-overview-debt-aging-walkthrough-flow.mp4) - Payment alert to receivables triage — Upstream payment overdue alert row-click
- Finance debt receivables triage — Debt Aging Top debtors before tenant outreach
- Payment Allocation — Two-layer model behind Payment Plan and Transactions
- Handling a Late Payment — Full collections workflow (section cross-reference; Deeper workflow reads; hub)
- Notification triage — Upstream alert triage (Step 4)
- Pending manual receipt approval — Step 4b approval mesh
- Reject/revert mistaken receipts — Ledger cleanup before Step 3
- FAQ — Handling a Late Payment hub — Collections symptom table
- Glossary — Handling a Late Payment collections hub — Surface table + per-guide mesh
- API Reference — Handling a Late Payment collections — Partner import hub parity
Finance Income status drill-down
Two-layer Payment Allocation shapes Income chart Paid / Scheduled / In debt segments — segment-click opens payment-line modals; booking-level rank stays on Debt Aging. Hub parity: Common Workflows — Finance Income status drill-down. Full pairing matrix: Concepts — Section cross-reference.
- Common Workflows — Finance Income status drill-down — Hub matrix (
finance-overview-income-status-in-debt-modal.png,finance-overview-income-drill-down-flow.mp4) - Finance debt receivables triage — Debt Aging Top debtors when payment-line modal is not enough
- Finance module — Income status drill-down — Stacked Income chart canonical surface
- FAQ — Finance Income status drill-down hub — Symptom table for segment vs Debt Aging
- Portfolio KPI review — Finance Income status drill-down — Month-end Income reconciliation on Step 7
- Cash flow forecast drill-down — Collections history — distinct from status segments
- Payment Allocation — Two-layer model behind status segments
- Finance module — Canonical Income chart surface
Cash flow forecast drill-down
Approved collections on Cash flow forecast reflect Payment Allocation timing — distinct from Income status segments and Dashboard rent due chart. Hub parity: Common Workflows — Cash flow forecast drill-down. Full pairing matrix: Concepts — Section cross-reference.
- Common Workflows — Cash flow forecast drill-down — Hub matrix (
finance-overview-cash-flow-all-payments-modal.png,finance-overview-cash-flow-day-view.png,finance-overview-cash-flow-drill-down-flow.mp4) - Finance Income status drill-down — Paid / Scheduled / In debt segments — not collections history
- Finance module — Income chart and cash flow forecast — Canonical Cash flow forecast chart surface
- FAQ — Cash flow forecast drill-down hub — Symptom table for collections vs Income / Dashboard
- Portfolio KPI review — Cash flow forecast drill-down — Month-end collections reconciliation on Step 7
- Finance debt receivables triage — Top debtors when collections modal is not enough
- Payment Allocation — When approved receipts hit collections history
- Glossary — Cash flow forecast (Finance Overview) — Term definition
Same-day turnover coordination
Lifecycle models pair with Booking Lifecycle and Glossary — Same-day turnover when a departing Ongoing stay and incoming Upcoming reservation share one unit on the same calendar day — finish outgoing turnover before incoming key handover. Hub parity: Common Workflows — Same-day turnover coordination. Full pairing matrix: Concept cross-reference.
- Common Workflows — Same-day turnover coordination — Hub matrix (
operations-add-ticket-modal.png,bookings-timeline-day-week-month-and-sidebar.mp4) - Booking Lifecycle — Upcoming / Ongoing / Ended overlap on shared units
- Glossary — Same-day turnover — Shared-unit arrival/departure vocabulary
- Operations module — Same-day turnover coordination — Check-in & Check-out week lists primary entry
- Managing a Check-out — Step 2 — Turnover ticket before incoming Step 4
- Check-out collections before refund — Outgoing In Debt before incoming keys
- FAQ — Same-day turnovers — Four-step operator habit
Check-out final utilities handoff
Ledger and allocation concepts pair with Glossary — End-of-Booking cost split when final utility overage lines post on departure week — distinct from mid-stay Utility overage collections. Hub parity: Common Workflows — Check-out final utilities handoff. Full pairing matrix: Concept cross-reference.
- Common Workflows — Check-out final utilities handoff — Hub matrix (
utilities-allocations-review-flow.mp4,bookings-detail-payment-plan-tab-schedule.png,utilities-bills-tab-missing-toggle.png) - Payment Allocation — Two-layer model behind overage lines on Payment Plan
- Glossary — End-of-Booking cost split — End of Booking charge time vocabulary
- Utilities module — Check-out final utilities handoff — Allocations / Bills canonical posting
- Entering Monthly Utility Bills — Step 4 — Overage line verification before refund
- Managing a Check-out — Step 6 — Charge settlement gate before deposit release
- FAQ — Check-out final utilities handoff — Symptom table for final overage blocking refund
- Check-out collections before refund — Rent/fee arrears — distinct mesh
Check-out collections before refund
Ledger and allocation concepts pair with Payment Allocation when departure-week rent/fee lines stay In Debt on Payment Plan before deposit release — distinct from utility Check-out final utilities handoff and duplicate Check-out ledger cleanup before refund. Hub parity: Common Workflows — Check-out collections before refund. Full pairing matrix: Concept cross-reference.
- Common Workflows — Check-out collections before refund — Hub matrix (
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) - Payment Allocation — Two-layer model behind rent/fee lines on Payment Plan
- Bookings module — Check-out collections before refund — Payment Plan / Deposit tab settlement path
- Finance module — Check-out collections before refund — Portfolio Contract Values In Debt filter for departure-week arrears
- Managing a Check-out — Step 6 — Charge settlement gate before deposit release
- Handling a Late Payment — Step 1 — Collections when Ready To Refund is blocked
- Check-out final utilities handoff — Utility overage lines — distinct mesh
- FAQ — Check-out collections before refund — Symptom table for rent/fee In Debt blocking Ready To Refund
- Check-out ledger cleanup before refund — Duplicate transfers — distinct mesh
Check-out ledger cleanup before refund
Ledger and allocation concepts pair with Payment Allocation — Correcting mistaken receipts when duplicate departure transfers leave phantom In Debt before deposit release — distinct from rent Check-out collections before refund and utility Check-out final utilities handoff. Hub parity: Common Workflows — Check-out ledger cleanup before refund. Full pairing matrix: Concept cross-reference.
- Common Workflows — Check-out ledger cleanup before refund — Hub matrix (
bookings-detail-transactions-revert-modal-info-banner.png,finance-transactions-bulk-reject-selected-bar.png,bookings-detail-deposit-tab-ready-to-refund-toggle.png) - Payment Allocation — Correcting mistaken receipts — Two-layer model behind Reject / Revert
- Bookings module — Check-out ledger cleanup before refund — Transactions Reject / Revert on departure-week duplicates
- Finance module — Check-out ledger cleanup before refund — Portfolio Transactions bulk Reject selected
- Managing a Check-out — Step 6 — Canonical departure-week duplicate cleanup before Step 5
- Check-out collections before refund — Real arrears contrast (tenant did not pay)
- Reject/revert mistaken receipts — Duplicate transfer cleanup before Ready To Refund
- FAQ — Check-out ledger cleanup before refund — Symptom table for phantom In Debt / duplicate departure transfers
- Check-out vs cancellation — Ended vs Canceled lifecycle exit — distinct mesh
- Cancellation collections before void — Policy void — distinct mesh
Check-out vs cancellation
Lifecycle exit models pair with Booking Lifecycle when operators must choose completed stay (Ended) vs policy void (Canceled) — distinct from mistaken rows (Cancel Booking vs Delete Booking), departure-week Check-out collections before refund, and pre-cancel Cancellation collections before void. Hub parity: Common Workflows — Check-out vs cancellation. Full pairing matrix: Concept cross-reference.
- Common Workflows — Check-out vs cancellation — Hub matrix (
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) - Booking Lifecycle — Ended vs Canceled status tabs and filters
- Managing a Check-out — Step 7 — Normal completed stay → Ended
- Cancelling a Booking — Step 4 — Policy void → Canceled
- Bookings module — Check-out vs cancellation — Cancel booking modal, Canceled / Ended filters
- Finance module — Check-out vs cancellation — Deposits refund queue on both paths
- Check-out collections before refund — Departure-week arrears on Ended path
- Cancellation collections before void — Pre-cancel arrears on Canceled path
- FAQ — Check-out vs cancellation — Symptom table for Ended vs Canceled routing
Cancellation collections before void
Ledger and allocation concepts pair with Payment Allocation when pre-cancel rent/fee lines stay In Debt on Payment Plan before Cancelling a Booking — Step 4 — distinct from departure-week Check-out collections before refund, duplicate Check-out ledger cleanup before refund, and utility Check-out final utilities handoff. Hub parity: Common Workflows — Cancellation collections before void. Full pairing matrix: Concept cross-reference.
- Common Workflows — Cancellation collections before void — Hub matrix (
finance-contract-values-in-debt-filter.png,bookings-detail-transactions-approve-payment-modal.png,bookings-cancel-booking-modal-refund-types.png,workflows-cancel-booking-refund-modal-flow.mp4) - Payment Allocation — Scheduled charge settlement before policy void
- Bookings module — Cancellation collections before void — Payment Plan unpaid lines before Cancel booking
- Finance module — Cancellation collections before void — Portfolio Contract Values In Debt filter
- Cancelling a Booking — Step 2 — Canonical pre-cancel settlement before void
- Handling a Late Payment — Cancellation collections before void — Steps 1–4 before policy void
- Check-out collections before refund — Departure-week arrears contrast (completed stay)
- Reject/revert mistaken receipts — Duplicate transfer cleanup — distinct from rent arrears
- FAQ — Cancellation collections before void — Symptom table for In Debt blocking Cancel booking
- Wrong tenant on a booking — Valid stay with wrong profile — distinct mesh
- Cancel Booking vs Delete Booking — Duplicate row vs policy void — distinct mesh
Wrong tenant on a booking
Booking–tenant profile linkage pairs with Booking Lifecycle when a valid Upcoming reservation points at the wrong existing tenant — use Change tenant on Contract Info, not tenant master-data edits or Cancel Booking vs Delete Booking soft-archive. Hub parity: Common Workflows — Wrong tenant on a booking. Full pairing matrix: Concept cross-reference.
- Common Workflows — Wrong tenant on a booking — Hub matrix (
bookings-detail-change-tenant-control.png,bookings-detail-change-tenant-modal.png,bookings-detail-change-tenant-flow.mp4) - Booking Lifecycle — Upcoming reassignment guards before check-in and contract signing
- Bookings module — Wrong tenant on a booking — Change tenant control and reassignment guards
- Tenants module — Wrong tenant on a booking — Profile directory vs reservation reassignment contrast
- Processing a New Booking — Step 6 — Post-import profile check
- Cancel Booking vs Delete Booking — Duplicate row vs wrong profile decision table
- FAQ — Wrong tenant on a booking — Eligibility and symptom table
Cancel Booking vs Delete Booking
Lifecycle and ledger models pair with Booking Lifecycle when operators must choose policy void (Cancel booking with refund dialog) vs mistaken-row cleanup (Delete Booking soft-archive) — distinct from wrong-profile Wrong tenant on a booking, lifecycle exit Check-out vs cancellation, and pre-cancel Cancellation collections before void. Hub parity: Common Workflows — Cancel Booking vs Delete Booking. Full pairing matrix: Concept cross-reference.
- Common Workflows — Cancel Booking vs Delete Booking — Hub matrix (
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) - Booking Lifecycle — Canceled vs soft-archived row visibility
- Bookings module — Delete Booking (soft archive) — Soft-archive control and #1897 ledger behaviour
- Cancelling a Booking — Step 4 — Policy void → Cancel booking
- Finance module — Manual Transactions hidden after Delete Booking
- Wrong tenant on a booking — Valid stay with wrong profile — distinct mesh
- Glossary — Archived booking ledger visibility — #1897 Manual Transactions invariant
- FAQ — Cancel Booking vs Delete Booking — Decision table and symptom routing
Portfolio retirement decisions
Lifecycle and inventory models pair with Booking Lifecycle and Glossary — Archived property when operators must choose building-level Archive property, policy void Cancel booking, or mistaken-row Delete Booking soft-archive — distinct from Cancel Booking vs Delete Booking reservation-only scope and Wrong tenant on a booking profile reassignment. Hub parity: Common Workflows — Portfolio retirement decisions. Full pairing matrix: Concept cross-reference.
- Common Workflows — Portfolio retirement decisions — Hub matrix (
listings-archived-populated-table.png,listings-archived-unarchive-sidebar.png,bookings-cancel-booking-modal-refund-types.png,finance-transactions-type-summary-cards.png) - Booking Lifecycle — Canceled vs soft-archived vs building Archive scope contrast
- Listings module — Archived properties — Building retirement model
- Bookings module — Delete Booking (soft archive) — Reservation soft-archive and #1897 ledger behaviour
- Glossary — Archived property — Building scope vs Glossary — Archived booking ledger visibility
- Cancel Booking vs Delete Booking — Reservation void vs cleanup — distinct mesh
- Manual block hygiene — Portfolio retirement decisions — Portfolio sunsetting after hold cleanup
- FAQ — Portfolio retirement decisions — Three-way decision table and symptom routing
Archive property (building-level)
Inventory models pair with Glossary — Archived property when operators retire a whole building from active pickers — Archive property preserves booking and ledger history unlike Delete Booking (reservation soft-archive). Pair Portfolio retirement decisions when scope is unclear. Hub parity: Common Workflows — Archive property (building-level). Full pairing matrix: Concept cross-reference.
- Common Workflows — Archive property (building-level) — Hub matrix (
listings-archived-populated-table.png,listings-archived-unarchive-sidebar.png) - Listings module — Archived properties — Building retirement model
- Glossary — Archived property — Building scope vs Glossary — Archived booking ledger visibility
- Manual block hygiene — Portfolio retirement decisions — Clear holds before building Archive
- Portfolio retirement decisions — Three-way Archive vs Cancel vs Delete scope table
- Cancel Booking vs Delete Booking — Reservation void vs cleanup — distinct mesh
- FAQ — Archive a property — Step-by-step Archive / Unarchive
Utility overage collections
Ledger and allocation concepts pair with Payment Allocation and Glossary — End-of-Booking cost split when utility overage lines post on Payment Plan after monthly bill entry — distinct from departure-week Check-out final utilities handoff. Hub parity: Common Workflows — Utility overage collections. Full pairing matrix: Concept cross-reference.
- Common Workflows — Utility overage collections — Hub matrix (
utilities-allocations-row-breakdown-expanded.png,finance-contract-values-in-debt-filter.png,utilities-allocations-review-flow.mp4) - Payment Allocation — Two-layer model behind overage lines on Payment Plan
- Glossary — End-of-Booking cost split — End of Booking charge time contrast (not mid-stay mesh)
- Utilities module — Utility overage collections — Allocations / Bills canonical posting before collections
- Entering Monthly Utility Bills — Step 4 — Overage line verification before collections
- Handling a Late Payment — Step 1 — Collections after bill posting
- Check-out final utilities handoff — Departure-week subset contrast
- FAQ — Utility overage collections — Symptom table for unpaid utility overage on Payment Plan
Property setup to first arrival handoff
Lifecycle and portal models pair with Booking Lifecycle and Glossary — Tenant category when go-live inventory reaches its first arrival week — finish Onboarding a New Property — Steps 1–7 before Managing a Check-in — Step 1. Hub parity: Common Workflows — Property setup to first arrival handoff. Full pairing matrix: Concept cross-reference.
- Common Workflows — Property setup to first arrival handoff — Hub matrix (
listings-property-edit-access-lockers-tab.png,workflows-onboarding-property-wizard.mp4,workflows-operations-check-in-out-planning-view.png) - Booking Lifecycle — Upcoming first stay on new inventory before Ongoing
- Glossary — Tenant category — Property-level defaults before portal gates
- Listings module — Property setup to first arrival handoff — Access Lockers and portfolio verify on go-live
- Onboarding a New Property — Step 7 — Upstream go-live verify before first arrival
- Managing a Check-in — Step 1 — Downstream arrival-week entry (~7 days out)
- New inventory to first booking handoff — Upstream first Upcoming reservation on new property
- FAQ — Property setup to first arrival handoff — Symptom table for go-live → first arrival week
New inventory to first booking handoff
Lifecycle models pair with Booking Lifecycle and Glossary — Tenant category when go-live inventory needs its first Upcoming reservation — finish Onboarding a New Property — Steps 1–7 before Processing a New Booking — Step 1 duplicate checks or manual Add booking. Hub parity: Common Workflows — New inventory to first booking handoff. Full pairing matrix: Concept cross-reference.
- Common Workflows — New inventory to first booking handoff — Hub matrix (
listings-module-overview.png,bookings-add-booking-modal.png,workflows-onboarding-property-wizard.mp4) - Booking Lifecycle — Upcoming first stay on new inventory before Ongoing
- Glossary — Tenant category — Property-level defaults before portal gates
- Listings module — New inventory to first booking handoff — Portfolio verify on go-live Step 7
- Bookings module — New inventory to first booking handoff — First Upcoming status tabs / Add booking on new inventory
- Onboarding a New Property — Step 7 — Upstream go-live verify before first reservation
- Processing a New Booking — Step 1 / Step 6 — Duplicate check and confirmation gates
- Property setup to first arrival handoff — Downstream ~7-day arrival planning after first booking
- FAQ — New inventory to first booking handoff — Symptom table for go-live → first reservation
Confirmation to check-in handoff
Upcoming portal and receipt models pair with Booking Lifecycle and Tenant Portal — finish Processing a New Booking — Steps 5b–6 before Managing a Check-in — Step 1 (~7 days out). Hub parity: Common Workflows — Confirmation to check-in handoff. Full pairing matrix: Concept cross-reference.
- Common Workflows — Confirmation to check-in handoff — Hub matrix (
bookings-detail-contract-method-of-payments.png,workflows-operations-check-in-out-planning-view.png,booking-lifecycle-status-tabs-flow.mp4) - Booking Lifecycle — Upcoming status gates before arrival week
- Tenant Portal — Contract signing and portal module gates on Upcoming stays
- Bookings module — Confirmation to check-in handoff — Contract Info portal gates on Upcoming imports
- Operations module — Confirmation to check-in handoff — Check-in & Check-out Next 7 days after Step 6
- Processing a New Booking — Step 6 — Upstream portal sanity before handoff
- Managing a Check-in — Step 1 — Downstream arrival-week entry
- Confirmation alert triage — Alert-driven entry before Step 6 portal checks
- FAQ — Confirmation to check-in handoff — Symptom table for Upcoming → arrival week
Check-in to check-out handoff
Ongoing lifecycle and ledger models pair with Booking Lifecycle and Payment Allocation — finish Managing a Check-in — Step 4 before Managing a Check-out — Step 1 (~7 days out). Hub parity: Common Workflows — Check-in to check-out handoff. Full pairing matrix: Concept cross-reference.
- Common Workflows — Check-in to check-out handoff — Hub matrix (
operations-check-in-out-check-outs-next-7-days.png,bookings-timeline-view.png) - Booking Lifecycle — Ongoing status gates before departure week
- Payment Allocation — Departure-week charge settlement before deposit release
- Bookings module — Check-in to check-out handoff — Timeline departure bars on Ongoing rows
- Operations module — Check-in to check-out handoff — Check-outs pill + Next 7 days
- Managing a Check-in — Step 4 — Upstream key handover prerequisite
- Managing a Check-out — Step 1 — Downstream departure-week entry
- Confirmation to check-in handoff — Upstream Upcoming → arrival week contrast
- FAQ — Check-in to check-out handoff — Symptom table for Ongoing → departure week
Occupancy KPI to block hygiene handoff
KPI and calendar models pair with Booking Lifecycle and Glossary — Manual unavailability (manual block) when Analytics Occupancy / RevPAR dips without a rate change — run Portfolio KPI review — Step 3 before Manual block hygiene — Step 1. Hub parity: Common Workflows — Occupancy KPI to block hygiene handoff. Full pairing matrix: Concept cross-reference.
- Common Workflows — Occupancy KPI to block hygiene handoff — Hub matrix (
analytics-kpi-occupancy-tab.png,audit-manual-blocks-workspace.png,audit-manual-blocks-filter-scroll.mp4) - Booking Lifecycle — Availability bars vs Upcoming/Ongoing status on held units
- Glossary — Manual unavailability (manual block) — Hold semantics before calendar edits
- Glossary — Vacant Unit Preference — Whether manual blocks count as vacancy on Dashboard
- Analytics module — Occupancy KPI to block hygiene handoff — Occupancy tab dip signal
- Audit module — Occupancy KPI to block hygiene handoff — Manual Blocks portfolio workspace
- Portfolio KPI review — Step 3 — Upstream Ranking dip signal
- Manual block hygiene — Step 1 — Downstream Tools → Audit pass
- Portfolio segmentation by tenant category — When segment — not holds — explains the dip
- FAQ — Occupancy KPI to block hygiene handoff hub — Symptom table for KPI dip → block hygiene
Confirmation alert triage
Upcoming alerts on new reservations pair with Booking Lifecycle and Processing a New Booking confirmation gates. Hub parity: Common Workflows — Confirmation alert triage. Full pairing matrix: Concept cross-reference.
- Common Workflows — Confirmation alert triage — Hub matrix (
notifications-row-navigate-to-booking-detail.png,bookings-detail-transactions-approve-payment-modal.png) - Booking Lifecycle — Upcoming status on confirmation-week alerts
- Processing a New Booking — Step 5b / Step 6 — Canonical confirmation gates
- Notification row-click navigation — Row-click on
/notificationsbefore mark-read - Payment alert to receivables triage — Contrast Upcoming vs Ongoing/Ended payment overdue
- Pending manual receipt approval — Payment received alert until Approve payments
Walkthrough media
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: Concept cross-reference.
- Common Workflows — Walkthrough media — Canonical MP4 index for step-by-step operator guides
- Modules — Module pages with embedded clips (Analytics tab switching, Operations mobile shell, Finance drill-downs)
- Account Settings — Settings clips (ChatBot Save, Support new-ticket flow)
- Onboarding a New Property — Property wizard MP4 beside setup steps 4–12
- Booking lifecycle — Status filters and Timeline MP4 beside lifecycle concepts
Portfolio segmentation by tenant category
Segment filters pair with Tenant Portal — Portal access by tenant category and Settings > Tenant categories. Hub parity: Common Workflows — Portfolio segmentation by tenant category. Full pairing matrix: Concept cross-reference.
- Common Workflows — Portfolio segmentation by tenant category — Hub matrix when segment filters must align across reservations, receivables, and tenant profiles
- Settings > Tenant categories — Define segments, portal gates, and integration defaults
- Bookings — Other filters — Tenant category in portfolio Other filters
- Finance — Tenant category filter — Ledger segmentation (cache-built option list)
- Tenants — Tenant category filter — Directory toolbar dropdown
- Glossary — Tenant category — Definition, portfolio filter catalog, and Finance parity
- FAQ — Finance tenant category filter parity — Why Finance may omit segments not yet in the cache
Pending manual receipt approval
Receipt approval pairs with Payment Allocation — Pending manual approval and FAQ — Manual receipt still pending. Hub parity: Common Workflows — Pending manual receipt approval. Full pairing matrix: Concept cross-reference.
- Common Workflows — Pending manual receipt approval — Hub matrix when recorded bank transfers still show pending and KPIs or
/notificationslag until Approve payments - Payment Allocation — Two-layer model and month-end approval habit
- Finance — Pending manual payments — Amber Pending chip on Finance → Transactions
- Glossary — Pending manual in-payment (Finance) — Definition and notification pairing
- FAQ — Pending manual in-payment on /notifications — Alert persists until Approve payments clears Finance or booking Transactions
- FAQ — Uncovered Debt KPI — Finance Total Debt minus deposit offsets; pair with Debt Aging and In debt drill-down
- FAQ — Dashboard Total Debt subtitle — Post-login Total Debt card headline vs >15 days subtitle; ongoing bookings only
Reject/revert mistaken receipts
Receipt cleanup pairs with Payment Allocation — Correcting mistaken receipts and FAQ — Reject or revert an incoming payment. Hub parity: Common Workflows — Reject/revert mistaken receipts. Full pairing matrix: Concept cross-reference.
- Common Workflows — Reject/revert mistaken receipts — Hub matrix when duplicate bank transfers or wrong-booking receipts need Reject / Revert after Approve
- Payment Allocation — Correcting mistaken receipts — Two-layer model, modal copy, and credit note accounting follow-up
- Finance — Row actions on in-payment rows — Bulk Reject selected on Finance → Transactions
- Bookings — Row actions on in-payment rows — Per-row Reject payment and Revert payment on booking Transactions
Month-end invoicing (fixed date)
Ledger and allocation concepts pair with Payment Allocation and Glossary — Fixed invoice date when month-end close requires every Fatura or Invoice-xpress document in a batch to share one posting date — save fixed Invoice date in Settings → Invoicing before bulk Issue allocation on Finance → Transactions. Pair Bulk Hostkit invoicing on the same amber toolbar banner. Hub parity: Common Workflows — Month-end invoicing (fixed date). Full pairing matrix: Concept cross-reference.
- Common Workflows — Month-end invoicing (fixed date) — Hub matrix (
settings-invoicing-invoice-date-toggle.png,finance-transactions-fixed-invoice-date-banner.png,finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png) - Payment Allocation — Two-layer model and month-end approval habit before export
- Glossary — Fixed invoice date — Account-wide document dating and amber banner
- Settings > Invoicing — Default invoice date — Use today as invoice date toggle and saved Invoice date
- Finance — Month-end invoicing with a fixed date — Six-step operator habit on Transactions
- Bulk Hostkit invoicing — Hostkit Issue allocation pacing on same bulk toolbar
- Pending manual receipt approval — Clear Pending mesh before month-end export
- FAQ — Month-end invoicing (fixed date) hub — Symptom table + toggle reset after batch
Bulk Hostkit invoicing
Integrations & Distribution — Hostkit invoicing Fatura-Recibo workflow paces API calls during bulk Issue allocation — pair Month-end invoicing (fixed date) for fixed document dates. Hub parity: Common Workflows — Bulk Hostkit invoicing. Full pairing matrix: Concept cross-reference.
- Common Workflows — Bulk Hostkit invoicing — Hub matrix (
finance-transactions-bulk-selection-bar.png,settings-invoicing-hostkit-series.png) - Integrations & Distribution — Hostkit invoicing — Per-listing API keys and HTTP 429 pacing
- Payment Allocation — Correcting mistaken receipts — Issue credit notes after invoiced Reject / Revert
- Glossary — Hostkit — Portuguese invoicing provider vocabulary
- Finance — Invoice automation — Bulk toolbar on Transactions
- Month-end invoicing (fixed date) — Fixed Invoice date before Hostkit batch
- FAQ — Bulk Hostkit invoicing hub — Symptom table + per-guide mesh
- FAQ — Bulk Hostkit invoicing slow — HTTP 429 pacing — refresh before re-issue
Rent reduction after invoicing
Payment Allocation and Glossary — Invoiced floor (rent) explain why Change monthly rent clamps exported months — pair Bulk Hostkit invoicing for Issue credit notes after external rent relief. Hub parity: Common Workflows — Rent reduction after invoicing. Full pairing matrix: Concept cross-reference.
- Common Workflows — Rent reduction after invoicing — Hub matrix (
bookings-detail-change-monthly-rent-modal.png,bookings-rent-reduction-invoiced-floor-flow.mp4) - Payment Allocation — Correcting mistaken receipts — Credit note follow-up when rent cannot drop below exported months
- Bookings module — Rent reduction after invoicing — Contract Info and Contract Values modals
- Finance — Invoiced floor and rent edits — Operator habit on booking vs Transactions
- Bulk Hostkit invoicing — Issue credit notes Hostkit pacing after external rent relief
- Month-end invoicing (fixed date) — Fixed Invoice date before first bulk export
- FAQ — Rent reduction after invoicing hub — Symptom table + per-guide mesh
- FAQ — Lower rent below invoiced — Modal walkthrough + MP4
Deeper workflow reads
Workflow reads pair with Common Workflows hub subsection index and per-concept section cross-reference tables. Each concept sub-guide also has its own Deeper workflow reads subsection with per-concept [section cross-reference] anchors — for example Booking Lifecycle — Deeper workflow reads, Payment Allocation — Deeper workflow reads, Tenant Portal — Deeper workflow reads. Each workflow sub-guide reciprocates with its own Deeper workflow reads subsection and [Deeper workflow reads](../concepts/booking-lifecycle.md#deeper-workflow-reads) anchors on Concepts & settings bullets — for example Processing a New Booking, Onboarding a New Property. Meta-hubs reciprocate: Account Settings — Deeper workflow reads, Getting Started — Deeper workflow reads, Introduction — Deeper workflow reads, Common Workflows hub — Deeper workflow reads. Full pairing matrix: Concept cross-reference.
- Onboarding a New Property — Apply lifecycle, payments, and integration concepts during the property wizard (section cross-reference; Deeper workflow reads; hub)
- Processing a New Booking — Booking lifecycle and payment allocation when a reservation is first created (section cross-reference; Deeper workflow reads; hub)
- Handling a Late Payment — Collections when Payment Allocation and portal visibility matter (section cross-reference; Deeper workflow reads; hub)
- Cancelling a Booking — Termination workflow alongside Booking Lifecycle status rules (section cross-reference; Deeper workflow reads; hub)
- Portfolio KPI review — Reconciliation tying Analytics, Finance, and Operations signals together (section cross-reference; Deeper workflow reads; hub)
- Entering Monthly Utility Bills — Monthly supplier billing paired with Bills Included and Utilities concepts (section cross-reference; Deeper workflow reads; hub)
- Notification triage — Row-click routes from
/notificationsinto Deep Links module routes (section cross-reference; Deeper workflow reads; hub) - Manual block hygiene — Audit pass when occupancy deep links show unexpected blocks (section cross-reference; Deeper workflow reads; hub)
Modules where concepts surface
Module rows pair with Core Systems and Modules — Module cross-reference. Permission-gated modules: FAQ — Navigation & shortcuts. Full pairing matrix: Concept cross-reference.
- Bookings — Reservation lifecycle, Payment plan, Deposit, and Communication tabs
- Finance — Ledgers, payment approval, invoiced-floor guards, and Deposits
- Listings — Property wizard, Channels, and Bills Included ceilings
- Properties workspace — Legacy
/propertiesbookmarks that redirect into Listings (guide subsection index) - Booking engine details — Rich marketplace payload via the Full integration pill
- Operations — Tickets, cash flows, check-in/out queues, and linked cash flows
- Inbox — Portfolio WhatsApp triage when chatbot rules escalate to operators
- Notifications — Full
/notificationshistory with search and row-click navigation - Notifications — Payment overdue alerts — Operator Payments category rows when scheduled charges are overdue
- AI Chat — Vivin-internal AI Assistant paired with Landlord MCP
- Audit — Manual Blocks and Discounts during month-end reconciliation
Deeper concept reads
Each concept sub-guide also has its own Deeper concept reads subsection with per-concept [section cross-reference] anchors — for example Booking Lifecycle — Deeper concept reads, Payment Allocation — Deeper concept reads, Tenant Portal — Deeper concept reads. Each sub-guide also has Deeper workflow reads for operator procedures. Full pairing matrix: Concept cross-reference.
- Booking Lifecycle — Computed status model, list filters, and Timeline (section cross-reference; Deeper concept reads)
- Payment Allocation — Two-layer receipts, invoiced-floor rent, and reject/revert corrections (section cross-reference; Deeper concept reads)
- Tenant Portal — Booking-scoped tenant self-service, contract signing, and payments (section cross-reference; Deeper concept reads)
- FAQ — Tenant contract signing blocked — No PDF yet, mandatory Your Details gates, category locks, or Lease purpose; portal signing vs paper upload on Contract Info
- Integrations & Distribution — Marketplace calendar sync, booking imports, and white-label engine (section cross-reference; Deeper concept reads)
- Automation & AI — Channel map, chatbot, in-app assistant, and MCP clients (section cross-reference; Deeper concept reads)
- Landlord MCP — Account-scoped external automation (section cross-reference; Deeper concept reads)
- Tenant MCP — Booking-scoped external automation (section cross-reference; Deeper concept reads)
- Management Frontend Deep Links — Bookmarkable management routes (section cross-reference; Deeper concept reads)
- Create New Menu — Global + slide-out shortcuts (section cross-reference; Deeper concept reads)
- Services Marketplace — Portal add-on catalogue and fulfilment (section cross-reference; Deeper concept reads)
Deeper API reads
Each concept sub-guide also has its own Deeper API reads subsection with per-guide [section cross-reference] anchors on companion API Reference pages — for example Booking Lifecycle — Deeper API reads, Integrations & Distribution — Deeper API reads, Landlord MCP — Deeper API reads. API Reference Deeper concept reads bullets link back here with reciprocal [Deeper API reads] anchors. Full pairing matrix: Concept cross-reference.
- Booking Lifecycle — Computed status vs integration validation and webhook events (section cross-reference; Deeper API reads)
- Payment Allocation — Layer 1 schedules from partner enqueue and error shapes (section cross-reference; Deeper API reads)
- Tenant Portal — White-label and import APIs that provision portal access (section cross-reference; Deeper API reads)
- Integrations & Distribution — Full/partial feeds, iCal, webhooks, and mapping guides (section cross-reference; Deeper API reads)
- Automation & AI — Management session, auth, and inbound channel HTTP (section cross-reference; Deeper API reads)
- Landlord MCP — Portfolio JWT bootstrap and listing/booking HTTP behind tools (section cross-reference; Deeper API reads)
- Tenant MCP — Booking-scoped session bootstrap and underlying integration routes (section cross-reference; Deeper API reads)
- Management Frontend Deep Links — Sign-in and mapping guides before bookmark routes (section cross-reference; Deeper API reads)
- Create New Menu — Programmatic booking and listing verification alternatives (section cross-reference; Deeper API reads)
- Services Marketplace — Enqueue vs portal catalogue boundaries on partner HTTP (section cross-reference; Deeper API reads)
Key glossary terms
Glossary rows pair with Glossary cluster cross-reference and concept pages that cite the same terms. Receipt disputes: Common Workflows — Reject/revert mistaken receipts. Full pairing matrix: Concept cross-reference.
- Invoiced floor (rent) — Rent edits on live bookings after Finance export
- FAQ — Bulk Hostkit invoicing slow — Vivin paces Hostkit API calls and retries HTTP 429 during bulk Issue allocation / Invoice selected; refresh Transactions before re-issuing
- Credit note (payment reject/revert) — Finance Transactions reject/revert accounting follow-up; concept walkthrough: Payment Allocation — Correcting mistaken receipts; workflow hub: Common Workflows — Reject/revert mistaken receipts
- Deposit dispute — Finance → Deposits and booking Deposit tab freeze before refund
- Glossary — End-of-Booking cost split — Charge Time → End of Booking splits daily overage across every occupied unit; still-staying roommates stay in the denominator (#2111)
- Glossary — Change history — Operator-initiated edits on Listings setup and Bookings Changelog; create-time defaults excluded (#2093)
- FAQ — Booking Changelog scope — Operator-initiated edits only; create-time defaults excluded (#2093)
- Glossary — Archived booking ledger visibility — Delete Booking hides manual/provider_platform rows on Finance → Transactions; vIBAN and credit card stay visible (#1897)
- Bookings — Provider platform payment — Non-rejected provider platform in-payment blocks Delete Booking until Reject or assign (#2076)
- FAQ — Delete Booking on integration reservation — Clear pending provider platform in-payment with Reject or assign before soft-archive (#2076)
- Listings — Property edit sidebar pills — Setup / Full integration / Photos pills on property and unit edit sidebars; replaced the old Go to details shortcut (#2082)
- Glossary — Finance tenant category cache refresh — Recategorizing a tenant on Tenants → Tenant Info force-refreshes Finance caches so Contract Values, Overview, and Deposits filters match within seconds (#2088)
- Glossary — SIMAR water contract ID — SIMAR (Loures e Odivelas) water bills use Cód. Local in Connections — not Nº de Contador; leading zeros stripped (#2110)
- FAQ — SIMAR water bill property match — Cód. Local in Connections — not Nº de Contador; strip leading zeros (#2110)
- Glossary — Per-booking maintenance ticket opt-out — Add booking checkboxes skip automatic CI/CO tickets for one reservation only; property rule unchanged (#1140)
- FAQ — Cancel Booking vs Delete Booking — Cancel for real stays with settlement; Delete soft-archives mistaken/test rows (#1897 / #2076)
- Glossary — Archived property — Archive retires a building to Listings → Archived without deleting bookings; distinct from Delete Booking (reservation soft-archive) — Listings — Archived properties
- FAQ — Portfolio retirement decisions — Archive property (building) vs Cancel booking vs Delete Booking (reservation soft-archive) — three-way decision table
- Deposit lifecycle status — Payment-driven
depositStatuspill on booking Deposit tab and Finance → Deposits rows - Finance — Deposit status filter — Other filters → Deposit status multi-select on Bookings and Finance (#2090)
- Finance — Deposit lifecycle status cards — Deposit lifecycle status row on Finance → Deposits; click Partial paid for collection shortfalls (#2091)
- FAQ — Partly collected security deposit — Paid above zero but below Amount on booking Deposit; Partial paid card on Finance → Deposits (#2090 / #2091)
- Operations — Tickets toolbar search — Paste the full sequential ticket ID (for example
S259,T27) in toolbar Search (#2074) - FAQ — Find a ticket by its ID — Paste the full sequential ticket ID (for example
S259,T27) in Operations → Tickets toolbar Search (#2074) - FAQ — Skip automatic check-in/out tickets for one booking — Turn off Use unit contract rents and other contract details on Add booking to reveal CI/CO ticket checkboxes (#1140)
- FAQ — Manual payments after Delete Booking — Delete Booking hides manual/provider_platform rows on Finance → Transactions; vIBAN and credit card stay visible (#1897)
- Glossary — Directory list load failures — First-fetch directory failures show Retry / Try again; distinct from filter-empty states and booking-sidebar tab errors
- Glossary — Vacant Unit Preference — Include manual blocks counts operator holds as free on Dashboard / Sales vacancy surfaces (#1427)
- FAQ — Communication or Tickets load failure — Tab-scoped Refresh (Communication) or Retry (Tickets); other booking sidebar tabs stay usable
- Operations — Property-level ticket search — Property-name matches share the top relevance tier with unit hits; building-scoped rows float first under an active Property filter (#2089)
- Draft ticket (display status) — Operations far-future prep jobs
- Ticket — linked cash flows — Operations cost allocation to contractor ledger rows
- Notification row navigation —
/notificationsrow-click into Bookings, Tenants, or Listings - FAQ — Notification row-click navigation — On
/notifications, row click marks unread then openslink,bookingId,tenantId,listingId, orpropertyId(first match); Dashboard bell General rows stay in-panel unlesslinkis set - FAQ — Phone shows Operations only — Mobile phone user agent locks operators with Operations access to
/operations; iPads and narrow desktop browsers keep the full module list - Communication schedule — Emails toolbar calendar for lifecycle outreach referenced in booking and portal concepts
- Finance Deposits date range — Toolbar default window on Finance → Deposits during check-out and deposit-dispute concepts
- FAQ — Deposit missing on Finance Deposits — Default ~3 months date range; clear or widen before triaging older move-outs or dispute row actions
- Same-day turnover — Shared-unit arrival/departure overlap across lifecycle and operations concepts
- FAQ — Archive a property — Edit property sidebar Archive / Unarchive on Listings; building-level — not Delete Booking or Cancel booking
- FAQ — Same-day turnovers — Check-out + check-in on one unit same day: Operations → Check-in & Check-out, Timeline / Multicalendar, turnover tickets
- FAQ — AI token usage — Poll GET /ai-usage / GET /ai-usage/summary with management JWT;
landlord_chat+utility_bill_extraction; no management UI screen yet - FAQ — Automatic check-in email — Trigger matrix, 15-day cutoff, paper upload vs portal signing, Nuki-only toggle, Send / Resend on Contract Info
- FAQ — WhatsApp and email per booking — Bookings → Communication tab when tenant chatbot is enabled; Inbox for portfolio-wide triage
- FAQ — Lower rent below invoiced — Change monthly rent clamps and Contract Values → Edit amount blocks net below exported invoice totals; use credit notes in accounting when you truly need a reduction
- FAQ — Finance Income status drill-down hub — Symptom table for segment vs Debt Aging
- FAQ — Finance Income status drill-down — Overview Income chart (Paid / Scheduled / In debt); click a segment for month-scoped payment-line modal; Debt Aging for booking-level receivables
- FAQ — Cash flow forecast drill-down hub — Symptom table for collections vs Income / Dashboard
- FAQ — Cash flow forecast drill-down — Month / Day bar-click habit
- FAQ — Bookings that owe money — Top debtors and overdue buckets on Finance → Overview; Total Debt KPI is not a table
- FAQ — Fixed rent on variable unit — Variable listing + equal rent every contract month → booking stores fixed headline Monthly rent; payment plan unchanged