Skip to main content

Concepts

First-time workspace setup

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).

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):

Create New slide-out — “What would you like to create?” with People, Listings, Reservations, Operations, Payments, and Tools

Reference

Pair with other Concepts hub sections

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.

Core Systems

Pair with other Concepts hub sections

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 detail — Payment plan tab with scheduled charges (Layer 1) before incoming payments are allocated

Tenant Experience

Pair with other Concepts hub sections

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.

Platform Capabilities

Pair with other Concepts hub sections

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).
Analytics — Overview tab with KPI bar charts and month-range picker in the management shell
  • 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

Pair with other Concepts hub sections

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

Pair with other Concepts hub sections

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.

SubsectionWhen to open itPair with
ReferenceBookmarkable management routesManagement Frontend Deep Links, Create New Menu
Core SystemsLifecycle, ledger, and module pointersBooking Lifecycle, Payment Allocation, Legacy properties guide subsection index, Modules hub subsection index
Tenant ExperiencePortal and tenant-scoped automationTenant Portal, Tenant MCP, Services Marketplace
Platform CapabilitiesChannels, analytics, and AI/MCPIntegrations & Distribution, Automation & AI, Landlord MCP
Setup sequence after go-livePost-setup concept reads after steps 1–15Getting Started — Recommended Setup Sequence, Onboarding a New Property — Step 7
Documentation map & escalationCross-hub navigation during troubleshootingIntroduction — Section cross-reference, FAQ — Section cross-reference, Support — Section cross-reference
Navigation & bookmarksDeep links and global + shortcutsManagement Frontend Deep Links, Create New menu
Settings that shape concept behaviourAccount-wide defaults (steps 1–12)Account Settings hub subsection index, Tab cross-reference, Settings > Tenant categories
Deeper workflow readsOperator procedures that apply concept modelsBooking Lifecycle, Payment Allocation, Tenant Portal, Onboarding a New Property, Handling a Late Payment, Cancelling a Booking
Recommended operator workflowsDay-to-day procedures after go-liveCommon Workflows hub subsection index, Workflow cross-reference, Portfolio KPI review
Walkthrough mediaMP4 walkthroughs beside PNG screenshotsCommon Workflows — Walkthrough media, Modules, Account Settings
Notification row-click navigation/notifications row-click from concept troubleshootingCommon Workflows — Notification row-click navigation, Deep Links — Notifications, Notification triage
Payment alert to receivables triagepayment overdue on payment and lifecycle conceptsCommon Workflows — Payment alert to receivables triage, Payment Allocation, Handling a Late Payment — Step 1
Finance debt receivables triageDebt Aging / Uncovered Debt on ledger conceptsCommon Workflows — Finance debt receivables triage, Handling a Late Payment collections (Steps 1–6 after triage surfaces), Payment Allocation, Glossary — Uncovered Debt
Handling a Late Payment collectionsTriage surface picked — collections Steps 1–6 on allocation modelsCommon Workflows — Handling a Late Payment collections hub, Handling a Late Payment, Payment Allocation, FAQ — Handling a Late Payment hub
Finance Income status drill-downIncome segments on Payment Allocation conceptsCommon Workflows — Finance Income status drill-down, Payment Allocation, Finance module
Cash flow forecast drill-downCollections history on ledger conceptsCommon Workflows — Cash flow forecast drill-down, Payment Allocation, Glossary — Cash flow forecast (Finance Overview)
Same-day turnover coordinationShared-unit overlap on lifecycle and calendar modelsCommon Workflows — Same-day turnover coordination, Booking Lifecycle, Glossary — Same-day turnover
Check-out final utilities handoffFinal-cycle overage on ledger and allocation modelsCommon Workflows — Check-out final utilities handoff, Payment Allocation, Entering Monthly Utility Bills
Check-out collections before refundDeparture-week rent/fee In Debt on allocation modelsCommon Workflows — Check-out collections before refund, Payment Allocation, Handling a Late Payment, FAQ — Check-out collections before refund
Check-out ledger cleanup before refundDuplicate departure transfers on allocation models before refundCommon Workflows — Check-out ledger cleanup before refund, Payment Allocation — Correcting mistaken receipts, Bookings module, FAQ — Check-out ledger cleanup before refund
Check-out vs cancellationEnded vs Canceled lifecycle exit on allocation modelsCommon Workflows — Check-out vs cancellation, Booking Lifecycle, Bookings module, FAQ — Check-out vs cancellation
Cancellation collections before voidPre-cancel rent/fee In Debt on allocation models before voidCommon Workflows — Cancellation collections before void, Payment Allocation, Bookings module, FAQ — Cancellation collections before void
Wrong tenant on a bookingBooking–tenant profile link — Change tenant vs Delete on allocation modelsCommon Workflows — Wrong tenant on a booking, Booking Lifecycle, Bookings module, FAQ — Wrong tenant on a booking
Cancel Booking vs Delete BookingSoft-archive vs policy void — Delete Booking vs Cancel booking on ledger modelsCommon Workflows — Cancel Booking vs Delete Booking, Booking Lifecycle, Bookings module, FAQ — Cancel Booking vs Delete Booking
Portfolio retirement decisionsBuilding Archive vs reservation Cancel vs Delete on inventory modelsCommon Workflows — Portfolio retirement decisions, Listings — Archived properties, Manual block hygiene, FAQ — Portfolio retirement decisions
Archive property (building-level)Building Archive / Unarchive on Listings inventory modelCommon Workflows — Archive property (building-level), Listings — Archived properties, FAQ — Archive a property, Glossary — Archived property
Utility overage collectionsMid-stay overage In Debt on allocation modelsCommon Workflows — Utility overage collections, Payment Allocation, Glossary — End-of-Booking cost split
Property setup to first arrival handoffGo-live property → first arrival week on lifecycle modelsCommon Workflows — Property setup to first arrival handoff, Booking Lifecycle, Onboarding a New Property — Step 7
New inventory to first booking handoffGo-live property → first Upcoming reservation on lifecycle modelsCommon Workflows — New inventory to first booking handoff, Booking Lifecycle, Processing a New Booking — Step 1
Confirmation to check-in handoffUpcoming → arrival week on lifecycle and portal modelsCommon Workflows — Confirmation to check-in handoff, Booking Lifecycle, Processing a New Booking, Managing a Check-in
Check-in to check-out handoffOngoing → departure week on lifecycle and ledger modelsCommon Workflows — Check-in to check-out handoff, Booking Lifecycle, Managing a Check-in, Managing a Check-out
Occupancy KPI to block hygiene handoffAnalytics Occupancy dip without rate change on KPI modelsCommon Workflows — Occupancy KPI to block hygiene handoff, Portfolio KPI review, Manual block hygiene
Confirmation alert triageUpcoming alerts on new booking conceptsCommon Workflows — Confirmation alert triage, Booking Lifecycle, Processing a New Booking
Portfolio segmentation by tenant categoryReview only one tenant segment across Bookings, Finance, and TenantsCommon Workflows — Portfolio segmentation by tenant category, Settings > Tenant categories, Glossary — Tenant category
Pending manual receipt approvalRecorded bank transfers still pending until approvalCommon Workflows — Pending manual receipt approval, Finance — Pending manual payments, FAQ — Manual receipt still pending
Reject/revert mistaken receiptsDuplicate or invoiced receipt cleanupCommon Workflows — Reject/revert mistaken receipts, Payment Allocation — Correcting mistaken receipts
Month-end invoicing (fixed date)Month-end bulk Issue allocation with uniform document dateCommon Workflows — Month-end invoicing (fixed date), Settings > Invoicing — Default invoice date, Portfolio KPI review — Step 7, FAQ — Month-end invoicing (fixed date) hub
Bulk Hostkit invoicingHostkit bulk Issue allocation pacing on Finance → TransactionsCommon Workflows — Bulk Hostkit invoicing, Using in-app support — Bulk Hostkit invoicing, FAQ — Bulk Hostkit invoicing hub, FAQ — Bulk Hostkit invoicing slow
Rent reduction after invoicingInvoiced floor on ledger and allocation concepts after month-end exportCommon Workflows — Rent reduction after invoicing, Payment Allocation, Using in-app support — Rent reduction after invoicing, FAQ — Rent reduction after invoicing hub
Modules where concepts surfaceScreen docs for each concept rowModules — Module cross-reference, Bookings, Finance
Deeper concept readsCross-concept pairing after one sub-guideConcept cross-reference, Booking Lifecycle, Payment Allocation, Tenant Portal
Deeper API readsCompanion API guides after one concept sub-guideAPI hub subsection index, API guide cross-reference, Booking Lifecycle, Integrations & Distribution
Key glossary termsDefinitions cited on concept pagesGlossary deep-dive index, Glossary cluster cross-reference

