Skip to main content

FAQ & Troubleshooting

Finding your way in this guide

Start with Navigation & shortcuts for shell behaviour, permissions, and directory UX; use Bookings and Payments & Finance for reservation and ledger troubleshooting. Jump to anchored deep-dives via FAQ subsection cross-reference (permission toasts, reject/revert, invoiced floor, portal signing, and more). First-time administrators configuring a workspace should pair answers here with Getting Started — Recommended Setup Sequence (steps 1–12 tab map: Account Settings — Recommended setup order, then steps 13–15 in Listings, Bookings, and Tenants). Payment overdue alerts: Handling a Late Payment — Step 1 after a /notifications row-click. Tenant-facing issues: Tenant Portal & Mobile App paired with Settings & tenant communications. Term definitions: Glossary deep-dive index Non-linear operator habits (Lockout catch-up, Pending manual receipt approval, Reject/revert mistaken receipts, Portfolio segmentation by tenant category hub, Finance Income status drill-down hub, Occupancy KPI to block hygiene handoff hub, Wrong tenant on a booking, Cancel Booking vs Delete Booking hub, Same-day turnover coordination, New inventory to first booking handoff, Property setup to first arrival handoff, Confirmation to check-in handoff, Check-in to check-out handoff, Check-out final utilities handoff, Check-out collections before refund, Check-out ledger cleanup before refund, Cancellation collections before void, Utility overage collections, Check-out vs cancellation, Deposit missing on Finance Deposits, Partly collected security deposit) have matching Related subsections below. Full pairing matrix: FAQ section cross-reference.

First-time workspace setup
Pair with other FAQ sections

Directory and permission answers here pair with Notifications & alerts (bell vs /notifications) and Settings & tenant communications (email and Communication Rules). During first-time setup, confirm Getting Started — Recommended Setup Sequence step 3 (Users) before greyed-out + Create New rows block onboarding. Mobile-only shell: Navigation & shortcuts (mobile) (FAQ — Phone shows Operations only, Glossary — Operations-only phone shell). Full pairing matrix: FAQ section cross-reference.

Why are some rows in + Create New greyed out? Each action checks your role’s create permissions for that record type (tenants, bookings, tickets, and so on). Disabled rows include a no permission tooltip on hover. Ask an account administrator to adjust Users and roles. See the full action list in Create New Menu.

Why do I see “You do not have permission to perform this action”?

Vivin blocked the API call because your role lacks the granular permission for that action (save, delete, approve, and similar mutations). The toast is the localized replacement for the backend Forbidden resource denial when no more specific business message applies. Some controls are hidden or greyed out up front (+ Create New, Finance tabs without Approve payments); others stay visible until you click Save or a row action. An administrator can fix this in Users and roles → Role Permissions. After they change your role, refresh or navigate to a new page — you do not need to sign out. See Blocked actions in the app.

The + Create New slide-out keeps every shortcut in one grid; which rows are clickable depends on those permissions (and, for Tools, whether you are on a Vivin internal sign-in — see the next question).

Create New slide-out — category grid; actions you cannot use stay disabled with a no-permission hint on hover

Why don’t I see a “Tools” block inside + Create New? The Tools category (currently Upload Utility Bills) is shown only when you are signed in with an email address ending in @vivin.app (Vivin internal operators). Customer accounts see the other five categories only. Internal users who still lack the underlying permission for utility bill upload will see Tools but with that action disabled.

Why don’t I see “AI Assistant” under Tools in the sidebar? The AI Assistant screen (/ai-chat) is limited to Vivin internal operator sign-ins: the app hides the nav entry for everyone else, and opening the URL directly shows the standard permission state. That matches the same internal-only pattern as other Vivin-gated tools in the shell (not the same rule as the + Create New > Tools email check above). See the AI Chat module and bookmarkable route in Deep Links — AI Assistant.

Why don’t I see “Analytics” under Business in the sidebar? The Analytics entry (/analytics, portfolio KPI charts) is shown only when your role includes the Analytics module permission (analytics.module). Administrators can grant it in Users and roles. Opening /analytics directly without permission shows the standard access-denied state. For what each tab shows, see the Analytics module; tab-level URLs and behaviour are listed under Deep Links — Analytics (KPI Dashboard).

Why don’t I see “Audit” under Tools (or why is Audit empty / blocked)? Audit (/audit) reviews manual availability blocks across your portfolio. The sidebar entry uses the same Listings module permission as the Listings workspace — if you cannot open Listings, you cannot open Audit either. The workspace does not replace the unit Calendar in Listings; it helps you spot blocks that may be stale or mis-described. When Analytics Occupancy dips without a rate change, pair Portfolio KPI review — Step 3 with hub Common Workflows — Occupancy KPI to block hygiene handoff before you edit Settings → Tenant categories account-wide. Use Created by (multi-select) after staff turnover, clickable column headers for server-side sort (for example Unit or End), and Export for the full filtered set — see Audit — Toolbar and filters and Manual block hygiene. See Audit module and Deep Links — Audit.

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

A shared link opens the wrong Finance tab, or the URL says /finance/foo while I see Overview — is that normal? Tabbed modules (Finance, Operations, Sales, Utilities, Account Settings, Analytics) rewrite unknown :tab segments to a safe default (usually the module Overview) so the address bar matches what is on screen. Legacy aliases (for example /sales/calendar/sales/pricing) still work where documented. If a link includes a tenant, property, or transaction id that does not exist, you get a short not found toast and return to the parent list. See Deep Links — Invalid, legacy, and mistyped URLs.

Can I connect Vivin to an external AI assistant (for example ChatGPT or Claude with MCP)? Yes, for automation against the same Core API the management app uses. Landlord MCP exposes account-scoped portfolio tools (bookings, listings, maintenance, and more, depending on your role). Tenant MCP targets booking- and tenant-scoped flows (portal links, chatbot rules, maintenance for a reservation). Both require a valid management-user token and respect the same permissions as HTTP clients. Administrators tune tool permissions on Account Settings → AI / MCP (/settings/mcp); API keys suit IDE and custom clients, while Claude.ai and ChatGPT connectors use OAuth on the Core API host — see Landlord MCP — Connector OAuth. Protocol details: Landlord MCP and Tenant MCP; HTTP contracts: API Reference.

How do Claude or ChatGPT connectors sign in to Landlord MCP?

Hosted MCP connectors (Claude.ai, ChatGPT) run Vivin's OAuth 2.1 authorization-code flow on the Core API host — you sign in on a Vivin consent page that lists the tool domains you are granting. PKCE is required. The connector receives a management JWT (same shape as browser login) plus a refresh token (60-day lifetime, rotates on use). This path does not use the API keys card on AI / MCP — keys remain for IDE configs (Cursor, Claude Desktop) and custom scripts. Enable at least one tool domain on Account Settings → AI / MCP before authorizing; zero enabled domains returns access_denied. Revoke by turning AI access off for the user or disabling every domain — the next refresh fails and the connector asks you to sign in again. Operator narrative: Landlord MCP — Connector OAuth. HTTP endpoints: MCP OAuth.

Where do I configure Landlord MCP API keys and tool permissions?

Open Account Settings → System → AI / MCP at /settings/mcp. Managers with account_settings.mcp can edit Connection, API keys, account Tool permissions, Per-user permissions, and review the Permission audit trail and Assistant activity logs. The tab currently follows the same Vivin-internal rollout gate as Tools → AI Assistant (/ai-chat); other users may see the tab greyed out or a read-only My permissions card. See Users and roles — Role permissions.

Pair with other FAQ sections