Setup sequence after go-live

Pair with other Concepts hub sections

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.

Documentation map & escalation

Pair with other Concepts hub sections
Pair with other Concepts hub sections

Bookmark routes pair with Management Frontend Deep Links and Reference deep-link docs. Missing records: Create New menu. Full pairing matrix: Concept cross-reference.

Settings that shape concept behaviour

Pair with other Concepts hub sections

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.

Pair with other Concepts hub sections

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.

Lockout catch-up after password recovery

Pair with other Concepts hub sections

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.

Notification row-click navigation

Pair with other Concepts hub sections

Payment alert to receivables triage

Pair with other Concepts hub sections

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.

Finance debt receivables triage

Pair with other Concepts hub sections

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.

Handling a Late Payment collections

Pair with other Concepts hub sections

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.

SymptomTriage surfaceCollections step
Payment overdue alertRow-click on /notificationsHandling a Late Payment — Step 1
Ranked debtors neededFinance → Overview → Debt AgingStep 1 after booking open
Balance unchanged after transferPending manual receipt approvalStep 4b
Walkthrough: open an arrears booking, confirm Payment Plan overdue pills, use Communication for tenant outreach, record a manual receipt via Transaction (Add Payment modal), then approve pending rows when your role allows.

Finance Income status drill-down

Pair with other Concepts hub sections

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.

Cash flow forecast drill-down

Pair with other Concepts hub sections

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.

Same-day turnover coordination

Pair with other Concepts hub sections

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.

Check-out final utilities handoff

Pair with other Concepts hub sections

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.

Check-out collections before refund

Pair with other Concepts hub sections

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.

Check-out ledger cleanup before refund

Pair with other Concepts hub sections

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.

Check-out vs cancellation

Pair with other Concepts hub sections

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.

Cancellation collections before void

Pair with other Concepts hub sections

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.

Wrong tenant on a booking

Pair with other Concepts hub sections

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.

Cancel Booking vs Delete Booking

Pair with other Concepts hub sections

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.

Portfolio retirement decisions

Pair with other Concepts hub sections

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.

Archive property (building-level)

Pair with other Concepts hub sections

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.

Utility overage collections

Pair with other Concepts hub sections

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.

Property setup to first arrival handoff

Pair with other Concepts hub sections

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.

New inventory to first booking handoff

Pair with other Concepts hub sections

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.

Confirmation to check-in handoff

Pair with other Concepts hub sections

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.

Check-in to check-out handoff

Pair with other Concepts hub sections

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.

Occupancy KPI to block hygiene handoff

Pair with other Concepts hub sections

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.

Confirmation alert triage

Pair with other Concepts hub sections

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.

Walkthrough media

Pair with other Concepts hub sections

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

Portfolio segmentation by tenant category

Pending manual receipt approval

Pair with other Concepts hub sections

Reject/revert mistaken receipts

Month-end invoicing (fixed date)

Pair with other Concepts hub sections

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.

Bulk Hostkit invoicing

Pair with other Concepts hub sections

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.

Rent reduction after invoicing

Pair with other Concepts hub sections

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.

Deeper workflow reads

Pair with other Concepts hub sections

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.

Modules where concepts surface

Pair with other Concepts hub sections

Module rows pair with Core Systems and Modules — Module cross-reference. Permission-gated modules: FAQ — Navigation & shortcuts. Full pairing matrix: Concept cross-reference.

Deeper concept reads

Pair with other Concepts hub sections

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.

Deeper API reads

Pair with other Concepts hub sections

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.

Key glossary terms

Pair with other Concepts hub sections

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.