Phone-only Operations shell answers pair with Operations (bottom tab bar, field workflows), Getting Started — Mobile phones (operations-only shell), Operations — Mobile and narrow layouts (redirect vs 768px bottom tabs), Deep Links — Operations (bookmark /operations/* on phones), Glossary — Operations-only phone shell, and Help & Vivin support (/settings/support still opens on phones). Full pairing matrix: FAQ section cross-reference.

Why does my phone only show Operations?

On an actual mobile phone (user-agent detection — not merely a narrow browser window), anyone whose role includes the Operations module gets an operations-focused shell: other module URLs redirect to /operations, and the mobile menu shows Operations only. That is intentional for field coordination (tickets, check-in/out, cash flows). iPads, tablets, and desktop browsers resized narrow keep the full module list — only phone-class devices are locked. Use a tablet or desktop browser when you need Listings, Bookings, Finance, and the rest of the portfolio tools from a phone. Support ticket links under /settings/support still open on phones. Roles without Operations access are not redirected. Inside Operations on any viewport below 768px, a bottom tab bar still appears for tab switching — that part is width-based, separate from the phone-only redirect. The Dashboard notifications bell is hidden on narrow viewports — use /notifications directly on phones. See Getting Started — Mobile phones (operations-only shell), Operations — Mobile and narrow layouts, Glossary — Operations-only phone shell, and Deep Links — Operations.

Operations — Tickets tab on a narrow viewport with the mobile bottom tab bar

For a short clip of the /bookings → /operations redirect and bottom tab bar, see the video on Getting Started — Narrow viewports or Operations — Mobile and narrow layouts.

Notifications & alerts

Pair with other FAQ sections

Payment and overdue alert behaviour pairs with Payments & Finance and Bookings (row-click navigation into booking sidebars — FAQ — Notification row-click navigation, Notification row-click navigation hub (symptom table for /notifications row-click vs Dashboard bell — notifications-row-navigation-flow.mp4), Glossary — Notification row navigation, Glossary — Notification row navigation hub), Booking sidebar tab load failures hub (symptom table when row-click opens a booking but Communication / Tickets fail — bookings-detail-communication-tab-whatsapp-thread.png), Payment alert to receivables triage hub (symptom table for Ongoing/Ended payment overdue before Debt Aging), Payment alert to receivables triage (Ongoing/Ended payment overdue before Debt Aging), Confirmation alert triage hub (symptom table for Upcoming Booking created / Payment received before bulk mark-read — notifications-row-navigation-flow.mp4), Confirmation alert triage (Upcoming Booking created / Payment received before bulk mark-read), Payment notification (operator) hub (email/in-app opt-in layers and payment row-type symptom table — notifications-row-navigate-to-booking-detail.png, notifications-row-navigation-flow.mp4), Why do I still see Pending manual in-payment on /notifications? (alert until ledger approval), and Manual receipt still pending (amber Pending chip triage). WhatsApp triage: AI & Automation. Full pairing matrix: FAQ section cross-reference.

Where do I open the full notification history (search and read filters)? Open the Notifications module at /notifications — for example platform.vivin.app/notifications. The Dashboard header bell (desktop only) shows a compact recent list with General and Inbox sub-tabs when the global inbox release is active — Inbox rows deep-link to /inbox or booking Communication; the bell still has no search or All / Unread / Read pills. Bookmark /notifications when you triage the full mixed history regularly. See Notification triage.

Notifications module — full history at /notifications with All filter, search, and totals line

Why is the Dashboard notifications bell missing on my phone? The bell slide-over is tied to the Dashboard header and is hidden on narrow viewports in the current layout. Use /notifications directly for the same events with search, filters, and infinite history on mobile.

Why does clicking a notification on /notifications open a booking or tenant?

SurfaceRow click behaviourBest for
/notificationsOpens link, then bookingId, tenantId, listingId, or propertyId (first match)Payment alerts, ticket pings, search + All / Unread / Read filters
Dashboard bell — GeneralOpens in-panel Notification detail unless link is setQuick desktop scan — not full triage
Dashboard bell — InboxFollows link to /inbox or booking CommunicationWhatsApp / inbox message pings
MobileBell hidden — use /notifications directlySame row-click navigation as desktop full page
Symptom after row-clickLikely causeFix
Pending manual in-payment alert persistsReceipt still pending on ledgerTransactionsApprove paymentPending manual receipt approval
Total Debt unchangedTransfer not approved yetAmber Pending chip on Finance → Transactions
Landed on booking but debt unclearPayment overdue vs pending alertPayment Plan or Finance debt receivables triage
Bell row did not navigateGeneral tab in-panel detailUse /notifications for row-click triage

On the full Notifications page, a row click marks unread items in the background, then navigates when the event carries a target: backend link, then bookingId, tenantId, listingId, or propertyId (first match). Payment and overdue alerts usually open the related booking sidebar so you can review Payment Plan or Contract Values — see Handling a Late Payment — Step 1, Notifications — Payment overdue alerts, Notification triage — Step 4, and during month-end Portfolio KPI review — Dashboard Total Debt subtitle. The Dashboard bell does not jump to Bookings from most General rows (it opens Notification detail in the panel unless the row has a deep link). Inbox sub-tab rows with link still jump to /inbox or booking Communication from the bell. On phones, bookmark /notifications when the bell is hidden — see Getting Started — Notification access. See Glossary — Notification row navigation, Deep Links — Notifications, and Deep Links — Broken entity deep links when a target id no longer exists.

Notifications module — inbox row ready to open the related booking

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

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

Hub matrix: Common Workflows — Notification row-click navigation · Notification row-click navigation hub · Glossary — Notification row navigation hub. Module pairing: Bookings — Notification row-click navigation, Finance — Notification row-click navigation. Per-guide mesh: Processing a New Booking — Notification row-click navigation, Cancelling a Booking — Notification row-click navigation, Managing a Check-in — Notification row-click navigation, Managing a Check-out — Notification row-click navigation, Entering Monthly Utility Bills — Notification row-click navigation, Handling a Late Payment — Notification row-click navigation, Portfolio KPI review — Notification row-click navigation, Notification triage — Notification row-click navigation, Manual block hygiene — Notification row-click navigation, Onboarding a New Property — Notification row-click navigation, Using in-app support — Notification row-click navigation, Resetting a Management User Password — Notification row-click navigation. Pair Common Workflows — Pending manual receipt approval when Pending manual in-payment alerts drive triage (notifications-row-navigate-to-booking-detail.png, finance-transactions-pending-approve-flow.mp4).

Why do some lists load more rows when I scroll (skeletons, “End of list”) instead of a Load more button? Large directories — Listings (Portfolio and Archived), Bookings (list view), Bookings Timeline (unit rows on the Gantt chart), Audit (Manual Blocks), Tenants, Notifications, Sales (Pricing and Channels grids), Finance (Contract Values, Transactions, Payouts, Deposits), Operations (Tickets and Cash Flows), Utilities (Connections, Timeline rows, and Allocations), and in-app Support (Help & Support drawer and /settings/support inbox) — are server-paged. The app loads an initial batch, then fetches the next batch when you scroll near the bottom. Skeleton placeholders (or a small spinner under the ticket list in the Support drawer) appear while the request runs. When every row for your current search and filters is loaded, many full-page screens show Showing X of Y and an End of list line (the Bookings list, Dashboard notifications bell slide-over, and Help & Support drawer load in chunks but omit End of list). Changing filters or search clears the list and starts from the first batch again. On Bookings and Finance → Contract Values / Transactions, Export still downloads the full filtered result set even if you have not scrolled through every chunk — see Exporting the list and Finance — Large tables. Operations ticket/cash-flow exports and Utilities → Connections export only loaded rows until you scroll through the list — see Operations — Tickets list loading and Utilities — Connections. Finance ledger tabs omit the End of list footer. See Glossary — Infinite scroll (directory loading) and Glossary — End of list.

Notifications module — scrollable list loading the next page with skeleton placeholder rows

Help & Support drawer — scrolled ticket list (scroll near the bottom to load the next batch; spinner while fetching)

Why does the same search term sort differently on Bookings, Operations, and Listings? Large directories use server-side search, but only some modules re-rank matches. Bookings and Operations (Tickets, Check-in & Check-out, and Cash Flows) put unit / room hits at the top when you paste an internal name. Listings keeps properties in A–Z order after filtering. Tenants keeps your chosen sort column. See Glossary — Directory search ranking.

When should I use Tenants grid vs table view? Use grid when debt badges and multi-status booking previews matter at a glance (Show all bookings on dense cards). Use table when you need column sort and an inline booking roll-up: click the row chevron to expand Unit, Rent, and Balance sub-rows, then open a sub-row for the booking sidebar or the tenant name for the profile sidebar. Pair table + With Debt during collections — see Tenants — Table view and Glossary — Tenants table expand.

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

Why do totals look smaller when I choose Unread? The totals line describes the active filter and search together. Unread intentionally limits the list (and the count shown there) to items you have not marked read yet — switch back to All to see counts for the full matching set under your current search text. Mark all as read still clears unread items account-wide when enabled; see the Notifications module.

Why does Bookings → Other filters → Select owners show “No options found” when I have owners in Settings? The Bookings list loads its filter vocabulary from the account-wide portfolio filter catalog. On the default Unit Name sort, the first portfolio response sometimes returns an empty meta.filterOptions.owners array even though Settings → Owners lists owners — the dedicated GET /bookings/portfolio/filter-options endpoint still has the full list. Workaround: click the Created column header once, or choose Creation Date from Sort By, reopen Other filters, then pick owners. You can switch back to Unit Name afterward; the owner filter stays applied. See Bookings — Property & Listing filters.

Bookings list — Other filters Select owners showing No options found on default Unit Name sort

Where do I set or change lease purpose on a booking? Enable and maintain the allowed values under Settings → Categories → Lease purpose. When the field is on, operators choose a value on + Create New → Booking and on the booking sidebar Contract Info → Booking information (edit mode). Tenants may be required to pick on the portal Review step when Make Lease Purpose mandatory is enabled. See Bookings — Lease purpose and Glossary — Lease purpose (booking).

Booking detail — Contract Info with Lease purpose read-only under Booking categories

I enabled payment notifications on Preferences but I still don’t get emails when a tenant pays.

Receive payment notifications under Account Settings → Preferences → Notifications & Emails is account-wide permission for the workspace to send those operator alerts. Each user must also turn on Payment notification emails under Account → Personal Settings → Your email preferences (/settings/personal). If either layer is off, you will not receive email or in-app payment-received rows. Administrators can confirm the account toggle; you control only your personal opt-in on Personal Settings. See Glossary — Payment notification (operator), Glossary — Payment notification (operator) hub, and FAQ — Payment notification (operator) hub.

I see payment emails but no matching row on /notifications (or the Dashboard bell).

Check Preferences → In-app notifications → Payments (account master) and Personal Settings → Your in-app notifications → Payments (your opt-out). Payment in-app rows also require you to stay opted in on Payment notification emails under Your email preferences. See Notifications — In-app notification preferences, Glossary — Payment notification (operator) hub, and FAQ — Payment notification (operator) hub.

Why do I still see “Pending manual in-payment” on /notifications after I recorded a receipt?

That in-app row means the receipt is still pending until someone with Approve payments confirms it on Finance → Transactions or the booking Transactions tab — the alert is expected until approval clears the queue. Distinct from Payment received rows (tenant transfer already confirmed) and Payment overdue balance alerts — see Glossary — Payment notification (operator).

Alert typeTypical summaryNext step
Pending manual in-paymentOperator-recorded receipt still pendingRow-click → booking TransactionsApprove payment
Payment receivedTenant transfer recorded (may still need approval if manual)Same triage when status is pendingFAQ — Manual receipt still pending
Payment overdueBalance past due — collectionsHandling a Late Payment — Step 1

Row-click from /notifications opens the related booking so you can approve from Transactions — see FAQ — Notification row-click navigation, Notification triage — Step 4, Bookings > Transactions — Row actions, then Step 5 when balances look correct. Until approval, Dashboard Total Debt and Finance In debt lines may lag — FAQ — Dashboard Total Debt subtitle. Full ledger habit: Glossary — Pending manual in-payment (Finance), FAQ — Manual receipt still pending, Payment Allocation — Pending manual approval (month-end habit), Common Workflows — Pending manual receipt approval, Portfolio KPI review — Step 7, and Notifications — Pending manual in-payments.

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

Hub matrix: Common Workflows — Pending manual receipt approval. Pair Common Workflows — Notification row-click navigation for alert-driven entry (notifications-row-navigation-flow.mp4).

How do I mute WhatsApp or inbox pings without turning off the Chatbot? Turn off Inbox messages under Personal Settings → Your in-app notifications for your user, or ask an administrator to disable the account master under Preferences → In-app notifications. You can still open Tools → Inbox and booking Communication when your role allows — only the bell / /notifications pings are suppressed.

Settings & tenant communications

Pair with other FAQ sections

Lifecycle and Communication Rules answers pair with Tenant Portal & Mobile App (contract signing, check-in mail), Why didn't the automatic check-in email send? (trigger matrix, paper upload vs portal signing), and Integrations & Distribution (iCal URLs). During workspace setup, map answers to Getting Started — Recommended Setup Sequence steps 10–12 (Tenant categories, Emails, Integrations) — tab map: Account Settings — Recommended setup order. Notification opt-in layers: Notifications & alerts. Full pairing matrix: FAQ section cross-reference.

Where do I get the iCal URL to subscribe an external site to Vivin availability? Each unit exposes an outbound feed at {Core API host}/ical-integration/listings/{listingId}/iCal.ics (same host your management app uses for API calls). On Sales > Channels, click Copy iCal in the trailing actions column for one unit, use the Airbnb / Booking.com wizard when linking short-stay calendars, or export CSV / Excel and read the VIVIN iCal column for many units at once — see Sales — Channel Manager export and Integrations — iCal. The feed honours Short-term iCal Max Date and your availability rules. Technical details (response headers, retrofeed for Airbnb/Booking.com, troubleshooting) are in API Reference — iCal feeds.

Where do I see which automated emails are queued or already sent? Open Account Settings → Emails and go to the Communication Rules sub-tab at /settings/communications. Click the toolbar calendar icon for All schedules, or use View sent/scheduled messages on one rule to scope the list to that rule only. The Communication schedule modal shows recipient, subject, status, and scheduled/sent times; use search to narrow the list or Export for CSV/Excel. Click a row to open that booking in the sidebar without leaving Settings. See Glossary — Communication schedule and Communication schedule (calendar).

Why don’t I see the “Now” tab or “Send now” on a communication rule? Immediate-send rules and the Now filter require the communication.send_now permission on the user’s role. Without it, the Now tab is disabled with an explanation and ad hoc blast actions are hidden. Grant it only to roles that should manually fire tenant messages; configure it in Users and roles. See Send now permission.

Analytics (KPI workspace)

Pair with other FAQ sections

Why don’t portfolio KPIs in Analytics match what I see in Sales or on a listing calendar? Analytics rolls up the portfolio for the from–to month range on the tab you are viewing (use the toolbar picker or its 6M, 12M, and YTD quick presets), with optional property, unit, and (where offered) owner roll-ups on rankings and heatmaps. Sales and Listings focus on per-listing availability, rent edits, and channel rows over the windows you work in there. Metric definitions, filters, and time lenses differ by design, so headline revenue or occupancy values are not expected to match row-for-row. Use Analytics for multi-month trends and comparisons; use Sales when you are pricing or closing availability gaps. See How Analytics differs from Sales.

How is Analytics different from the Dashboard? The Dashboard is the post-login snapshot: KPI cards, Occupancy Forecast and Cash Flow Forecast (with 1M / 3M / 6M / 12M horizon controls), and Vacant Units as of today. Illustrated chart behaviour: Glossary — Occupancy Forecast (Dashboard), Cash Flow Forecast (Dashboard), and Vacant Units (Dashboard). Analytics is the dedicated /analytics workspace: the same shell, but tabbed KPI views (Overview, Revenue, Occupancy, ADR, RevPAR, Maintenance) driven by a configurable month range, plus ranking tables and heatmaps on the metric tabs. ADR on the Analytics tabs (revenue divided by occupied nights in range) is not the same label as ADR (€) on the Dashboard occupancy chart (average monthly rent among units counted occupied that day) — see the Analytics module and Glossary — RevPAR.

Analytics shows a red error banner instead of charts — what should I do? When the KPI API fails on first load, Analytics shows an inline alert (for example that portfolio KPIs could not be loaded) and a Try again control — not empty charts that imply zero performance. Click Try again before changing filters or assuming the portfolio has no revenue or occupancy. If the problem persists, use the Dashboard for a same-day snapshot or retry later. See Analytics — Layout and controls (failure vs slow load).

Analytics — KPI load failure banner with Try again

Analytics — Overview tab with KPI bar charts and month-range picker in the management shell

Overview tab capture re-verified 2026-06-23 11:17 UTC (capture-analytics-kpi-screenshots.ts); metric tabs with ranking/heatmaps still use prior publication-clean PNGs until staging rows are clean.

Bookings

Pair with other FAQ sections

Reservation lifecycle answers pair with Payments & Finance (payment schedule, invoiced floor), Rent reduction after invoicing hub (symptom table when Change monthly rent clamps exported months — bookings-detail-change-monthly-rent-modal.png, bookings-rent-reduction-invoiced-floor-flow.mp4), Lower rent below invoiced (Change monthly rent clamps and Edit amount blocks), Fixed rent on variable unit (headline rent vs listing Rent Value), Wrong tenant on a booking hub (Change tenant vs duplicate-row Delete), Cancel Booking vs Delete Booking (real voids vs soft-archive cleanup, #1897 / #2076), Booking Changelog scope (operator edits vs create-time defaults, #2093), Booking sidebar tab load failures hub (symptom table per tab — bookings-detail-communication-tab-whatsapp-thread.png, bookings-detail-tickets-tab.png), Communication or Tickets load failure (tab-scoped Refresh / Retry), Operations (tickets and turnover), and Tenant Portal & Mobile App (contract signing). Full pairing matrix: FAQ section cross-reference.

How do I leave an internal note for my team on a booking? Open the booking (for example from Bookings → List or /bookings/list/:bookingId) and select the Internal Notes tab. The thread is not visible to tenants. Type your update in the composer; use @ plus a colleague’s handle (pick from the autocomplete list) to email them when you save. Messages are grouped by day in a chat-style layout; hover a bubble and use the trash icon to delete a note after confirming. See Bookings > Internal Notes tab.

Communication or Tickets won't load inside a booking — what should I do?

Each tab in the booking detail sidebar loads its own API slice. A failure on Communication or Tickets does not block Contract Info, Payment Plan, Deposit, or other tabs — switch tabs or keep working on Payment Plan while you retry the affected surface.

TabError copy (English UI)Recovery control
CommunicationCould not load messagesSomething went wrong loading the conversation. Try again.Refresh in the booking sidebar header toolbar (visible while Communication is active)
TicketsCould not load tickets. Try again.Retry on the red banner inside the tab

This is tab-scoped recovery — distinct from Directory list load failures, where the first fetch for an entire module list fails and shows Failed to load … with Retry / Try again on the main page.

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

Booking detail — Tickets tab with linked maintenance rows (normal loaded state; Retry appears on the red banner when the tab fetch fails)

Walkthrough: Communication tab Could not load messages → header Refresh while Payment Plan stays usable — tab-scoped recovery, not whole-module list Retry.

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

If Refresh / Retry does not recover after connectivity returns, close and reopen the booking from the list. See Bookings > Sidebar tab load failures and Glossary — Booking detail sidebar tab load failures.

Wrong tenant on a booking

The booking is linked to the wrong tenant — can I point it at someone else already in Vivin? Yes, when your role includes bookings.edit_items and the booking is still Upcoming, with check-in in the future, no signed contract on file, and no paid + invoiced allocations blocking the change. On Contract Info, use the swap icon (Change tenant) in the Tenant card, pick another existing tenant, and confirm Reassign booking. Past payments and issued invoices stay on the original tenant for audit; the payment plan is not rebuilt automatically.

SymptomLikely wrong controlFix
Wrong person, dates and unit are correctDelete BookingChange tenant — reservation stays live
Entire row is duplicate importChange tenantDelete BookingCancel Booking vs Delete Booking
Real stay voided under policyChange tenant or DeleteCancel booking — refund dialog

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

See Bookings > Change tenant.

Where is the Gantt-style bookings chart (Day / Week / Month)? On Bookings, switch the view toggle to Timeline (or open /bookings/timeline). Each row is a unit; coloured bars are stays. The chart loads listings in pages — scroll the chart body vertically to load more unit rows. Use Day, Week, or Month above the date axis, clear Only bookings when you need manual or channel blocks on the same rows, and click a bar to open Booking detail in the sidebar. Export is available only on the table List view. See Bookings > Timeline view and the walkthrough video on that page.

Bookings — Timeline view (Day scale) with unit rows, booking bars, and Day / Week / Month controls

Why can't I see a platform in my booking filters? Only platforms that are enabled in Settings > Integrations appear as filter options in the Bookings module. Enable the platform there first, then link each unit to its external listing ID.

Why does Delete Booking fail on an integration reservation?

Pair with other FAQ subsections

Integration Delete guard pairs with FAQ — Cancel Booking vs Delete Booking (when Delete is appropriate vs Cancel booking), FAQ — Portfolio retirement decisions, Glossary — Provider platform Delete Booking guard hub, Glossary — Provider platform Delete Booking guard, Bookings — Provider platform payment (bookings-detail-provider-platform-payment-field.png, bookings-provider-platform-reject-delete-flow.mp4), Bookings — Delete Booking (soft archive), and Processing a New Booking — Step 1 (duplicate imports). Full pairing matrix: FAQ subsection cross-reference.

When the booking still has a provider platform in-payment (partner-collected first payment recorded in Vivin), Delete Booking on Contract Info → Check-in & Check-out is blocked until that row is cleared (#2076). Open Transactions on the booking or Finance → Transactions, then Reject the provider-platform payment when it is still pending, or assign it to another reservation in the same account when no allocation is invoiced. Delete payment on the ledger stays disabled for provider-platform rails — rejection is the supported path. After the in-payment is rejected (or moved), retry Delete Booking. Use FAQ — Cancel Booking vs Delete Booking when you need full ledger history for a real voided stay instead of soft-archive. See Bookings — Delete Booking (soft archive) and Bookings — Provider platform payment.

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

Hub matrix: Common Workflows — Provider platform Delete Booking guard · Glossary — Provider platform Delete Booking guard hub. Per-guide mesh: Processing a New Booking — Provider platform Delete Booking guard, Managing a Check-in — Provider platform Delete Booking guard, Onboarding a New Property — Provider platform Delete Booking guard, Notification triage — Provider platform Delete Booking guard, Resetting a Management User Password — Provider platform Delete Booking guard, Using in-app support — Provider platform Delete Booking guard.

Why does Delete Booking fail with a VIVIN credit card or Virtual IBAN message?

When the booking still has a non-rejected credit card or Virtual IBAN in-payment row (Vivin system rails), Delete Booking is blocked until that payment is cleared (#2200). The error toast reads: "The booking cannot be deleted while there is a VIVIN credit card or Virtual IBAN payment still present, please reject or reassign the payment."

Open Transactions on the booking or Finance → Transactions, then Reject the pending system payment, or assign it to another reservation in the same account when invoicing rules allow. Delete payment stays disabled for vIBAN and credit card rails — rejection or reassignment is the supported path. After the in-payment is cleared, retry Delete Booking.

This guard is distinct from the provider platform block (#2076) — that error mentions provider platform payment instead. A booking can hit one guard or the other depending on which rail still has an open in-payment.

Why doesn't the booking Changelog list every field Vivin stored at creation?

Pair with other FAQ subsections

Changelog scope pairs with Glossary — Change history, Bookings — Timeline (booking change log), Listings — Change history (property/unit setup — same #2093 rule), Tools → Audit (manual blocks and discounts — not booking field edits), and Manual block hygiene (cross-portfolio block triage). Full pairing matrix: FAQ subsection cross-reference.

The Changelog under Contract Info → Check-in & Check-out shows operator-initiated edits and workflow milestones — not every default or normalized value Vivin writes when the reservation is first created (#2093). Vivin intentionally omits untouched defaults and normalized fields so the timeline does not look like dozens of phantom edits on day one. The same rule applies to Change history on Listings property/unit setup.

SurfaceWhereWhat it logs
Booking ChangelogContract Info → Check-in & Check-outMilestone dates + booking field edits (rent, dates, status)
Listings Change historyProperty/unit setup sidebarsBuilding and unit field edits (contract timing, rent grid, access)
Tools → Audit/auditCross-portfolio manual blocks and discounted contract values

When more than four booking events exist, use View all (N) and Search changes… in the modal to filter by field name, author, or date text. For cross-portfolio manual block triage, open Tools → Audit — Audit does not replace the in-sidebar Changelog or Change history blocks.

Booking detail — Contract Info, Changelog under Check-in & Check-out with milestone dates and logged field changes

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

See Bookings — Timeline (booking change log), Listings — Change history (listings-property-edit-change-history.png), Glossary — Change history, and Manual block hygiene (Audit vs sidebar audit trails).

Why does a booking show fixed monthly rent when the unit is variable?

Pair with other FAQ subsections

When every contract month between the booking's Start date and End date shares the same configured rent on a variable unit, Vivin stores the reservation as fixed rent at booking level — scheduled payment amounts are unchanged; only the headline Monthly rent and the fixed/variable flag reflect the constant value. If any month is missing from the unit's seasonal grid or amounts differ, the booking stays variable with per-month rows. The listing remains variable for future stays — only this reservation collapses to one headline. After Add booking, open Contract Info to confirm whether Change monthly rent opens with fixed selected. Legacy bookings were backfilled when their stored per-month values already matched. Rent decreases on invoiced months still follow FAQ — Lower rent below invoiced. See Bookings > Fixed rent on a variable unit, Processing a New Booking — Step 3, and Glossary — Fixed Rent.

Booking detail — Contract Info with a single Monthly rent headline on a variable listing (booking stored as fixed rent)

How do I list bookings with debt or filter by channel? Use Sort by → Debt for a debt-ordered list, or open Other filters on the Bookings toolbar: set Balance to Debt or Overpayment, use Source platform for channel-specific lists, and combine with contract, deposit, and date filters. See Bookings — Other filters.

Where do I assign a tenant category for a new direct booking?

Add booking does not include a category field — assign tenant category on the tenant profile. Use + Create New → Tenant (optional Category in the modal) before you create the reservation, or open TenantsTenant InfoPersonal Information (pencil) after the booking exists. Do this before contract or onboarding mail in Processing a New Booking — Step 4 so portal modules and Communication Rules audience match the segment. Re-verify Category during Managing a Check-in — Step 1 before access codes go out. Channel imports may inherit the default for integration-created tenants; direct bookings do not. See Glossary — Tenant category, Onboarding a New Property — Step 4, and Processing a New Booking — Step 2.

Why did my booking not generate a payment schedule? The payment schedule is generated based on the property's contract settings (payment frequency, confirmation payments, check-in payments) configured during property creation Step 4. If these settings are incomplete or missing, the schedule may not generate correctly. Verify the property's Payments tab settings.

Can I edit a booking's payment schedule after creation? The payment schedule is fixed at booking creation. You can add extra charges using the Add Charge button (see Adding Extra Charges), but you cannot remove or modify the originally generated charges.

What happens if I create a booking that overlaps with an existing one? Vivin prevents overlapping bookings on the same unit. The system will warn you about the conflict and block the creation.

What happens to the payment schedule when I cancel a booking? It depends on the refund type. Full refund: all payment items are removed. No refund: only unpaid future items are removed; already-paid items are retained. Partial refund: requires manual adjustment — the system does not automatically calculate partial amounts. When the tenant contests deposit retention during cancellation, use deposit disputes before you Mark refunded. See Cancelling a Booking.

How do I handle an early departure? Update the booking Move out date to the actual departure date from Contract Info (pencil on Booking informationMove outChange move-out date). Leave Update Payment Plan enabled so Vivin recalculates the schedule and removes future unpaid charges beyond the new date. For contract-boundary-only edits, use End dateChange contract end date — see Early Departures. Be careful with room changes to avoid double billing.

What about charges that have already been invoiced? Charges that have been invoiced through the accounting integration (e.g., Invoice-xpress) cannot be automatically removed from the payment schedule. Create a credit note on Contract Values (then issue from Finance → Transactions) or register the document manually in your accounting system. For rent specifically, Vivin enforces an invoiced floor on Change monthly rent and Contract Values → Edit amount — you cannot save a lower net on a month that Finance already exported.

Why can't I lower rent below what was already invoiced?

SymptomSurfaceFix
Month saves at invoiced amount, not your lower entryContract Info → Change monthly rentBlue Already invoiced months banner — clamped months keep exported totals
Save disabled under New net amountContract Values → Edit amountRed inline validation — net below invoiced+draft totals
Need goodwill discount below exported rentContract Values → Credit noteManage credit notes (bookings.add_credit_note) → Not issued credit noteIssue credit notes (N)
Hostkit Not issued credit note after rent reliefCredit note registered in Vivin ledgerIssue credit notes (N) — same pacing as Bulk Hostkit invoicing

When Finance has already invoiced rent for a calendar month, lowering the scheduled net below that total would break accounting alignment. On Contract Info → Change monthly rent, months where the new amount would fall below the invoiced total are clamped to the invoiced value (blue Already invoiced months info banner in the modal — other months still save at your entered amount). On Contract Values → Edit amount, Save stays disabled when net would drop below the invoiced+draft totals on that line (red inline validation under New net amount). When you truly need to reduce invoiced rent, open Contract Values → Credit note (Manage credit notes) to create a pending reversal, then issue it from Finance → Transactions (Not issued credit noteIssue credit notes (N) / Issue credit note to provider). Vivin will not persist a lower net on an already-exported month via Edit amount alone. Pair with FAQ — Fixed rent on variable unit when repricing after equal-month inference. See Bookings — Changing contract dates and rent, Contract Values tab, Finance — Invoiced floor and rent edits, and Common Workflows — Rent reduction after invoicing.

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

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

Walkthrough: pencil-edit Booking information, open Change monthly rent, then Contract Values → Edit amount on an invoiced rent line.

Hub matrix: Common Workflows — Rent reduction after invoicing · Invoiced floor (rent) hub · Rent reduction after invoicing hub · Glossary — Rent reduction after invoicing hub. Per-guide mesh: Processing a New Booking — Rent reduction after invoicing, Handling a Late Payment — Rent reduction after invoicing, Cancelling a Booking — Rent reduction after invoicing, Managing a Check-in — Rent reduction after invoicing, Portfolio KPI review — Rent reduction after invoicing, Managing a Check-out — Rent reduction after invoicing, Entering Monthly Utility Bills — Rent reduction after invoicing, Notification triage — Rent reduction after invoicing, Manual block hygiene — Rent reduction after invoicing, Onboarding a New Property — Rent reduction after invoicing, Using in-app support — Rent reduction after invoicing, Resetting a Management User Password — Rent reduction after invoicing. Pair Common Workflows — Bulk Hostkit invoicing when external rent relief surfaces Not issued credit note rows (finance-transactions-bulk-selection-bar.png).

What happens when I reject or revert an incoming payment?

Pick the correction that matches receipt status — a duplicate still pending needs Reject; a duplicate already approved needs Revert:

SymptomLikely causeFix
Duplicate never approvedStill pending on ledgerReject payment / Reject selectedPending manual receipt approval
Duplicate after month-end ApproveWrong booking or amount confirmedRevert payment on booking Transactions or Finance row menu
Delete payment greyed outvIBAN / provider platform or invoiced allocationRevert or clear Not issued credit note queue
Red / blue modal on confirmCharge already invoicedIssue credit notes (N)Finance — Issuing credit notes
Not issued credit note batch stays PendingHostkit rate limit on bulk pushSame pacing as Bulk Hostkit invoicingFAQ — Bulk Hostkit invoicing slow
Rent cut blocked below exported monthInvoiced floor — distinct from receipt cleanupRent reduction after invoicing
ActionRow statusBest surfaceEffect
Reject payment / Reject selectedpending / processingBookings → Transactions (per-row) or Finance → Transactions (bulk Reject selected only)Removes the in-payment from the booking and ledger
Revert paymentconfirmed or rejectedBookings → Transactions (per-row) or Finance → Transactions row menuRolls allocations and booking balances back
Delete paymentEligible manual rows onlyFinance → TransactionsRemoves the row entirely — disabled for vIBAN / provider platform or when any allocation is invoiced, manual, or draft
Issue credit notesAfter Reject / Revert on an invoiced chargeFinance → TransactionsNot issued credit note filter pillPushes reversal documents to Hostkit / Invoice-xpress or Set manual

Both Reject and Revert show accounting follow-up copy in the confirmation modal — Reject warns that you may need a credit note and invoice updates (red banner); Revert reminds you to update the invoice or issue a credit note when Finance already recorded the charge (blue info banner). On Finance → Transactions, Reject is bulk-only — tick pending rows and use Reject selected (there is no per-row reject icon on the ledger); booking Transactions still exposes per-row Reject payment and Revert payment.

When Hostkit or Invoice-xpress already invoiced the charge, Vivin creates credit-note reversal allocations after you confirm Reject or Revert. Triage those from Finance → Transactions: use the invoice filter pills beside ExportNot issued credit note lists rows whose reversals still need a provider push or manual registration; tick eligible rows and Issue credit notes (N) on the bulk bar, or open transaction detail and use Issue credit note to provider / Set manual on each reversal allocation. Issued credit note confirms the document left Vivin or was registered externally. This queue is the in-product follow-up the red and blue modals reference — not a separate spreadsheet. Pair with Finance — Issuing credit notes (integrated invoicing) and Glossary — Credit note (payment reject/revert).

When a duplicate or wrong booking receipt blocks month-end KPIs, use the same habit as Processing a New Booking — Step 5b, Managing a Check-in — Step 3b, Handling a Late Payment — Step 4b, Entering Monthly Utility Bills — Step 4b, Cancelling a Booking — Step 2a, Managing a Check-out — Step 6 (duplicate final payment), Notification triage — Step 4, and Portfolio KPI review — Step 7. See Payment Allocation — Correcting mistaken receipts, Bookings > Transactions row actions, Finance > Row actions, and Finance > Delete payment on the ledger.

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

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

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

Walkthrough: booking Transactions — open Approve, Reject, and Revert confirmation modals (demo cancels each without saving).

Hub matrix: Common Workflows — Reject/revert mistaken receipts. Per-guide mesh: Processing a New Booking — Reject/revert mistaken receipts, Handling a Late Payment — Reject/revert mistaken receipts, Cancelling a Booking — Reject/revert mistaken receipts, Managing a Check-in — Reject/revert mistaken receipts, Portfolio KPI review — Reject/revert mistaken receipts, Managing a Check-out — Reject/revert mistaken receipts, Entering Monthly Utility Bills — Reject/revert mistaken receipts, Notification triage — Reject/revert mistaken receipts, Manual block hygiene — Reject/revert mistaken receipts, Onboarding a New Property — Reject/revert mistaken receipts, Using in-app support — Reject/revert mistaken receipts, Resetting a Management User Password — Reject/revert mistaken receipts. Pair Common Workflows — Pending manual receipt approval when Total Debt lags because rows are still pending — approve legitimate receipts before you Revert an approved duplicate (finance-transactions-pending-pill.png). Pair Common Workflows — Bulk Hostkit invoicing when clearing the Not issued credit note queue after month-end Reject / Revert (finance-transactions-bulk-selection-bar.png).

Why is my manual receipt still pending after I recorded it?

Manual in-payments stay pending until a user with Approve payments confirms them. The Manual Payments KPI on Overview totals every manual in-payment in the selected month (pending and approved) — a non-zero value does not by itself mean the approval queue still has rows. Clicking the card opens the month drill-down of all manual rails; isolate pending rows with the amber Pending chip on Finance → Transactions.

SurfaceBest forApproval action
Finance → TransactionsPortfolio-wide Pending queue, bulk Approve selected / Reject selectedAmber Pending chip on All card → row icons or bulk bar
Bookings → TransactionsOne reservation with Payment Plan / Contract Values contextPer-row Approve payment (same modal as Finance)
/notifications or bellAlert-driven entry when a receipt still awaits approvalRow-click → booking TransactionsApprove (Step 4)

Triage from Finance → Transactions: click the amber Pending chip on the All type-summary card, then Approve payment (per row) or Approve selected / Reject selected (bulk bar). Ledger Reject is bulk-only — booking Transactions still exposes per-row reject. For mistaken duplicates, see FAQ — Reject or revert an incoming payment and Common Workflows — Reject/revert mistaken receipts. Until approval, Total Debt and In debt lines may not reflect the receipt — including the Dashboard Total Debt card for ongoing stays (headline and >15 days subtitle — FAQ — Dashboard Total Debt subtitle). When a Payment received or Pending manual in-payment alert brought you here, start from Notification triage — Step 4 before you clear unread in Step 5 — see also FAQ — Pending manual in-payment on /notifications. See Glossary — Pending manual in-payment (Finance), Payment Allocation — Pending manual approval (month-end habit), Processing a New Booking — Step 5b, Handling a Late Payment — Step 4b, Managing a Check-in — Step 3b, Entering Monthly Utility Bills — Step 4b, Cancelling a Booking — Step 2a, Portfolio KPI review — Step 7, and Finance — Pending manual payments.

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

Booking detail Transactions — Approve payment confirmation modal

Walkthrough: amber Pending chip on Finance → TransactionsApprove payment (cancel before saving).

Hub matrix: Common Workflows — Pending manual receipt approval. Per-guide mesh: Processing a New Booking — Pending manual receipt approval, Handling a Late Payment — Pending manual receipt approval, Cancelling a Booking — Pending manual receipt approval, Managing a Check-in — Pending manual receipt approval, Portfolio KPI review — Pending manual receipt approval, Managing a Check-out — Pending manual receipt approval, Entering Monthly Utility Bills — Pending manual receipt approval, Notification triage — Pending manual receipt approval, Manual block hygiene — Pending manual receipt approval, Onboarding a New Property — Pending manual receipt approval, Using in-app support — Pending manual receipt approval, Resetting a Management User Password — Pending manual receipt approval. Pair Common Workflows — Reject/revert mistaken receipts when a duplicate sits in the amber Pending queue — Reject selected, not Approve (finance-transactions-bulk-reject-selected-bar.png).

Payments & Finance

Pair with other FAQ sections

Ledger, deposits, credit note (modal banners: Credit note warning hub), and payment overdue answers pair with Bookings (Contract Values, Transactions tabs), Hostkit hub (setup surfaces + Listing keys / FR series — settings-invoicing-hostkit-series.png), Bulk Hostkit invoicing hub (symptom table for month-end Issue allocation / Issue credit notes pacing — finance-transactions-bulk-selection-bar.png, finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png), Month-end invoicing (fixed date) hub (fixed Invoice date before bulk export — settings-invoicing-invoice-date-toggle.png), Fixed invoice date reminder hub (amber banner on Finance → Transactionsfinance-transactions-fixed-invoice-date-banner.png, finance-transaction-detail-fixed-invoice-date-banner.png), Utility overage collections hub (bill posting → Payment Plan overage In Debtutilities-allocations-row-breakdown-expanded.png, utilities-allocations-review-flow.mp4), Check-out final utilities handoff hub (final supplier bills + overage lines before Ready To Refundbookings-detail-payment-plan-tab-schedule.png, bookings-detail-deposit-tab-ready-to-refund-toggle.png, utilities-allocations-review-flow.mp4), Check-out collections before refund hub (rent/fee In Debt on Payment Plan before deposit release — workflows-check-out-coordination-flow.mp4, finance-contract-values-in-debt-filter.png, bookings-detail-deposit-tab-ready-to-refund-toggle.png), Check-out ledger cleanup before refund hub (tenant paid once but duplicate transfer leaves phantom In Debtbookings-detail-transactions-revert-modal-info-banner.png, finance-transactions-bulk-reject-selected-bar.png, bookings-payment-row-actions-flow.mp4), Cancellation collections before void hub (pre-cancel rent/fee In Debt blocks Cancel bookingfinance-contract-values-in-debt-filter.png, bookings-cancel-booking-modal-refund-types.png, workflows-cancel-booking-refund-modal-flow.mp4), Deposit dispute hub (contested deposit retention blocks Refund / Mark refundedbookings-detail-deposit-tab-mark-disputed-button.png, bookings-detail-deposit-tab-disputed-state.png, deposit-dispute-mark-and-resolve-flow.mp4), Partly collected security deposit hub (deposit Paid > 0 but < Amount — distinct from rent Partial Paidfinance-deposits-lifecycle-partial-paid-card.png, bookings-detail-deposit-tab-partial-badge.png, finance-deposits-partial-collection-walkthrough.mp4), Pending manual receipt approval hub (recorded transfers still pending until Approve paymentsfinance-transactions-pending-pill.png, finance-transactions-pending-approve-flow.mp4), Credit note warning (reject/revert) hub (red/blue modal banners → Not issued credit note queue — bookings-detail-transactions-reject-modal-credit-note-banner.png, bookings-payment-row-actions-flow.mp4), Payment alert to receivables triage hub (symptom table when payment overdue alerts need row-click before Debt Agingnotifications-row-navigate-to-booking-detail.png, notifications-row-navigation-flow.mp4), Payment alert to receivables triage (row-click /notifications before Debt Aging), Confirmation alert triage (Upcoming Booking created / Payment received before bulk mark-read), Finance Income status drill-down (Income chart segments vs Debt Aging booking rows), Cash flow forecast drill-down (Cash flow forecast collections history vs Dashboard rent-due chart), Bookings that owe money (receivables triage), Dashboard Total Debt subtitle (headline vs >15 days on post-login /), Uncovered Debt KPI (deposit coverage vs all-booking Total Debt), Why do I not see a deposit on Finance Deposits? (toolbar date range default), Notifications & alerts (Handling a Late Payment — Step 1, Pending manual in-payment on /notifications until ledger approval), Integrations & Distribution (Hostkit invoicing), and Utilities (overage charges). Full pairing matrix: FAQ section cross-reference.

When should I use Cancel Booking vs Delete Booking?

Pair with other FAQ subsections

Use Cancel booking when a real reservation ends or is voided under your cancellation policy — you settle balances first (Cancelling a Booking), pick a refund type in the Contract Info dialog, and the stay stays visible in Canceled filters with full Finance → Transactions history. Use Delete Booking (soft-archive) only for mistaken or test rows you want out of default Bookings lists while keeping audit rails — not as a shortcut around cancellation settlement or deposit refunds.

ActionWhen to useList visibilityFinance → Transactions after action
Cancel bookingReal stay voided; policy-driven refundCanceled filter / statusAll payment types stay visible
Delete BookingDuplicate import, training row, mistaken createDrops from default lists (soft-archive)System Transactions (vIBAN, credit card) stay; Manual Transactions hidden (#1897); clear provider platform in-payment first (#2076)

Cancel booking opens the refund-type dialog on Contract Info → Check-in & Check-out — illustrated in Cancelling a Booking — Step 4. After confirmation, filter Bookings → Canceled to audit voided stays (bookings-list-canceled-tab.png). Delete Booking sits beside Cancel booking on the same card but soft-archives without running cancellation policy.

Delete Booking guards: clear any non-rejected provider platform in-payment first (#2076) — see Why does Delete Booking fail on an integration reservation?. Clear any non-rejected credit card or Virtual IBAN system in-payment before soft-archive (#2200) — see Why does Delete Booking fail with a VIVIN credit card or Virtual IBAN message?. Distinct from Archive property (building-level). Full three-way scope table: Portfolio retirement decisions. When manual or provider platform rows vanish from Finance → Transactions after soft-archive, see FAQ — Manual payments after Delete Booking (finance-transactions-type-summary-cards.png).

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

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

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

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

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

See Bookings — Delete Booking (soft archive), Finance — Archived bookings on the ledger, and Glossary — Archived booking ledger visibility.

Why did manual or provider platform payments disappear from Finance → Transactions after Delete Booking?

Delete Booking soft-archives the reservation. On Finance → Transactions, Vivin hides manual ledger types tied to archived bookings — transfer, cash, deposit refund, provider platform, and similar operator-recorded rows under Manual Transactions — so test or mistaken stays do not clutter the portfolio ledger (#1897). vIBAN and credit card automated captures under System Transactions stay visible for bank/card reconciliation. Canceled bookings that are not archived keep every payment type visible. Ledger rows with no booking link (platform-level movements) are never hidden by this gate.

This is expected behaviour, not a sync bug — use FAQ — Cancel Booking vs Delete Booking when you need full Transactions history for a real voided stay. Month-end: if totals look short after cleaning up training rows, confirm you did not Delete Booking on reservations that still had manual receipts you need in exports — Portfolio KPI review — Step 7.

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

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

See Finance — Archived bookings on the ledger, Glossary — Archived booking ledger visibility hub, Glossary — Archived booking ledger visibility, and Bookings — Delete Booking (soft archive).

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

What does Finance Overview “Income status” show, and how do I open the debt list?

Pair with other FAQ subsections

On Finance > Overview, the stacked Income chart breaks each month into Paid (dark teal), Scheduled (light teal), and In debt (red). Click a bar segment (or a row in its hover tooltip) to open a payment-line modal scoped to that month and status — tenant · unit rows with View booking, not a ranked debtor list.

SurfaceScopeOpens
Income → In debt segmentOne calendar month + statusPayment-line modal (finance-overview-income-status-in-debt-modal.png)
Debt Aging panelBooking-level receivablesTop debtors or overdue bucket → booking sidebar (finance-overview-debt-aging-expanded-bucket.png)
Total Debt KPI (Finance strip)All-booking underpayment headlineSummary only — triage from Debt Aging
Dashboard Total Debt cardOngoing bookings onlyHeadline + >15 days subtitle — not clickable (dashboard-kpi-total-debt-tooltip.png)

For booking-level receivables (who owes, days overdue), use the Debt Aging panel on the right: expand an overdue bucket or pick Top debtors, then click a row to open the booking sidebar. The Finance Total Debt KPI summarizes underpayment but does not open a table. Pair with FAQ — Bookings that owe money when you need tenant · unit rows instead of payment lines. Collections workflow: Handling a Late Payment — Step 1. Month-end reconciliation: Portfolio KPI review — Step 7. See Finance > Income status drill-down and Debt Aging.

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

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

Hub matrix: Common Workflows — Finance Income status drill-down · Finance debt receivables triage · Payment alert to receivables triage (notifications-row-navigation-flow.mp4). Per-guide mesh: Processing a New Booking — Finance Income status drill-down, Cancelling a Booking — Finance Income status drill-down, Managing a Check-in — Finance Income status drill-down, Managing a Check-out — Finance Income status drill-down, Entering Monthly Utility Bills — Finance Income status drill-down, Handling a Late Payment — Finance Income status drill-down, Portfolio KPI review — Finance Income status drill-down, Notification triage — Finance Income status drill-down, Manual block hygiene — Finance Income status drill-down, Onboarding a New Property — Finance Income status drill-down, Using in-app support — Finance Income status drill-down, Resetting a Management User Password — Finance Income status drill-down. Pair Common Workflows — Pending manual receipt approval when Total Debt lags because transfers are still pending (finance-transactions-pending-pill.png).

What does Finance Overview “Cash flow forecast” show, and how do I open the All payments modal?

Pair with other FAQ subsections

Cash flow forecast (Finance Overview) pairs with FAQ — Finance Income status drill-down (Income chart status segments vs collections history), Cash flow forecast drill-down hub (collections history vs Income / Dashboard symptom table), FAQ — Dashboard Total Debt subtitle (ongoing bookings on / vs Finance KPIs), Glossary — Cash flow forecast (Finance Overview), Glossary — Cash Flow Forecast (Dashboard) (rent due dates — different chart), Common Workflows — Cash flow forecast drill-down, Portfolio KPI review — Step 7, and Finance > Income chart and cash flow forecast. Full pairing matrix: FAQ subsection cross-reference.

On Finance > Overview, the Cash flow forecast chart (below the stacked Income chart) shows actual cash received per period — confirmed in-payments only, with no scheduled or In debt amounts. Toggle Month vs Day on the chart header. Click a bar to open an All payments drill-down modal for that month or day.

SurfaceScopeOpens
Cash flow forecast barOne calendar month or dayAll payments modal (finance-overview-cash-flow-all-payments-modal.png)
Income → Paid segmentOne month + statusPayment-line modal — FAQ — Finance Income status drill-down
Dashboard Cash Flow ForecastRent due on calendar daysTiming chart — not collections (dashboard-cash-flow-forecast-chart.png)
Operations → Cash FlowsNon-booking expensesOperator-recorded lines — not Overview collections

This is collections history on Finance — distinct from the Dashboard rent-due chart (Dashboard > Cash Flow Forecast) and from the stacked Income chart (FAQ — Finance Income status drill-down). Month-end reconciliation: Portfolio KPI review — Step 7.

Finance Overview — Cash flow forecast with Day granularity selected

Finance Overview — All payments drill-down from a Cash flow forecast month bar

Short walkthrough: toggle Day on Cash flow forecast, click a bar, review the All payments drill-down, then close.

Hub matrix: Common Workflows — Cash flow forecast drill-down · Cash flow forecast drill-down hub · Finance Income status drill-down · Portfolio KPI review — Step 7. Per-guide mesh: Processing a New Booking — Cash flow forecast drill-down, Cancelling a Booking — Cash flow forecast drill-down, Managing a Check-in — Cash flow forecast drill-down, Managing a Check-out — Cash flow forecast drill-down, Entering Monthly Utility Bills — Cash flow forecast drill-down, Handling a Late Payment — Cash flow forecast drill-down, Portfolio KPI review — Cash flow forecast drill-down, Notification triage — Cash flow forecast drill-down, Manual block hygiene — Cash flow forecast drill-down, Onboarding a New Property — Cash flow forecast drill-down, Using in-app support — Cash flow forecast drill-down, Resetting a Management User Password — Cash flow forecast drill-down.

How do I triage a payment overdue alert before opening Finance Debt Aging?

Pair with other FAQ subsections

Payment overdue alerts on /notifications pair with Payment alert to receivables triage hub (symptom table + per-guide mesh), FAQ — Notification row-click navigation (row-click opens the related booking), FAQ — Confirmation alert triage (contrast Upcoming vs Ongoing/Ended alerts), FAQ — Pending manual in-payment on /notifications (Approve before Debt Aging), FAQ — Bookings that owe money (portfolio Top debtors after single-booking triage), Common Workflows — Payment alert to receivables triage, Notification triage — Step 4, Glossary — Payment notification (operator), and Notifications — Payment overdue alerts. Full pairing matrix: FAQ subsection cross-reference.

On /notifications, row-click a Payments alert before you bulk Mark all as readNotification triage — Step 4 opens the booking behind the ping so you confirm balance on Payment Plan or Transactions first. Only after single-booking triage (and clearing amber Pending receipts) open Finance → Overview → Debt Aging for ranked Top debtors — hub: Common Workflows — Finance debt receivables triage.

Alert text on /notificationsStep 4 row-click targetBefore Debt Aging
Payment overduePayment Plan on opened bookingConfirm arrears — then Handling a Late Payment — Step 1 or Top debtors
Pending manual in-paymentTransactionsApproveNot Debt Aging until queue clears — Pending manual receipt approval
Payment received from tenant …Transactions — confirm ledgerApprove if still pending — then Step 5

Contrast Upcoming confirmation-week alerts (Booking created, Payment received on imports) with Ongoing/Ended payment overdueFAQ — Confirmation alert triage and hub: Common Workflows — Confirmation alert triage. When Total Debt stays high after row-click, check amber Pending on Finance → Transactions and duplicate approved transfers (Reject/revert mistaken receipts) before you escalate collections on phantom debt.

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

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

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

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

Hub matrix: Common Workflows — Payment alert to receivables triage · Payment alert to receivables triage hub · Finance debt receivables triage · Notification triage — Step 4. Module pairing: Bookings — Payment alert to receivables triage, Finance — Payment alert to receivables triage. Per-guide mesh: Processing a New Booking — Payment notification (operator), Cancelling a Booking — Payment notification (operator), Managing a Check-in — Payment notification (operator), Managing a Check-out — Payment notification (operator), Entering Monthly Utility Bills — Payment notification (operator), Handling a Late Payment — Payment notification (operator), Portfolio KPI review — Payment notification (operator), Notification triage — Payment notification (operator), Manual block hygiene — Payment notification (operator), Onboarding a New Property — Payment notification (operator), Using in-app support — Payment notification (operator), Resetting a Management User Password — Payment notification (operator).

How do I triage an Upcoming confirmation alert before marking notifications read?

Pair with other FAQ subsections

Upcoming confirmation-week alerts on /notifications pair with FAQ — Notification row-click navigation (row-click opens the related booking), FAQ — Payment alert to receivables triage (contrast Upcoming vs Ongoing/Ended payment overdue), Confirmation alert triage hub (Booking created / Payment received symptom table), FAQ — Pending manual in-payment on /notifications (Approve before bulk mark-read), Common Workflows — Confirmation alert triage, Processing a New Booking — Step 5b / Step 6, Notification triage — Step 4, Glossary — Payment notification (operator), and Notifications — Payment overdue alerts (alert-type contrast). Full pairing matrix: FAQ subsection cross-reference.

On /notifications, row-click each Upcoming Booking created or Payment received alert before you bulk Mark all as readNotification triage — Step 4 opens the Upcoming booking behind the ping so you finish confirmation gates on Transactions or Contract Info first. Only after Processing a New Booking — Step 5b / Step 6 (and Step 5) clear unread — hub: Common Workflows — Confirmation alert triage.

Alert text on /notificationsStep 4 row-click targetBefore bulk mark-read
Booking created / new reservationContract Info / status tabs on opened bookingStep 6 portal sanity — not Managing a Check-in — Step 1 until ~7 days out
Payment received from tenant …TransactionsApproveStep 5b when receipt stays pending
Pending manual in-paymentTransactionsApprovePending manual receipt approval — not Debt Aging
Payment overdue on Upcoming stayPayment Plan on opened bookingHandling a Late Payment — Step 1 — contrast Upcoming vs Ongoing on Payment alert to receivables triage

Contrast Upcoming confirmation-week alerts with Ongoing/Ended payment overdue — route receivables alerts via FAQ — Payment alert to receivables triage before Finance → Overview → Debt Aging. When Payment Plan still shows unpaid after a Payment received alert, the transfer is usually still pending — finish Step 5b before Step 5. Month-end lingering Pending on imports: Step 6b during Portfolio KPI review — Step 7.

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

Booking detail Transactions — Approve payment confirmation modal

Short walkthrough: row-click a confirmation-week Payment received alert on /notifications, Approve on Transactions, then clear unread in Step 5.

Hub matrix: Common Workflows — Confirmation alert triage · Confirmation alert triage hub · Payment alert to receivables triage · Confirmation to check-in handoff · Notification triage — Step 4. Module pairing: Bookings — Confirmation alert triage, Finance — Confirmation alert triage. Per-guide mesh: Processing a New Booking — Confirmation alert triage, Cancelling a Booking — Confirmation alert triage, Managing a Check-in — Confirmation alert triage, Managing a Check-out — Confirmation alert triage, Entering Monthly Utility Bills — Confirmation alert triage, Handling a Late Payment — Confirmation alert triage, Portfolio KPI review — Confirmation alert triage, Notification triage — Confirmation alert triage, Manual block hygiene — Confirmation alert triage, Onboarding a New Property — Confirmation alert triage, Using in-app support — Confirmation alert triage, Resetting a Management User Password — Confirmation alert triage.

How do I see which bookings owe money right now?

Open Finance > Overview and use the Debt Aging panel: expand an overdue bucket or pick a row under Top debtors (each line shows tenant · unit, days overdue, and amount). Click a row to open the booking sidebar for collections follow-up.

When arrears cluster on one tenant category (corporate, short-stay, or Unassigned), open Other filters → Tenant category on Finance → Overview or Contract Values before you rank Top debtors — mirror the same segment on Bookings and Tenants when the Finance drawer omits it (FAQ — Finance tenant category filter parity, Common Workflows — Portfolio segmentation by tenant category).

The Total Debt KPI above summarizes portfolio underpayment but does not open a table on the redesigned Overview — triage from Debt Aging or the In debt segment on the Income chart (FAQ — Finance Income status drill-down). When Uncovered Debt sits close to Total Debt, prioritize Top debtors rows with thin deposit coverage — FAQ — Uncovered Debt KPI. Collections follow-through: Handling a Late Payment — Step 1. After a payment alert on /notifications, continue from Notification triage — Step 4. See Finance > Debt Aging panel and Glossary — Finance Debt Aging.

Finance Overview — Debt Aging panel with overdue buckets and Top debtors for booking-level receivables triage

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

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

What does Dashboard Total Debt subtitle mean?

On the post-login Dashboard, the Total Debt card headline sums tenant underpayment on ongoing bookings only — the same live-stay notion Finance uses for collections triage. The subtitle below it shows how much of that ongoing debt sits on bookings older than 15 days; it is not a second copy of the headline. Hover the card info icon for the in-app definition of ongoing bookings and overdue debt.

The card does not open a booking list — use FAQ — Bookings that owe money (Debt Aging / Top debtors on Finance) when you need tenant · unit rows. For all-booking receivables, Uncovered Debt, and Manual Payments, open Finance > Overview instead (finance-overview-kpi-cards.png). Month-end reconciliation habit: Portfolio KPI review — Dashboard Total Debt subtitle. Hub matrix: Common Workflows — Finance debt receivables triage · Payment alert to receivables triage. Per-guide mesh: Processing a New Booking — Dashboard Total Debt subtitle, Cancelling a Booking — Dashboard Total Debt subtitle, Managing a Check-in — Dashboard Total Debt subtitle, Managing a Check-out — Dashboard Total Debt subtitle, Entering Monthly Utility Bills — Dashboard Total Debt subtitle, Handling a Late Payment — Dashboard Total Debt subtitle, Portfolio KPI review — Dashboard Total Debt subtitle, Notification triage — Dashboard Total Debt subtitle, Manual block hygiene — Dashboard Total Debt subtitle, Onboarding a New Property — Dashboard Total Debt subtitle, Using in-app support — Dashboard Total Debt subtitle, Resetting a Management User Password — Dashboard Total Debt subtitle. Pair FAQ — Finance debt receivables triage hub and Pending manual receipt approval hub when headline lags after Add Payment.

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

What is Uncovered Debt on Finance Overview?

Uncovered Debt is the part of portfolio Total Debt that is not offset by security deposits you still hold. A high Total Debt with a similar Uncovered Debt figure often means collections risk is not cushioned by deposit balances — prioritize those bookings in Debt Aging or Contract Values → In Debt (FAQ — Bookings that owe money, Finance — Debt Aging panel).

The Dashboard Total Debt card covers ongoing bookings only and does not show Uncovered Debt — open Finance → Overview for the seven-card strip (finance-overview-kpi-cards.png). See Glossary — Uncovered Debt, Glossary — Uncovered Debt hub, Common Workflows — Uncovered Debt KPI, Common Workflows — Finance debt receivables triage, Handling a Late Payment — Step 1, FAQ — Dashboard Total Debt subtitle, and Finance > KPI strip. Hub matrix: Common Workflows — Uncovered Debt KPI · Uncovered Debt KPI hub. Per-guide mesh: Processing a New Booking — Uncovered Debt KPI, Cancelling a Booking — Uncovered Debt KPI, Managing a Check-in — Uncovered Debt KPI, Managing a Check-out — Uncovered Debt KPI, Entering Monthly Utility Bills — Uncovered Debt KPI, Handling a Late Payment — Uncovered Debt KPI, Portfolio KPI review — Uncovered Debt KPI, Notification triage — Uncovered Debt KPI, Manual block hygiene — Uncovered Debt KPI, Onboarding a New Property — Uncovered Debt KPI, Using in-app support — Uncovered Debt KPI, Resetting a Management User Password — Uncovered Debt KPI.

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

Finance Overview — In debt legend opened with payment line list and total

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

Uncovered Debt KPI

Pair with other FAQ hub sections

Deposit-coverage questions pair with Finance debt receivables triage hub (Top debtors after KPI strip compare), Pending manual receipt approval hub (Total Debt / Uncovered Debt lag until Approve), Partly collected security deposit hub (booking Deposit shortfall vs portfolio KPI), Payments & Finance, and Portfolio KPI review — Step 7. Hub parity: Uncovered Debt KPI hub · Glossary — Uncovered Debt hub · Common Workflows — Uncovered Debt KPI. Full pairing matrix: FAQ section cross-reference.

SymptomFix
Uncovered DebtTotal DebtThin deposit offsets — prioritize Debt Aging Top debtors (finance-overview-debt-aging-expanded-bucket.png)
Looking for Uncovered Debt on DashboardOpen Finance → Overview seven-card strip — finance-overview-kpi-cards.png
Total Debt unchanged after Add PaymentApprove Pending rows first — Pending manual receipt approval hub
Month-end debt looks low but notifications persistCompare Uncovered Debt on Finance strip — not Dashboard ongoing card — Portfolio KPI review — Step 7
Need ranked debtors after thin-coverage readFinance debt receivables triage hubTop debtors after KPI compare

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

Why doesn't Finance → Other filters list every tenant category?

SymptomLikely causeFix
Segment defined in Settings but missing on FinanceStale browser session or permissionsRefresh the page; confirm the segment still exists under Settings → Tenant categories — Finance loads the full catalog via GET /tenant-categories (#2314)
Filter results stale after Tenant Info editFinance caches refreshingWait seconds — Finance tenant category cache refresh
Segment missing on Bookings toolbar but present on FinanceBookings uses portfolio filter catalogMirror on Tenants or check Bookings — Other filters catalog source
Month-end debt skewed to one segmentMixed portfolio in default Finance viewsFinance → Other filters → Tenant category + Finance debt receivables triagePortfolio KPI review — Step 6

Finance → Other filters → Tenant category lists every segment defined under Settings → Tenant categories (GET /tenant-categories, #2314) — not only segments already present on cached booking rows. If a segment you created in Settings does not appear, refresh the drawer or confirm the segment was saved. Bookings → Other filters may still use the portfolio filter catalog for some controls; when Bookings and Finance disagree, check that the segment exists in Settings first. See Finance — Tenant category filter.

After you recategorize a tenant on Tenants → Tenant Info, Vivin force-refreshes Finance caches in the background (#2088) — Contract Values, Overview, and Deposits filter results usually match the new segment within seconds. That refresh updates which rows match the filter; it does not change the drawer vocabulary (already account-wide). See Glossary — Finance tenant category cache refresh.

Hub matrix: Common Workflows — Portfolio segmentation by tenant category. Per-guide mesh: Onboarding a New Property — Portfolio segmentation by tenant category, Processing a New Booking — Portfolio segmentation by tenant category, Managing a Check-in — Portfolio segmentation by tenant category, Notification triage — Portfolio segmentation by tenant category, Handling a Late Payment — Portfolio segmentation by tenant category, Portfolio KPI review — Portfolio segmentation by tenant category, Managing a Check-out — Portfolio segmentation by tenant category, Cancelling a Booking — Portfolio segmentation by tenant category.

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

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

Why doesn't WhatsApp Genius recognize my number?

SymptomLikely causeFix
Genius ignores messages from a staff phoneNumber not linked on UsersOpen Account Settings → Users, Edit the teammate, enter Phone Number in international format, and save (#2311) — the field is on Edit, not Add Team Member
Linked but wrong permissionsSender maps to a different userConfirm the WhatsApp sender matches the saved Phone Number exactly — Genius resolves the real property manager and their role
Cannot save a phoneNumber already linked to another userEach phone is unique per account while set — clear or change the other user's phone first
Confused with tenant chatbotTwo different WhatsApp flowsGenius = landlord staff assistant; ChatBot = tenant support line — see Automation & AI
Replies look like broken markdown / tablesWhatsApp formatting pathExpected: Genius strips tables/headings for WhatsApp (#2323) — see Automation & AI — How Genius replies behave
Genius says it cannot change data / cannot access accountHonest tool surfaceCheck AI / MCP → Tool permissions and the user’s role — Genius only advertises tools actually attached this turn (#2325)
Confirmation asks in the wrong languageLanguage consistencyGenius must confirm in the language of the latest user message (#2324); rephrase in that language if a prior English stub appears

Why don't Genius or AI Chat revenue numbers match Analytics?

SymptomLikely causeFix
Assistant “revenue” ≠ Analytics Revenue / ADR / RevPAR chartsDifferent domains by design (#3183)Compare against Finance → Overview (or Income), not Analytics occupancy pricing charts
“How much did we make?” ≠ bank depositsIncome expected vs cash collectedAsk for cash collected / received — get-finance-overview exposes both; get-revenue-summary is expected income (paid + scheduled + in debt), not cash in
Assistant cannot answer finance questionsAnalytics tool domain Off, or missing finance.moduleEnable Analytics (at least Read-only) on AI / MCP and confirm the user’s role includes Finance
Figures look stale vs the Finance pageFilters / month windowMatch the assistant’s month (or omit months for current) and property/owner scope to the Finance toolbar before re-asking

Why does the tenant portal show a different deposit refund amount?

After operators Mark refunded, the Tenant Portal — Payments tab shows the net cash returned to the tenant — not the full contract deposit (#2295). When damage or unpaid charges were deducted from the deposit before refund, the portal shows a breakdown: gross reversed, amount applied to charges, and net to tenant. Transferred refunds (balance moved to another booking) show €0 net on this reservation. Before Mark refunded, tenants still see the forecast/pending state. Operators reconcile using Est. Refund on the booking Deposit tab and Finance → Deposits.

Why is a payment showing in the wrong month? Check the Paid At date on the incoming payment. If it is set incorrectly, the payment will appear in the wrong period in financial reports. Correct it in the Finance > Transactions tab.

A tenant paid on the wrong booking — can I move the receipt without re-entering the amount? Yes, when your role includes Assign payments to other bookings (finance.assign_payments_to_other_bookings). On Finance → Transactions or a booking’s Transactions tab, use Assign to other booking on an eligible in-payment row, or open transaction detail and use Reassign after choosing the target booking. The target can belong to a different tenant as long as it is in the same Vivin account — the case where a tenant pays for a family member and the transfer lands on the payer's booking. The whole payment moves (there is no partial split), and the control is disabled when any allocation on that payment is already invoiced. See Finance > Assign a payment to another booking.

How does payment allocation work? Incoming payments are allocated to scheduled charges based on the priority order configured in Settings > Payments. The highest-priority outstanding charge is paid first. See Payment Allocation for a detailed explanation.

What happens when a tenant overpays? The excess amount becomes a credit that is automatically applied to the next outstanding charge. See Overpayment Handling.

How do I reconcile bank statements with Vivin? Use the Transactions tab as your ledger: set the date range and Other filters to match the statement period, and use Select platforms when you isolate one channel's inflows. Export CSV or Excel to compare against your bank file offline. When you need to approve pending payments or batch-update invoice or allocation state, select rows with the checkboxes and use Approve selected, Issue allocation, Set manual, or Revert invoice from the bulk bar (requires Approve payments). For platform payouts where commissions were deducted, see Platform reconciliation. If a payment appears in the wrong month in reports, check Paid At on the transaction row.

Why is bulk Hostkit invoicing slow?

Before you re-run Issue allocation on the same rows, match your symptom:

SymptomLikely causeFix
Rows stay Pending / Failed for several minutesHostkit rate limit — Vivin paces per listing keyLeave the batch running; refresh Transactions before duplicate runs
Same rows still Failed after refreshMissing Listing keys or blank Hostkit invoice seriesIntegrations — Hostkit + Invoicing — Hostkit series
Hostkit invoice series is not configured toastSeries field emptySave the exact FR code from Hostkit Faturação → Séries
Wrong document date on issued invoicesFixed Invoice date still activeMonth-end invoicing hub — turn Use today back on after batch
Bulk Pending — not a date issueHostkit API pacingBulk Hostkit invoicingrefresh Transactions before re-issue
Not issued credit note queue after Reject / RevertInvoiced charge reversed in VivinIssue credit notes (N) — same Hostkit pacing as Issue allocationReject/revert mistaken receipts
Change monthly rent clamped below exported totalInvoiced floor — not Hostkit slownessRent reduction after invoicing — external credit note first

Hub matrix: Common Workflows — Bulk Hostkit invoicing · Bulk Hostkit invoicing hub · Glossary — Bulk Hostkit invoicing hub. Per-guide mesh: Processing a New Booking — Bulk Hostkit invoicing, Handling a Late Payment — Bulk Hostkit invoicing, Cancelling a Booking — Bulk Hostkit invoicing, Managing a Check-in — Bulk Hostkit invoicing, Portfolio KPI review — Bulk Hostkit invoicing, Managing a Check-out — Bulk Hostkit invoicing, Entering Monthly Utility Bills — Bulk Hostkit invoicing, Notification triage — Bulk Hostkit invoicing, Manual block hygiene — Bulk Hostkit invoicing, Onboarding a New Property — Bulk Hostkit invoicing, Using in-app support — Bulk Hostkit invoicing, Resetting a Management User Password — Bulk Hostkit invoicing. Pair Common Workflows — Month-end invoicing (fixed date) when document dates must match before the batch (finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png). Pair Common Workflows — Rent reduction after invoicing when month-end repricing hits the invoiced floor (bookings-detail-change-monthly-rent-modal.png). Pair Common Workflows — Reject/revert mistaken receipts when cleanup surfaces the Not issued credit note filter (finance-transactions-bulk-reject-selected-bar.png).

Hostkit limits how many API requests each listing key can make per minute. When you run Issue allocation or Invoice selected on many Finance → Transactions rows at once, Vivin paces outbound Hostkit calls (per key and at account level) and automatically retries HTTP 429 responses with backoff — so a large batch can take several minutes even though the UI stays responsive.

What to do: leave the batch running, then refresh Transactions before you click Issue allocation again on rows that still show Pending or Failed invoicing — duplicate runs can create support noise. If failures persist after a few minutes, confirm each unit has a Listing keys entry and Hostkit invoice series is saved. See Integrations — Hostkit API pacing, Glossary — Hostkit, and Portfolio KPI review — Step 7 (month-end sign-off).

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

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

Account Settings Invoicing — Hostkit invoice series (FR) field

How do I check which tenants have provided their IBAN for deposit returns? The Deposits tab lists Tenant IBAN on each row and supports search (including IBAN substring) plus quick status chips so you can focus on refunds blocked on missing bank details. See Finance > Deposits.

How do I find bookings where the security deposit is only partly collected?

Partial Paid on a security deposit is not the same signal as Partial Paid on a rent schedule line — use this table before you chase the wrong tab:

SignalWhere to lookWhat it means
Deposit Partial paid lifecycle cardFinance → DepositsDeposit lifecycle status rowPortfolio queue: Paid > 0 but < Amount on the deposit
Other filters → Deposit status → Partial paidBookings or Finance → Contract ValuesSame lifecycle slice without opening Finance first
Amber Partially paid + remainingBooking sidebar Deposit tab — Initial DepositPer-booking shortfall (Partial Paid on depositStatus)
Partial Paid on a rent linePayment Plan or Contract Values rent rowsScheduled rent — not the security deposit

On Finance → Deposits, click Partial paid in the Deposit lifecycle status row on Finance → Deposits to narrow the table to rows where Paid is greater than zero but still below Amount. Alternatively, open Other filters → Deposit status → Partial paid on Bookings or Finance → Contract Values for the same lifecycle slice across modules. Click a row to open the booking sidebar on Deposit — the Initial Deposit row shows an amber Partially paid badge and a remaining helper with the shortfall (Partial Paid on depositStatus). The same badge appears when you open Deposit from the booking list without using Finance first. Hub matrix: Common Workflows — Partly collected security deposit. Per-guide mesh: Processing a New Booking — Partly collected security deposit, Managing a Check-in — Partly collected security deposit, Handling a Late Payment — Partly collected security deposit, Cancelling a Booking — Partly collected security deposit, Portfolio KPI review — Partly collected security deposit, Managing a Check-out — Partly collected security deposit, Entering Monthly Utility Bills — Partly collected security deposit, Notification triage — Partly collected security deposit, Onboarding a New Property — Partly collected security deposit, Manual block hygiene — Partly collected security deposit, Resetting a Management User Password — Partly collected security deposit, Using in-app support — Partly collected security deposit. See Finance → Deposits — Deposit lifecycle status cards, Finance — Deposit status filter, Bookings — Deposit tab, Processing a New Booking — Step 5, Managing a Check-in — Step 3, and Glossary — Deposit lifecycle status.

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

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

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

How do I freeze a deposit refund while we dispute deductions? Turn on Enable deposit disputes under Account Settings → Preferences → Charges & Payments, then use Mark as Disputed on the booking Deposit tab (or Mark disputed on Finance → Deposits) while the deposit is Fully Paid and your role includes bookings.dispute. Refund and Mark refunded stay disabled until you click Resolve Dispute (Disputed on depositStatus — see Glossary — Deposit lifecycle status). Portfolio triage: Other filters → Deposit status → Disputed on Bookings or Finance — see Finance — Deposit status filter. Full symptom table and mesh: Deposit dispute hub. See also Glossary — Deposit dispute hub, Glossary — Deposit dispute, Bookings — Deposit disputes, Finance — Deposit disputes (portfolio actions), Managing a Check-out, and Cancelling a Booking when retention is contested during cancellation.

Why do I not see a deposit (or dispute row actions) on Finance → Deposits?

Before you assume a booking has no deposit record, check whether the Finance → Deposits toolbar date range is hiding the row:

SymptomLikely causeFix
Tenant or unit missing after an older move-outDefault ~3 months excludes check-out / Refund Due DateClear date range selection or widen from / to, then Search
Mark disputed / Resolve dispute chips missing on FinanceDispute row actions only render on visible rowsClear or widen the toolbar range first
Lifecycle card counts look too lowCards scope to the active date windowClear the range before month-end deposit triage
Partial paid card empty after clearing rangeNo partly collected deposits in portfolioFAQ — Partly collected security deposit — distinct from rent Payment Plan
Older move-outs surfaced during lockout catch-upDelayed refund/dispute triageCommon Workflows — Lockout catch-up after password recovery

The tab’s date range defaults to about the last three months. Rows appear when check-in, check-out, or Refund Due Date intersects that window — not when the booking was created. For older move-outs, clear the date range or widen from / to, then use Search by tenant or unit. The same range applies to status summary card counts and Export. Hub matrix: Common Workflows — Deposit missing on Finance Deposits. Per-guide mesh: Managing a Check-out — Deposit missing on Finance Deposits, Cancelling a Booking — Deposit missing on Finance Deposits, Portfolio KPI review — Deposit missing on Finance Deposits, Resetting a Management User Password — Deposit missing on Finance Deposits, Processing a New Booking — Deposit missing on Finance Deposits, Handling a Late Payment — Deposit missing on Finance Deposits, Managing a Check-in — Deposit missing on Finance Deposits, Notification triage — Deposit missing on Finance Deposits, Onboarding a New Property — Deposit missing on Finance Deposits, Entering Monthly Utility Bills — Deposit missing on Finance Deposits, Manual block hygiene — Deposit missing on Finance Deposits, Using in-app support — Deposit missing on Finance Deposits. See Glossary — Finance Deposits date range, Finance — Deposits tab, Managing a Check-out — Step 5, and Glossary — Deposit dispute when Enable deposit disputes row chips are missing for an older check-out.

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

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

Booking detail — Deposit tab Refund Disputed with Resolve Dispute while refund is blocked

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

Can I see Airbnb and Booking.com income in the Finance module? Short-term platform income (when configured) is reflected in the Finance module's Income tab and Transactions tab. See the Finance module for income tracking across all channels.

Properties & Listings

Pair with other FAQ sections

Property wizard and calendar answers pair with Integrations & Distribution (channels and iCal), Operations (check-in/out pseudo rows), and Bookings (Timeline overlap checks). Full pairing matrix: FAQ section cross-reference.

How do I change the cleaning fee timing (Every Month vs. one-time)? The cleaning fee frequency defaults to Every Month during property creation and cannot be changed in the wizard. After creation, open the property in Listings, edit Contract Information, enable Cleaning Fee if needed, and choose Every Month, One-Time Fee at Booking Confirmation, or One-Time Fee at Move-in from the Frequency dropdown — see Payments tab — Cleaning fee frequency. You can override the mode on an individual booking under Contract Info → Cleaning Fees requirement; verify the Payment plan afterward, especially when invoiced cleaning rows already exist.

What is the difference between a Property and a Unit? A Property is a physical building or location. A Unit is an individual rentable space within that property. See Portfolio Hierarchy for more details.

Why can't I select an owner when creating a property? Owners must be registered in Settings > Owners before they appear in the property creation wizard. Add the owner there first.

Why don't I see the Full integration pill on my property or unit in Listings? Operators with Listings edit access should see Setup, Full integration, and Photos pills in the property or unit edit sidebar (#2082). Setup holds operational fields; Full integration opens the rich property & listing (booking engine) details editor (marketplace copy, amenities, partner fields); Photos is the gallery-only layer. If pills are missing, confirm your role includes Listings edit permission in Users and roles. The older header Go to details shortcut was replaced by these pills — see Glossary — Property edit sidebar pills and Listings — Editing Properties.

Can I bookmark or share a link straight into Property Details or Listing Details? Yes: use Listings URLs with ?propertyDetails=1 on the property edit path, or ?listingDetails=1 on a unit sidebar path. Patterns and examples are in Management Frontend Deep Links — Booking engine details layer.

Can I see prices directly on the availability calendar? Yes. Open Sales > Pricing (/sales/pricing): each month cell shows rent with bookings and blocks drawn behind it. You can also bulk-edit prices by selecting multiple cells. Legacy /sales/calendar bookmarks redirect to the same grid. For a time-on-axis view without month rent cells, use Sales > Multicalendar (/sales/multicalendar), Sales > Overview → Availability over time, or Bookings > Timeline. See Sales > Pricing tab and Sales > Multicalendar tab.

Why doesn’t Vacant Units show a unit that only has a manual block?

Pair with other FAQ subsections

By default (Default on Preferences → Booking Defaults), a manual block makes the unit not vacant — it disappears from Dashboard → Vacant Units, lowers Today, and is excluded from Sales → Available now / Multicalendar filters. Choose Include manual blocks when you treat operator holds as physical vacancy for leasing triage (maintenance buffers you still want on Vacant Units). OTA/iCal calendar blocks and booking-linked unavailabilities still occupy the unit everywhere. After you change the setting, refresh Dashboard and Sales before reconciling counts with Portfolio KPI review — Step 7.

How can I tell the difference between a booking and a manual block on the calendar? In Sales > Pricing, bookings and manual or channel unavailabilities use different colours and patterns so you can distinguish tenant stays from operator holds and short-term blocks. The Overview tab’s Availability over time charts and Bookings Timeline use the same underlying occupancy rules with aggregated or per-unit free windows. See Sales module.

Portfolio retirement: Archive property, Cancel booking, or Delete Booking?

Before you pick Archive, Cancel booking, or Delete Booking, match your symptom:

SymptomLikely wrong controlFix
Need full ledger for a voided real stayDelete BookingUse Cancel bookingCancelling a Booking
Manual receipts vanished after cleanupDelete Booking on a stay you still reconcileExpected #1897 — use Cancel when you need manual rows; see Manual payments after Delete Booking
Building should leave pickers but history staysDelete Booking on every reservationArchive propertyArchive a property
Delete Booking blocked on OTA importPending provider platform in-paymentReject or assign first (#2076) — Delete Booking on integration reservation

Three different controls retire inventory at different scopes. Use this table before you pick Archive, Cancel booking, or Delete Booking:

ActionScopeWhen to useVisibility after actionFinance → Transactions
Archive propertyWhole buildingPortfolio sunsetting; building leaves active pickersListings → Archived tab; hidden from default property pickersAll booking history and payment rows stay visible
Cancel bookingOne reservationReal stay voided under cancellation policyCanceled filter / statusAll payment types stay visible
Delete BookingOne reservationMistaken import, training row, duplicate createDrops from default Bookings lists (soft-archive)vIBAN / credit card stay; manual / provider platform hidden (#1897)

Archive property does not remove bookings — step-by-step: How do I archive a property?. For reservation-level voids vs cleanup, see Cancel Booking vs Delete Booking (bookings-cancel-booking-modal-refund-types.png, bookings-list-canceled-tab.png, workflows-cancel-booking-refund-modal-flow.mp4). After Delete Booking, manual / provider platform rows may disappear from Finance → Transactions while vIBAN / credit card stay — FAQ — Manual payments after Delete Booking (finance-transactions-type-summary-cards.png, #1897). Clear provider platform in-payment before Delete Booking on integration reservations (#2076) — bookings-detail-delete-booking-provider-platform-error-toast.png.

Listings Archived tab — populated table with archived properties and Unarchive actions

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

Hub matrix: Common Workflows — Portfolio retirement decisions · Glossary — Portfolio retirement decisions hub. Per-guide mesh: Portfolio KPI review — Portfolio retirement decisions, Manual block hygiene — Portfolio retirement decisions, Cancelling a Booking — Portfolio retirement decisions, Managing a Check-out — Portfolio retirement decisions, Onboarding a New Property — Portfolio retirement decisions, Processing a New Booking — Portfolio retirement decisions, Entering Monthly Utility Bills — Portfolio retirement decisions, Handling a Late Payment — Portfolio retirement decisions, Managing a Check-in — Portfolio retirement decisions, Notification triage — Portfolio retirement decisions, Resetting a Management User Password — Portfolio retirement decisions, Using in-app support — Portfolio retirement decisions. Reservation-level pairing: Common Workflows — Cancel Booking vs Delete Booking and Cancel Booking vs Delete Booking (bookings-cancel-booking-modal-refund-types.png, bookings-list-canceled-tab.png, workflows-cancel-booking-refund-modal-flow.mp4). Ledger visibility after Delete Booking: Manual payments after Delete Booking (finance-transactions-type-summary-cards.png). Month-end sign-off: Portfolio KPI review — Step 7.

How do I archive a property (or bring one back)?

Open the property in the Edit property sidebar on the Portfolio tab, scroll to the danger zone at the bottom, and choose Archive (the app confirms first; active bookings may trigger an extra warning). Archived properties move to the Archived tab at /listings/archived and disappear from default portfolio pickers until you Unarchive from that tab’s property sidebar. Archiving does not delete bookings or financial history. Legacy /properties/archived URLs redirect to the same tab. Archive property is building-level — do not confuse it with Delete Booking (reservation soft-archive) or Cancel booking (policy void with settlement). Hub matrix: Common Workflows — Archive property (building-level) · Glossary — Archive property (building-level) hub. See Listings — Archived properties, Glossary — Archived property, and the three-way table Portfolio retirement decisions.

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

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

Per-guide mesh: Manual block hygiene — Archive property (building-level), Onboarding a New Property — Archive property (building-level), Processing a New Booking — Archive property (building-level), Entering Monthly Utility Bills — Archive property (building-level), Managing a Check-in — Archive property (building-level), Managing a Check-out — Archive property (building-level), Handling a Late Payment — Archive property (building-level), Cancelling a Booking — Archive property (building-level), Portfolio KPI review — Archive property (building-level), Notification triage — Archive property (building-level), Resetting a Management User Password — Archive property (building-level), Using in-app support — Archive property (building-level).

Operations

Pair with other FAQ sections

Ticket and turnover answers pair with Bookings (Timeline / Multicalendar overlap), Properties & Listings (maintenance automation on property), and Payments & Finance (deposit settlement on check-out). Full pairing matrix: FAQ section cross-reference.

How do I handle same-day turnovers?

When a check-out and check-in fall on the same calendar day for the same unit, plan cleaning, inspection, key handover, and deposit timing together — see Glossary — Same-day turnover.

  1. Operations → Check-in & Check-out — Use Next 7 days (or Custom), switch Check-outs and Check-ins on the same unit (paste the unit internal name in Search so unit hits rank first). Step-by-step: Managing a Check-out and Managing a Check-in.
  2. Operations → Tickets — Create or verify a turnover ticket with a due date before the incoming arrival; far-future schedule dates may show Draft until the date nears (Glossary — Draft ticket (display status)).
  3. Visual overlap — On one unit row, open Bookings → Timeline (/bookings/timeline) or Sales → Multicalendar (/sales/multicalendar), paste the unit in toolbar Search, and use Week or Month scale to see departure and arrival bars together (bookings-timeline-day-week-month-and-sidebar.mp4, sales-multicalendar-timeline-booking-click.mp4).
  4. Times and access — Confirm default check-in / check-out times in Settings → General Information and Access Lockers on the property before handover (Managing a Check-in — Step 4).

Hub matrix: Common Workflows — Same-day turnover coordination. Per-guide mesh: Managing a Check-in — Same-day turnover coordination, Managing a Check-out — Same-day turnover coordination, Processing a New Booking — Same-day turnover coordination, Onboarding a New Property — Same-day turnover coordination, Cancelling a Booking — Same-day turnover coordination, Entering Monthly Utility Bills — Same-day turnover coordination, Manual block hygiene — Same-day turnover coordination, Notification triage — Same-day turnover coordination, Portfolio KPI review — Same-day turnover coordination, Resetting a Management User Password — Same-day turnover coordination, Using in-app support — Same-day turnover coordination, Handling a Late Payment — Same-day turnover coordination.

Why aren't automatic tickets being created for check-ins? Automatic ticket creation must be configured per property in Maintenances tab in the property editor (Listings). Verify the required fields and that the check-in automation toggle is enabled. If you opted out on Add booking for a one-off stay, see Can I skip automatic check-in/out tickets for one booking? (#1140).

Can I skip automatic check-in/out tickets for one booking?

Yes — on Add booking, after you select property and unit, turn off Use unit contract rents and other contract details on the rent step. When the property has check-in or check-out auto-create on Maintenances tab, Vivin shows Create check-in ticket and/or Create check-out ticket (#1140). Both default on (same as the property). Uncheck the events you want to skip for this reservation only — the property rule stays unchanged for future bookings. See Glossary — Per-booking maintenance ticket opt-out and Bookings — Creating a New Booking (bookings-add-booking-maintenance-ticket-opt-out.png).

How do I find a ticket by its ID?

On Operations → Tickets, paste the full sequential ticket ID shown on the row (for example S259, T27) into the toolbar Search box — added in #2074. Use the prefix letter plus number when email or support references #S259; partial numeric-only queries can match unrelated rows. For property-level tickets (common-area work with no unit suffix on the row), search the building internal name or combine with an active Property filter chip. When the Vivin team cites a maintenance ticket ID in Using in-app support, use the same Search habit on Operations → Tickets — not the Vivin support inbox. See Operations — Tickets toolbar search and Glossary — Directory search ranking.

Where is the Operations Schedule timeline? The Schedule tab (/operations/schedule) is a Vivin internal-only Gantt-style view of maintenance tickets by property. Customer property managers do not see it in the tab strip; opening the URL redirects to Operations overview. On desktop, use Today and the Day / Week zoom pills to scan ticket bars; click a bar to open Ticket details. The tab is not on the Operations bottom bar on phones — bookmark /operations/schedule or use a wider screen. See Operations — Schedule tab and Glossary — Schedule (Operations).

Why do I see “Booking.com Reservation” (or Airbnb) on Check-in & Check-out without a tenant booking? Short-term platforms sync through iCal calendar blocks, not full API booking imports. Those blocks appear as pseudo arrival or departure rows on Operations > Check-in & Check-out — often labelled with the platform name instead of a tenant. They block dates on your calendar but do not create a mid-term booking with payment plan, contract, or tenant portal access. Use Filters → Stay type → Mid-term when you only want long-stay handovers; use Short-term when reconciling channel turnover with Sales > Multicalendar. For contract and collections work, add a manual booking — see Processing a New Booking. See Glossary — Short-term iCal pseudo check-in/out.

Management Account Access

Pair with other FAQ sections

Sign-in and session answers pair with Common Workflows — Lockout catch-up after password recovery (post-recovery backlog mesh), Help & Vivin support (when locked out vs product help), and Platform subscription (Vivin billing) (checkout after sign-in). Team invites during setup: Getting Started — Recommended Setup Sequence step 3 (Users) and Accessing the Platform. Full pairing matrix: FAQ section cross-reference.

I forgot my management account password. How do I recover access? On the login page, click Reset your password, enter your account email, then use the link sent to your inbox to open the tokenized reset page and set a new password. Follow the full workflow: Resetting a Management User Password. After Step 3, catch up operational backlog per Getting Started — Lockout catch-up after password recovery and Common Workflows — Lockout catch-up after password recovery (notification triage, month-end Pending receipt mesh, portal gates). If you are signed in but need product help instead, see Help & Vivin support below.

Symptom after password resetFix
Unread /notifications alertsNotification triage — Step 4
Pending receipts inflated debtCommon Workflows — Pending manual receipt approval
Landlord MCP / AI Chat 403Refresh JWT — Landlord MCP — How it connects
Setup still blocked mid-wizardRerun Onboarding — Step 7 after catch-up

Management sign-in — password reset entry point

The reset link says invalid or expired. What should I do? Request a new link at platform.vivin.app/reset-password, then complete the flow using the newest email link. See Troubleshooting: invalid or expired link/token.

The reset form says my email format is invalid. Enter a full address with @ and a domain (for example [email protected]). The request step validates format in the browser before sending — see Step 1.

Why was I signed out with “Your session expired”? The management app refreshes your access token automatically in the background. That message appears only when refresh can no longer continue — for example after Logout, a long idle period past the refresh lifetime, or revoked credentials. Sign in again with your email and password. On shared devices, use Logout when you finish. See Getting Started — Staying signed in and logging out and Glossary — Management session.

Platform subscription (Vivin billing)

Pair with other FAQ sections

Workspace billing answers pair with Management Account Access (sign-in before checkout) and Help & Vivin support (billing escalations). Full pairing matrix: FAQ section cross-reference.

Why does Subscription show “Action Required” and ask me to add a card? Your workspace is not fully subscribed yet. Open Account Settings → Account → Subscription at /settings/subscription, expand Add card, and complete the hosted checkout (on mobile, use Open checkout in a new tab). Do not close the page until checkout succeeds. Some accounts also see the same checkout modal shortly after sign-in on desktop. See Subscription — Hosted checkout when action is required.

Help & Vivin support

Pair with other FAQ sections

In-app ticket UX pairs with Management Account Access (password recovery before tickets), Directory list load failures hub (symptom table for whole-module Retry / Try againnotifications-module-load-failure.png, audit-manual-blocks-load-failure.png), and Navigation & shortcuts (export and directory load-failure patterns). When a setup tab or wizard step still blocks progress after self-serve docs, confirm the matching Getting Started — Recommended Setup Sequence step and Account Settings — Recommended setup order row before you file a ticket — choose module Settings or Listings on the ticket. Full pairing matrix: FAQ section cross-reference.

When should I email support versus opening a ticket in the app? Use Get Help & Support (email to Vivin and the status page) for account-wide questions, billing or subscription changes, or when you do not need the conversation tied to a specific screen inside Vivin. Use in-app support when your role has the Support permission and you want a structured ticket thread, attachments (including videos up to 100 MB per file with inline playback in the thread), and history under Account Settings > Support (or the floating Help & Support control on desktop).

Why don't I see the floating Help & Support button or Support under Account Settings? The in-app experience is permission-gated. Only users whose role includes Support see the floating button and the Support area; administrators assign that capability in Users and roles (Support is only assignable to Administrator and Super administrator roles in the matrix). If you open a Support URL directly without permission, you see a standard access message.

Where do I open the full support ticket inbox? Sign in and go to platform.vivin.app/settings/support, or use Account / Settings in the sidebar and choose Support. Per-ticket URLs use /settings/support/:ticketId. See Using in-app support for filters, search, sort, scroll-to-load behaviour, New Ticket, and status labels.

Can I edit a Vivin support ticket after I submit it? On open tickets, use the ticket sidebar to fix the subject (pencil beside the title), change the module chip, or Edit the text of your own replies before Vivin posts a later message. You cannot change priority from the landlord inbox, edit Vivin’s messages, or edit messages on Closed tickets. See Editing open tickets.

How do search and sort work in the drawer versus the full inbox? Both surfaces share the same status and Opened by filters, the same sort options (Last updated, Creation date, Due date, Priority), and the same server-side search and sort (debounced search on subject, ticket number, and message text). Each loads tickets in batches of 20 and fetches the next batch when you scroll near the bottom. The full page shows Showing X of Y and End of list when every matching row is loaded; the drawer uses the same loading pattern in its scroll panel. Status tab counts come from a dedicated count API so badges stay accurate before you scroll through every ticket. Use the full inbox when you want the table layout and new ticket assignee default card. Changing search, sort, or filters reloads from the first batch on both surfaces.

What is the drawer Status multi-select (beside Active / Closed)? On desktop, the Help & Support drawer (#1861, #2085) pairs Active and Closed view chips with a Status multi-select and Sort by pills on the filter row. Status narrows active workflow states — tick any combination of Open, Pending, Awaiting your reply, Ongoing analysis, or Backlog (leave all unticked for All statuses; Closed is only on the chip). Chip and Status compose together: Active + Status → [Pending] focuses on Vivin-pending rows while Closed tickets can still appear in the list until you switch to the Closed chip; Closed ignores Status. The full /settings/support inbox still uses All / Open / Closed chips only. See Using in-app support — Help & Support drawer and Ticket status labels.

Is “New Ticket” under + Create New how I contact Vivin? No. + Create New > Operations > New Ticket opens an internal operations ticket for work on your properties (maintenance, cleaning, inspections, tenant requests). Vivin support threads are filed from Help & Support, Account Settings > Support, or /settings/support when your role has the Support permission. See Create New Menu and Using in-app support.

I clicked Export but no file downloaded — what happened? Large directory Export actions assemble the full filtered result set server-side. When the request fails (timeout, network drop, or HTTP error), Vivin shows feedback instead of failing silently: Bookings shows a red alert under the toolbar; Tenants, Listings, Sales, and Audit show a toast. An empty filtered list produces no file by design — that is not an error. See Glossary — Export and download failures.

A list page shows “Failed to load …” instead of my data — what should I do?

That message means the first fetch for the directory failed (network, timeout, or server error) — not that your portfolio is empty. Use Retry / Try again on the alert, or refresh the page after connectivity recovers. A successful fetch that returns zero rows for your filters is the normal empty state — not this error.

ScopeExample surfacesRecovery
Bookings Timeline/bookings/timeline Gantt chartCentered error panel — Couldn't load the timeline bookings. + Retry (re-fetches axis and bars)
Whole directoryBookings list, Tenants, Listings, Sales, Operations tabs, /notificationsInline alert card or red panel + Retry / Try again
Dashboard aggregatePost-login / KPI stripBanner — Some dashboard data failed to load. + Retry (other widgets may still render)
Booking sidebar tabCommunication, Tickets on one reservationTab-scoped Refresh / RetryFAQ — Communication or Tickets load failure

Notifications module — initial load failure with Try again control

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

Bookings Timeline — axis/bars load failure panel with Retry (#2310)

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

Analytics — portfolio KPI workspace load failure with Try again

Hub matrix: Common Workflows — Directory list load failures · Directory list load failures hub. Per-guide mesh: Manual block hygiene — Directory list load failures, Cancelling a Booking — Directory list load failures, Managing a Check-out — Directory list load failures, Onboarding a New Property — Directory list load failures, Processing a New Booking — Directory list load failures, Entering Monthly Utility Bills — Directory list load failures, Handling a Late Payment — Directory list load failures, Managing a Check-in — Directory list load failures, Notification triage — Directory list load failures, Resetting a Management User Password — Directory list load failures, Using in-app support — Directory list load failures, Portfolio KPI review — Directory list load failures.

Common surfaces: Bookings list and Bookings Timeline (/bookings/timelineCouldn't load the timeline bookings. + Retry, distinct from the list card), Tenants, Listings, Sales (whole module — distinct from Sales Overview day/bar popovers that show Failed to load free units while charts still work), Operations (Tickets / Cash Flows), Notifications, Audit (Manual Blocks), Analytics (We couldn't load your portfolio KPIs + Try again), Utilities (each tab — Cost map has no Retry; refresh the page), Support, and the Dashboard banner when aggregate KPI data fails. Inside a booking sidebar, Communication and Tickets tabs can fail independently — use Refresh or Retry on that tab without leaving the reservation. Account Settings tabs such as Emails → Communication Rules, Services → Requests, Integrations → Other providers (silent empty list — refresh the tab), and Invoicing → Tax codes (amber Retry while editing) use tab-scoped patterns. See Glossary — Directory list load failures, Glossary — Settings and profile load failures, and Glossary — Booking detail sidebar tab load failures.

Mark all as read did nothing — did it work? On /notifications and the Dashboard bell, a successful Mark all as read shows a success toast (All notifications marked as read.). If the API fails, you get an error toast and unread badges stay — retry after connectivity improves. See Glossary — Notification read actions.

Tenant Portal & Mobile App

Pair with other FAQ sections

Portal access and payment answers pair with Settings & tenant communications (mandatory fields, lifecycle emails), Why can't a tenant sign the contract in the portal? (PDF + Your Details gates), and Payments & Finance (operator-side receipts). Full pairing matrix: FAQ section cross-reference.

How do tenants access the Tenant Portal? The web Tenant Portal opens with an email form where tenants click Send access link. If a matching booking is found, Vivin emails a secure portal link. Direct links that include Booking ID (id) + Access Code (code, when configured) are also supported in onboarding/check-in communications. The portal does not use email/password login. See Tenant Portal.

Why can't a tenant make a payment online? Tenant online payments require your account payment module to be active (Vivin provisioning for pay-in flows — contact support if payments never appear for tenants) and the per-property Property Payments Active toggle in the Listings property editor — Payments tab. Both must be enabled for that property. These controls are not a single switch under Preferences; that page covers portal edit permissions and operational defaults instead.

Why is the Tenant Portal credit-card checkout blank or stuck on “Initializing payment…”? Card pay-in runs on Make payment (/paywall): Vivin creates a checkout session, then embeds the provider form in an iframe on the same page. A blank frame usually means the browser blocked embedding (privacy extension, strict tracking protection) or the session failed before a URL was returned — the portal shows a red error with Try again when create-checkout fails. Confirm the booking has an amount selected, Property Payments Active is on, and the tenant retries on desktop without frame-blocking extensions. Operators still see successful card in-payments on Finance → Transactions after webhook completion. See Tenant Portal — Make payment (Paywall) and Credit card (embedded checkout).

Can tenants attach photos to maintenance requests? Yes — the Help tab accepts text and file attachments. When the ticket is created but uploads fail (network or storage error), the portal shows an amber Request submitted without attachments banner: the Operations ticket still exists, but photos did not save. Tenants should retry or contact support. See Tenant Portal — Maintenance errors.

Why don't tenants see entry codes on portal Home?

The portal Home Entry codes card is gated separately from the check-in email (#2166). Tenants see the card only when all of the following are true:

CheckWhat to verify
Preferences toggleAllow to see entry codes is On under Settings → Preferences → Tenant Portal.
Check-in email sentLast sent on Contract Info → Check-in & Check-out shows a check-in email — or use Send Check-in email when triggers are met.
During the stayCurrent time is before checkout date + time. After checkout, the card hides even if codes were visible earlier.
Not canceledCanceled reservations do not show entry codes on Home.
Codes configuredBuilding, property, or unit codes exist on Listings → Access Lockers.

When tenants received access codes in check-in mail but Home has no card, the account toggle is usually Off or the check-in email has not sent yet — not missing Access Lockers data. Disabling Allow to see entry codes hides only the portal card; it does not remove codes from the check-in email body.

Why can't a tenant sign the contract in the portal?

Pair with other FAQ subsections

Common causes:

  • No contract PDF yet — Vivin must generate a contract for the booking before Sign contract appears on portal Home or Contract. Confirm Contract Info in management shows a generated file (or regenerate from your contract template workflow). Without a PDF, the portal shows a contact-you message instead of opening the wizard — see Processing a New Booking — Step 4.
  • Mandatory fields empty — Each toggle under Preferences — Mandatory for contract signing blocks the wizard Your Details step until the matching field is filled. Asterisk labels in the portal mirror those toggles. Enforcement runs in the portal UI and server-side on sign.
  • Category or preference locksTenant categories and portal permission toggles can make a field read-only; the tenant cannot complete a gate you require but disabled for their segment.
  • Lease purpose — When Lease purpose is required on the account, the tenant must pick an allowed value on the Review step before Sign unlocks — see Bookings — Lease purpose.

Operator checklist: (1) PDF on Contract Info, (2) mandatory toggles in Preferences, (3) tenant category allows editing required fields, (4) Lease purpose when required. Illustrated account toggles:

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

See Tenant Portal — Digital contract signing for the full wizard (Your Details → Billing → Review → Sign). Portal signing satisfies lifecycle After contract signed triggers; paper uploads on Contract Info do not — see Why didn't the automatic check-in email send?.

Why is my tenant not receiving emails? Check the email template triggers in Settings > Emails. Verify the trigger conditions (e.g., "After paid & contract signed" vs. "Immediately after booking creation") and ensure the tenant's email address is correct in the booking. For lifecycle templates (onboarding, check-in, check-out), also confirm the booking still meets the trigger on the Booking lifecycle emails sub-tab — see the next question for check-in specifics.

Why didn't the automatic check-in email send?

Lifecycle check-in mail fires only when your Booking lifecycle emails — check-in trigger matches and Vivin has not already sent one check-in email for that booking (checkInEmailSentAt). Common blockers:

  • Trigger not met — For example After paid & contract signed requires move-in requirements paid and a portal digital signature (signedContractPath); After paid alone waits on move-in payments only. When the trigger needs signing but tenants stall on Sign contract, start with FAQ — Tenant contract signing blocked (PDF on Contract Info, mandatory Your Details gates, category locks).
  • Paper contract uploaded — Uploading a signed PDF on Contract Info marks the booking contract-signed for reporting but does not set signedContractPath or re-run lifecycle evaluation — see Emails — Operator upload vs portal signing. Use Send Check-in email on Contract Info → Check-in & Check-out after upload when move-in requirements are met.
  • 15-day cutoff — Automatic send is skipped when check-in day is more than 15 days in the past (canceled bookings are skipped entirely).
  • Nuki-only toggle — With Only for Nuki access on, send waits until Nuki access points exist on the property or unit.
  • Already sent — Check Last sent on Resend Check-in email on Contract Info; use Resend if you need another copy.

On Contract Info → Check-in & Check-out, Send Check-in email / Resend Check-in email and Last sent are the operator controls when automation did not fire — distinct from Communication Rules (payment reminders, custom schedules on the Communication Rules sub-tab). Only a portal digital signature satisfies lifecycle After contract signed triggers; paper upload on Contract Info does not — pair Tenant Portal — Digital contract signing with FAQ — Tenant contract signing blocked when tenants never reach the Sign step.

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

See Managing a Check-in, Glossary — Lifecycle check-in email, Processing a New Booking — Step 4 (generate PDF before portal signing), and Bookings — Check-in & Check-out emails.

Can tenants submit maintenance requests through the portal? Yes. Tenants can submit maintenance requests directly from the Tenant Portal, including photo attachments. These requests automatically create tickets in the Operations module for your team to manage. If the Request history list cannot load, tenants see Couldn’t load your requests with Try again — not the No requests yet empty state. See Tenant Portal — Errors, timeouts, and recovery.

Is the tenant portal branded with my company? Yes. The Tenant Portal is fully white-labelled with your brand colours, logo, and company name. Tenants see your identity, not Vivin's. Configure branding in Settings > General Information.

Integrations & Distribution

Pair with other FAQ sections

Channel sync and iCal answers pair with Properties & Listings (Channels tab linking), Bookings (import vs manual booking), and Operations (pseudo check-in/out rows). Full pairing matrix: FAQ section cross-reference.

Why aren't bookings syncing from Airbnb/Booking.com? Verify your API key or integration email is correct in Settings > Integrations. Then ensure each unit is linked to its corresponding external listing ID in the unit's Channels tab. See Integrations Troubleshooting for more issues.

Does Airbnb or Booking.com iCal sync create a full Vivin booking with payment plan? No. Airbnb and Booking.com use two-way iCal from Sales > Channels (and per-unit Channels in Listings): Vivin exports outbound availability and imports platform calendar blocks to prevent double bookings. Imported short-stay blocks surface on Operations > Check-in & Check-out and unit calendars as pseudo check-in/out rows — they do not automatically create mid-term booking records, payment schedules, or tenant profiles. For contract and collections work on a channel stay, create or import a proper booking. Mid-term marketplaces (HousingAnywhere, Uniplaces, and similar) use API imports that do create full booking records. See Glossary — Short-term iCal pseudo check-in/out and API Reference — iCal feeds — Inbound platform calendars.

Why does Airbnb or Booking.com stop showing availability after a certain date (or show everything as blocked beyond my horizon)? Short-term platforms read Vivin’s iCal feeds. The Short-term iCal Max Date is an account-wide safety horizon: nights after that date are exported to the feed as blocked, so external sites do not advertise open inventory past the cutoff you configured. If the date is too soon, calendars look “cut off”; if it is too far, you may be exposing more forward availability than you intended. Adjust the date under Account Settings > Integrations and use Apply to all listings or Apply to selected listings (Airbnb) so unit overrides stay aligned. See also Glossary — Short-term iCal Max Date.

Which marketplaces does Vivin integrate with? Vivin has full API integration with HousingAnywhere, Spotahome, Uniplaces, Inlife, Spacest, and more. Airbnb and Booking.com are supported via iCal calendar sync. See Integrations & Distribution.

What is the white label booking engine? It's a fully branded booking interface you embed on your website for commission-free direct bookings. It shows real-time availability, supports visit scheduling and video calls, and includes conversion tracking. See White Label Booking Engine.

Where do I configure property and listing details for the booking engine? From Listings, open a property or unit sidebar and choose the Full integration pill to edit booking-engine fields (descriptions, amenities, rules, multilingual content). Use Photos for gallery-only work. Those details power the white-label booking engine and marketplace integrations. See Property & listing details (booking engine).

Do I need to update each channel separately when blocking dates? No. When you block dates in Vivin (whether manually, through a booking, or via any channel), all connected platforms are updated automatically. See How Calendar Synchronisation Works.

How do I set up Hostkit for Portuguese Fatura-Recibo invoicing?

  1. Open Account Settings → Integrations and add Hostkit under Other providers (no API key on the add dialog — keys are per listing).
  2. On the Hostkit card, open Listing keys, search for each unit if needed, paste the property API key from Hostkit, and Save per row (the modal loads about 20 listings per scroll chunk).
  3. Set Hostkit invoice series on Account Settings → Invoicing to match Hostkit Faturação → Séries (Vivin always requests document type FR).
  4. After chargeable payments are invoiced, use see invoice on Finance → Transactions allocation rows or Invoice_ PDF tiles on the booking Files tab. See Finance — Hostkit invoice links and Glossary — Hostkit. Only one invoicing provider (Hostkit or Invoice-xpress) can be active per account.

Hostkit invoice links or PDFs look wrong — what should I check? Confirm Hostkit invoice series on Account Settings → Invoicing matches the FR series you issue from in Hostkit Faturação → Séries. Hostkit reuses numeric sequence ids across series; Vivin tracks each document as {series}/{id} and fetches PDFs from Hostkit’s permalink for that pair. A series typo can cause invalid series errors on create or mismatched see invoice / Files attachments until Settings match your live Hostkit series. See Finance — Hostkit invoice links.

Why does Hostkit invoicing fail with “invoice series is not configured”? The Hostkit invoice series field on Account Settings → Invoicing is required before Vivin calls Hostkit to create a document — an empty or whitespace-only value is rejected in-product so invoices are not silently issued into Hostkit’s default series. Paste the exact FR series code from Hostkit Faturação → Séries, Save, then retry Issue allocation or Invoice selected on Finance → Transactions.

The tenant did not receive a final invoice receipt email — was invoicing skipped? Not necessarily. Issue allocation / Invoice selected persists the PDF on the booking and updates allocation Invoiced state before Vivin attempts the optional receipt email controlled on Preferences → Final invoices (receipts). Check Bookings → Files or Finance → Transactions first — when the document is there, invoicing succeeded and only delivery may have failed (tenant email missing, toggles off, or spam). Outbound mail failure does not roll back invoiced state; do not re-issue solely because the mailbox is empty. See Finance — Tenant invoice receipt email.

AI & Automation

Pair with other FAQ sections

Chatbot and MCP answers pair with Settings & tenant communications (ChatBot settings under Account Settings), Bookings (Communication tab, Bot reasoning), Where do I read WhatsApp and email for one booking? (Communication vs global Inbox), WhatsApp per-booking messaging hub (symptom table for Inbox vs Bookings → Communicationinbox-module-triage-flow.mp4), Common Workflows — WhatsApp per-booking messaging, and How do I see AI token usage for my account? (internal LLM cost ledger — no management UI screen). Full pairing matrix: FAQ section cross-reference.

What can the AI chatbot do? The chatbot provides 24/7 tenant support via WhatsApp and email (there is no tenant chat surface inside the Tenant Portal). It handles enquiries about payment status, contracts, maintenance, and move-in information. Complex issues are automatically escalated to your team. See Automation & AI.

Where can I ask the AI questions about my own portfolio? Use the AI Chat module (Tools > AI Assistant in the sidebar, or /ai-chat) to ask questions about occupancy, revenue, move-ins, and coliving overview. The VIVIN AI Assistant answers using your real data. Access is Vivin internal accounts only — other roles do not see this menu entry. WhatsApp Genius (staff phones linked on Users) shares the same Landlord MCP tools. Money answers use Finance-page figures (get-finance-overview, get-revenue-summary) — compare against Finance → Overview, not Analytics ADR/RevPAR (FAQ — Genius revenue vs Analytics). See AI Chat Module, Automation & AI — WhatsApp Genius, and bookmarkable routes under Management deep links.

Why don't I see Tools > AI Assistant (or /ai-chat)? The in-product AI Assistant for operators is available only to Vivin internal management accounts. Customer property managers, admins, and viewers use the rest of the platform without this entry point; opening /ai-chat directly shows a standard permission message. Tenant-facing automated support remains on WhatsApp and email, not inside the Tenant Portal. See AI Chat.

What is the difference between Landlord MCP and Tenant MCP? Both are Model Context Protocol servers in the VIVIN stack that call the same Core API as the management app, but they target different automation scopes. Landlord MCP is account-scoped — portfolio intelligence, listings, bookings, owners, payments, and related operator tools for integrations that act like a signed-in property manager. Tenant MCP is booking- and tenant-context scoped — tools for tenant-facing assistants (portal links, payment and contract context, chatbot rules, maintenance) when the conversation is about a specific reservation. Choose Landlord MCP for operator workflows; choose Tenant MCP when the client already knows which tenant or booking it is serving.

Integration Swagger UI — listings operations expanded with Try it out

Partner channels that push booking events into Vivin (Housing Anywhere, Uniplaces) use inbound POST …/webhook routes on the Core API host — documented in Webhooks & Notifications with Integration Swagger captures, not via MCP tool names alone.

How does the AI invoice reader work? Upload a utility bill and the AI automatically detects the utility type, identifies the correct property, and extracts the amount, consumption, and billing dates. See Utilities > AI Invoice Reader.

How do I see AI token usage for my account?

Pair with other FAQ subsections

Token metering pairs with Glossary — AI usage ledger, AI usage API (GET /ai-usage, GET /ai-usage/summary), Portfolio KPI review — Step 7, and Automation & AI (assistant vs utility-bill features). Full pairing matrix: FAQ subsection cross-reference.

Vivin records each LLM call in an append-only ai_usage ledger (token counts and Vivin’s internal USD provider cost). There is no management-frontend screen for this today — operators with account_settings.module poll the Core API with a management JWT:

  • GET /ai-usage — paginated call log (newest first), with optional feature, from, and to filters
  • GET /ai-usage/summary — month-scoped aggregates by feature and model

landlord_chat covers AI Chat assistant turns; utility_bill_extraction covers Utilities — AI Invoice Reader PDF reads. Costs are internal metering — not tenant-facing invoices. Month-end review habit: Portfolio KPI review — Step 7. Full contract: AI usage API and Glossary — AI usage ledger.

Does Vivin change my prices automatically? No. Rent is under your control: set and bulk-edit monthly amounts in Sales > Pricing. Integrations propagate the availability and rates you configure; they do not replace your pricing decisions.

What kind of automation can I set up? Vivin supports automated booking-to-contract pipelines, payment reminders, invoice generation, check-in/check-out ticket creation, and bulk operations. Most automations are configured through Settings or property-level configuration. See Automation & AI.

Does the WhatsApp bot create tickets automatically? Yes. When the bot identifies a new issue that requires action, it automatically creates a ticket in the Operations module with the tenant's message, booking context, and any relevant history. If an existing ticket already covers the topic, the bot responds with that context instead of creating a duplicate. See Automatic Ticket Creation.

Will the WhatsApp bot respond to suppliers or contractors? If your WhatsApp business number is used for both tenant and supplier communications, the bot may respond to non-tenant messages. Consider using a dedicated number for tenant support to avoid this. See WhatsApp Support.

How do I audit why the WhatsApp bot sent a particular reply? On Bookings → booking detail → Communication, select the WhatsApp filter and find a mint Bot bubble (outbound message sent by the tenant chatbot). When Vivin stored internal reasoning for that automated reply, a compact Reasoning control appears under the message body — click it to expand the explanation the bot used before sending (italic text in parentheses). Only Bot messages include this toggle; tenant and human You bubbles do not. Use it to verify IF/THEN rules and persona behaviour without server logs. Hub parity: Bot reasoning (audit) hub · Common Workflows — Bot reasoning (audit). See Bookings — Communication tab (Bot reasoning) and Glossary — Bot reasoning (audit).

Bot reasoning (audit)

Pair with other FAQ subsections

Bot audit pairs with ChatBot settings hub (edit Persona / IF/THEN after thread review), FAQ — WhatsApp per-booking messaging hub, and AI & Automation. Full pairing matrix: FAQ subsection cross-reference.

SymptomLikely causeFix
Bot gave a generic or wrong answerBroad IF/THEN If phraseExpand Reasoning → narrow rule at ChatBot settings
No Reasoning under Bot bubbleReasoning not stored for that sendNot a UI bug — adjust rules from message content; see ChatBot settings hub
Need to change tone for all channelsPersona missing or vagueChatBot — Persona — then verify on live thread
Bot still auto-replies on one bookingPause bot not toggledCommunication → WhatsApp when pause label is configured

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

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

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

ChatBot settings

Pair with other FAQ subsections

ChatBot configuration pairs with Bot reasoning (audit) hub (thread audit after rule edits), FAQ — WhatsApp per-booking messaging hub, and AI & Automation. Full pairing matrix: FAQ subsection cross-reference.

SymptomLikely causeFix
Inbox greyed in sidebarChatbot not enabled or not pairedBot Status until Connected
Unlock your communication historyisTenantChatBotEnabled falseContact Vivin; then pair Bot Status
Bot replies on almost every messageCatch-all IF/THEN ruleReplace with specific If situations — IF/THEN rules
Cannot edit rules (read-only card)Super Admin–managed accountWho can edit ChatBot settings
WhatsApp composer missingOutbound not provisionedWhatsApp replies aren't available yet notice on Communication
QR expired before scanSession timed out on phoneRefresh QR code on Bot Status

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

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

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

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

Walkthrough: Bot Status → Connect WhatsApp, confirm after the warning countdown, then scan the QR until Connected.

Where do I read WhatsApp and email for one booking?

When the tenant chatbot is enabled on your account, open the booking from Bookings and select the Communication tab in the detail sidebar. Use the WhatsApp pill for chat bubbles (tenant, Bot, and You), Labels, Pause bot (when configured), and the bottom composer to send replies from the management UI; use Email for read-only inbox-style rows you can expand (attachments preview/download when ingested). Traffic matches the tenant’s phone or email on the booking. Use Refresh in the sidebar header to reload after new traffic.

SurfaceBest forReply from Vivin?
Bookings → CommunicationOne reservation with Payment Plan, Tickets, and Files contextWhatsApp yes (composer); Email read-only
Inbox (/inbox) or bell Inbox sub-tabCross-booking triage, unknown numbers, alert-driven entryWhatsApp yes; same UAZAPI state as Communication
Dashboard bell → GeneralPayment/ticket/booking alerts — not message threadsN/A — switch to Inbox for WhatsApp pings
/notifications row New WhatsApp message from …Mixed alert inbox — message ping among payment rowsRow with link opens thread; bookingId only → open CommunicationNotification row-click navigation

If you see Unlock your communication history, the chatbot integration is not active for the workspace yet — pair with ChatBot settings and Inbox — Chatbot gating. If Communication shows Could not load messages, use header Refresh — other booking tabs stay available (FAQ — Communication or Tickets load failure).

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

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

Short walkthrough: open Inbox from the sidebar, pick a conversation, reply, and jump to the booking Communication tab when you need reservation context.

Hub matrix: Common Workflows — WhatsApp per-booking messaging · WhatsApp per-booking messaging hub. Per-guide mesh: Processing a New Booking — WhatsApp per-booking messaging, Handling a Late Payment — WhatsApp per-booking messaging, Cancelling a Booking — WhatsApp per-booking messaging, Managing a Check-in — WhatsApp per-booking messaging, Portfolio KPI review — WhatsApp per-booking messaging, Managing a Check-out — WhatsApp per-booking messaging, Entering Monthly Utility Bills — WhatsApp per-booking messaging, Notification triage — WhatsApp per-booking messaging, Manual block hygiene — WhatsApp per-booking messaging, Onboarding a New Property — WhatsApp per-booking messaging, Using in-app support — WhatsApp per-booking messaging, Resetting a Management User Password — WhatsApp per-booking messaging. Pair Common Workflows — Notification row-click navigation when message alerts arrive on /notifications instead of bell Inbox (inbox-module-overview.png, notifications-module-row-click-target.png).

See Bookings — Communication tab (bookings-detail-communication-tab-whatsapp-composer.png, bookings-detail-communication-tab-email-inbox.png) and Inbox — Relationship to Bookings Communication.

How do I see why the bot sent a particular WhatsApp reply? On Bookings → Communication → WhatsApp, automated Bot bubbles can include a Reasoning control under the message when Vivin stored audit text with that reply. Click Reasoning to expand the internal explanation (italic text in parentheses). Tenant messages and human You replies do not show this control. Persona and IF/THEN rules are edited under Account Settings → ChatBot; reasoning is read-only on the thread. Hub parity: Bot reasoning (audit) hub · ChatBot settings hub. See Bookings — Bot reasoning and Glossary — Bot reasoning (audit).

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

Services Marketplace

Pair with other FAQ sections

Tenant add-on answers pair with Tenant Portal & Mobile App (catalogue preview) and Payments & Finance (charges on payment plan). Full pairing matrix: FAQ section cross-reference.

What services can I offer to tenants? You can offer any service through a customisable catalogue — common examples include cleaning packages, gym memberships, insurance, airport transfers, co-working access, parking, and more. See Services Marketplace.

How are service charges billed? Service charges are automatically added to the tenant's payment schedule and tracked alongside rent and other charges in the Finance module.

My service description is long (for example terms and conditions). What do tenants see? The Tenant Portal shows a short preview of the description on each service card and in the confirmation step before they submit a request (about two lines, with an ellipsis when the text continues). Put critical information at the beginning, or add the optional Link on the service in Settings > Services so tenants can open your full terms or detail page. See Tenant Portal — Services catalogue.

Notifications

Pair with other FAQ sections

This section complements Notifications & alerts — start there for bell vs /notifications, infinite scroll, and payment-alert opt-in. Full pairing matrix: FAQ section cross-reference.

Where can I see all my notifications? Use the Notifications module to view your full notification history. You can search, filter by All/Unread/Read, and mark notifications as read. On desktop Dashboard, the header bell shows unread count and opens a slide-over with General and Inbox sub-tabs (message pings on Inbox; payment/ticket/booking alerts on General) — no in-panel link to the full page. Open /notifications directly (bookmark or address bar) for the full module. For WhatsApp-only triage, use the bell Inbox sub-tab or the global Inbox workspace at /inbox. There is no dedicated Notifications item in the left sidebar. See Notifications Module.

Utilities

Pair with other FAQ sections

Overage and AI reader answers pair with Properties & Listings (Bills Included ceilings), Payments & Finance (tenant charges on payment plan), and Why didn't my SIMAR water bill match the property? (Cód. Local vs meter number on Connections). Full pairing matrix: FAQ section cross-reference.

Why are tenant overage charges not being created? Overages require three things to be configured: (1) utility account IDs linked to the property, (2) Bills Included ceilings set on the property, and (3) utility types enabled in Settings > Utilities. Also ensure the bill is entered with the correct billing period. See Entering Monthly Utility Bills.

How does the AI read my utility bills? Upload the bill document and the AI Invoice Reader extracts all relevant data automatically. For best results, ensure your property utility connections are configured with up-to-date account IDs so the AI can match bills to properties. See Utilities > AI Invoice Reader.

Why didn't my SIMAR water bill match the property?

SIMAR (Loures e Odivelas) invoices label the supply location as Cód. Local or Código de Localnot the water meter number (Nº de Contador). Enter that local code (without leading zeros) in Utilities → Connections Water and in property setup Step 2 (#2110). Example: Cód. Local: 0181474 → save 181474. The AI reader enforces the same rule on upload; if matching still fails, open the PDF, copy Cód. Local, and compare it to your Connections row. See Glossary — SIMAR water contract ID and Onboarding a New Property — Step 6.

FAQ subsection cross-reference

Pair with other FAQ sections

This table pairs anchored ### troubleshooting deep-dives with glossary terms, modules, and workflows. Section-level pairing: FAQ section cross-reference below. Term definitions: Glossary deep-dive index. Full hub map: the Finding your way tip at the top of this page.

SubsectionParent sectionPair with
Permission denied toastNavigation & shortcutsUsers and roles — Role Permissions, Users and roles — Blocked actions, Create New menu — Permissions, Glossary — Permission denied toast, Finance — Access tabs and toolbar, Error Handling — Authentication errors, Using in-app support (persistent 403 on Vivin tickets)
Phone shows Operations onlyNavigation & shortcuts (mobile)Operations — Mobile and narrow layouts, Getting Started — Mobile phones (operations-only shell), Glossary — Operations-only phone shell, Deep Links — Operations, Notifications module (/notifications when the Dashboard bell is hidden), Using in-app support (/settings/support on phones)
Notification row-click navigationNotifications & alertsNotifications module — Open the related booking, Bookings — Notification row-click navigation, Finance — Notification row-click navigation, Notification triage — Step 4, Glossary — Notification row navigation, Glossary — Notification row navigation hub, Deep Links — Notifications, Dashboard — Notifications bell (desktop), Handling a Late Payment — Step 1, Portfolio KPI review — Dashboard Total Debt subtitle, Deep Links — Broken entity deep links
Pending manual in-payment on /notificationsNotifications & alertsCommon Workflows — Pending manual receipt approval, FAQ — Manual receipt still pending, FAQ — Notification row-click navigation, Glossary — Payment notification (operator), Notifications — Pending manual in-payments, Glossary — Pending manual in-payment, Notification triage — Step 4, Notification triage — Step 5, Bookings > Transactions — Row actions, Finance — Pending manual payments, FAQ — Dashboard Total Debt subtitle, Portfolio KPI review — Step 7, Payment Allocation — Pending manual approval (notifications-row-navigate-to-booking-detail.png, finance-transactions-pending-pill.png, finance-transactions-pending-approve-flow.mp4)
Booking sidebar tab load failuresBookingsBooking sidebar tab load failures hub, Common Workflows — Booking sidebar tab load failures, Common Workflows — Directory list load failures (whole-module Retry), Directory list load failures hub, Glossary — Booking detail sidebar tab load failures, Glossary — Directory list load failures, Bookings module, FAQ — Directory list load failures, Common Workflows — WhatsApp per-booking messaging, Notification triage — Step 4, Handling a Late Payment — Step 3, Managing a Check-in, Managing a Check-out (bookings-detail-communication-tab-whatsapp-thread.png, bookings-detail-tickets-tab.png)
Directory list load failuresHelp & Vivin supportDirectory list load failures hub, Common Workflows — Directory list load failures, Common Workflows — Booking sidebar tab load failures (tab-scoped recovery), Booking sidebar tab load failures hub, Glossary — Directory list load failures, Glossary — Booking detail sidebar tab load failures, Dashboard — Partial data load failures, Analytics — Layout and controls, Notifications module, Audit — Manual Blocks, Utilities — Tab load failures, FAQ — Communication or Tickets load failure, Using in-app support — Inbox load failures (notifications-module-load-failure.png, bookings-detail-communication-tab-whatsapp-thread.png) (notifications-module-load-failure.png, audit-manual-blocks-load-failure.png, dashboard-partial-data-load-failure.png, analytics-kpi-load-failure.png)
Booking Changelog scopeBookingsGlossary — Change history, Bookings — Timeline (booking change log), Listings — Change history, Tools → Audit (manual blocks — not booking edits), Manual block hygiene (bookings-detail-contract-info-timeline.png, bookings-detail-contract-info-timeline-view-all-modal.png, listings-property-edit-change-history.png)
Vacant Unit PreferenceProperties & ListingsGlossary — Vacant Unit Preference, Preferences — Vacant Unit Preference, Dashboard — Vacant Units, Manual block hygiene
Archive a property (or bring one back)Properties & ListingsGlossary — Archived property, Listings — Archived properties, Portfolio retirement decisions, Manual block hygiene
Fixed rent on variable unitBookingsGlossary — Fixed Rent, Listings — Rent Value tab, Bookings — Fixed rent on a variable unit, Processing a New Booking — Step 3, FAQ — Lower rent below invoiced
Assign tenant category (direct booking)BookingsCommon Workflows — Portfolio segmentation by tenant category, Glossary — Tenant category, Settings > Tenant categories, Tenants — Tenant Info, Processing a New Booking — Step 2, Managing a Check-in — Step 1, FAQ — Finance tenant category filter parity
Lower rent below invoicedBookingsCommon Workflows — Rent reduction after invoicing, Glossary — Invoiced floor (rent), Common Workflows — Reject/revert mistaken receipts, Bookings — Changing contract dates and rent, Contract Values tab, Finance — Invoiced floor and rent edits, FAQ — Fixed rent on variable unit, Glossary — Credit note (payment reject/revert), Portfolio KPI review — Step 7 (bookings-detail-change-monthly-rent-modal.png, bookings-detail-contract-values-invoiced-floor-edit-amount.png, bookings-rent-reduction-invoiced-floor-flow.mp4)
Reject or revert incoming paymentBookingsCommon Workflows — Reject/revert mistaken receipts, Common Workflows — Bulk Hostkit invoicing (Issue credit notes pacing), Glossary — Credit note (payment reject/revert), Payment Allocation — Correcting mistaken receipts, Common Workflows — Pending manual receipt approval, Common Workflows — Rent reduction after invoicing, Finance — Issuing credit notes (Not issued credit note queue), Bookings — Row actions on in-payment rows, Finance — Row actions on in-payment rows, Finance — Delete payment on the ledger, FAQ — Manual receipt still pending, FAQ — Bulk Hostkit invoicing slow, Notification triage — Step 4, Portfolio KPI review — Step 7 (bookings-detail-transactions-reject-modal-credit-note-banner.png, bookings-detail-transactions-revert-modal-info-banner.png, finance-transactions-bulk-reject-selected-bar.png, bookings-payment-row-actions-flow.mp4)
Manual receipt still pendingBookingsCommon Workflows — Pending manual receipt approval, Glossary — Pending manual in-payment (Finance), Finance — Pending manual payments, Payment Allocation — Pending manual approval, FAQ — Pending manual in-payment on /notifications, FAQ — Dashboard Total Debt subtitle, Notification triage — Step 4, Reject/revert mistaken receipts, Portfolio KPI review — Step 7, FAQ — Reject or revert an incoming payment (finance-transactions-pending-pill.png, bookings-detail-transactions-approve-payment-modal.png, finance-transactions-pending-approve-flow.mp4)
Cash flow forecast drill-downPayments & FinanceCommon Workflows — Cash flow forecast drill-down, Common Workflows — Finance Income status drill-down, Portfolio KPI review — Cash flow forecast drill-down, Handling a Late Payment — Cash flow forecast drill-down, Glossary — Cash flow forecast (Finance Overview), Dashboard — Cash Flow Forecast, Finance > Income chart and cash flow forecast (finance-overview-cash-flow-day-view.png, finance-overview-cash-flow-all-payments-modal.png, finance-overview-cash-flow-drill-down-flow.mp4)
Payment alert to receivables triagePayments & FinanceCommon Workflows — Payment alert to receivables triage, Bookings — Payment alert to receivables triage, Finance — Payment alert to receivables triage, FAQ — Confirmation alert triage (contrast Upcoming vs Ongoing), Common Workflows — Finance debt receivables triage, Notification triage — Step 4, FAQ — Notification row-click navigation, FAQ — Pending manual in-payment on /notifications, FAQ — Bookings that owe money, Handling a Late Payment — Payment notification (operator), Notifications — Payment overdue alerts (notifications-row-navigate-to-booking-detail.png, notifications-row-navigation-flow.mp4, finance-overview-debt-aging-walkthrough-flow.mp4)
Confirmation alert triagePayments & FinanceCommon Workflows — Confirmation alert triage, Bookings — Confirmation alert triage, Finance — Confirmation alert triage, FAQ — Payment alert to receivables triage (contrast Upcoming vs Ongoing), Common Workflows — Pending manual receipt approval, Processing a New Booking — Step 5b / Step 6, Notification triage — Step 4, FAQ — Notification row-click navigation, FAQ — Pending manual in-payment on /notifications, Confirmation to check-in handoff (notifications-row-navigate-to-booking-detail.png, bookings-detail-transactions-approve-payment-modal.png, notifications-row-navigation-flow.mp4)
Finance Income status drill-downPayments & FinanceCommon Workflows — Finance Income status drill-down, Common Workflows — Finance debt receivables triage, Handling a Late Payment — Finance Income status drill-down, Portfolio KPI review — Finance Income status drill-down, FAQ — Bookings that owe money, FAQ — Dashboard Total Debt subtitle, FAQ — Uncovered Debt KPI, Glossary — Finance income status, Glossary — Finance Debt Aging, Finance — Income status drill-down, Handling a Late Payment — Step 1, Portfolio KPI review — Step 7 (finance-overview-income-chart-debt-aging.png, finance-overview-income-status-in-debt-modal.png, finance-overview-income-drill-down-flow.mp4)
Bookings that owe moneyPayments & FinanceCommon Workflows — Finance debt receivables triage, FAQ — Finance Income status drill-down, FAQ — Uncovered Debt KPI, FAQ — Dashboard Total Debt subtitle, Glossary — Finance Debt Aging, Finance — Debt Aging panel, Handling a Late Payment — Step 1, Notification triage — Step 4, Portfolio KPI review — Step 7 (finance-overview-income-chart-debt-aging.png, finance-overview-debt-aging-expanded-bucket.png, finance-overview-debt-aging-walkthrough-flow.mp4)
Dashboard Total Debt subtitlePayments & FinanceFAQ — Bookings that owe money, FAQ — Uncovered Debt KPI, Dashboard — KPI cards, Finance — KPI strip, Common Workflows — Finance debt receivables triage, Portfolio KPI review — Dashboard Total Debt subtitle, Handling a Late Payment — Step 1 (dashboard-kpi-total-debt-tooltip.png)
Uncovered Debt KPIPayments & FinanceFAQ — Bookings that owe money, FAQ — Dashboard Total Debt subtitle, Glossary — Uncovered Debt, Finance — KPI strip, Common Workflows — Finance debt receivables triage, Handling a Late Payment — Step 1, Portfolio KPI review — Uncovered Debt KPI, Processing a New Booking — Uncovered Debt KPI, Cancelling a Booking — Uncovered Debt KPI, Managing a Check-in — Uncovered Debt KPI, Managing a Check-out — Uncovered Debt KPI, Entering Monthly Utility Bills — Uncovered Debt KPI, Handling a Late Payment — Uncovered Debt KPI, Notification triage — Uncovered Debt KPI, Manual block hygiene — Uncovered Debt KPI, Onboarding a New Property — Uncovered Debt KPI, Using in-app support — Uncovered Debt KPI, Resetting a Management User Password — Uncovered Debt KPI (finance-overview-kpi-cards.png)
Finance tenant category filter parityPayments & FinanceCommon Workflows — Portfolio segmentation by tenant category, Bookings — Other filters, Tenants — Tenant category filter, Finance — Tenant category filter, Glossary — Tenant category, Glossary — Finance tenant category cache refresh, FAQ — Assign tenant category for direct booking, Portfolio KPI review — Step 6, Finance debt receivables triage (bookings-list-other-filters-tenant-category.png, finance-other-filters-tenant-category.png)
Bulk Hostkit invoicing slowPayments & FinanceBulk Hostkit invoicing hub, Common Workflows — Bulk Hostkit invoicing, Common Workflows — Month-end invoicing (fixed date), Common Workflows — Reject/revert mistaken receipts, Glossary — Hostkit, Glossary — Credit note (payment reject/revert), Integrations — Hostkit API pacing, Settings > Invoicing — Hostkit invoice series, Finance — Invoice automation, Finance — Issuing credit notes, Portfolio KPI review — Step 7 (finance-transactions-bulk-selection-bar.png, finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png, settings-invoicing-hostkit-series.png)
Deposit / dispute row actions missingPayments & FinanceCommon Workflows — Deposit missing on Finance Deposits, Glossary — Finance Deposits date range, Finance — Deposits tab, Glossary — Deposit dispute, Managing a Check-out — Step 5, Portfolio KPI review — Step 7 (finance-deposits-date-range-toolbar-default.png, finance-deposits-date-range-toolbar-cleared.png, finance-deposits-date-range-clear-flow.mp4)
Partly collected security depositPayments & FinanceCommon Workflows — Partly collected security deposit, Glossary — Deposit lifecycle status, Finance — Deposit lifecycle status cards, Finance — Deposit status filter, Bookings — Deposit tab, Processing a New Booking — Step 5, Managing a Check-in — Step 3, Handling a Late Payment — Step 1 (finance-deposits-lifecycle-partial-paid-card.png, bookings-detail-deposit-tab-partial-badge.png, finance-deposits-partial-collection-walkthrough.mp4)
Manual payments after Delete BookingPayments & FinanceFAQ — Cancel Booking vs Delete Booking, FAQ — Portfolio retirement decisions, Finance — Archived bookings on the ledger, Finance — Type summary cards, Glossary — Archived booking ledger visibility hub, Glossary — Archived booking ledger visibility, Bookings — Delete Booking, Portfolio KPI review — Step 7 (finance-transactions-type-summary-cards.png)
Wrong tenant on a bookingBookingsCommon Workflows — Wrong tenant on a booking, Bookings — Change tenant, Common Workflows — Cancel Booking vs Delete Booking, Processing a New Booking — Step 6 (bookings-detail-change-tenant-control.png, bookings-detail-change-tenant-flow.mp4)
Cancel Booking vs Delete BookingBookingsCommon Workflows — Cancel Booking vs Delete Booking, Wrong tenant on a booking hub, Cancelling a Booking, FAQ — Portfolio retirement decisions, FAQ — Delete Booking on integration reservation (#2076), FAQ — Manual payments after Delete Booking (#1897), Bookings — Delete Booking (soft archive), Finance — Archived bookings on the ledger, Glossary — Archived booking ledger visibility, Processing a New Booking — Step 1 (bookings-cancel-booking-modal-refund-types.png, bookings-list-canceled-tab.png, workflows-cancel-booking-refund-modal-flow.mp4, finance-transactions-type-summary-cards.png)
Delete Booking on integration reservationBookingsFAQ — Cancel Booking vs Delete Booking, Bookings — Provider platform payment, Bookings — Delete Booking (soft archive) (bookings-detail-delete-booking-provider-platform-error-toast.png, bookings-provider-platform-reject-delete-flow.mp4)
Portfolio retirement decisionsProperties & ListingsCommon Workflows — Portfolio retirement decisions, FAQ — Cancel Booking vs Delete Booking, FAQ — Archive a property, FAQ — Manual payments after Delete Booking (#1897), Glossary — Archived property, Glossary — Archived booking ledger visibility, Manual block hygiene (listings-archived-populated-table.png, listings-archived-unarchive-sidebar.png, bookings-cancel-booking-modal-refund-types.png, finance-transactions-type-summary-cards.png)
Same-day turnoversOperationsGlossary — Same-day turnover, Operations — Check-in & Check-out, Bookings — Timeline, Sales — Multicalendar, Managing a Check-in / Managing a Check-out
Find a ticket by its IDOperationsOperations — Tickets toolbar search, Glossary — Directory search ranking, Using in-app support
Skip automatic check-in/out tickets for one bookingOperationsGlossary — Per-booking maintenance ticket opt-out, Bookings — Creating a New Booking, Listings — Maintenances tab
Tenant contract signing blockedTenant Portal & Mobile AppGlossary — Mandatory for contract signing, Preferences — Mandatory fields, Tenant Portal — Digital contract signing, Settings > Contract templates, Processing a New Booking — Step 4, FAQ — Automatic check-in email (settings-preferences-tenant-portal-contract-signing-required.png)
Automatic check-in email did not sendTenant Portal & Mobile AppGlossary — Lifecycle check-in email, Settings > Emails — When lifecycle check-in emails send, Tenant Portal — Digital contract signing, FAQ — Tenant contract signing blocked, Processing a New Booking — Step 4, Bookings — Check-in & Check-out emails, Managing a Check-in (bookings-detail-contract-check-in-out-emails.png)
WhatsApp and email per bookingAI & AutomationCommon Workflows — WhatsApp per-booking messaging, Common Workflows — Notification row-click navigation, Bookings — Communication tab, Inbox module, ChatBot settings, Glossary — Booking Communication tab, Glossary — Notification row navigation, Glossary — Bot reasoning (audit), FAQ — Communication or Tickets load failure, Notification triage — Step 2, Handling a Late Payment — Step 3 (bookings-detail-communication-tab-whatsapp-thread.png, inbox-module-triage-flow.mp4) (bookings-detail-communication-tab-whatsapp-thread.png, bookings-detail-communication-tab-whatsapp-composer.png, inbox-module-overview.png, inbox-module-triage-flow.mp4)
AI token usage for my accountAI & AutomationGlossary — AI usage ledger, AI usage API, AI Chat module (landlord_chat), Utilities — AI Invoice Reader (utility_bill_extraction), Portfolio KPI review — Step 7
SIMAR water bill property matchUtilitiesGlossary — SIMAR water contract ID, Utilities — Connections tab, Listings — Step 2: Utility Bills ID, Entering Monthly Utility Bills

FAQ section cross-reference

Pair with other FAQ sections

This table pairs troubleshooting sections with setup, modules, and escalation hubs. Start with Navigation & shortcuts for shell behaviour; jump to Payments & Finance for ledger disputes. Full hub map: the Finding your way tip at the top of this page.

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

| FAQ section | Pair with these sections | | ----------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | FAQ subsection cross-reference | Getting Started hub subsection index (onboarding sections), Concepts hub subsection index (underlying models), Modules hub subsection index (screen workspaces), Common Workflows hub subsection index (operational procedures), Account Settings hub subsection index (setup tabs), Glossary deep-dive index (term definitions), Support — Section cross-reference (escalation), Common Workflows — Workflow cross-reference (step-by-step procedures) | | Navigation & shortcuts | Notifications & alerts, Settings & tenant communications, FAQ — Permission denied toast, Glossary — Permission denied toast, Getting Started — Recommended Setup Sequence (step 3 Users — create permissions for greyed-out + Create New rows) | | Navigation & shortcuts (mobile) | Operations, FAQ — Phone shows Operations only, Glossary — Operations-only phone shell, Getting Started — Mobile phones (operations-only shell), Operations — Mobile and narrow layouts, Help & Vivin support | | Notifications & alerts | Payments & Finance, Bookings, AI & Automation, FAQ — Notification row-click navigation, FAQ — Payment alert to receivables triage, FAQ — Confirmation alert triage, Glossary — Notification row navigation, Notification triage, Deep Links — Notifications, Handling a Late Payment — Step 1, Notifications — Payment overdue alerts, FAQ — Pending manual in-payment on /notifications, FAQ — Manual receipt still pending, Glossary — Pending manual in-payment (Finance) | | Settings & tenant communications | Tenant Portal & Mobile App, Integrations & Distribution, Getting Started — Recommended Setup Sequence (steps 10–12 — tenant categories, emails, integrations), Account Settings — Recommended setup order (tab map), Settings > Tenant categories (portal segments and Communication Rules audience), Glossary — Tenant category | | Analytics (KPI workspace) | Payments & Finance, Properties & Listings, Dashboard Total Debt subtitle, Uncovered Debt KPI, Portfolio KPI review, Analytics module, Dashboard module, Sales module, Glossary — ADR, Glossary — RevPAR, Finance — Tenant category filter, Glossary — Tenant category | | Bookings | Payments & Finance, Operations, Tenant Portal & Mobile App, Settings > Tenant categories, FAQ — Assign tenant category for direct booking, Glossary — Tenant category | | Payments & Finance | Bookings, Notifications & alerts, Handling a Late Payment — Step 1, Integrations & Distribution, Utilities, FAQ — Payment alert to receivables triage, FAQ — Confirmation alert triage, FAQ — Finance Income status drill-down, FAQ — Cash flow forecast drill-down, FAQ — Bookings that owe money, FAQ — Dashboard Total Debt subtitle, FAQ — Uncovered Debt KPI, FAQ — Deposit missing on Finance Deposits, Finance — Tenant category filter, FAQ — Finance tenant category filter parity, Glossary — Tenant category, Glossary — Finance Deposits date range, Portfolio KPI review — Step 7 | | Properties & Listings | Integrations & Distribution, Operations, Bookings | | Operations | Bookings, Properties & Listings, Payments & Finance | | Management Account Access | Help & Vivin support, Platform subscription (Vivin billing), Getting Started — Recommended Setup Sequence (step 3 Users — invites before modules go live), Getting Started — Accessing the Platform (first login), Getting Started — Lockout catch-up after password recovery (post-recovery operational mesh) | | Platform subscription (Vivin billing) | Management Account Access, Help & Vivin support | | Help & Vivin support | Management Account Access, Navigation & shortcuts, Getting Started — Recommended Setup Sequence (cite setup step on Settings / Listings tickets), Account Settings — Recommended setup order (tab map), Get Help & Support (email escalation), Using in-app support (ticket workflow) | | Tenant Portal & Mobile App | Settings & tenant communications, Payments & Finance, Settings > Tenant categories (portal modules and editable fields), Glossary — Tenant category | | Integrations & Distribution | Properties & Listings, Bookings, Operations, Settings > Tenant categories (default for integration-created tenants), Glossary — Tenant category | | AI & Automation | Settings & tenant communications, Bookings, FAQ — WhatsApp and email per booking, Common Workflows — WhatsApp per-booking messaging, Inbox module, Landlord MCP, Tenant MCP, AI usage API, FAQ — How do I see AI token usage for my account?, Glossary — AI usage ledger, Glossary — Tenant category | | Services Marketplace | Tenant Portal & Mobile App, Payments & Finance, Settings > Services, Settings > Tenant categories (Allow to see services per segment), Glossary — Tenant category | | Notifications | Notifications & alerts, FAQ — Notification row-click navigation, Glossary — Notification row navigation, Notification triage — Step 4, Deep Links — Notifications | | Utilities | Properties & Listings, Payments & Finance | | Setup sequence after go-live | Getting Started — Recommended Setup Sequence (steps 1–15), Onboarding a New Property — Step 7 (go-live verification), Support — Setup sequence escalation (module choice on tickets), FAQ — Settings & tenant communications (self-serve during steps 10–12), Onboarding a New Property (guided steps 4–12) | | Documentation map & escalation | Introduction — Section cross-reference, Introduction hub subsection index, Getting Started hub subsection index, Concepts hub subsection index, Modules hub subsection index, Common Workflows hub subsection index, Account Settings hub subsection index, API hub subsection index, Support — Section cross-reference, Modules — Module cross-reference, Getting Started — Recommended Setup Sequence, Using in-app support (Vivin product tickets) | | Navigation & bookmarks | Management Frontend Deep Links, Create New menu, Deep Links — Account Settings, Settings > Interface language, Resetting a Management User Password (sign-in recovery) | | Key glossary terms | Glossary cluster cross-reference, Glossary — Setup sequence vocabulary, Support — Key glossary terms, Payment Allocation — Correcting mistaken receipts, Common Workflows — Reject/revert mistaken receipts | | Lockout catch-up after password recovery | Sign-in restored after password reset; onboarding, alert, or month-end backlog accumulated during lockout | Glossary — Lockout catch-up after password recovery hub, FAQ — Lockout catch-up after password recovery hub, Common Workflows — Lockout catch-up after password recovery, Getting Started — Lockout catch-up after password recovery, Resetting a Management User Password (workflows-login-reset-password-link.png, notifications-row-navigate-to-booking-detail.png, finance-transactions-pending-pill.png) | | Walkthrough media | MP4 walkthroughs beside PNG screenshots | Common Workflows — Walkthrough media, Modules, Account Settings | | Notification row-click navigation | /notifications row-click troubleshooting and alert-driven module entry — Glossary — Notification row navigation hub reciprocal mesh | Common Workflows — Notification row-click navigation, FAQ — Notification row-click navigation, Glossary — Notification row navigation, Notification triage — Step 4 | | Payment alert to receivables triage | payment overdue alert → receivables before Debt Aging or collections | Common Workflows — Payment alert to receivables triage, FAQ — Payment alert to receivables triage, Finance debt receivables triage hub, Handling a Late Payment — Step 1 | | Finance debt receivables triage hub | Dashboard Total Debt, Debt Aging, Income → In debt, or Uncovered Debt surface choice — clear Pending and Revert duplicates before collections | Glossary — Finance debt receivables triage hub, Common Workflows — Finance debt receivables triage, FAQ — Bookings that owe money, Uncovered Debt KPI hub, Pending manual receipt approval hub, Reject/revert mistaken receipts hub, Handling a Late Payment hub, Payment alert to receivables triage hub (finance-overview-income-chart-debt-aging.png, finance-overview-debt-aging-walkthrough-flow.mp4) | | Uncovered Debt KPI hub | Finance Total Debt minus deposit offsets — thin coverage when Uncovered DebtTotal Debt; pair Top debtors on Step 7 | Glossary — Uncovered Debt hub, Common Workflows — Uncovered Debt KPI, FAQ — What is Uncovered Debt on Finance Overview?, Finance debt receivables triage hub, Portfolio KPI review — Step 7 (finance-overview-kpi-cards.png, finance-overview-debt-aging-expanded-bucket.png, dashboard-kpi-total-debt-tooltip.png) | | Directory list load failures hub | Whole-module Retry / Try again when Bookings, /notifications, Dashboard, or Analytics first-fetch fails — not filter-empty states | Common Workflows — Directory list load failures, FAQ — Directory list load failures, Booking sidebar tab load failures hub, Help & Vivin support (notifications-module-load-failure.png, audit-manual-blocks-load-failure.png, dashboard-partial-data-load-failure.png, analytics-kpi-load-failure.png) | | Booking sidebar tab load failures hub | Tab-scoped Refresh / Retry inside one booking when Communication or Tickets fail — Payment Plan may still load | Common Workflows — Booking sidebar tab load failures, FAQ — Communication or Tickets load failure, Directory list load failures hub, Notifications & alerts (bookings-detail-communication-tab-whatsapp-thread.png, bookings-detail-tickets-tab.png) | | Hostkit hub | Per-listing Listing keys + FR invoice series before Issue allocation / see invoice | Glossary — Hostkit hub, FAQ — Hostkit hub, Integrations — Hostkit API pacing, Settings > Invoicing — Hostkit invoice series, Finance — Hostkit invoice links, Bulk Hostkit invoicing hub (settings-invoicing-hostkit-series.png, finance-transactions-bulk-selection-bar.png) | | Bulk Hostkit invoicing hub | Month-end Issue allocation / Invoice selected or Issue credit notes batches pace Hostkit — refresh Transactions before re-issue | Common Workflows — Bulk Hostkit invoicing, Glossary — Bulk Hostkit invoicing hub, FAQ — Bulk Hostkit invoicing slow, Month-end invoicing (fixed date) hub, Payments & Finance (finance-transactions-bulk-selection-bar.png, finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png) | | Month-end invoicing (fixed date) hub | Fixed Invoice date before bulk Issue allocation — toggle Use today back on after batch | Glossary — Month-end invoicing (fixed date) hub, Glossary — Fixed invoice date reminder hub, Common Workflows — Month-end invoicing (fixed date), Bulk Hostkit invoicing hub, Invoicing — Default invoice date, Portfolio KPI review — Step 7 (settings-invoicing-invoice-date-toggle.png, finance-transactions-fixed-invoice-date-banner.png, finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png) | | Confirmation alert triage | Upcoming confirmation-week alerts before bulk mark-read | Common Workflows — Confirmation alert triage, FAQ — Confirmation alert triage, Processing a New Booking hub, Pending manual receipt approval | | Portfolio segmentation by tenant category hub | Review only corporate, short-stay, or unassigned tenants across reservations, receivables, and profiles | Common Workflows — Portfolio segmentation by tenant category, Common Workflows — Finance debt receivables triage (segment-scoped Top debtors), Settings > Tenant categories, Bookings — Other filters, Finance — Tenant category filter, Glossary — Tenant category, Portfolio KPI review — Step 6 (finance-other-filters-tenant-category.png, finance-overview-debt-aging-expanded-bucket.png) | | Payment notification (operator) hub | Operator payment received / payment overdue email + in-app opt-in layers and row-type triage | Common Workflows — Payment notification (operator), Glossary — Payment notification (operator) hub, FAQ — Payment notifications enabled but no email, Notification row-click navigation hub, Pending manual receipt approval hub, Payment alert to receivables triage hub, Notifications & alerts (notifications-row-navigate-to-booking-detail.png, notifications-row-navigation-flow.mp4) | | Pending manual receipt approval hub | Recorded bank transfers still pending until Approve paymentsTotal Debt / In debt lag | Common Workflows — Pending manual receipt approval, Glossary — Pending manual in-payment (Finance) hub, FAQ — Manual receipt still pending, Finance debt receivables triage hub, Reject/revert mistaken receipts hub, Payments & Finance (finance-transactions-pending-pill.png, finance-transactions-pending-approve-flow.mp4) | | Credit note warning (reject/revert) hub | Red/blue Reject / Revert modal banners when charge may be invoiced — clear Not issued credit note queue | Glossary — Credit note warning (reject/revert) hub, Common Workflows — Reject/revert mistaken receipts, FAQ — Reject or revert an incoming payment, Finance — Issuing credit notes, Bulk Hostkit invoicing hub, Reject/revert mistaken receipts hub, Invoiced floor (rent) hub, Payments & Finance (bookings-detail-transactions-reject-modal-credit-note-banner.png, bookings-detail-transactions-revert-modal-info-banner.png, bookings-payment-row-actions-flow.mp4) | | Rent reduction after invoicing hub | Change monthly rent clamp + external credit notes then Issue credit notes after month-end export | Glossary — Rent reduction after invoicing hub, Common Workflows — Rent reduction after invoicing, Invoiced floor (rent) hub, Bulk Hostkit invoicing hub, Payments & Finance (bookings-detail-change-monthly-rent-modal.png, bookings-detail-contract-values-invoiced-floor-edit-amount.png, bookings-rent-reduction-invoiced-floor-flow.mp4) | | Invoiced floor (rent) hub | Change monthly rent clamp and Edit amount Save block below exported rent — external credit notes then Issue credit notes | Glossary — Invoiced floor (rent) hub, Glossary — Rent reduction after invoicing hub, Rent reduction after invoicing hub, Common Workflows — Rent reduction after invoicing, FAQ — Lower rent below invoiced, Bulk Hostkit invoicing hub, Credit note warning (reject/revert) hub, Payments & Finance (bookings-detail-change-monthly-rent-modal.png, bookings-detail-contract-values-invoiced-floor-edit-amount.png, bookings-rent-reduction-invoiced-floor-flow.mp4) | | Reject/revert mistaken receipts hub | Duplicate bank transfer or wrong booking — Reject while pending; Revert after Approve; Issue credit notes when Finance already invoiced | Common Workflows — Reject/revert mistaken receipts, FAQ — Reject or revert an incoming payment, Credit note warning (reject/revert) hub, Glossary — Credit note warning (reject/revert) hub, Payment Allocation — Correcting mistaken receipts, Pending manual receipt approval hub, Finance debt receivables triage hub, Payments & Finance (finance-transactions-bulk-reject-selected-bar.png, bookings-payment-row-actions-flow.mp4) | | Finance Income status drill-down hub | Income chart Paid / Scheduled / In debt segments vs Debt Aging booking rows | Glossary — Finance Income status drill-down hub, Common Workflows — Finance Income status drill-down, FAQ — Finance Income status drill-down, Finance debt receivables triage hub, Cash flow forecast drill-down hub (finance-overview-income-status-in-debt-modal.png, finance-overview-income-drill-down-flow.mp4) | | Cash flow forecast drill-down hub | Cash flow forecast collections history vs Income status segments | Glossary — Cash flow forecast drill-down hub, Common Workflows — Cash flow forecast drill-down, FAQ — Cash flow forecast drill-down, Finance Income status drill-down hub, Dashboard — Cash Flow Forecast (finance-overview-cash-flow-all-payments-modal.png, finance-overview-cash-flow-drill-down-flow.mp4) | | Occupancy KPI to block hygiene handoff hub | Analytics Occupancy / RevPAR dip without rate change — stale manual holds before category or pricing edits | Common Workflows — Occupancy KPI to block hygiene handoff, Analytics (KPI workspace), Manual block hygiene, Audit module (analytics-kpi-occupancy-tab.png, audit-manual-blocks-workspace.png) | | Wrong tenant on a booking | Change tenant vs duplicate-row Delete Booking on import mistakes | Common Workflows — Wrong tenant on a booking, FAQ — Wrong tenant on a booking hub, Cancel Booking vs Delete Booking hub, Bookings — Change tenant (bookings-detail-change-tenant-modal.png) | | Cancel Booking vs Delete Booking hub | Policy void vs soft-archive cleanup; ledger visibility after Delete Booking (#1897 / #2076) | Common Workflows — Cancel Booking vs Delete Booking, FAQ — Cancel Booking vs Delete Booking, Portfolio retirement decisions hub, Cancelling a Booking (workflows-cancel-booking-refund-modal-flow.mp4) | | Same-day turnover coordination | Shared-unit departure + arrival on the same calendar day | Common Workflows — Same-day turnover coordination, FAQ — Same-day turnovers, Managing a Check-in hub, Managing a Check-out hub (bookings-timeline-day-week-month-and-sidebar.mp4) | | New inventory to first booking handoff | Property wizard → first Upcoming reservation on new inventory | Common Workflows — New inventory to first booking handoff, Onboarding a New Property — Step 7, Processing a New Booking hub, Property setup to first arrival handoff (listings-module-overview.png, workflows-onboarding-property-wizard.mp4) | | Property setup to first arrival handoff | Go-live inventory → first arrival week (~7 days before move-in) | Common Workflows — Property setup to first arrival handoff, Onboarding a New Property — Step 7, Managing a Check-in hub, Confirmation to check-in handoff (listings-property-edit-access-lockers-tab.png, workflows-operations-check-in-out-planning-view.png) | | Confirmation to check-in handoff | Upcoming portal gates → arrival-week planning | Common Workflows — Confirmation to check-in handoff, Processing a New Booking hub, Managing a Check-in hub, Confirmation alert triage hub (booking-lifecycle-status-tabs-flow.mp4, bookings-detail-contract-method-of-payments.png) | | Check-in to check-out handoff | Mid-stay Ongoing → departure-week planning | Common Workflows — Check-in to check-out handoff, Managing a Check-in hub, Managing a Check-out hub, Same-day turnover coordination (operations-check-in-out-check-outs-next-7-days.png, bookings-timeline-view.png) | | Check-out final utilities handoff | Final supplier bills + overage lines before deposit release | Common Workflows — Check-out final utilities handoff, Entering Monthly Utility Bills hub, Managing a Check-out hub, Utility overage collections (utilities-allocations-review-flow.mp4, bookings-detail-payment-plan-tab-schedule.png) | | Check-out collections before refund | Rent/fee In Debt on Payment Plan blocks Ready To Refund before deposit release | Common Workflows — Check-out collections before refund, Managing a Check-out hub, Handling a Late Payment hub, Check-out ledger cleanup before refund (workflows-check-out-coordination-flow.mp4, bookings-detail-payment-plan-tab-schedule.png, finance-contract-values-in-debt-filter.png, bookings-detail-deposit-tab-ready-to-refund-toggle.png) | | Check-out ledger cleanup before refund | Tenant paid once but duplicate transfer leaves phantom In Debt before refund | Common Workflows — Check-out ledger cleanup before refund, Reject/revert mistaken receipts hub, Managing a Check-out hub, Check-out collections before refund (bookings-detail-transactions-revert-modal-info-banner.png, finance-transactions-bulk-reject-selected-bar.png) | | Cancellation collections before void | Pre-cancel rent/fee arrears block Cancel booking until Payment Plan settles | Common Workflows — Cancellation collections before void, Cancelling a Booking hub, Handling a Late Payment hub, Check-out vs cancellation (finance-contract-values-in-debt-filter.png, bookings-cancel-booking-modal-refund-types.png, workflows-cancel-booking-refund-modal-flow.mp4) | | Deposit lifecycle status | depositStatus pill vocabulary — Not Paid through Refunded on booking Deposit and Finance lifecycle cards | Common Workflows — Deposit lifecycle status, Glossary — Deposit lifecycle status hub, Glossary — Deposit lifecycle status, Finance — Deposit lifecycle status cards, Bookings — Deposit tab, Partly collected security deposit, Deposit dispute, Deposit missing on Finance Deposits, Managing a Check-out hub, Portfolio KPI review — Step 7 (finance-deposits-status-cards.png, bookings-detail-deposit-tab.png, bookings-detail-deposit-tab-ready-to-refund-toggle.png, finance-deposits-tab-mark-refunded-flow.mp4) | | Deposit dispute | Contested deposit retention blocks Refund / Mark refunded until Resolve Dispute | Managing a Check-out — Step 5, Cancelling a Booking — Step 3, Glossary — Deposit dispute, FAQ — Deposit missing on Finance Deposits, Partly collected security deposit (bookings-detail-deposit-tab-mark-disputed-button.png, deposit-dispute-mark-and-resolve-flow.mp4) | | Utility overage collections | Unpaid utility overage lines on Payment Plan after bill posting | Common Workflows — Utility overage collections, Entering Monthly Utility Bills hub, Handling a Late Payment hub, Check-out final utilities handoff (utilities-allocations-row-breakdown-expanded.png, finance-contract-values-in-debt-filter.png) | | Check-out vs cancellation | Completed stay → Ended vs policy void → Canceled | Common Workflows — Check-out vs cancellation, Managing a Check-out hub, Cancelling a Booking hub, Cancel Booking vs Delete Booking hub (workflows-cancel-booking-refund-modal-flow.mp4, bookings-list-canceled-tab.png) | | Deposit missing on Finance Deposits | Booking Deposit tab shows data but Finance → Deposits row is hidden — default ~3 months toolbar date range | Common Workflows — Deposit missing on Finance Deposits, FAQ — Deposit missing on Finance Deposits hub, FAQ — Deposit missing on Finance Deposits, Glossary — Deposit missing on Finance Deposits hub, Glossary — Finance Deposits date range, Glossary — Finance Deposits date range hub, Partly collected security deposit, Lockout catch-up after password recovery, Processing a New Booking hub, Managing a Check-in hub, Managing a Check-out hub, Handling a Late Payment hub, Cancelling a Booking hub (finance-deposits-date-range-toolbar-default.png, finance-deposits-date-range-toolbar-cleared.png, finance-deposits-date-range-clear-flow.mp4) | | Partly collected security deposit | Paid > 0 but < Amount on security deposit — distinct from rent Partial Paid on Payment Plan | Common Workflows — Partly collected security deposit, FAQ — Partly collected security deposit, Glossary — Partly collected security deposit hub, Glossary — Partly collected security deposit, Glossary — Deposit lifecycle status, Deposit missing on Finance Deposits, Processing a New Booking hub, Managing a Check-in hub, Managing a Check-out hub, Handling a Late Payment hub, Cancelling a Booking hub (finance-deposits-lifecycle-partial-paid-card.png, bookings-detail-deposit-tab-partial-badge.png, finance-deposits-partial-collection-walkthrough.mp4) | | Concepts & integrations | Payment Allocation, Booking Lifecycle, Tenant Portal · Tenant MCP · Landlord MCP, Automation & AI, Integrations & Distribution | | Settings that shape troubleshooting | Account Settings — Tab cross-reference, Settings > Integration field capability, Settings > Subscription, Settings > Emails, Support — Settings that shape escalations | | Self-serve workflows | Common Workflows — Workflow cross-reference, Handling a Late Payment — Step 1, Notification triage, Portfolio KPI review, Support — Self-serve before opening a ticket | | Deeper workflow reads | Handling a Late Payment, Notification triage, Portfolio KPI review | | Module documentation hubs | Modules (screen-by-screen reference), Using in-app support — Module picker layout, Support — Module documentation hubs, Notifications — Payment overdue alerts |

Definitions behind linked terms: Glossary. Step-by-step procedures: Common Workflows. First-time setup hub: Getting Started — Recommended Setup Sequence (steps 1–12 tab map: Account Settings — Recommended setup order).

Pair with other FAQ hub sections

Related below is the documentation map when troubleshooting spans setup, modules, concepts, workflows, or escalation paths. Pair Setup sequence after go-live with Getting Started — Recommended Setup Sequence; pair FAQ section cross-reference with Support — Section cross-reference. Each Related subsection has a row in FAQ section cross-reference above. Full hub map: the Finding your way tip at the top of this page.

Setup sequence after go-live

Pair with other FAQ hub sections

Post-go-live pairing starts with Getting Started — Recommended Setup Sequence (steps 1–15) and Onboarding a New Property — Step 7 before setup defect tickets. When a step is blocked, continue to Support — Setup sequence escalation. Self-serve first: FAQ — Settings & tenant communications. Full pairing matrix: FAQ section cross-reference.

Documentation map & escalation

Pair with other FAQ hub sections
Pair with other FAQ hub sections

Bookmark routes pair with FAQ — Navigation & shortcuts when answers point to wrong tabs. Missing records: Create New menu. UI-language mismatches: Interface language before translation defect tickets. Full pairing matrix: FAQ section cross-reference.

Lockout catch-up after password recovery

SymptomFix
Total Debt high after alert triageApprove Pending receipts — Pending manual receipt approval; then Finance debt receivables triage
/notifications or Bookings will not load after lockoutDirectory list load failuresRetry before alert triage
Partial paid card empty but booking Deposit shows shortfallClear date rangeDeposit missing on Finance Deposits
Older move-outs missing from Finance DepositsDeposit missing on Finance Deposits
MCP automation 403Refresh JWT after Step 3
Setup wizard still blockedRerun Onboarding — Step 7

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

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

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

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

Walkthrough media

Pair with other FAQ 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: FAQ section cross-reference.

Portfolio segmentation by tenant category

SymptomFix
Segment on Bookings but missing on Finance drawerLoad Contract Values or mirror Bookings / TenantsFAQ — Finance tenant category filter parity
Stale results after Tenants → Tenant Info recategorizationWait seconds — Finance tenant category cache refresh (#2088)
Direct booking has wrong portal modulesAssign on Tenant Info before contract mail — FAQ — Assign tenant category for direct booking
Payment alerts cluster on one cohort/notifications row-click → Finance → Other filters → Tenant category before account-wide collections
Segment filters healthy but Occupancy still dipsOccupancy KPI to block hygiene handoff hub — stale holds, not category rules
Top debtors skewed to one segmentFinance debt receivables triage hub — add Tenant category filter on Overview / Contract Values first

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

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

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

WhatsApp per-booking messaging

Pair with other FAQ hub sections

Tenant messaging questions pair with Notification row-click navigation hub (message alerts on /notifications), AI & Automation, and the anchored FAQ subsection below. Hub parity: Common Workflows — WhatsApp per-booking messaging. Full pairing matrix: FAQ section cross-reference.

Finance debt receivables triage

Pair with other FAQ hub sections

Debt triage questions pair with Portfolio segmentation by tenant category hub (Finance → Other filters → Tenant category when arrears cluster on one segment), Payments & Finance, and the four anchored FAQ subsections below. Hub parity: Common Workflows — Finance debt receivables triage. Full pairing matrix: FAQ section cross-reference.

Finance debt receivables triage

Pair with other FAQ hub sections

Receivables surface choice pairs with Handling a Late Payment hub (collections Steps 1–6 after triage surfaces), Processing a New Booking hub (unpaid confirmation on Upcoming stays), Managing a Check-in hub (move-in shortfall before key handover), Managing a Check-out hub (departure arrears before deposit refund), Cancelling a Booking hub (pre-cancel settlement), Entering Monthly Utility Bills hub (utility overage In Debt — not rent Top debtors alone), Reject/revert mistaken receipts hub (Revert approved duplicates before Top debtors collections), Pending manual receipt approval hub (amber Pending chip — Total Debt / In debt lag until Approve), Payments & Finance, and month-end Portfolio KPI review — Step 7. Hub parity: Finance debt receivables triage hub · Glossary — Finance debt receivables triage hub · Common Workflows — Payment alert to receivables triage · Finance debt receivables triage. Full pairing matrix: FAQ section cross-reference.

SymptomFix
Total Debt unchanged after Add PaymentApprove Pending rows first — Pending manual receipt approval hub
Top debtors still high after tenant paidDuplicate transfer approvedReject/revert mistaken receipts hubRevert duplicate (bookings-detail-transactions-revert-modal-info-banner.png)
Need ranked debtors with days overdueFinance → Overview → Debt AgingTop debtors after pending queue clears and ledger duplicates are Reverted
Opened Income → In debt modal, need booking rowsUse Debt Aging buckets — not payment-line modal alone
Dashboard Total Debt not clickableHeadline only — open Finance → Overview
Payment overdue alert but portfolio rank neededNotification triage — Step 4 first — then Debt Aging (finance-overview-debt-aging-expanded-bucket.png)
Unpaid confirmation on Upcoming stayProcessing a New Booking hub — booking Payment Plan before portfolio Top debtors
Move-in shortfall before key handoverManaging a Check-in hubStep 3 before Debt Aging
Departure arrears block Ready To RefundManaging a Check-out hubStep 6 before deposit refund
Pre-cancel rent In Debt blocks voidCancelling a Booking hubStep 2 before Step 4
Utility overage In Debt after bill cycleEntering Monthly Utility Bills hubStep 4 — not rent Top debtors alone
Walkthrough: compare Total Debt and Uncovered Debt on Finance Overview, rank debtors in Debt Aging, then contrast the month-scoped Income → In debt modal.

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

Finance Income status drill-down

Pair with other FAQ hub sections

Income chart segment questions pair with Finance debt receivables triage hub (Income → In debt modal is payment-line scope — use Debt Aging for booking rows), Cash flow forecast drill-down hub (collections history vs status segments), Pending manual receipt approval hub (Scheduled / In debt lag until Approve), Payments & Finance, and FAQ — Finance Income status drill-down. Hub parity: Common Workflows — Finance Income status drill-down. Full pairing matrix: FAQ section cross-reference.

SymptomFix
Opened Income → In debt modal, need ranked debtorsFinance → Overview → Debt Aging Top debtors — not payment-line modal alone (finance-overview-debt-aging-expanded-bucket.png)
Scheduled high but bank shows collectionsCash flow forecast All payments modal — Cash flow forecast drill-down hub (finance-overview-cash-flow-all-payments-modal.png)
Paid segment disagrees with month-end KPIsPortfolio KPI review — Step 7 — reconcile Income vs Analytics (finance-overview-income-drill-down-flow.mp4)
Confirmation month In debt before check-inProcessing a New Booking hubStep 5 / Step 6
Move-in shortfall in wrong month segmentManaging a Check-in hubStep 3 before Debt Aging
Departure charges block Ready To RefundManaging a Check-out hubStep 6 + Debt Aging
Pre-cancel rent In Debt on Contract ValuesCancelling a Booking hubStep 2 before Step 4
Utility overage In Debt after bill cycleEntering Monthly Utility Bills hubStep 4 — not rent Top debtors alone
Income → In debt inflated after duplicate transferReject/revert mistaken receipts hubRevert approved duplicate before re-reading segments (bookings-detail-transactions-revert-modal-info-banner.png)
Walkthrough: Paid / Scheduled / In debt segment drill-down — payment-line modal, View booking, then contrast Debt Aging Top debtors.

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

Cash flow forecast drill-down

Pair with other FAQ hub sections

Collections-history questions pair with Finance Income status drill-down hub (Income status segments vs confirmed cash received), Pending manual receipt approval hub (month bars lag until Approve), Payments & Finance, FAQ — Cash flow forecast drill-down, and Dashboard — Cash Flow Forecast (rent due dates — different chart). Hub parity: Common Workflows — Cash flow forecast drill-down. Full pairing matrix: FAQ section cross-reference.

SymptomFix
Bank received cash but Income → Paid looks lowCash flow forecast All payments modal — confirmed collections only (finance-overview-cash-flow-all-payments-modal.png)
Opened Dashboard Cash Flow Forecast by mistakeRent due timing on / — Finance Cash flow forecast is collections history (dashboard-cash-flow-forecast-chart.png)
Scheduled high but bank shows collectionsCash flow forecast bar click — contrast Income segments on Finance Income status drill-down hub
Month bar missing a transfer tenant insists they paidPending manual receipt approval hubApprove before Cash flow forecast month bars update (finance-transactions-pending-pill.png)
Month-end collections vs Analytics mismatchDay view on Cash flow forecastPortfolio KPI review — Step 7 (finance-overview-cash-flow-drill-down-flow.mp4)
Confirmation payment not on current month barProcessing a New Booking hubStep 5b before portfolio reads
Move-in deposit landed but wrong weekManaging a Check-in hubStep 3 — toggle Day on Cash flow forecast
Departure refund blocked despite bank transferManaging a Check-out hubStep 6All payments for final-week collections
Utility overage payment not visibleEntering Monthly Utility Bills hubStep 4 — not rent Top debtors alone

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

Pending manual receipt approval

Pair with other FAQ hub sections

Pending receipt questions pair with Finance debt receivables triage hub (Total Debt / In debt until Approve — not Debt Aging alone), Finance Income status drill-down hub (Scheduled / In debt lag until approval), Cash flow forecast drill-down hub (month bars lag until Approve), Reject/revert mistaken receipts hub (Reject duplicate while pending), Payments & Finance, and FAQ — Manual receipt still pending. Hub parity: Glossary — Pending manual receipt approval hub · Common Workflows — Pending manual receipt approval. Full pairing matrix: FAQ section cross-reference.

SymptomFix
Total Debt unchanged after Add PaymentAmber Pending chip → Approve payment / Approve selected — not Debt Aging (finance-transactions-pending-pill.png)
Manual Payments KPI non-zero but queue unclearKPI totals monthly manual in-payments including pending — card opens the month drill-down, not the pending-only queue; triage amber Pending on Finance → Transactions
Pending manual in-payment alert persistsRow-click → booking TransactionsApproveNotification triage — Step 4
Income → Paid / Cash flow forecast bar lowApprove before segment or month bars update — Finance Income status drill-down hub / Cash flow forecast drill-down hub
Duplicate bank transfer recordedReject selected while pendingReject/revert mistaken receipts hub (finance-transactions-bulk-reject-selected-bar.png)
Month-end KPIs disagree after lockoutLockout catch-up after password recovery + workflow Steps 5b / 6b
Confirmation transfer still PendingProcessing a New Booking hubStep 5b before portal gates
Move-in receipt still Pending before key handoverManaging a Check-in hubStep 3b before Step 4
Departure receipt still Pending before refundManaging a Check-out hubStep 6b before Ready To Refund
Utility overage receipt still PendingEntering Monthly Utility Bills hubStep 4b
Approve payments permission missing on ticketUsers and roles — Role permissions — self-serve before filing product defect

Hub matrix: Common Workflows — Pending manual receipt approval · Pending manual receipt approval hub · Glossary — Pending manual receipt approval hub. Per-guide mesh: Processing a New Booking — Pending manual receipt approval, Handling a Late Payment — Pending manual receipt approval, Cancelling a Booking — Pending manual receipt approval, Managing a Check-in — Pending manual receipt approval, Portfolio KPI review — Pending manual receipt approval, Managing a Check-out — Pending manual receipt approval, Entering Monthly Utility Bills — Pending manual receipt approval, Notification triage — Pending manual receipt approval, Manual block hygiene — Pending manual receipt approval, Onboarding a New Property — Pending manual receipt approval, Using in-app support — Pending manual receipt approval, Resetting a Management User Password — Pending manual receipt approval.

Payment notification (operator)

SymptomFix
No email when tenant paysAccount Receive payment notifications + your Payment notification emails on /settings/personal — both layers required
Email but no in-app rowPreferences → In-app notifications → Payments master On + your Payments opt-out On
Teammate missing payment rowsThey need Payment notification emails on — in-app rows are per-PM audience scoped
Payment received but balance unchangedReceipt still pendingPending manual receipt approval hub (not a broken notification)
Payment overdue opened Debt Aging too earlyPayment alert to receivables triage hub — row-click booking first
Upcoming alert bulk mark-read before triageConfirmation alert triage hub — contrast Upcoming vs Ongoing/Ended
Confused Pending manual in-payment vs Payment receivedFAQ — Pending manual in-payment on /notifications — third row type

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

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

Occupancy KPI to block hygiene handoff

SymptomFix
Occupancy / RevPAR dip without rate changePortfolio KPI review — Step 3Manual block hygiene — Step 1 (analytics-kpi-occupancy-tab.png)
Ranking concentrates on one unitManual block hygiene — Step 2 Search + row-click unit sidebar — not Sales → Pricing yet
Segment filters look healthy on Step 6Edit Settings → Tenant categories — not holds; contrast Portfolio segmentation by tenant category hub
Dashboard Vacant Units lower than AnalyticsPortfolio KPI review — Step 7Manual block hygiene — Step 5
Sales Multicalendar mystery blocks after go-liveOnboarding a New Property — Step 7Manual block hygiene — Step 4
Timeline overlap on channel importProcessing a New Booking — Step 1 — clear holds before Add booking
Calendar bars persist after Ended departureManaging a Check-out — Step 7Manual block hygiene — Step 4
Availability not restored after cancellation voidCancelling a Booking — Step 5Multicalendar before repricing
Unit looks vacant but collections triage shows arrearsHandling a Late Payment — Step 1 — distinguish holds from rent debt
Calendar edit blocked after hold cleanupManual block hygiene — Step 6Using in-app support

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

Processing a New Booking

Pair with other FAQ hub sections

Confirmation workflow pairs with Managing a Check-in hub (Step 6 → arrival-week Steps 1–4), Notification triage (Steps 4–5 on Booking created / Payment received alerts), Pending manual receipt approval hub (Step 5b / Step 6b confirmation receipts — finance-transactions-pending-pill.png), Reject/revert mistaken receipts hub (duplicate confirmation transfers on Step 5bfinance-transactions-bulk-reject-selected-bar.png), Partly collected security deposit (deposit shortfall vs rent Partial Paidbookings-detail-deposit-tab-partial-badge.png), Deposit missing on Finance Deposits (Partial paid card empty until toolbar range clears), Bookings (lifecycle and portal signing), and Handling a Late Payment hub (unpaid confirmation/move-in charges before handoff). Hub parity: Common Workflows — New inventory to first booking handoff · Confirmation alert triage · Confirmation to check-in handoff · Pending manual receipt approval · Reject/revert mistaken receipts · Partly collected security deposit · Deposit missing on Finance Deposits. Full pairing matrix: FAQ section cross-reference.

SymptomStay on confirmationHand off to check-in
Contract unsignedProcessing a New Booking — Step 4Wait — portal gates block arrival prep
Portal modules hidden after Impersonate TenantStep 6 + Tenant category on Tenant InfoManaging a Check-in — Step 6 when category is already correct
Confirmation transfer still Pending after bank transferPending manual receipt approval hubStep 5b before Step 6 handoff / Step 3b for move-in bucket only
~7 days to move-in, planning ticketsStep 6 sanity checkManaging a Check-in — Step 1
Booking created / Payment received alertNotification triage — Step 4Step 5b / Step 6
Pending manual in-payment on Upcoming importPending manual receipt approval hub — row-click → ApproveStep 5b / Notification triage — Step 5 after balance clears
Month-end Pending on confirmation importsPending manual receipt approval hub — amber Pending chipStep 6b during Portfolio KPI review — Step 7
Tenant paid once, ledger shows duplicate confirmationReject/revert mistaken receipts hubReject while pending / Revert after ApproveStep 5b before Step 6 handoff
Deposit Partially paid after confirmation paymentPartly collected security deposit — not rent Partial PaidStep 5 — chase remaining before Step 6 handoff
Partial paid card empty after Step 5Deposit missing on Finance Deposits — toolbar date rangeClear date range selection on Finance → Deposits (finance-deposits-date-range-clear-flow.mp4) before deposit triage

Managing a Check-in

Pair with other FAQ hub sections

Arrival-week workflow pairs with Onboarding a New Property — Step 7 (upstream property setup on new inventory — hub: Property setup to first arrival handoff; workflows-onboarding-property-wizard.mp4), Processing a New Booking hub (upstream Step 6 portal gates), Common Workflows — Confirmation alert triage (upstream alert-driven confirmation before arrival week), Managing a Check-out hub (mid-stay → departure-week Steps 1–7), Pending manual receipt approval hub (Step 3b / Step 6b move-in receipts — finance-transactions-pending-pill.png), Reject/revert mistaken receipts hub (duplicate move-in transfers on Step 3bfinance-transactions-bulk-reject-selected-bar.png), Handling a Late Payment hub (unpaid move-in charges before Step 4), FAQ — Same-day turnovers, Partly collected security deposit (deposit shortfall before Step 4bookings-detail-deposit-tab-partial-badge.png), Deposit missing on Finance Deposits (Partial paid card empty until toolbar range clears), and Operations. Hub parity: Common Workflows — Confirmation to check-in handoff · Check-in to check-out handoff · Pending manual receipt approval · Reject/revert mistaken receipts · Partly collected security deposit · Deposit missing on Finance Deposits. Full pairing matrix: FAQ section cross-reference.

SymptomUpstream confirmation fixCheck-in step
Arrival listed but contract unsignedProcessing a New Booking — Step 4Not Step 4 until signed
Payment overdue before key handoverHandling a Late Payment — Step 1Step 3
Move-in receipt Pending after bank transferPending manual receipt approval hubStep 3b before Step 4 handover / Step 5b for confirmation bucket only
Pending manual in-payment on arrival-week importPending manual receipt approval hub — row-click → ApproveStep 3b / Notification triage — Step 5 after balance clears
Month-end Pending on move-in importsPending manual receipt approval hub — amber Pending chipStep 6b during Portfolio KPI review — Step 7
Tenant paid once, ledger shows duplicate move-inReject/revert mistaken receipts hubReject while pending / Revert after ApproveStep 3b before Step 4 handover
Portal access codes missingOnboarding — Access LockersStep 4
Same-day turnover on unitManaging a Check-out — Step 2 turnover ticketManaging a Check-in — Step 4 — hub: Same-day turnover coordination
Deposit Partially paid before key handoverPartly collected security deposit — not rent Partial PaidStep 3 — chase remaining before Step 4
Partial paid card empty at move-inDeposit missing on Finance Deposits — toolbar date rangeClear date range selection on Finance → Deposits (finance-deposits-date-range-clear-flow.mp4) before Step 3

Managing a Check-out

Pair with other FAQ hub sections

Departure-week workflow pairs with Managing a Check-in hub (upstream Step 4 keys handed over), Cancelling a Booking hub (policy void vs completed stay — not Delete Booking), Handling a Late Payment hub (rent/fee arrears before Step 5), Reject/revert mistaken receipts hub (duplicate departure transfers on Step 6bfinance-transactions-bulk-reject-selected-bar.png), Entering Monthly Utility Bills hub (utility overages before Step 6 — hub: Check-out final utilities handoff; utilities-allocations-review-flow.mp4), Pending manual receipt approval hub (Step 6b departure receipts — finance-transactions-pending-pill.png), FAQ — Same-day turnovers, and Deposit missing on Finance Deposits. Hub parity: Common Workflows — Check-in to check-out handoff · Check-out vs cancellation (workflows-cancel-booking-refund-modal-flow.mp4, bookings-list-canceled-tab.png) · Check-out collections before refund (workflows-check-out-coordination-flow.mp4) · Check-out ledger cleanup before refund · Pending manual receipt approval · Reject/revert mistaken receipts · Check-out final utilities handoff. Full pairing matrix: FAQ section cross-reference.

SymptomUpstream check-in fixCheck-out step
Guest still Upcoming on departure weekManaging a Check-in — Step 4 not completedNot Step 5 until Ongoing
Deposit Partially paid at move-inPartly collected security depositStep 5 blocked
Unpaid rent/fee on Payment PlanHandling a Late Payment — Step 1Step 4Step 6 before Step 5
Final utility overage unpaidEntering Monthly Utility Bills — Step 4Step 6 — hub: Check-out final utilities
Departure transfer still Pending after bank transferPending manual receipt approval hubStep 6b before Step 5 refund / Step 4b for collections bucket only
Pending manual in-payment on departure-week importPending manual receipt approval hub — row-click → ApproveStep 6b / Notification triage — Step 5 after balance clears
Month-end Pending on departure importsPending manual receipt approval hub — amber Pending chipStep 6b during Portfolio KPI review — Step 7
Tenant paid once, ledger shows duplicate departureReject/revert mistaken receipts hubReject while pending / Revert after ApproveStep 6 / Step 6b before Step 5
Same-day turnover on unitManaging a Check-out — Step 2 before incoming arrivalFAQ — Same-day turnovers — hub: Same-day turnover coordination (bookings-timeline-day-week-month-and-sidebar.mp4)
Stay voided under policy, not completedCancelling a Booking hubCanceled filterNot Step 7 — hub: Check-out vs cancellation
Older move-out missing on Finance → DepositsN/ADeposit missing on Finance Deposits — clear date range

Cancelling a Booking

Pair with other FAQ hub sections

Cancellation workflow pairs with Managing a Check-out hub (completed stay → Ended vs policy void → Canceled), Handling a Late Payment hub (collections before Step 2 / Step 4), Cancel Booking vs Delete Booking (real void vs mistaken row), Portfolio retirement decisions (Archive vs Cancel vs Delete), Pending manual receipt approval hub (Step 2a / Step 6b settlement receipts — finance-transactions-pending-pill.png), Reject/revert mistaken receipts hub (duplicate settlement transfers on Step 2afinance-transactions-bulk-reject-selected-bar.png), Partly collected security deposit (deposit shortfall vs rent Partial Paid at Step 2 / Step 3bookings-detail-deposit-tab-partial-badge.png), Deposit missing on Finance Deposits (Partial paid card empty until toolbar range clears), and Manual block hygiene (calendar release after Step 5). Hub parity: Common Workflows — Check-out vs cancellation · Cancellation collections before void (finance-contract-values-in-debt-filter.png, bookings-detail-transactions-approve-payment-modal.png, workflows-cancel-booking-refund-modal-flow.mp4) · Pending manual receipt approval · Reject/revert mistaken receipts · Partly collected security deposit · Deposit missing on Finance Deposits. Full pairing matrix: FAQ section cross-reference.

| Symptom | Cancellation step | Check-out contrast | | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------- | | Tenant backs out before arrival | Step 4 refund-type dialog | Guest never Ongoing — not Managing a Check-out | | Mid-stay early termination | Steps 1–4 policy settlement | Step 7 only when stay completes | | Deposit refund after void | Step 3 | Step 5 for normal departure | | Settlement transfer still Pending after bank transfer | Pending manual receipt approval hub | Step 2a before Step 4 / Step 6b for month-end mesh only | Step 6b | | Pending manual in-payment on settlement import | Pending manual receipt approval hub — row-click → Approve | Step 2a / Notification triage — Step 5 after balance clears | Step 6b departure mesh | | Month-end Pending on settlement imports | Pending manual receipt approval hub — amber Pending chip | Step 6b during Portfolio KPI review — Step 7 | Step 6b | | Calendar still blocked | Step 5 + Manual block hygiene | Step 7 | | Unpaid rent/fee before Cancel booking | Handling a Late Payment — Step 1Step 4 | Step 2 before Step 4 | | Collections failed — last resort | Step 6 | Step 4 refund dialog | | Deposit Partially paid before void | Partly collected security deposit — not rent Partial Paid | Step 2 / Step 3 — settlement math on remaining before Step 4 | | Partial paid card empty at Step 3 | Deposit missing on Finance Deposits — toolbar date range | Clear date range selection on Finance → Deposits (finance-deposits-date-range-clear-flow.mp4) before Step 3 deposit settlement | | Tenant paid once, ledger shows duplicate settlement | Reject/revert mistaken receipts hubReject while pending / Revert after Approve | Step 2a / Step 6b before Step 4 | | Mistaken duplicate row | Delete Booking — not this hub | Cancel Booking vs Delete Booking |

Entering Monthly Utility Bills

Pair with other FAQ hub sections

Monthly supplier billing pairs with Managing a Check-out hub (downstream Step 6 / Step 5 before deposit release — hub: Check-out final utilities handoff), Handling a Late Payment hub (unpaid overage lines → Step 1), Pending manual receipt approval hub (Step 4b overage receipts — finance-transactions-pending-pill.png), Reject/revert mistaken receipts hub (duplicate overage transfers on Step 4bfinance-transactions-bulk-reject-selected-bar.png), and Utilities (module reference). Hub parity: Common Workflows — Utility overage collections (utilities-allocations-row-breakdown-expanded.png, utilities-allocations-review-flow.mp4) · Check-out final utilities handoff · Pending manual receipt approval · Reject/revert mistaken receipts. Full pairing matrix: FAQ section cross-reference.

SymptomUtility bills stepCheck-out step
Final supplier bill missing at departureStep 2Step 6 blocked
Overage on Payment Plan, tenant has not paidStep 4Handling a Late Payment — Step 1Step 4
Overage on Canceled stay (not departure week)Step 4Step 1 — not rent cancellation mesh
Overage transfer still Pending after bank transferPending manual receipt approval hubStep 4b before Managing a Check-out — Step 6 / Handling a Late Payment — Step 4b for collections bucket only
Pending manual in-payment on overage importPending manual receipt approval hub — row-click → ApproveStep 4b / Notification triage — Step 5 after balance clears
Month-end Pending on overage importsPending manual receipt approval hub — amber Pending chipStep 4b during Portfolio KPI review — Step 7 — hub: Check-out final utilities handoff
Departure-week overage blocks refundStep 4Managing a Check-out — Step 6 before Step 5
End of Booking — charge not posted yetGlossary — End-of-Booking cost splitStep 7
Month-end Missing bills on portfolioStep 5Portfolio KPI review — Step 7
Tenant paid once, ledger shows duplicate overageReject/revert mistaken receipts hubReject while pending / Revert after ApproveStep 4b before Managing a Check-out — Step 6

Handling a Late Payment

Pair with other FAQ hub sections

Collections workflow pairs with Entering Monthly Utility Bills hub (utility overage lines after Step 4), Cancelling a Booking hub (pre-cancel settlement before Step 4), Managing a Check-in hub (move-in charges before Step 4), Managing a Check-out hub (departure-week arrears before Step 5), Finance debt receivables triage hub (Debt Aging / Top debtors before Step 3), Notification triage (upstream payment overdue Step 4), Pending manual receipt approval hub (Step 4b / Step 6b collections receipts — finance-transactions-pending-pill.png), Reject/revert mistaken receipts hub (duplicate collections transfers on Step 4bfinance-transactions-bulk-reject-selected-bar.png), Partly collected security deposit (deposit vs rent Partial Paid at Step 1bookings-detail-deposit-tab-partial-badge.png), Deposit missing on Finance Deposits (Partial paid card empty until toolbar range clears), Notifications & alerts (payment overdue row-click), and Portfolio KPI review — Step 7. Hub parity: Common Workflows — Handling a Late Payment collections hub · Payment alert to receivables triage (notifications-row-navigation-flow.mp4) · Utility overage collections (utilities-allocations-row-breakdown-expanded.png, finance-contract-values-in-debt-filter.png, utilities-allocations-review-flow.mp4) · Cancellation collections before void (finance-contract-values-in-debt-filter.png, bookings-cancel-booking-modal-refund-types.png) · Check-out collections before refund (workflows-check-out-coordination-flow.mp4, bookings-detail-payment-plan-tab-schedule.png) · Check-out ledger cleanup before refund · Pending manual receipt approval · Reject/revert mistaken receipts · Partly collected security deposit · Deposit missing on Finance Deposits. Full pairing matrix: FAQ section cross-reference.

SymptomTriage firstCollections step
Payment overdue alert on /notificationsRow-click → confirm balanceHandling a Late Payment — Step 1Step 3
Need portfolio-ranked debtorsFinance → Overview → Debt AgingStep 1 after you open a booking
Collections transfer still Pending after bank transferPending manual receipt approval hubStep 4b before Step 3 outreach / Step 6b for month-end mesh only
Pending manual in-payment on collections importPending manual receipt approval hub — row-click → ApproveStep 4b / Notification triage — Step 5 after balance clears
Month-end Pending on collections receiptsPending manual receipt approval hub — amber Pending chipStep 6b during Portfolio KPI review — Step 7
Tenant paid once, ledger shows duplicate collectionsReject/revert mistaken receipts hubReject while pending / Revert after ApproveStep 4b / Step 6b before Step 3 — re-triage Debt Aging
In Debt includes utility overage lineEntering Monthly Utility Bills — Step 4Step 1 — hub: Utility overage collections
In Debt blocks Cancel booking dialogStep 1Step 4Cancelling a Booking — Step 2 before Step 4
Departure-week Ready To Refund blocked by rent arrearsStep 1 on booking Payment PlanManaging a Check-out — Step 6 before Step 5
Amber Partial Paid on Payment Plan but shortfall is depositRent collections mesh — security deposit is separatePartly collected security deposit — open Deposit tab at Step 1
Partial paid card empty during portfolio triageToolbar date range on Finance → Deposits hides the stayDeposit missing on Finance Deposits — clear range before deposit vs rent contrast at Step 1
Last-resort cancel after collections failedStep 6Cancelling a Booking — Step 4

Handling a Late Payment collections

Pair with other FAQ hub sections

Receivables triage surfaces answer “who owes?” — Handling a Late Payment Steps 1–6 answer “what do I do next?” Pair with Handling a Late Payment hub (full collections workflow), Finance debt receivables triage hub (Debt Aging / Top debtors before Step 3), Payment alert to receivables triage hub (upstream payment overdue Step 4), Pending manual receipt approval hub (Step 4b / Step 6b collections receipts — finance-transactions-pending-pill.png), Reject/revert mistaken receipts hub (duplicate collections transfers — Revert before Step 3), Utility overage collections (utility In Debt — not rent Top debtors alone), Cancellation collections before void (pre-cancel settlement), and Check-out collections before refund (departure-week arrears). Hub parity: Common Workflows — Handling a Late Payment collections hub · Glossary — Handling a Late Payment collections hub. Full pairing matrix: FAQ section cross-reference.

SymptomTriage surfaceCollections step
Need ranked debtors with days overdueFinance → Overview → Debt AgingStep 1 after you pick a booking
Payment overdue alert row-clickConfirm balance on opened bookingStep 3 after Step 2
Tenant paid but Total Debt unchangedPending manual receipt approval hubStep 4 / Step 4b
Tenant insists they paid twiceReject/revert mistaken receipts hubRe-open Debt Aging — not Step 3 until ledger is clean
Month-end Pending collections receiptsAmber Pending chipStep 6b mesh
Dashboard Total Debt not clickableFinance → OverviewStep 1
Partly collected deposit, not rent arrearsFinance → Deposits Partial paid cardPartly collected security deposit — not rent collections
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.

Pending manual receipt approval

Pair with other FAQ hub sections

Pending receipt questions pair with Processing a New Booking hub (confirmation transfers still pending on Step 5b / Step 6bfinance-transactions-pending-pill.png), Managing a Check-in hub (move-in transfers still pending on Step 3b / Step 6bbookings-detail-transactions-approve-payment-modal.png), Managing a Check-out hub (departure transfers still pending on Step 6bfinance-transactions-pending-pill.png), Handling a Late Payment hub (collections transfers still pending on Step 4b / Step 6bfinance-transactions-pending-pill.png), Cancelling a Booking hub (settlement transfers still pending on Step 2a / Step 6bfinance-transactions-pending-pill.png), Entering Monthly Utility Bills hub (overage transfers still pending on Step 4bfinance-transactions-pending-pill.png), Finance debt receivables triage hub (Total Debt / In debt until Approve — not Debt Aging alone), Reject/revert mistaken receipts hub (Reject while pending vs Revert after Approve — decision table: approve legitimate rows first, then Reject selected on duplicates; finance-transactions-bulk-reject-selected-bar.png, bookings-payment-row-actions-flow.mp4), Payments & Finance, and Why is my manual receipt still pending?. Hub parity: Common Workflows — Pending manual receipt approval. Full pairing matrix: FAQ section cross-reference.

Hub matrix: Common Workflows — Pending manual receipt approval · Pending manual receipt approval hub. Per-guide mesh: Processing a New Booking — Pending manual receipt approval, Handling a Late Payment — Pending manual receipt approval, Cancelling a Booking — Pending manual receipt approval, Managing a Check-in — Pending manual receipt approval, Portfolio KPI review — Pending manual receipt approval, Managing a Check-out — Pending manual receipt approval, Entering Monthly Utility Bills — Pending manual receipt approval, Notification triage — Pending manual receipt approval, Manual block hygiene — Pending manual receipt approval, Onboarding a New Property — Pending manual receipt approval, Using in-app support — Pending manual receipt approval, Resetting a Management User Password — Pending manual receipt approval.

Credit note warning (reject/revert)

SymptomLikely causeFix
Red banner on Reject paymentCharge may already be invoicedConfirm duplicate is wrong — then Not issued credit noteIssue credit notes (N)
Blue info on Revert paymentApproved receipt tied to exported invoiceSame Finance → Transactions queue
Banner but no reversal rowsFilter wrong or batch already IssuedToggle Not issued credit note / Issued credit note pills; refresh ledger
Issue credit notes batch PendingHostkit rate limitFAQ — Bulk Hostkit invoicing slow — same pacing as Issue allocation
Confused with invoiced floor blockRent edit — not receipt cleanupInvoiced floor (rent) hub · Rent reduction after invoicing hub

Hub matrix: Common Workflows — Reject/revert mistaken receipts · Credit note warning (reject/revert) hub · Glossary — Credit note warning (reject/revert) hub. Per-guide mesh: Processing a New Booking — Reject/revert mistaken receipts, Handling a Late Payment — Reject/revert mistaken receipts, Cancelling a Booking — Reject/revert mistaken receipts, Managing a Check-in — Reject/revert mistaken receipts, Portfolio KPI review — Reject/revert mistaken receipts, Managing a Check-out — Reject/revert mistaken receipts, Entering Monthly Utility Bills — Reject/revert mistaken receipts, Notification triage — Reject/revert mistaken receipts, Manual block hygiene — Reject/revert mistaken receipts, Onboarding a New Property — Reject/revert mistaken receipts, Using in-app support — Reject/revert mistaken receipts, Resetting a Management User Password — Reject/revert mistaken receipts.

Reject/revert mistaken receipts

Pair with other FAQ hub sections

Receipt disputes pair with Credit note warning (reject/revert) hub (red/blue modal banners and Not issued credit note queue), Processing a New Booking hub (duplicate confirmation transfers on Step 5bfinance-transactions-bulk-reject-selected-bar.png), Managing a Check-in hub (duplicate move-in transfers on Step 3bfinance-transactions-bulk-reject-selected-bar.png), Managing a Check-out hub (duplicate departure transfers on Step 6bfinance-transactions-bulk-reject-selected-bar.png), Handling a Late Payment hub (duplicate collections transfers on Step 4bfinance-transactions-bulk-reject-selected-bar.png), Cancelling a Booking hub (duplicate settlement transfers on Step 2afinance-transactions-bulk-reject-selected-bar.png), Entering Monthly Utility Bills hub (duplicate overage transfers on Step 4bfinance-transactions-bulk-reject-selected-bar.png), Finance debt receivables triage hub (re-check Top debtors / Dashboard Total Debt after Revert — not collections on phantom duplicates), Pending manual receipt approval hub (amber Pending chip — approve legitimate rows before Revert; finance-transactions-pending-approve-flow.mp4), Payments & Finance, and What happens when I reject or revert an incoming payment?. Hub parity: Common Workflows — Reject/revert mistaken receipts · Glossary — Reject/revert mistaken receipts hub · Glossary — Credit note warning (reject/revert) hub · Check-out ledger cleanup before refund. Full pairing matrix: FAQ section cross-reference.

Hub matrix: Common Workflows — Reject/revert mistaken receipts · Reject/revert mistaken receipts hub. Per-guide mesh: Processing a New Booking — Reject/revert mistaken receipts, Handling a Late Payment — Reject/revert mistaken receipts, Cancelling a Booking — Reject/revert mistaken receipts, Managing a Check-in — Reject/revert mistaken receipts, Portfolio KPI review — Reject/revert mistaken receipts, Managing a Check-out — Reject/revert mistaken receipts, Entering Monthly Utility Bills — Reject/revert mistaken receipts, Notification triage — Reject/revert mistaken receipts, Manual block hygiene — Reject/revert mistaken receipts, Onboarding a New Property — Reject/revert mistaken receipts, Using in-app support — Reject/revert mistaken receipts, Resetting a Management User Password — Reject/revert mistaken receipts.

Booking sidebar tab load failures

Pair with other FAQ hub sections

Per-tab load failures pair with Directory list load failures hub (whole-module Retry vs tab-scoped recovery), Bookings, Help & Vivin support, and Notifications & alerts (row-click into booking then tab fails). Hub parity: Common Workflows — Booking sidebar tab load failures. Full pairing matrix: FAQ section cross-reference.

Walkthrough: tab-scoped Communication Refresh after load failure — Payment Plan stays usable; contrast with Directory list load failures hub whole-module Retry.

Payment alert to receivables triage

SymptomFix
Bulk Mark all as read before opening each rowNotification triage — Step 4 — row-click every payment overdue alert first (notifications-row-navigate-to-booking-detail.png)
Payment overdue on /notificationsRow-click → Payment Plan on opened booking — then Handling a Late Payment — Step 1 or Top debtors
Pending manual in-payment on alertTransactionsApprove — not Debt Aging until queue clears — Pending manual receipt approval
Payment received from tenant … still unreadTransactions — confirm ledger → Approve if still pendingNotification triage — Step 5
Total Debt high after alert triageAmber Pending on Finance → Transactions + Revert duplicate transfers — Finance debt receivables triage hub
Upcoming Booking created / Payment received insteadConfirmation alert triage hub — contrast Upcoming vs Ongoing/Ended payment overdue
Lockout-delayed payment overdue backlogResetting a Management User Password — Step 3Notification triage — Steps 4–5
Stale alerts after calendar hold cleanupManual block hygiene — Step 5 before bulk-clear
Month-end alert batch before KPI sign-offPortfolio KPI review — Step 7 — triage before Dashboard Total Debt read

Confirmation alert triage

SymptomFix
Bulk Mark all as read before opening each rowNotification triage — Step 4 — row-click every Upcoming alert first (notifications-row-navigate-to-booking-detail.png)
Payment received but Payment Plan still unpaidProcessing a New Booking — Step 5b — transfer still pending (bookings-detail-transactions-approve-payment-modal.png)
Booking created on already-confirmed stayProcessing a New Booking — Step 6 — portal gates; not Managing a Check-in — Step 1 until ~7 days out
Pending manual in-payment on Upcoming importPending manual receipt approval hubApprove before Notification triage — Step 5
Upcoming payment overdue before voidCancelling a Booking hubStep 2 — contrast Payment alert to receivables triage
Month-end lingering Pending on confirmation importsProcessing a New Booking — Step 6b during Portfolio KPI review — Step 7
Stale Upcoming after calendar hold cleanupManual block hygieneStep 5 before bulk-clear
Lockout-delayed confirmation backlogResetting a Management User PasswordStep 3 catch-up mesh

Per-guide mesh: Processing a New Booking — Confirmation alert triage, Managing a Check-in — Confirmation alert triage, Managing a Check-out — Confirmation alert triage, Notification triage — Confirmation alert triage, Handling a Late Payment — Confirmation alert triage, Cancelling a Booking — Confirmation alert triage, Onboarding a New Property — Confirmation alert triage, Portfolio KPI review — Confirmation alert triage, Manual block hygiene — Confirmation alert triage, Entering Monthly Utility Bills — Confirmation alert triage, Resetting a Management User Password — Confirmation alert triage, Using in-app support — Confirmation alert triage.

Invoiced floor (rent)

Pair with other FAQ hub sections

Invoiced-floor blocks pair with Rent reduction after invoicing hub (workflow mesh), Bulk Hostkit invoicing hub (Issue credit notes Hostkit pacing after external rent relief), Month-end invoicing (fixed date) hub (fixed Invoice date before first Issue allocation), Credit note warning (reject/revert) hub (receipt cleanup — distinct from rent edit blocks), Bookings, Payments & Finance, and Lower rent below invoiced. Hub parity: Glossary — Invoiced floor (rent) hub · Common Workflows — Rent reduction after invoicing. Full pairing matrix: FAQ section cross-reference.

SurfaceModal behaviourBest for
Contract Info → Change monthly rentMonths below exported totals clamp (blue Already invoiced months banner)Portfolio-wide repricing (bookings-detail-change-monthly-rent-modal.png)
Contract Values → Edit amountSave disabled when net below invoiced+draft totalsPer-line net edit (bookings-detail-contract-values-invoiced-floor-edit-amount.png)
Finance → Transactions Not issued credit noteBulk Issue credit notes (N) after external rent reliefPost-accounting queue (finance-transactions-bulk-selection-bar.png)
SymptomLikely causeFix
Month saves at invoiced amount, not your lower entryInvoiced floor on exported monthChange monthly rent — other months still save at your amount
Save disabled under New net amountNet below invoiced+draft on lineExternal credit notes first
Need goodwill below exported rentAccounting alignment ruleIssue credit notes outside Vivin — then Issue credit notes (N)
Hostkit batch Pending on TransactionsHostkit API pacingFloor unrelated — check booking modals first
Red/blue banner on Reject / RevertReceipt cleanup — not rent floorCredit note warning (reject/revert) hub
Repricing after equal-month inferenceFixed rent on variable unitFAQ — Fixed rent on variable unit

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

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

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

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

Rent reduction after invoicing

Pair with other FAQ hub sections

Invoiced-floor blocks pair with Bulk Hostkit invoicing hub (Issue credit notes Hostkit pacing after external rent relief — finance-transactions-bulk-selection-bar.png), Month-end invoicing (fixed date) hub (fixed Invoice date before first Issue allocation), Invoiced floor (rent) hub (definition + modal surfaces), Bookings, Payments & Finance (month-end repricing), and Reject/revert mistaken receipts (credit note follow-up on invoiced ledger rows). Hub parity: Glossary — Rent reduction after invoicing hub · Common Workflows — Rent reduction after invoicing · Glossary — Invoiced floor (rent) hub. Full pairing matrix: FAQ section cross-reference.

SymptomSurfaceFix
Month saves at invoiced amount, not your lower entryContract Info → Change monthly rentBlue Already invoiced months banner — clamped months keep exported totals; other months save at your amount (bookings-detail-change-monthly-rent-modal.png)
Save disabled under New net amountContract Values → Edit amountRed inline validation — net would drop below invoiced+draft totals on that line (bookings-detail-contract-values-invoiced-floor-edit-amount.png)
Need goodwill discount below exported rentExternal accountingIssue credit notes or manual adjustments — Vivin will not persist lower nets on exported months
Hostkit Not issued credit note after rent reliefExternal credit note registered in VivinIssue credit notes (N) — same pacing as Bulk Hostkit invoicing (finance-transactions-bulk-selection-bar.png)
Repricing after equal-month inference on variable unitChange monthly rent reopenSame floor applies — pair FAQ — Fixed rent on variable unit
Batch stays Pending on TransactionsHostkit pacingFloor unrelated — check booking modals; Refresh Transactions before duplicate Hostkit run
Support ticket cites blocked rent cut below exported monthSelf-serve modal check skippedUsing in-app support — Rent reduction after invoicing before New Support Ticket modal
Lockout-delayed month-end repricing on live bookingsPassword recovery delayed repricingResetting a Management User Password — Step 3Contract Info → Change monthly rent (bookings-rent-reduction-invoiced-floor-flow.mp4)

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

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

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

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

Directory list load failures

Pair with other FAQ hub sections
Walkthrough: whole-module Bookings list Retry vs tab-scoped Communication Refresh while Payment Plan still loads.

Fixed invoice date reminder

Pair with other FAQ hub sections

Amber banner surfaces pair with Month-end invoicing (fixed date) hub (save fixed Invoice date → bulk export → reset toggle), Bulk Hostkit invoicing hub (same toolbar beside Issue allocation), Hostkit hub, Payments & Finance, and Portfolio KPI review — Step 7. Hub parity: Glossary — Fixed invoice date reminder hub · Common Workflows — Month-end invoicing (fixed date). Full pairing matrix: FAQ section cross-reference.

SurfaceBanner layoutBest for
Finance → Transactions inline stripFull-width above searchConfirm saved date before filtering (finance-transactions-fixed-invoice-date-banner.png)
Finance → Transactions bulk toolbarCompact beside Issue allocationMonth-end bulk export (finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png)
Transaction detail sidebarCompact above allocationsSingle-row Invoice selected (finance-transaction-detail-fixed-invoice-date-banner.png)
Settings → InvoicingToggle off + date pickerSource of truth — no banner until saved (settings-invoicing-invoice-date-toggle.png)
SymptomLikely causeFix
No amber banner on TransactionsUse today still on or date unsavedSave fixed date in Invoicing, reload Transactions
Banner shows wrong dateStale sessionRe-save Invoice date in Invoicing, hard-refresh Transactions
Bulk toolbar banner missingNo allocatable rows selectedTick rows with Pending / Failed invoicing
Issued invoices show wrong document dateFixed date still active after batchMonth-end invoicing (fixed date) hub — turn Use today back on
Bulk Pending with banner visibleHostkit API pacingBulk Hostkit invoicing hub — not a banner bug

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

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

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

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

Month-end invoicing (fixed date)

Pair with other FAQ hub sections

Fixed document-date batches pair with Fixed invoice date reminder hub (amber banner surfaces on Finance → Transactions), Bulk Hostkit invoicing hub (same Transactions bulk toolbar + Hostkit pacing), Payments & Finance, and month-end Portfolio KPI review — Step 7. Hub parity: Glossary — Month-end invoicing (fixed date) hub · Common Workflows — Month-end invoicing (fixed date) · Glossary — Fixed invoice date reminder hub. Full pairing matrix: FAQ section cross-reference.

| Symptom | Fix | | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Wrong document date on issued invoices | Turn Use today as invoice date back on after batch — Invoicing — Default invoice date (finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png) | | No amber banner on Transactions | Save fixed date with toggle off, reload Transactions (finance-transactions-fixed-invoice-date-banner.png) | | Bulk Pending for minutes | Hostkit pacing — not a date issue; see Bulk Hostkit invoicing hub (finance-transactions-bulk-selection-bar.png) | | Forgot to reset after month-end | Turn Use today as invoice date back on in Settings → Invoicing — next day's invoices otherwise use the saved fixed date (settings-invoicing-invoice-date-toggle.png) | | Month-end export blocked by Pending mesh | Confirmation or duplicate transfers still pending | Pending manual receipt approval — finish Pending mesh on workflow Step 6b before Issue allocation | | Lockout-delayed month-end export backlog | Password recovery delayed bulk export | Resetting a Management User Password — Step 3 → save fixed date → Finance → Transactions bulk toolbar | | Support ticket cites wrong document date | Self-serve toggle check skipped | Using in-app support — Month-end invoicing (fixed date) before New Support Ticket modal |

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

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

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

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

Hostkit

Pair with other FAQ hub sections

Hostkit setup pairs with Bulk Hostkit invoicing hub (month-end Issue allocation pacing), Month-end invoicing (fixed date) hub (fixed Invoice date before bulk export), Credit note warning (reject/revert) hub (Not issued credit note queue after invoiced Reject / Revert), Payments & Finance, and Integrations & Distribution. Hub parity: Glossary — Hostkit hub · Common Workflows — Bulk Hostkit invoicing. Full pairing matrix: FAQ section cross-reference.

SurfaceSetup / retrieval behaviourBest for
Integrations → Hostkit → Listing keysServer search + ~20-row infinite scroll; per-row SavePer-listing API keys before first export
Invoicing → Hostkit invoice seriesRequired FR code from Hostkit Faturação → SériesAccount-wide series before document create
Finance → Transactions bulk toolbarIssue allocation / Invoice selected; Issue credit notes (N)Month-end export (finance-transactions-bulk-selection-bar.png)
Finance → Transactions allocation rowsee invoice opens Hostkit permalinkPost-export PDF retrieval
Booking → Files tabInvoice_ PDF tilesTenant-facing document copy
SymptomLikely causeFix
Hostkit invoice series is not configured toastBlank FR seriesSave exact series — settings-invoicing-hostkit-series.png
Rows stay Failed after refreshMissing Listing keysIntegrations → Hostkit → Listing keys — search unit, paste key, Save
see invoice disabled or 404Series typo or wrong {series}/{id}Match Invoicing series to live Hostkit FR code
Batch stays Pending for minutesHostkit API pacingBulk Hostkit invoicing hubrefresh Transactions before re-issue
Not issued credit note after Reject / RevertInvoiced charge reversed in VivinIssue credit notes (N) — same Hostkit pacing
Wrong document date on issued invoicesFixed Invoice date still activeMonth-end invoicing (fixed date) hub

Account Settings Invoicing — Hostkit invoice series (FR) field

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

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

Bulk Hostkit invoicing

Pair with other FAQ hub sections

Bulk Hostkit pacing pairs with Hostkit hub (setup surfaces + Listing keys / FR series), Glossary — Hostkit hub, Month-end invoicing (fixed date) hub (fixed Invoice date before bulk export — finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png), Rent reduction after invoicing hub (invoiced floor → external credit notes → Issue credit notesbookings-rent-reduction-invoiced-floor-flow.mp4), Reject/revert mistaken receipts hub (Not issued credit note queue after month-end Reject / Revert), Payments & Finance, Integrations & Distribution, and month-end Portfolio KPI review — Step 7. Hub parity: Glossary — Bulk Hostkit invoicing hub · Common Workflows — Bulk Hostkit invoicing. Full pairing matrix: FAQ section cross-reference.

| Symptom | Fix | | -------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Rows stay Pending / Failed for several minutes | Hostkit rate limit — Vivin paces per listing key — leave batch running; refresh Transactions before duplicate Issue allocation (finance-transactions-bulk-selection-bar.png) | | Same rows still Failed after refresh | Missing Listing keys or blank Hostkit invoice seriesIntegrations — Hostkit + Invoicing — Hostkit series (settings-invoicing-hostkit-series.png) | | Hostkit invoice series is not configured toast | Series field empty on account | Save the exact FR code from Hostkit Faturação → Séries | | Wrong document date on issued invoices | Fixed Invoice date still active | Month-end invoicing hub — turn Use today back on after batch (finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png) | | Not issued credit note queue after Reject / Revert | Invoiced charge reversed in Vivin | Issue credit notes (N) — same Hostkit pacing as Issue allocationReject/revert mistaken receipts | | Change monthly rent clamped below exported total | Invoiced floor — not Hostkit slowness | Rent reduction after invoicing — external credit note first (bookings-rent-reduction-invoiced-floor-flow.mp4) | | Month-end export blocked by Pending receipts | Duplicate or confirmation transfers still pending | Pending manual receipt approval — finish Pending mesh on workflow Step 6b before Issue allocation | | Support ticket cites slow Hostkit batch | Self-serve pacing before escalation | FAQ — Bulk Hostkit invoicing slowUsing in-app support — New Support Ticket modal only after refresh + series/keys check | | Lockout-delayed month-end Issue allocation backlog | Password recovery delayed bulk export | Resetting a Management User Password — Step 3Finance → Transactions bulk toolbar |

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

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

Account Settings Invoicing — Hostkit invoice series (FR) field

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

Notification row-click navigation

Pair with other FAQ hub sections

Row-click navigation pairs with WhatsApp per-booking messaging hub (message alerts → Inbox / Communication), Notifications & alerts, Bookings (sidebar opened from alerts), and Payments & Finance (payment overdue → Transactions). Hub parity: Notification row-click navigation hub · Glossary — Notification row navigation hub · Common Workflows — Notification row-click navigation. Full pairing matrix: FAQ section cross-reference.

Wrong tenant on a booking

Pair with other FAQ hub sections

Wrong-profile questions pair with Cancel Booking vs Delete Booking hub (duplicate import row → Delete, not Change tenant), Bookings, Processing a New Booking hub (Step 1 import check, Step 6 confirmation), and FAQ — Wrong tenant on a booking hub. Hub parity: Common Workflows — Wrong tenant on a booking. Full pairing matrix: FAQ section cross-reference.

Cancel Booking vs Delete Booking

Pair with other FAQ hub sections

Cancel vs Delete pairs with Wrong tenant on a booking hub (Change tenant when profile link is wrong), Portfolio retirement decisions hub (building Archive vs reservation actions), Bookings, and FAQ — Cancel Booking vs Delete Booking. Hub parity: Common Workflows — Cancel Booking vs Delete Booking. Full pairing matrix: FAQ section cross-reference.

Same-day turnover coordination

Pair with other FAQ hub sections
SymptomFix
Incoming guest waiting but unit not readyManaging a Check-out — Step 2 turnover ticket before Managing a Check-in — Step 4 (operations-add-ticket-modal.png)
Same unit shows two bookings on Timeline Week scaleBookings — Timeline view — paste unit in toolbar Search (bookings-timeline-day-week-month-and-sidebar.mp4)
Outgoing tenant still In Debt on Payment PlanHandling a Late Payment — Step 1Check-out collections before refund before incoming key handover
Keys handed before outgoing checkout EndedManaging a Check-in — Step 4 only after outgoing Managing a Check-out — Step 7
Turnover ticket shows Draft far from due dateOperations → Tickets — assign tight due date before incoming arrival
Arrival/access alert before turnover ticket doneNotification triage — Step 4 row-click before bulk mark-read
Multicalendar gap on turnover daySales — Multicalendar Week scale overlap check
Lockout-delayed turnover catch-upResetting a Management User Password — Step 3Operations → Check-in & Check-out
Turnover coordination blocked after self-serve checksUsing in-app support — New Support Ticket modal — not tenant notify-landlord
Final utilities not posted before deposit release on turnover dayCheck-out final utilities handoff — outgoing Step 6 before incoming Step 4

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

New inventory to first booking handoff

Pair with other FAQ hub sections

First-reservation questions pair with Setup sequence after go-live (steps 13–15 + Onboarding — Step 7), Processing a New Booking hub (Steps 1–6), Property setup to first arrival handoff (downstream arrival week), and Confirmation alert triage hub (first Booking created alerts). Hub parity: Common Workflows — New inventory to first booking handoff. Full pairing matrix: FAQ section cross-reference.

Property setup to first arrival handoff

Pair with other FAQ hub sections

First-arrival questions pair with New inventory to first booking handoff (upstream property wizard → first reservation), Managing a Check-in hub (Steps 1–4), Confirmation to check-in handoff (portal gates after first booking), and FAQ — Automatic check-in email. Hub parity: Common Workflows — Property setup to first arrival handoff. Full pairing matrix: FAQ section cross-reference.

Confirmation to check-in handoff

Pair with other FAQ hub sections
SymptomFix
Started Managing a Check-in — Step 1 weeks before move-inFinish Processing a New Booking — Step 6 portal gates first — arrival-week planning ~7 days out (booking-lifecycle-status-tabs-flow.mp4)
Tenant Portal Copy / Impersonate Tenant blockedProcessing a New Booking — Step 6 — contract + Tenant category; file support only after checklist (bookings-detail-contract-method-of-payments.png)
Contract not signed on Upcoming importStep 4Step 5 before Managing a Check-in — Step 4
Confirmation bank transfer still PendingProcessing a New Booking — Step 5b — distinct from move-in Step 3b (finance-transactions-pending-pill.png)
Move-in week but unpaid Payment Plan pillsHandling a Late Payment — Step 1 before Managing a Check-in — Step 4
Tenant category wrong on portalProcessing a New Booking — Step 2 / Tenant InfoGlossary — Tenant category
Deposit only partly collectedPartly collected security deposit — deposit shortfall vs rent Partial Paid on Payment Plan
Month-end lingering Pending on confirmation importsProcessing a New Booking — Step 6b during Portfolio KPI review — Step 7
Operations → Check-in & Check-out empty ~7 days outConfirm Upcoming portal gates on Step 6 — then scan Next 7 days (workflows-operations-check-in-out-planning-view.png)
Lockout-delayed Upcoming backlogResetting a Management User Password — Step 3 catch-up → Confirmation alert triage hub before handoff

Per-guide mesh: Processing a New Booking — Confirmation to check-in handoff, Managing a Check-in — Confirmation to check-in handoff, Notification triage — Confirmation to check-in handoff, Handling a Late Payment — Confirmation to check-in handoff, Cancelling a Booking — Confirmation to check-in handoff, Managing a Check-out — Confirmation to check-in handoff, Onboarding a New Property — Confirmation to check-in handoff, Portfolio KPI review — Confirmation to check-in handoff, Manual block hygiene — Confirmation to check-in handoff, Entering Monthly Utility Bills — Confirmation to check-in handoff, Resetting a Management User Password — Confirmation to check-in handoff, Using in-app support — Confirmation to check-in handoff.

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

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

Check-in to check-out handoff

Pair with other FAQ hub sections

Mid-stay handoff pairs with Managing a Check-in hub (upstream Step 4), Managing a Check-out hub (downstream Steps 1–7), Same-day turnover coordination (shared-unit one-day overlap), and Check-out final utilities handoff (final overages before refund). Hub parity: Check-in to check-out handoff · Glossary — Check-in to check-out handoff hub · Common Workflows — Check-in to check-out handoff. Full pairing matrix: FAQ section cross-reference.

SymptomFix
Started Managing a Check-out — Step 1 weeks before departureFinish Managing a Check-in — Step 4 first — departure-week planning ~7 days before checkout (operations-check-in-out-check-outs-next-7-days.png)
Still running check-in prep on Ongoing stayStep 5 confirms Ongoing — then scan Check-outs pill
Operations → Check-in & Check-out empty ~7 days outSwitch to Check-outs pill + Next 7 days — not Check-ins (operations-check-in-out-check-outs-next-7-days.png)
payment overdue on Ongoing stay at bellHandling a Late Payment — Step 1 before Managing a Check-out — Step 5
Deposit only partly collected at move-inPartly collected security deposit — deposit shortfall vs rent Partial Paid
Same-day turnover on shared unitSame-day turnover coordination — outgoing Step 2 before incoming Step 4
Booking still Ongoing after departure dayManaging a Check-out — Step 7 — not more check-in prep
Month-end Ongoing entering departure weekPortfolio KPI review — Step 7Check-outs pill
Lockout-delayed departure-week planningResetting a Management User Password — Step 3 catch-up → hub Lockout catch-up after password recovery

Per-guide mesh: Processing a New Booking — Check-in to check-out handoff, Managing a Check-in — Check-in to check-out handoff, Managing a Check-out — Check-in to check-out handoff, Notification triage — Check-in to check-out handoff, Handling a Late Payment — Check-in to check-out handoff, Cancelling a Booking — Check-in to check-out handoff, Onboarding a New Property — Check-in to check-out handoff, Portfolio KPI review — Check-in to check-out handoff, Manual block hygiene — Check-in to check-out handoff, Entering Monthly Utility Bills — Check-in to check-out handoff, Resetting a Management User Password — Check-in to check-out handoff, Using in-app support — Check-in to check-out handoff.

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

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

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

Hub matrix: Common Workflows — Check-in to check-out handoff · Check-in to check-out handoff · Glossary — Check-in to check-out handoff hub (operations-check-in-out-check-outs-next-7-days.png, bookings-timeline-view.png, check-in-to-check-out-handoff-flow.mp4).

Check-out final utilities handoff

Pair with other FAQ hub sections

Departure-week utility settlement pairs with Entering Monthly Utility Bills hub (Steps 2–4 posting), Managing a Check-out hub (Step 6 before Step 5), Utility overage collections (mid-stay overage arrears — distinct mesh), Pending manual receipt approval hub (Step 4b / Step 6bfinance-transactions-pending-pill.png), Reject/revert mistaken receipts hub (duplicate overage transfers on Step 4bfinance-transactions-bulk-reject-selected-bar.png), and Same-day turnover coordination (outgoing Step 6 before incoming Step 4). Hub parity: Glossary — Check-out final utilities handoff hub · Common Workflows — Check-out final utilities handoff · Utility overage collections. Full pairing matrix: FAQ section cross-reference.

SymptomSurfaceFix
Final utility overage unpaid on Payment PlanBooking Payment PlanStep 4Step 6 (bookings-detail-payment-plan-tab-schedule.png)
Ready To Refund blocked by overageBooking Deposit tabStep 4Step 1Step 6 (bookings-detail-deposit-tab-ready-to-refund-toggle.png)
Overage paid but Ready To Refund greyedBooking TransactionsStep 4bStep 6b (finance-transactions-pending-pill.png)
End of Booking — overage not visible yetCharge Time settingGlossary — End-of-Booking cost splitStep 7 then re-check Step 6
Month-end Missing bills on departing unitsUtilities → Bills Missing toggleStep 5Portfolio KPI review — Step 7 (utilities-bills-tab-missing-toggle.png)
Rent + utility both block Ready To RefundBooking Payment PlanUtility overage collections (utility line) · Check-out collections before refund (rent/fee lines)
Same-day turnover blocked by outgoing overageOperations → Check-in & Check-outOutgoing Step 6 before incoming Step 4 — hub: Same-day turnover coordination
Departure-week utility payment overdue alert/notifications row-clickStep 4Step 4Step 6
Support ticket cites final overage blocking Ready To RefundSelf-serve triage skippedUsing in-app support — Check-out final utilities handoff before New Support Ticket modal

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

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

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

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

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

Check-out collections before refund

Pair with other FAQ hub sections

Departure-week rent/fee arrears pair with Managing a Check-out hub (Step 6 before Step 5), Handling a Late Payment hub (collections Steps 1–4), Pending manual receipt approval hub (Step 6b departure receipts — finance-transactions-pending-pill.png), Reject/revert mistaken receipts hub (duplicate departure transfers — finance-transactions-bulk-reject-selected-bar.png), Check-out final utilities handoff (utility overage lines — distinct mesh), Check-out ledger cleanup before refund (tenant paid once — Revert duplicate, not collections), and Same-day turnover coordination (outgoing Step 6 before incoming Step 4). Hub parity: Glossary — Check-out collections before refund hub · Common Workflows — Check-out collections before refund · Check-out final utilities handoff · Check-out ledger cleanup before refund. Full pairing matrix: FAQ section cross-reference.

SymptomSurfaceFix
Ready To Refund greyed / In Debt on rentBooking Payment PlanStep 1Step 4Step 6 (bookings-detail-payment-plan-tab-schedule.png)
Ready To Refund blocked on Deposit tabBooking Deposit tabStep 6 after collections — bookings-detail-deposit-tab-ready-to-refund-toggle.png
Tenant paid once, balance still UnpaidBooking TransactionsCheck-out ledger cleanup before refundRevert duplicate
Unpaid line is utility overageBooking Payment PlanCheck-out final utilities handoff — not rent collections mesh
Departure transfer still PendingBooking TransactionsPending manual receipt approval hubStep 6b (finance-transactions-pending-pill.png)
Shortfall is deposit collection, not rentFinance → DepositsPartly collected security deposit hubPartial paid card
Portfolio Top debtors shows departure arrearsFinance → Contract ValuesStep 1In Debt filter (finance-contract-values-in-debt-filter.png)
Rent + utility both block Ready To RefundBooking Payment PlanUtility overage collections (utility line) · Check-out collections before refund (rent/fee lines)
Same-day turnover blocked by outgoing arrearsOperations → Check-in & Check-outOutgoing Step 6 before incoming Step 4 — hub: Same-day turnover coordination
Departure-week payment overdue alert/notifications row-clickStep 4Step 1Step 6
Support ticket cites Ready To Refund blocked by arrearsSelf-serve triage skippedUsing in-app support — Check-out collections before refund before New Support Ticket modal

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

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

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

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

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

Check-out ledger cleanup before refund

Pair with other FAQ hub sections

Duplicate-transfer cleanup pairs with Reject/revert mistaken receipts hub (Revert approved duplicate before collections — bookings-detail-transactions-revert-modal-info-banner.png, bookings-payment-row-actions-flow.mp4), Managing a Check-out hub (Step 6 / Step 6bfinance-transactions-bulk-reject-selected-bar.png), Pending manual receipt approval hub (duplicate Pending vs approved duplicate — finance-transactions-pending-pill.png), Bulk Hostkit invoicing hub (Issue credit notes after invoiced Reject / Revert), Check-out collections before refund (real rent/fee arrears — not ledger cleanup), and Check-out final utilities handoff (unpaid utility overage line — distinct mesh). Hub parity: Glossary — Check-out ledger cleanup before refund hub · Common Workflows — Check-out ledger cleanup before refund · Reject/revert mistaken receipts hub · Check-out collections before refund. Full pairing matrix: FAQ section cross-reference.

SymptomSurfaceLikely wrong pathFix
Ready To Refund blocked despite tenant paidBooking Deposit tabHandling a Late Payment — Step 3 outreachTransactionsRevert duplicate — Reject/revert mistaken receipts hub
In Debt after tenant paid departure rentBooking TransactionsCollections outreachRevert duplicate — not Step 3 until ledger clean
Top debtors still high after tenant paidFinance → Contract ValuesReal arrears collectionsCheck-out collections before refund — confirm duplicate pair on Transactions
Two identical transfers, one PendingFinance → TransactionsRevert on approved rowPending manual receipt approval hubReject pending duplicate first
Two identical transfers, both approvedBooking TransactionsCollections Step 3Revert payment on duplicate — Reject/revert mistaken receipts hub
Est. Refund inflated by duplicateBooking Deposit tabExternal bank transfer anywayRevert duplicate before Step 5
Red / blue modal after Reject / RevertBooking TransactionsSkip credit-note queueIssue credit notesBulk Hostkit invoicing hub pacing
Unpaid rent line on Payment PlanBooking Payment PlanLedger cleanup meshCheck-out collections before refund — tenant has not paid
Utility overage shows UnpaidBooking Payment PlanLedger cleanup meshCheck-out final utilities handoff — unpaid overage line, not duplicate transfer
Duplicate Pending manual in-payment during departure week/notifications row-clickApprove both rowsStep 4Reject selected
Support ticket — tenant paid but Ready To Refund blockedSelf-serve triage skippedFile ticket firstUsing in-app support — Check-out ledger cleanup before refund

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

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

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

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

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

Cancellation collections before void

Pair with other FAQ hub sections

Pre-cancel rent/fee arrears pair with Cancelling a Booking hub (Step 2 before Step 4bookings-cancel-booking-modal-refund-types.png, workflows-cancel-booking-refund-modal-flow.mp4), Handling a Late Payment hub (collections Steps 1–4 — finance-contract-values-in-debt-filter.png), Check-out vs cancellation (policy void → Canceled vs completed stay → Ended), Pending manual receipt approval hub (Step 2a settlement receipts — finance-transactions-pending-pill.png, bookings-detail-transactions-approve-payment-modal.png), Reject/revert mistaken receipts hub (duplicate settlement transfers on Step 2), Check-out collections before refund (departure-week mesh — not pre-cancel void), and Check-out ledger cleanup before refund (duplicate settlement transfer during Step 2 — tenant paid once). Hub parity: Glossary — Cancellation collections before void hub · Common Workflows — Cancellation collections before void. Full pairing matrix: FAQ section cross-reference.

SymptomSurfaceLikely wrong pathFix
Cancel booking blocked by In DebtBooking Contract InfoManaging a Check-out departure meshCancelling a Booking — Step 2 — policy void, not Ended stay
Unpaid rent/fee line on Payment PlanBooking Payment PlanCancel booking without settlementSteps 1–4Step 2 before Step 4
Top debtors still high before void queueFinance → Contract ValuesBatch Cancel booking without triageFinance debt receivables triage hub — filter In Debt before void
Unpaid utility overage on Canceled stayBooking Payment PlanRent pre-cancel meshEntering Monthly Utility Bills — Step 4 + Handling a Late Payment — Step 1
Settlement receipt Pending at cancelBooking TransactionsCollections Step 3Step 2a / Pending manual receipt approval hub
Tenant paid once, balance still UnpaidBooking TransactionsCollections outreachCheck-out ledger cleanup before refundRevert duplicate during Step 2
Tenant backs out before arrivalBooking Payment PlanDeparture-week Step 6Managing a Check-in hub move-in arrears → Cancelling a Booking — Step 4
Pre-cancel payment overdue alert on Upcoming stay/notifications row-clickBulk mark-read before triageStep 4Step 1Step 2
Support ticket cites In Debt blocking Cancel bookingSelf-serve triage skippedFile ticket firstUsing in-app support — Cancellation collections before void
Lockout-delayed pre-cancel collections backlogPassword recovery delayed triageCancel booking without catch-upResetting a Management User Password — Step 3Step 2
Month-end pre-cancel arrears at KPI sign-offFinance → Contract ValuesPolicy void batch with open In DebtPortfolio KPI review — Step 7 — settle before void queue

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

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

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

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

Walkthrough: settle Payment Plan arrears on Cancelling a Booking — Step 2, then open Contract InfoCancel booking and review refund types on Step 4 (clip closes without confirming).

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

Walkthrough: triage pre-cancel arrears on Finance → Contract Values (In Debt filter), confirm Payment Plan and Communication on the booking, then open Cancel booking refund types on Contract Info (clip closes without confirming).

Deposit lifecycle status

Pair with other FAQ hub sections

Deposit-lifecycle vocabulary pairs with Payments & Finance, Partly collected security deposit (Partial Paid shortfall), Deposit dispute hub (Disputed freeze), Deposit missing on Finance Deposits (lifecycle card counts scoped to toolbar date range), Managing a Check-out hub (Step 5 Ready to RefundRefunded), Cancelling a Booking hub (Step 3), and Check-out collections before refund (rent In Debt blocks Ready To Refund). Hub parity: Glossary — Deposit lifecycle status hub · Common Workflows — Deposit lifecycle status. Full pairing matrix: FAQ section cross-reference.

SymptomLikely wrong pathFix
Lifecycle pill Partial Paid but rent line also amberRent Payment Plan vs depositOpen booking Deposit tab — security deposit shortfall — Partly collected security deposit
Partial paid lifecycle card shows zero rowsToolbar date range excludes the stayDeposit missing on Finance Deposits — clear range first
Ready To Refund toggle disabled at departureRent/fee arrears on Payment PlanCheck-out collections before refund — not deposit shortfall alone
Refund / Mark refunded greyed on Deposit tabActive Disputed freezeDeposit dispute hubResolve Dispute after internal review
Pill stuck on Fully Paid at check-outReady To Refund step requiredManaging a Check-out — Step 5 — toggle Ready To Refund
Month-end KPI finds wrong lifecycle mixCard counts scoped to date windowPortfolio KPI review — Step 7 — clear toolbar range first
Deposit shortfall at confirmation or move-inDeparture inspection meshProcessing a New Booking — Step 5 / Managing a Check-in — Step 3
Partially paid badge or lifecycle pill defectsProduct defect after self-serve triageUsing in-app support — Deposit lifecycle statusFinance module ticket

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

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

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

Walkthrough: Finance → Deposits Deposit lifecycle status cards — portfolio triage across Ready to refund, Refunded, and Not paid with row-open to booking Deposit tab.
Walkthrough: toggle Ready To Refund on the booking Deposit tab, then Mark refunded on Finance → Deposits after the external bank transfer.

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

Deposit dispute

Pair with other FAQ hub sections

Contested deposit retention pairs with Managing a Check-out hub (Step 5deposit-dispute-mark-and-resolve-flow.mp4), Cancelling a Booking hub (Step 3), Partly collected security deposit (deposit shortfall vs dispute freeze), Deposit missing on Finance Deposits (toolbar date range hides dispute row chips), Check-out collections before refund (rent In Debt vs dispute freeze), and Check-out vs cancellation (Ended vs Canceled deposit paths). Hub parity: Glossary — Deposit dispute hub. Full pairing matrix: FAQ section cross-reference.

SymptomSurfaceLikely wrong pathFix
Refund / Mark refunded greyed on Deposit tabBooking Deposit tabCheck-out collections before refund rent meshResolve Dispute after internal review — Step 5
Mark as Disputed missing on booking Deposit tabBooking Deposit tabPartly collected shortfall meshEnable deposit disputes + bookings.dispute on role
Mark disputed chip missing on Finance → DepositsFinance → Deposits toolbarAssuming no deposit recordDeposit missing on Finance Depositsclear date range first
Deposit not Fully Paid yetBooking Deposit tab lifecycle pillDispute freeze on partial collectionPartly collected security deposit — collect shortfall first
Tenant contests retention during cancellationBooking Deposit tab on CanceledManaging a Check-out hub departure meshCancelling a Booking — Step 3Mark as Disputed before Mark refunded
Ready To Refund blocked despite settled chargesBooking Deposit tabRent In Debt on Payment PlanResolve Dispute — not Check-out collections before refund
Month-end KPI finds contested refundsFinance → Deposits Disputed cardBulk Mark refunded without reviewPortfolio KPI review — Step 7Disputed filter
Tenant WhatsApp contest before operator actionInbox threadChat reassurance without ledger checkOpen booking Deposit tab — confirm Disputed state before reply
Lockout-delayed dispute backlogPassword recovery delayed triageMark refunded without catch-upResetting a Management User Password — Step 3Finance → Deposits Disputed filter
Support ticket — refund blocked by disputeSelf-serve triage skippedFile ticket firstManaging a Check-out — Step 5 before filing

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

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

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

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

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

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

Utility overage collections

Pair with other FAQ hub sections

Utility overage arrears pair with Entering Monthly Utility Bills hub (upstream Steps 2–4), Handling a Late Payment hub (collections Steps 1–4), Check-out final utilities handoff (departure-week subset), Pending manual receipt approval hub (Step 4b overage receipts — finance-transactions-pending-pill.png), Reject/revert mistaken receipts hub (duplicate overage transfers — finance-transactions-bulk-reject-selected-bar.png), and Utilities (module reference). Hub parity: Glossary — Utility overage collections hub · Common Workflows — Utility overage collections · Check-out final utilities handoff. Full pairing matrix: FAQ section cross-reference.

SymptomSurfaceFix
In Debt includes utility-type line on Contract ValuesFinance → Contract Values In Debt filterStep 4Step 1 (finance-contract-values-in-debt-filter.png)
Payment overdue alert after monthly bill cycle/notifications row-clickStep 4 before Step 1 (notifications-row-navigate-to-booking-detail.png)
Overage line not on Payment Plan yetUtilities → AllocationsStep 2Step 4 — not collections until charge posts (utilities-allocations-row-breakdown-expanded.png)
Overage receipt still Pending at month-endFinance → Transactions / booking TransactionsStep 4b (bookings-detail-transactions-approve-payment-modal.png, finance-transactions-pending-pill.png)
Tenant insists they paid — duplicate on ledgerBooking TransactionsReject/revert mistaken receipts hubReject while pending / Revert after Approve on Step 4b
End of Booking — line not visible yetCharge Time settingGlossary — End-of-Booking cost split — wait until Managing a Check-out — Step 7
Rent line mistaken for utility overageBooking Payment PlanCheck-out collections before refund — rent In Debt contrast, not utility mesh alone
Support ticket cites utility overage on Payment PlanSelf-serve triage skippedUsing in-app support — Utility overage collections before New Support Ticket modal
Lockout-delayed overage payment overdue backlogPassword recovery delayed triageResetting a Management User Password — Step 3Step 4 (utilities-allocations-review-flow.mp4)

Utilities Allocations — expanded row breakdown showing tenant overage per stay

Finance Contract Values — In Debt filter highlighting utility overage lines

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

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

Check-out vs cancellation

Pair with other FAQ hub sections

Lifecycle exit questions pair with Managing a Check-out hub (completed stay → Ended), Cancelling a Booking hub (policy void → Canceled), Cancel Booking vs Delete Booking hub (real void vs mistaken row), Check-out collections before refund (departure-week arrears on Ended path), Cancellation collections before void (pre-cancel arrears on Canceled path), and Portfolio retirement decisions hub (Archive vs reservation actions). Hub parity: Common Workflows — Check-out vs cancellation · Glossary — Check-out vs cancellation hub. Full pairing matrix: FAQ section cross-reference.

SymptomLikely wrong pathFix
Guest never moved in but operator ran check-out flowManaging a Check-out EndedCancelling a Booking — Step 4Canceled filter
Mid-stay policy void but operator used EndedStep 7 on voided stayCancelling a Booking — Step 4 — hub: Check-out vs cancellation
Completed stay but Cancel booking was usedCanceled filter + refund dialogManaging a Check-out — Step 7Ended status
Mistaken Add booking / training duplicateCancel booking or check-outDelete BookingCancel Booking vs Delete Booking
Ready To Refund blocked on policy voidCheck-out collections before refund meshCancellation collections before voidStep 2 before Step 4
Utility overage on Canceled stayManaging a Check-out — Step 6Entering Monthly Utility Bills — Step 4

Portfolio retirement decisions

Pair with other FAQ hub sections

Portfolio retirement pairs with Cancel Booking vs Delete Booking hub (reservation void vs soft-archive — workflows-cancel-booking-refund-modal-flow.mp4), Properties & Listings, Bookings, and Payments & Finance (ledger visibility after soft-archive #1897). Hub parity: Common Workflows — Portfolio retirement decisions. Full pairing matrix: FAQ section cross-reference.

Deposit missing on Finance Deposits

Pair with other FAQ hub sections

Missing deposit rows pair with Payments & Finance, Why do I not see a deposit on Finance Deposits?, Partly collected security deposit (Partial paid card empty until range clears), Lockout catch-up after password recovery (older move-outs missed during lockout), Processing a New Booking hub (Step 5 confirmation deposit triage), Managing a Check-in hub (Step 3 move-in deposit triage), Managing a Check-out hub (Step 5 refund triage), Handling a Late Payment hub (widen range before deposit vs rent Partial Paid at Step 1), Cancelling a Booking hub (Step 3 deposit settlement when row is hidden), and Check-out collections before refund (rent arrears — not date-range hiding). Hub parity: Deposit missing on Finance Deposits hub · Common Workflows — Deposit missing on Finance Deposits · Glossary — Deposit missing on Finance Deposits hub · Glossary — Finance Deposits date range hub. Full pairing matrix: FAQ section cross-reference.

SymptomLikely causeFix
Row on booking Deposit but missing on Finance → DepositsDefault ~3 months toolbar date rangeClear date range selection or widen from / to, then Search (finance-deposits-date-range-clear-flow.mp4)
Mark disputed / Resolve dispute chips missingDispute actions only render on visible rowsClear or widen toolbar range before portfolio dispute triage
Lifecycle card counts look too lowCards scope to the active date windowClear range before month-end deposit sign-off — Portfolio KPI review — Step 7
Partial paid card empty but booking Deposit shows shortfallRange excludes the stay — not “no shortfalls”Clear range first, then Partly collected security deposit
Older move-outs surfaced during lockout catch-upDelayed refund/dispute triageLockout catch-up after password recoveryClear toolbar range before Partial paid card

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

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

Walkthrough: open Finance → Deposits with the default toolbar range, click Clear date range selection, then review the widened portfolio table.
Walkthrough: booking Deposit tab shows deposit data → Finance → Deposits default toolbar range with tenant search (row hidden) → Clear date range selection → portfolio row appears.

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

Partly collected security deposit

Pair with other FAQ hub sections

Deposit shortfalls pair with Payments & Finance, How do I find bookings where the security deposit is only partly collected?, Deposit missing on Finance Deposits (Partial paid card empty until toolbar range clears), Deposit dispute hub (shortfall vs dispute freeze contrast), Handling a Late Payment hub (deposit vs rent Partial Paid at Step 1), Processing a New Booking hub (confirmation shortfall after Step 5), Managing a Check-in hub (chase remaining before Step 4), Cancelling a Booking hub (settlement math on shortfall deposits at Step 2 / Step 3), and Managing a Check-out hub (Ready To Refund blocked until Fully Paid). Hub parity: Glossary — Partly collected security deposit hub. Full pairing matrix: FAQ section cross-reference.

SymptomLikely wrong pathFix
Amber badge on Payment Plan rent lineRent collections meshOpen booking Deposit tab — security deposit, not scheduled rent
Partial paid lifecycle card shows zero rowsToolbar date range excludes the stayDeposit missing on Finance Deposits — clear range first
Ready To Refund toggle disabled at departureRent/fee arrears on Payment PlanCheck-out collections before refund — not deposit shortfall alone
Deposit shortfall at move-inDeparture inspection meshManaging a Check-in — Step 3 — chase remaining before key handover
Partially paid badge or partial filter wrongProduct defect after self-serve triageUsing in-app support — Partly collected security depositFinance module ticket

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

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

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

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

Key glossary terms

Pair with other FAQ hub sections

Concepts & integrations

Pair with other FAQ hub sections

Concept escalations pair with API Reference for partner HTTP (distinct from Vivin support tickets). Tenant-facing issues: Tenant Portal + FAQ — Tenant Portal & Mobile App. External AI: Landlord MCP vs Tenant MCP. Full pairing matrix: FAQ section cross-reference.

Settings that shape troubleshooting

Pair with other FAQ hub sections

Self-serve workflows

Pair with other FAQ hub sections

Deeper workflow reads

Pair with other FAQ hub sections

Module documentation hubs

Pair with other FAQ hub sections