Processing a New Booking
Run this workflow only after Getting Started — Recommended Setup Sequence steps 1–12 and steps 13–14 (Listings inventory + Bookings module readiness) — channel imports need Settings → Integrations from setup step 12. First property on a new workspace: complete Onboarding a New Property and Step 7 — Verify in Listings first — hub matrix: Common Workflows — New inventory to first booking handoff. Lockout catch-up: Getting Started — Lockout catch-up after password recovery. Workflow pairing: Common Workflows — Setup sequence after go-live.
Start with Step 1 — Check if the booking was auto-imported for channel rows, then Step 2 / Step 3 for payment timing. Contract and confirmation: Step 4 → Step 5; month-end Pending mesh: Step 5b / Step 6b. Portal gates: Step 6. Non-linear operator habits (Lockout catch-up, Payment alert to receivables triage, Pending manual receipt approval, Reject/revert mistaken receipts, Month-end invoicing (fixed date), Bulk Hostkit invoicing, Utility overage collections, Check-out final utilities handoff, Check-in to check-out handoff, Check-out collections before refund, Check-out ledger cleanup before refund, Finance debt receivables triage, Handling a Late Payment collections, Cancellation collections before void, Rent reduction after invoicing, Same-day turnover coordination, Occupancy KPI to block hygiene handoff, Deposit missing on Finance Deposits, Partly collected security deposit, Wrong tenant on a booking, Cancel Booking vs Delete Booking, Portfolio retirement decisions, Directory list load failures, Booking sidebar tab load failures, Confirmation alert triage, Portfolio segmentation by tenant category) have matching Related subsections below. Full pairing matrix: Processing a New Booking section cross-reference · Common Workflows section cross-reference.
This workflow covers creating a booking from enquiry to confirmation — whether the booking comes from an external platform or directly.
After confirmation, continue with Managing a Check-in; when move-in or confirmation charges stay unpaid, pair with Handling a Late Payment. During month-end Step 6b, pair Portfolio KPI review — Step 7 with AI usage API (landlord_chat) when duplicate-import triage leaned on AI Chat. Step-to-module pairing: Processing a New Booking section cross-reference. Full pairing matrix: Common Workflows — Workflow cross-reference.
Before processing a booking, ensure:
- The property and unit exist in the Listings module
- The property's contract settings are configured (payment frequency, confirmation/check-in payments) — see Creating a New Property
- If the booking is from an external platform, the platform is connected in Settings > Integrations
Step 1 — Check if the booking was auto-imported.
Import duplicate checks pair with Common Workflows — New inventory to first booking handoff (upstream Onboarding — Step 7 on first property), Settings > Integrations, Bookings — Timeline, and Landlord MCP / Tenant MCP overlap reads before you create-booking. Downstream: Step 4 when a match exists. Full pairing matrix: Processing a New Booking section cross-reference.
If the booking originated from a connected platform (Airbnb, Booking.com, Channex, etc.), Vivin may have already imported it automatically. Before you create a duplicate:
- Open Bookings and search by tenant name, email, or contract dates in the toolbar.
- Optionally open Other filters and set Source platform to the channel you expect (for example Airbnb, Booking.com, or Channex) so the list only shows imported rows from that integration.
- Confirm the row shows the expected platform badge on the booking card or table row. If a matching reservation already exists, skip to Step 4 (contract) or Step 5 (payments) as appropriate.
When the extra row is a mistaken Add booking or training duplicate with no real stay, use Delete Booking on Contract Info → Check-in & Check-out instead of Cancel booking — see FAQ — Cancel Booking vs Delete Booking. Clear any provider platform in-payment first (#2076). Delete hides manual ledger lines on Finance → Transactions while keeping vIBAN / credit card (#1897). When the row is valid but linked to the wrong tenant profile, use Change tenant instead — Common Workflows — Wrong tenant on a booking.
Airbnb / Booking.com calendar feeds can import short-term blocks that appear on Operations > Check-in & Check-out and unit Calendars without a full mid-term booking row. If you only see a channel-labelled pseudo departure (for example Booking.com Reservation), you may still need a manual booking for contract and payment-plan work — see Glossary — Short-term iCal pseudo check-in/out.
When channel paperwork lists a fiscal ID (NIF) instead of a room code, open Tenants and paste that value in toolbar Search — the directory matches fiscal and identification IDs without re-ranking; open the tenant profile and jump to the linked booking from there. See Tenants — Interface overview.
When several bookings match your search text, the Bookings list ranks unit / listing name hits above tenant name or email — paste the internal room code (for example AA-11-5D-R2) to surface the channel import for that unit first. See Bookings — Search bar and Glossary — Directory search ranking.
After you confirm contract dates, switch to Bookings → Timeline (/bookings/timeline) and paste the unit internal name in toolbar Search — coloured bars show whether another stay or a calendar block already covers the window. Use Week or Month scale when a departure and arrival share one calendar day (same-day turnover). Clear Only bookings when you need manual or channel blocks on the same unit row. For Sales-scoped availability without rent cells, compare Sales → Multicalendar. Portfolio-wide manual holds: Tools → Audit (Manual block hygiene). FAQ: How do I handle same-day turnovers?.


Account-scoped Landlord MCP list-bookings and get-booking surface the same imported rows you search in Bookings — narrow by date range or tenant identifiers in your client before you create-booking manually. list-listings (thin GET /listings/options projection) resolves internal unit codes when channel paperwork lists a room name instead of a booking id — then get-booking or toolbar Search on the matching import. When you need a visual overlap check before creating a duplicate, get-listing includes unavailabilities (manual and channel blocks) and get-listing-calendar mirrors Bookings → Timeline reads — pair with get-property when several units on one building share similar names. Booking-scoped Tenant MCP list-bookings-by-email helps when channel paperwork only lists a guest email; get-listing-calendar is the tenant-facing read when guests ask about blocked dates on a suspected duplicate import. Portfolio-wide duplicate scans stay on Landlord MCP. Surface-choice contrast: Automation & AI — Workflow pairing for surface choice.
Full pairing matrix: Processing a New Booking section cross-reference.
Step 2 — Create the booking manually (direct bookings only).
Manual creation pairs with Create New menu — Booking, Settings > Tenant categories (assign Category before Step 4), and create-booking on Landlord MCP. Upstream: Step 1 when no channel import exists. Full pairing matrix: Processing a New Booking section cross-reference.
From any management screen, open + Create New > Booking (same entry point as in Listings). Fill in:

- Select the property and unit
- Enter tenant details (name, email, phone, nationality)
- Set the contract start date and move-in date
- Confirm the platform as "Direct"
Account-scoped Landlord MCP create-booking mirrors + Create New → Booking (POST /bookings) — it does not set tenant category; assign Category on Tenant Info or use create-tenant / update-tenant before contract mail, same as the management UI habit below.
The Add booking wizard does not set tenant category — the segment lives on the tenant profile (Tenant Info). When you pick an existing tenant, open Tenants and confirm Category matches the portal modules and Communication Rules audience you intend. When the person is not in the list yet, use + Create New → Tenant first (optional category in that modal) or assign category on Tenant Info after creation, before Step 4 sends contract or onboarding mail — channel imports may auto-assign the default for integrations category; direct bookings do not. Mirror segment checks on Bookings → Other filters Tenant → Tenant category or Tenants — Tenant category filter — see Glossary — Tenant category and FAQ — Finance tenant category filter parity. Month-end segment checks: Finance — Tenant category filter.
See Creating a New Booking for detailed field descriptions.
When the property has automatic check-in/out tickets on Listings — Maintenances tab, turn off Use unit contract rents and other contract details on the rent step to reveal Create check-in ticket / Create check-out ticket. Uncheck to skip automatic ticket creation for this reservation only — see Glossary — Per-booking maintenance ticket opt-out and FAQ — Skip automatic check-in/out tickets for one booking.
Full pairing matrix: Processing a New Booking section cross-reference.
Before you send the contract or share booking-engine links, confirm descriptions, amenities, rules, photos, and bilingual blocks for the property and unit match what you want tenants and channels to see. Open the Full integration pill in the Listings sidebars for the full Property Details / Listing Details layer — see Property & listing details (booking engine) and Deep Links — query params for bookmarkable URLs.
Step 3 — Review confirmation timing and the payment schedule.
Payment-schedule review pairs with Payment Allocation, Finance — Contract Values, and tenant-facing get-payment-info on Tenant MCP before Step 4 contract mail. Full pairing matrix: Processing a New Booking section cross-reference.
After creation, open the booking sidebar and check Contract Info → Booking information first:
- Read Confirmation payments and Check-in payments — they show which charges are due at booking confirmation versus move-in (for example Deposit and first rent at confirmation and Last rent at check-in).
- If the split does not match what you agreed with the tenant, click the pencil, adjust the dropdowns (overlapping options are disabled so deposit and first rent are not double-assigned), then Update. Saving recomputes due dates on requirement-flagged lines — confirm the result on Payment plan and in Contract Info → Timeline.

Then open the Payment Plan tab. Verify the automatically generated charges match what was agreed — correct amounts, due dates (aligned with the confirmation/move-in split above), and payment types (deposit, first rent, etc.). On a variable unit, if every contract month in the span shares one € amount, Contract Info may already show a fixed headline rent — the listing stays variable for future stays. See Fixed rent on a variable unit and FAQ — Fixed rent on variable unit.
Account-scoped Landlord MCP get-booking returns the same confirmation/check-in payment split and scheduled charge rows you review on Contract Info and Payment Plan — pair with get-listing-pricing-table when a variable unit’s generated rent looks off versus the unit’s configured ranges. Booking-scoped Tenant MCP get-payment-info is the tenant-facing read when external assistants answer “what do I owe at confirmation?” before you send Step 4 contract mail — portfolio-wide Contract Values sanity checks stay on Landlord MCP or the management UI.
If Communication or Tickets shows a load error while Contract Info or Payment Plan work, use Refresh or Retry on that tab without closing the booking — see Glossary — Booking detail sidebar tab load failures.
For portfolio-wide sanity checks across several new imports, open Finance > Contract Values with Other filters scoped to the property you just onboarded — see Finance — Property and listing filters.

Full pairing matrix: Processing a New Booking section cross-reference.
If anything is wrong, correct it now before the tenant receives communications. The payment schedule is generated based on the property's contract settings at the time of booking creation — changes to property settings afterward will not affect this booking.
Step 4 — Send the contract.
Contract delivery pairs with Tenant Portal — Digital contract signing, Preferences — Mandatory for contract signing (portal gates before signature), Settings > Contract templates, FAQ — Tenant contract signing blocked (when the wizard stalls), and lifecycle mail in Settings > Emails. Upstream: Step 3 payment split. Downstream: Step 5 when confirmation charges are due. Full pairing matrix: Processing a New Booking section cross-reference.
Open the booking sidebar and select the Contract Info tab (labeled Contract in some locales). Download the generated contract PDF, send it to the tenant via your preferred method (email, DocuSign, etc.), and upload the signed copy back to the same tab when it returns — the upload marks the booking as contract signed.
Account-scoped Landlord MCP upload-booking-contract can push an unsigned PDF to Contract Info — it may clear a previous signed file; treat as sensitive and prefer operator upload when portal signing is in flight. Digital signatures through the Tenant Portal still run the four-step Sign contract wizard; MCP upload does not replace portal gates in Preferences — Mandatory for contract signing.
When tenants sign through the Tenant Portal, confirm Preferences — Mandatory for contract signing matches your compliance needs (each Your Details field you require — name, phone, ID, fiscal data, IBAN, and related metadata) before you chase missing paperwork — illustrated toggles: settings-preferences-tenant-portal-contract-signing-required.png; see FAQ — Tenant contract signing blocked when the portal wizard stalls. The portal runs a four-step Sign contract wizard (Your Details → Billing → Review → Sign); asterisk labels mirror your mandatory toggles. A portal signature can immediately satisfy After contract signed (and combined paid+signed) check-in triggers when move-in requirements are already met — uploading a signed PDF on Contract Info does not (see FAQ — automatic check-in email); use Send Check-in email after manual upload. Automated onboarding and other nudges are configured separately under Settings > Emails — Communication Rules and Booking lifecycle emails.

Full pairing matrix: Processing a New Booking section cross-reference.
Step 5 — Record the confirmation payment.
Confirmation receipts pair with Finance > Add Payment, Payment Allocation, and create-manual-payment-in on Landlord MCP — pending until Step 5b. Full pairing matrix: Processing a New Booking section cross-reference.
When the tenant makes the confirmation payment (deposit, first rent, or whichever was configured), record it in one of two ways:
Account-scoped Landlord MCP create-manual-payment-in records bank transfers the same way + Transaction / Finance → Add Payment do — receipts may stay pending until Approve payments (Step 5b); confirm allocation with list-payments / get-payment when external clients triage before move-in.
- From the booking's Transactions tab — click + Transaction to open the Add Payment modal (see screenshot in the Bookings module)
- From Finance > Add Payment — select the booking and enter payment details

The system allocates the payment to the correct scheduled charge based on your payment priorities. See Payment allocation — Recording an incoming payment for the same flow from Finance → Add Payment.
When the tenant pays less than the full deposit (or confirmation bundle) in one transfer, Vivin may mark the deposit line Partially paid with a remaining helper on the booking Deposit tab (Partial Paid on depositStatus — see Glossary — Deposit lifecycle status). Triage those reservations portfolio-wide on Finance → Deposits — click Partial paid in the Deposit lifecycle status row — then open a row to chase the shortfall before move-in. See FAQ — Partly collected security deposit and Glossary — Deposit lifecycle status.
Manual confirmation payments may remain pending until a user with Approve payments acts on Finance → Transactions or the booking Transactions tab. Until then, move-in requirements can still read as unpaid — triage Pending rows on the ledger before handover (the Overview Manual Payments KPI is not an approval-queue indicator). See Finance — Pending manual payments.
Full pairing matrix: Processing a New Booking section cross-reference.
Step 5b — Approve confirmation receipts (when required)
Pending confirmation receipts pair with Finance — Pending manual payments, Handling a Late Payment — Step 4b (same approval habit), and Notification triage — Step 5 after balances settle. Upstream: Step 5. Full pairing matrix: Processing a New Booking section cross-reference.
Account-scoped Landlord MCP list-payments / get-payment surface the same Pending ledger rows you approve below — pair with get-booking when a Payment received alert from Notification triage — Step 4 already supplied the reservation id, or with list-bookings when several Upcoming imports on one property recorded confirmation transfers the same week. Receipts you entered in Step 5 via create-manual-payment-in follow the same pending queue. External clients cannot Approve payment or Reject selected from MCP; operators finish on Finance → Transactions or the booking Transactions tab.
Booking-scoped Tenant MCP get-payment-info helps tenant-facing assistants explain why a recorded transfer still shows unpaid until approval completes — it does not approve receipts or change Payment Plan requirement pills. list-bookings-by-email resolves the booking id when a WhatsApp or email thread only shows the guest address after they claim they paid confirmation charges; pair with Notification triage — Step 4 when Inbox preceded the alert. get-portal-links remains the right read when the tenant asks whether portal access is live while receipts stay pending (Step 6). notify-landlord alerts your team when a guest reports a bank transfer through a chatbot — it does not replace operator approval below. For Vivin product defects (permissions, integration scope, or MCP credential failures), file Using in-app support instead of routing tenant automation here. Surface-choice contrast: Automation & AI — Workflow pairing for surface choice.
When you recorded a bank transfer after Step 5 but Payment Plan still shows confirmation requirements as unpaid — or a Payment received alert from Notification triage — Step 4 still shows a stale balance — follow the same approval habit as Handling a Late Payment — Step 4b and Managing a Check-in — Step 3b before Managing a Check-in. During month-end, the same Pending pill queue appears in Portfolio KPI review — Step 7 when Total Debt or Manual Payments disagree with Analytics:
- Open Finance → Transactions (widen the date range if needed) or the booking Transactions tab and confirm Pending rows exist when you expect a manual approval queue.
- On the ledger, click the amber Pending chip on the All type-summary card (or use the Pending status filter) — see Finance — Pending manual payments (
finance-transactions-pending-pill.png). - Locate the manual row in the filtered table.
- Click Approve payment (per-row check icon) or tick several rows and use Approve selected from the floating bar. For a mistaken duplicate on the ledger, use Reject selected (bulk-only on Finance — no per-row reject icon there). Reject selected shows the same red credit note warning as booking Transactions when accounting may already have invoiced the charge — see Finance — Reject payment and Bookings — Transactions row actions.
- Re-open Payment Plan — confirmation and move-in requirement pills should flip to Paid once allocations apply.



Full pairing matrix: Processing a New Booking section cross-reference.
Step 6 — Confirm the booking status is correct.
Post-confirmation checks pair with Common Workflows — Confirmation alert triage (upstream Notification triage — Step 4 → Step 5b before Step 5; notifications-row-navigation-flow.mp4, bookings-detail-transactions-approve-payment-modal.png), Common Workflows — Confirmation to check-in handoff (Step 6 → Managing a Check-in — Step 1 decision table; bookings-detail-contract-method-of-payments.png, booking-lifecycle-status-tabs-flow.mp4, workflows-operations-check-in-out-planning-view.png), FAQ — Processing a New Booking hub, Booking Lifecycle, and get-portal-links on Tenant MCP. Unpaid charges: Handling a Late Payment — Step 1 before you hand off to arrival week. Full pairing matrix: Processing a New Booking section cross-reference.
Verify the booking is Upcoming (upcoming) if its start/check-in date is in the future, or Ongoing (current) if the start/check-in date is today. There is no pending booking status in the implemented model.
If the booking points at the wrong existing tenant (duplicate email or NIF in the account, or a picker mistake) and the stay is still Upcoming with no signed contract and check-in in the future, use Contract Info → Change tenant instead of editing the current tenant’s master record or Delete Booking. That reassigns the reservation to another tenant already in your account without rebuilding the payment plan or moving historical transactions — see Change tenant (reassign booking) and Common Workflows — Wrong tenant on a booking. Contrast duplicate-row cleanup: Cancel Booking vs Delete Booking.
The Tenant Portal access is now active. Tenants can request an email access link from the portal entry screen, or use a direct portal URL with booking credentials (id, and usually code) from onboarding/check-in communications.
Booking-scoped Tenant MCP get-portal-links surfaces the same self-service URLs Tenant Portal → Copy exposes under Contract Info — pair with get-booking-status when tenants ask whether portal access is live. Account-scoped Landlord MCP get-booking is the portfolio read when your automation already knows the booking ID.
On the booking Contract Info tab, use:
- Resend Onboarding email (under Check-in & Check-out) when the tenant did not receive portal or contract material.
- Tenant Portal → Copy or Impersonate Tenant (under Method of payments) to verify what the tenant sees before move-in.


See Bookings module — Contract Info for the full tab reference.
Finish Step 5b and Resend Onboarding email before you open a Vivin support ticket — portal activation and status reads are operator workflows when confirmation receipts are approved. Self-serve first when confirmation is live but other workflows still need attention:
- Unpaid confirmation or move-in charges on Payment Plan after Step 5b → Handling a Late Payment — Step 1 before you hand over to Managing a Check-in.
- Booking created or Payment received alerts on
/notificationsafter the reservation is Upcoming → clear unread rows in Notification triage — Step 5; at month-end when Pending receipts still lag, continue Step 6b and Portfolio KPI review — Step 7. - Timeline or Multicalendar overlap from Step 1 still shows stale manual holds → Manual block hygiene — Step 4 before you escalate portal defects.
- First reservation on newly onboarded property → verify Onboarding a New Property — Step 7 (Access Lockers, Multicalendar, first-booking alerts) before you escalate portal or Nuki defects.
- Move-in week approaching but portal modules still hidden after Impersonate Tenant → continue Managing a Check-in — Step 6 when Category on Tenant Info is already correct.
File Using in-app support when product behaviour blocks onboarding despite correct operator steps:
- Tenant Portal → Copy or Impersonate Tenant fails while Contract Info loads — attach the booking id and your user email on the New Support Ticket modal (Bookings module).
- Portal Contract or VIVIN payments modules stay hidden despite the correct Category on Tenant Info — attach the category name and a sample booking id (Settings or Bookings module).
- Change tenant missing when the criteria in the tip above are met — attach both tenant profile ids (Bookings module).
- Landlord MCP or Tenant MCP external clients return persistent 403 / auth errors after you refreshed the management JWT — see Using in-app support — When to use in-app support, Landlord MCP — Permissions and safety, and Resetting a Management User Password — Troubleshooting.
Use the Help & Support drawer from Bookings when screenshots should include Contract Info — Deep Links — Support. Pair with Notification triage — Step 6 when booking-created alerts row-click to the wrong entity. If a management lockout delayed portal verification, recover access with Resetting a Management User Password (Step 3) before you rerun Step 5b and Resend Onboarding email — refresh Landlord MCP Bearer JWT after Step 3 there; catch up booking-created and payment alerts in Notification triage — Step 4 and Step 5 (file Step 6 when row-click fails); on newly onboarded inventory, rerun Onboarding a New Property — Step 7 when Access Lockers or Multicalendar defects persist; finish Entering Monthly Utility Bills — Step 5 when the first bill cycle lagged during lockout (escalate extraction via Step 6).
Booking-scoped Tenant MCP get-portal-links and get-booking-status help external assistants confirm portal access before you file support — notify-landlord alerts your team when tenants report missing portal links through a chatbot; it does not replace operator Resend Onboarding email or a Vivin support ticket for integration defects. Account-scoped Landlord MCP get-booking, list-tenants, and get-tenant resolve fiscal-ID paperwork before you escalate wrong-tenant links. Surface-choice contrast: Automation & AI — Workflow pairing for surface choice.
Next step: When the move-in date approaches, follow the Managing a Check-in workflow.
Full pairing matrix: Processing a New Booking section cross-reference.
Step 6b — Approve lingering confirmation receipts (when required)
Month-end Pending mesh pairs with Portfolio KPI review — Step 7, Handling a Late Payment — Step 6b, and Managing a Check-in — Step 6b on the same ledger queue. Upstream: Step 5b. Full pairing matrix: Processing a New Booking section cross-reference.
At month-end when confirmation-week bank transfers still show Pending on Finance → Transactions but Payment Plan on Upcoming imports still lists confirmation requirements as unpaid — follow Step 5b and the same approval habit in Portfolio KPI review — Step 7, Managing a Check-in — Step 6b, Handling a Late Payment — Step 4b, and Handling a Late Payment — Step 6 (segment-wide arrears after month-end KPI review):
- Open Finance → Transactions (widen the date range to include confirmation week) or the booking Transactions tab.
- Click the amber Pending chip on the All type-summary card (or use the Pending status filter) — see Finance — Pending manual payments (
finance-transactions-pending-pill.png). - Locate confirmation requirement rows tied to Upcoming imports you confirmed in Step 6.
- Click Approve payment (per-row check icon) or tick several rows and use Approve selected from the floating bar. For a mistaken duplicate, use Reject selected (bulk-only on Finance) — same red credit note warning as Step 5b.
- Re-open Payment Plan — confirmation requirement pills should flip to Paid once allocations apply; clear related Payment received rows on
/notificationsin Notification triage — Step 5 before you hand over to Managing a Check-in.
Approve payments and ledger Reject selected are operator workflows — finish Step 6 and Step 5b before you open a Vivin support ticket. File Using in-app support when Approve payment is missing for your role, Pending rows persist after approval, or Landlord MCP / Tenant MCP clients return persistent 403 after you refreshed the management JWT — see Resetting a Management User Password — Troubleshooting. If a management lockout delayed month-end confirmation approval, recover access with Resetting a Management User Password (Step 3) before you rerun this step — refresh Landlord MCP Bearer JWT after Step 3 there; catch up payment alerts in Notification triage — Step 5 (file Step 6 when row-click fails); pair with Managing a Check-in — Step 6b, Managing a Check-out — Step 6b, Entering Monthly Utility Bills — Step 4b, and Portfolio KPI review — Step 7 on the same Pending queue.
Account-scoped Landlord MCP list-payments / get-payment and list-bookings surface the same Pending ledger rows you approve in Step 5b — external clients cannot Approve payment or Reject selected from MCP; operators finish on Finance → Transactions or the booking Transactions tab. Booking-scoped Tenant MCP get-payment-info helps tenant-facing assistants explain why a recorded transfer still shows unpaid until approval completes.
Full pairing matrix: Processing a New Booking section cross-reference.
Processing a New Booking section cross-reference
Use this table when one step in this workflow naturally leads into another module, concept page, or downstream workflow — each row links to the docs you should read before or after that step.
| Workflow step / section | Pair with these docs |
| ---------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Step 1 — Check if the booking was auto-imported | Settings > Integrations — Channex, API Reference — Creating Bookings, Tenants — Interface overview, Bookings — Timeline view, Glossary — Short-term iCal pseudo check-in/out, Manual block hygiene (get-listing unavailabilities when overlap checks find stale holds), Automation & AI — Workflow pairing for surface choice, Landlord MCP — Bookings, properties, and listings (list-listings, get-listing with unavailabilities, get-listing-calendar, get-property), Landlord MCP — Extended account tools (list-bookings, get-booking), Tenant MCP — Booking and contract data (list-bookings-by-email, get-listing-calendar; contrast with portfolio-wide Landlord reads) |
| Step 2 — Create the booking manually | Create New menu — Booking, Create New menu — Tenant, Tenants — Tenant Info, Tenants — Tenant category filter, Bookings — Other filters, Settings > Tenant categories, Glossary — Tenant category, Listings module, Booking engine details, Onboarding a New Property, FAQ — Assign tenant category for direct booking, FAQ — Finance tenant category filter parity, Landlord MCP — Bookings, properties, and listings (create-booking; follow-through with create-tenant / update-tenant and Tenant Info category) |
| Step 3 — Review confirmation timing and the payment schedule | Payment Allocation, Finance — Contract Values, Settings > Tenant categories, Bookings — Payment Plan tab, Finance — Tenant category filter (month-end segment checks after assignment), Landlord MCP — Bookings, properties, and listings (get-booking; get-listing-pricing-table on variable units), Tenant MCP — Property, payments, and portal tools (get-payment-info for tenant-facing confirmation balances) |
| Step 4 — Send the contract | Tenant Portal — Digital contract signing, Settings > Preferences — Mandatory for contract signing, Settings > Emails, Settings > Contract templates, Landlord MCP — Bookings, properties, and listings (upload-booking-contract; sensitive write — portal signing remains operator/tenant UI) |
| Step 5 — Record the confirmation payment | Payment Allocation — Recording an incoming payment, Finance > Add Payment, Bookings — Transactions tab, Landlord MCP — Extended account tools (create-manual-payment-in, list-payments, get-payment; pending until Step 5b) |
| Step 5b — Approve confirmation receipts | Notification triage — Step 4, Notification triage — Step 5, Handling a Late Payment — Step 4b, Managing a Check-in — Step 3b, Portfolio KPI review — Step 7, Finance — Pending manual payments, Finance > Transactions — Row actions, Payment Allocation — Correcting mistaken receipts, Glossary — Pending manual in-payment (Finance), Glossary — Credit note (payment reject/revert), FAQ — Manual receipt still pending, Managing a Check-in, Using in-app support (MCP scope or permission defects), Automation & AI — Workflow pairing for surface choice, Landlord MCP — Extended account tools (list-payments, get-payment, get-booking, list-bookings; approval remains operator UI), Tenant MCP — Booking and contract data (list-bookings-by-email when Inbox threads preceded payment alerts), Tenant MCP — Property, payments, and portal tools (get-payment-info, get-portal-links while receipts stay pending; notify-landlord for tenant-channel “I paid” escalations) |
| Step 6 — Confirm the booking status is correct | Booking Lifecycle, Managing a Check-in (downstream when move-in date approaches), Managing a Check-in — Step 6 (arrival-week portal gates), Onboarding a New Property — Step 7 (first reservation on newly onboarded inventory), Tenant MCP, Notification triage — Step 4 (booking-created alert row-click), Notification triage — Step 5 (booking-created alerts after confirmation), Notification triage — Step 6 (row-click to wrong entity), Using in-app support, Using in-app support — New Support Ticket modal, Resetting a Management User Password — Step 3 (lockout-delayed portal verification catch-up; refresh Landlord MCP JWT, then catch up Notification triage — Step 4 / Step 5 / Step 6 and Entering Monthly Utility Bills — Step 5 / Step 6), Resetting a Management User Password — Troubleshooting (MCP 403 after JWT refresh), Handling a Late Payment — Step 1 (unpaid confirmation or move-in charges), Manual block hygiene — Step 4 (Timeline overlap from Step 1), Step 6b — Approve lingering confirmation receipts (month-end Pending mesh), Portfolio KPI review — Step 7 (month-end Total Debt after confirmation week), Notifications — Payment overdue alerts, Bookings — Change tenant (reassign booking), Tenant Portal — Portal access by tenant category, Automation & AI — Workflow pairing for surface choice, Tenant MCP — Property, payments, and portal tools (get-portal-links, get-booking-status, notify-landlord), Landlord MCP — Bookings, properties, and listings (get-booking, list-tenants, get-tenant), Landlord MCP — Permissions and safety |
| Step 6b — Approve lingering confirmation receipts | Step 5b — Approve confirmation receipts, Portfolio KPI review — Step 7, Managing a Check-in — Step 6b, Managing a Check-out — Step 6b, Cancelling a Booking — Step 6b, Entering Monthly Utility Bills — Step 4b, Handling a Late Payment — Step 4b, Handling a Late Payment — Step 6, Handling a Late Payment — Step 6b (collections Pending mesh), Notification triage — Step 5, Notification triage — Step 6, Using in-app support (When to use in-app support), Resetting a Management User Password — Step 3 (lockout-delayed month-end catch-up; refresh Landlord MCP JWT; pair Notification triage — Step 6 when row-click fails), Resetting a Management User Password — Troubleshooting, Finance — Pending manual payments, Finance > Transactions — Row actions, Glossary — Pending manual in-payment (Finance), Landlord MCP — Extended account tools (list-payments, get-payment, list-bookings; approval remains operator UI), Tenant MCP — Property, payments, and portal tools (get-payment-info while receipts stay pending) |
| Lockout catch-up after password recovery | Sign-in restored; portal or confirmation approval delayed | Common Workflows — Lockout catch-up, Getting Started — Lockout catch-up, Resetting a Management User Password — Step 3, Step 6, Step 6b |
| Pending manual receipt approval | Confirmation receipts still pending until Approve payments | Common Workflows — Pending manual receipt approval, Step 5b, Step 6b, Finance — Pending manual payments |
| Reject/revert mistaken receipts | Duplicate confirmation bank transfers | Common Workflows — Reject/revert mistaken receipts, Payment Allocation — Correcting mistaken receipts, Step 5b |
| Same-day turnover coordination | Timeline overlap on shared unit — not duplicate import | Common Workflows — Same-day turnover coordination, Step 1 — Check if the booking was auto-imported, FAQ — Same-day turnovers (operations-add-ticket-modal.png, bookings-timeline-day-week-month-and-sidebar.mp4) |
| Occupancy KPI to block hygiene handoff | Timeline overlap from stale manual holds on Step 1 | Common Workflows — Occupancy KPI to block hygiene handoff, Step 1 — Check if the booking was auto-imported, FAQ — Analytics (KPI workspace) (analytics-kpi-occupancy-tab.png, audit-manual-blocks-filter-scroll.mp4) |
| Deposit missing on Finance Deposits | Confirmation Deposit tab shows data but Finance row is missing | Common Workflows — Deposit missing on Finance Deposits, Step 5 — Record the confirmation payment, FAQ — Deposit missing on Finance Deposits (finance-deposits-date-range-toolbar-default.png, finance-deposits-date-range-clear-flow.mp4) |
| Partly collected security deposit | Confirmation deposit shortfall after Step 5 | Common Workflows — Partly collected security deposit, Step 5, Finance — Deposits status summary cards, FAQ — Partly collected security deposit |
| Wrong tenant on a booking | Valid row linked to wrong profile — Change tenant on Step 6 | Common Workflows — Wrong tenant on a booking, Step 6 — Confirm the booking status is correct, FAQ — Wrong tenant on a booking (bookings-detail-change-tenant-control.png, bookings-detail-change-tenant-flow.mp4) |
| Cancel Booking vs Delete Booking | Duplicate import — Delete Booking not Cancel booking | Common Workflows — Cancel Booking vs Delete Booking, Step 1 — Check if the booking was auto-imported, FAQ — Cancel Booking vs Delete Booking (bookings-cancel-booking-modal-refund-types.png, bookings-list-canceled-tab.png, workflows-cancel-booking-refund-modal-flow.mp4) |
| Portfolio retirement decisions | Duplicate import cleanup — Delete Booking not building Archive | Common Workflows — Portfolio retirement decisions, Step 1 — Check if the booking was auto-imported, FAQ — Portfolio retirement decisions (listings-archived-populated-table.png, finance-transactions-type-summary-cards.png) |
| Directory list load failures | Bookings / /notifications fails before import triage | Common Workflows — Directory list load failures, Step 1 — Check if the booking was auto-imported, FAQ — Directory list load failures (notifications-module-load-failure.png, audit-manual-blocks-load-failure.png) |
| Booking sidebar tab load failures | Contract follow-up Communication thread will not load | Common Workflows — Booking sidebar tab load failures, Step 4 — Send the contract, FAQ — Communication or Tickets load failure (bookings-detail-communication-tab-whatsapp-thread.png, bookings-detail-tickets-tab.png) |
| Confirmation alert triage | Upcoming confirmation alert before bulk mark-read | Common Workflows — Confirmation alert triage, Step 5b — Approve confirmation receipts, FAQ — Processing a New Booking hub (notifications-row-navigate-to-booking-detail.png, bookings-detail-transactions-approve-payment-modal.png) |
| Portfolio segmentation by tenant category | Assign tenant category on direct bookings | Common Workflows — Portfolio segmentation, Settings > Tenant categories, Step 2 |
| Rent reduction after invoicing | Confirmation month already invoiced before schedule edit | Common Workflows — Rent reduction after invoicing, Step 3 — Review confirmation timing and the payment schedule, Glossary — Invoiced floor (rent) (bookings-detail-change-monthly-rent-modal.png, bookings-rent-reduction-invoiced-floor-flow.mp4) |
| Month-end invoicing (fixed date) | Confirmation Pending mesh at month-end before bulk export | Common Workflows — Month-end invoicing (fixed date), Step 6b — Approve lingering confirmation receipts, Portfolio KPI review — Month-end invoicing (fixed date) (settings-invoicing-invoice-date-toggle.png, finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png) |
| Bulk Hostkit invoicing | First-month Issue allocation after confirmation month-end mesh | Common Workflows — Bulk Hostkit invoicing, Step 6b — Approve lingering confirmation receipts, FAQ — Bulk Hostkit invoicing slow (finance-transactions-bulk-selection-bar.png, settings-invoicing-hostkit-series.png) |
| Utility overage collections | First Ongoing stay before first supplier bill cycle | Common Workflows — Utility overage collections, Step 6 — Confirm the booking status is correct, Entering Monthly Utility Bills — Step 4 (utilities-allocations-row-breakdown-expanded.png, utilities-allocations-review-flow.mp4) |
| Check-out final utilities handoff | First Ongoing stay before first departure final overages | Common Workflows — Check-out final utilities handoff, Step 6 — Confirm the booking status is correct, Managing a Check-out — Step 6 (utilities-allocations-review-flow.mp4, bookings-detail-payment-plan-tab-schedule.png) |
| Check-in to check-out handoff | Confirmed Ongoing after import needs departure planning | Common Workflows — Check-in to check-out handoff, Step 6 — Confirm the booking status is correct, Managing a Check-out — Step 1 (operations-check-in-out-check-outs-next-7-days.png, bookings-timeline-view.png) |
| Check-out collections before refund | Mid-stay rent arrears on first Ongoing import | Common Workflows — Check-out collections before refund, Step 6 — Confirm the booking status is correct, Managing a Check-out — Step 6 (workflows-check-out-coordination-flow.mp4, bookings-detail-payment-plan-tab-schedule.png, finance-contract-values-in-debt-filter.png) |
| Check-out ledger cleanup before refund | Duplicate confirmation transfer during Step 5b / Step 6b | Common Workflows — Check-out ledger cleanup before refund, Step 5b — Approve confirmation receipts when required, Managing a Check-out — Step 6 (bookings-detail-transactions-revert-modal-info-banner.png, finance-transactions-bulk-reject-selected-bar.png) |
| Payment alert to receivables triage | Upcoming vs Ongoing payment overdue on Step 5 / Step 6 | Common Workflows — Payment alert to receivables triage, Step 5 — Record the confirmation payment, Notification triage — Step 4 (notifications-row-navigate-to-booking-detail.png, notifications-row-navigation-flow.mp4) |
| Finance debt receivables triage | Unpaid confirmation charges on portfolio Top debtors | Common Workflows — Finance debt receivables triage, Step 5 — Record the confirmation payment, Common Workflows — Payment alert to receivables triage (finance-overview-income-chart-debt-aging.png, finance-overview-debt-aging-walkthrough-flow.mp4, finance-transactions-pending-pill.png) |
| Handling a Late Payment collections | Unpaid confirmation → collections Steps 1–4 on Step 5 / Step 6 |
| Finance Income status drill-down | Confirmation Income → In debt lines vs Top debtors on Steps 5–6 | Common Workflows — Finance Income status drill-down, Step 5 — Record the confirmation payment, Finance debt receivables triage (finance-overview-income-status-in-debt-modal.png, finance-overview-income-drill-down-flow.mp4) |
| Cash flow forecast drill-down | Confirmation collections on Cash flow forecast month bars on Steps 5–6 | Common Workflows — Cash flow forecast drill-down, Step 5 — Record the confirmation payment, Finance Income status drill-down (finance-overview-cash-flow-all-payments-modal.png, finance-overview-cash-flow-drill-down-flow.mp4) |
| Cancellation collections before void | Pre-cancel rent arrears on Upcoming import before policy void | Common Workflows — Cancellation collections before void, Step 6 — Confirm the booking status is correct, Cancelling a Booking — Step 2 (finance-contract-values-in-debt-filter.png, bookings-detail-transactions-approve-payment-modal.png, bookings-cancel-booking-modal-refund-types.png, workflows-cancel-booking-refund-modal-flow.mp4) |
Related
Related below links this workflow to modules, concepts, settings, and escalation paths. Pair Documentation map & escalation with Common Workflows hub — Documentation map & escalation; pair Upstream & downstream workflows with Common Workflows — Workflow cross-reference. Topic-to-section pairing in sections above: Processing a New Booking section cross-reference. Full hub matrix: Common Workflows section cross-reference.
Documentation map & escalation
Documentation-map bullets pair with Introduction — Section cross-reference and FAQ — Section cross-reference. Hub parity: Common Workflows hub — Documentation map & escalation. Full pairing matrix: Processing a New Booking section cross-reference · Common Workflows section cross-reference.
- Common Workflows — Hub pairing matrix across all operator guides
- Getting Started — Management shell before you run this workflow
- Glossary — Term definitions referenced in the steps above
- FAQ & Troubleshooting — Quick answers when a step does not match live product behaviour
- Get Help & Support — Escalate when permissions or account state block booking creation
Upstream & downstream workflows
Workflow bullets pair with Common Workflows — Workflow cross-reference for inter-guide step pairing. Full pairing matrix: Processing a New Booking section cross-reference · Common Workflows section cross-reference.
- Onboarding a New Property (section cross-reference; Deeper workflow reads; hub) — Property wizard and channel setup before the first reservation; Step 7 (section cross-reference; Deeper workflow reads; hub) when the first reservation lands on newly onboarded inventory (Step 6)
- Managing a Check-in (section cross-reference; Deeper workflow reads; hub) — Next workflow when the move-in date approaches (Step 6); Step 6 (section cross-reference; Deeper workflow reads; hub) when portal modules stay hidden into arrival week
- Managing a Check-out & Deposit Refund (section cross-reference; Deeper workflow reads; hub) — Downstream departure workflow after confirmation receipts are approved
- Handling a Late Payment — Step 1 (section cross-reference; Deeper workflow reads; hub) — When confirmation or move-in charges remain unpaid after creation
- Notification triage — Step 4 (section cross-reference; Deeper workflow reads; hub) — Row-click from booking-created alerts (Step 6)
- Notification triage — Step 5 (section cross-reference; Deeper workflow reads; hub) — Clear booking-created in-app alerts after the reservation is live (Step 6)
- Notifications — Payment overdue alerts — Operator Payments category rows when scheduled charges are overdue (Step 6)
- Manual block hygiene — Step 4 (section cross-reference; Deeper workflow reads; hub) — Audit pass when Timeline overlap checks reveal stale holds (Step 1, Step 6)
- Resetting a Management User Password (section cross-reference; Deeper workflow reads; hub) — Recover access when a lockout delayed portal verification (Step 6) or month-end confirmation approval (Step 6b); refresh Landlord MCP JWT after Step 3 (section cross-reference; Deeper workflow reads; hub), then catch up Notification triage — Step 4 (section cross-reference; Deeper workflow reads; hub) / Step 5 (section cross-reference; Deeper workflow reads; hub) / Step 6 (section cross-reference; Deeper workflow reads; hub) and Entering Monthly Utility Bills — Step 5 (section cross-reference; Deeper workflow reads; hub) / Step 4b (section cross-reference; Deeper workflow reads; hub)
- Notification triage (section cross-reference; Deeper workflow reads; hub) — Catch up unread booking-created and payment alerts after lockout (Step 4 (section cross-reference; Deeper workflow reads; hub), Step 5 (section cross-reference; Deeper workflow reads; hub); file Step 6 (section cross-reference; Deeper workflow reads; hub) when row-click fails)
- Portfolio KPI review — Step 6 (section cross-reference; Deeper workflow reads; hub) / Step 7 (section cross-reference; Deeper workflow reads; hub) — Month-end catch-up when lockout delayed confirmation-week Pending mesh (Step 6b)
- Managing a Check-in — Step 6 (section cross-reference; Deeper workflow reads; hub) / Step 6b (section cross-reference; Deeper workflow reads; hub) — Arrival-week portal gates after lockout-delayed confirmation (Step 6 downstream)
- Entering Monthly Utility Bills — Step 5 (section cross-reference; Deeper workflow reads; hub) / Step 4b (section cross-reference; Deeper workflow reads; hub) — First bill cycle and overage Pending mesh on new inventory after lockout-delayed confirmation (Step 6, Step 6b)
Navigation & bookmarks
Bookmark routes pair with Management Frontend Deep Links and Create New menu. Full pairing matrix: Processing a New Booking section cross-reference · Common Workflows section cross-reference.
- Create New menu — Booking — Manual reservation wizard when the enquiry did not arrive via a channel import
- Management Frontend Deep Links — Bookings — Bookmarkable routes into list, Timeline, and booking sidebars
Concepts & settings that shape this workflow
Concept and settings bullets pair with Concepts hub subsection index and Concept cross-reference and Account Settings — Tab cross-reference. Full pairing matrix: Processing a New Booking section cross-reference · Common Workflows section cross-reference.
- Booking Lifecycle — Status progression after the reservation is created (Upcoming → Ongoing → Ended) (section cross-reference; Deeper workflow reads; hub)
- Payment Allocation — How confirmation payments allocate to scheduled charges (section cross-reference; Deeper workflow reads; hub)
- Tenant MCP — Booking-scoped
get-portal-linksandget-booking-statuswhen portal access goes live (Step 6);list-bookings-by-emailandget-listing-calendarduring import duplicate checks (Step 1) and when Inbox threads preceded Payment received alerts (Step 5b);get-payment-infowhen tenants ask about confirmation balances before contract mail (Step 3) or while receipts stay pending (Step 5b);notify-landlordfor tenant-channel “I paid” escalations that still need operator approval (Step 5b) (section cross-reference; Deeper workflow reads; hub) - Landlord MCP — Account-scoped
list-bookings/get-booking(Step 1);list-listings,get-listing(unavailabilities),get-listing-calendar, andget-propertyfor unit-code resolution and Timeline overlap checks beforecreate-booking(Step 1);create-bookingwith tenant-category follow-through (Step 2);get-booking/get-listing-pricing-tableduring payment-schedule review (Step 3);upload-booking-contract(Step 4);create-manual-payment-in/list-payments/get-payment/list-bookings(Step 5–5b; approval remains operator UI) (section cross-reference; Deeper workflow reads; hub) - Using in-app support — Vivin product tickets when portal Copy / Impersonate Tenant or tenant-category modules block onboarding (Step 6)
- Automation & AI — Landlord vs Tenant MCP surface choice during confirmation receipt approval (Step 5b) and portal escalation (Step 6) (section cross-reference; Deeper workflow reads; hub)
- Tenant Portal — Portal access, onboarding emails, and digital contract signing (Step 4) (section cross-reference; Deeper workflow reads; hub)
- FAQ — Tenant contract signing blocked — No PDF yet, mandatory Your Details gates, category locks, or Lease purpose; portal signing vs paper upload on Contract Info
- Integrations & Distribution — Channel imports and calendar sync (Step 1) (section cross-reference; Deeper workflow reads; hub)
- Services Marketplace — Optional portal add-ons on Payment plan (Step 5) (section cross-reference; Deeper workflow reads; hub)
- Settings > Preferences — In-app notifications — Account-wide booking or payment alerts
- Settings > Preferences — Mandatory for contract signing — Portal gates before digital signature (Step 4)
- Settings > Emails — Communication Rules and booking lifecycle email triggers
- Settings > Contract templates — Placeholders in generated PDFs
- Settings > Integrations — Channex — Channel-manager imports (Step 1 Source platform filter)
- Settings > Tenant categories — Assign Category on Tenant Info before contract mail (Step 2) and before the first confirmation receipt (Step 3)
- FAQ — Assign tenant category for direct booking — Add booking wizard has no category field; use + Create New → Tenant or Tenants → Tenant Info
- Bookings — Other filters — Tenant → Tenant category mirror when verifying segment assignment on direct bookings (Step 2)
- Tenants — Tenant category filter — Profile-count cross-check before portal mail (Step 2)
- Glossary — Tenant category — Bookings, Finance, and Tenants segmentation on direct reservations (Step 2)
- FAQ — Finance tenant category filter parity — When Finance Other filters omits a segment Bookings/Tenants still list (Step 2)
Bookings, finance & collections surfaces
Bookings, finance & collections surfaces bullets pair with the matching topic rows in Processing a New Booking section cross-reference. Full pairing matrix: Processing a New Booking section cross-reference · Common Workflows section cross-reference.
- Bookings module — Full booking workspace reference
- Bookings — Timeline view — Gantt overlap and turnover planning (Step 1)
- Bookings — Payment Plan tab — Scheduled charges after creation (Step 3)
- Finance — Pending manual payments — Approve confirmation receipts before handover (Step 5b)
- Notification triage — Step 4 — Payment-received alerts after confirmation receipts (Step 5b)
- Handling a Late Payment — Step 4b — Same approval habit for collections receipts (Step 5b)
- Managing a Check-in — Step 3b — Move-in receipt approval on arrival week (downstream of Step 5b)
- Payment Allocation — Correcting mistaken receipts — Approve, reject, and revert on Transactions (Step 5b)
- Portfolio KPI review — Step 7 — Month-end Pending pill triage when Total Debt lags recorded receipts (Steps 5b, 6b)
- Managing a Check-in — Step 6b — Same month-end Pending habit for move-in receipts after confirmation is approved (Step 6b)
- Managing a Check-out — Step 6b — Departure-week Pending receipts on the same month-end queue (Step 6b)
- Cancelling a Booking — Step 6b — Cancellation settlement receipts on the same month-end queue (Step 6b)
- Handling a Late Payment — Step 6b — Collections Pending mesh at month-end (Step 6b)
- Tenants module — Fiscal-ID lookup and profile updates (Steps 1–2)
- Listings module — Property and unit context when verifying imports (Step 1)
- Operations module — Turnover prep tickets from property Maintenances
- Audit — Discounts tab — Cross-portfolio discount review on imported reservations (Step 2)
- API Reference — Creating Bookings — Partner
POST …/bookingsimports (Step 1)
Deeper workflow reads
Concept workflow reads pair with Concepts hub subsection index and Concept cross-reference. Each concept sub-guide reciprocates with [Deeper workflow reads](../workflows/processing-a-new-booking.md#deeper-workflow-reads) anchors on Processing a New Booking bullets — hub parity: Common Workflows hub — Deeper workflow reads. Full pairing matrix: Processing a New Booking section cross-reference · Common Workflows section cross-reference.
- Booking Lifecycle — Computed status model, list filters, and Timeline (section cross-reference; Deeper workflow reads; hub)
- Payment Allocation — Two-layer receipts, invoiced-floor rent, and reject/revert corrections (section cross-reference; Deeper workflow reads; hub)
- Tenant Portal — Booking-scoped tenant self-service, contract signing, and payments (section cross-reference; Deeper workflow reads; hub)
- Tenant MCP — Booking-scoped external AI clients and portal-link tools (section cross-reference; Deeper workflow reads; hub)
- Landlord MCP — Account-scoped portfolio automation from external clients (section cross-reference; Deeper workflow reads; hub)
- Automation & AI — Channel map, chatbot, in-app assistant, and MCP clients (section cross-reference; Deeper workflow reads; hub)
- Integrations & Distribution — Marketplace calendar sync, booking imports, and white-label engine (section cross-reference; Deeper workflow reads; hub)
- Services Marketplace — Portal add-on catalogue and fulfilment on Payment plan (section cross-reference; Deeper workflow reads; hub)
- Create New Menu — Global + slide-out shortcuts into module create flows (section cross-reference; Deeper workflow reads; hub)
Deeper API reads
API reads pair with API Reference hub subsection index and API guide cross-reference. Hub parity: Common Workflows — Deeper API reads. Full pairing matrix: Processing a New Booking section cross-reference · Common Workflows section cross-reference.
- Creating Bookings — Partner
POST /bookingsenqueue behind Step 1 auto-imports (section cross-reference; Deeper workflow reads; hub) - Booking Lifecycle & Validations — Async validation vs computed Upcoming list filters before Step 6 (section cross-reference; Deeper workflow reads; hub)
- Booking Engine API — White-label
POST /bookingson the same queue as marketplace imports (Step 2) (section cross-reference; Deeper workflow reads; hub) - Webhooks & Notifications — Outbound
booking.*events after partner enqueue completes (section cross-reference; Deeper workflow reads; hub) - iCal feeds — Short-term calendar blocks without full booking rows (Step 1) (section cross-reference; Deeper workflow reads; hub)
- Error Handling — Retry when imports return
409overlap or422business-rule responses (section cross-reference; Deeper workflow reads; hub) - AI usage API — Internal LLM token ledger (
GET /ai-usage/summary;landlord_chat) during Step 6b month-end mesh (section cross-reference; Deeper workflow reads; hub)
Lockout catch-up after password recovery
Portal verification and month-end confirmation approval delayed by lockout pair with Resetting a Management User Password. Hub parity: Common Workflows — Lockout catch-up after password recovery. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Lockout catch-up after password recovery — Hub matrix when sign-in was restored mid-workflow
- Getting Started — Lockout catch-up after password recovery — Canonical backlog mesh after Step 3
- Step 6 — Confirm the booking status is correct — Portal gates delayed by lockout
- Step 6b — Approve lingering confirmation receipts — Month-end Pending mesh catch-up
- Notification triage — Step 5 — Clear booking-created alerts after recovery
Pending manual receipt approval
Confirmation receipts stay pending until Approve payments on Step 5b and Step 6b. Duplicate confirmation transfers still pending → Common Workflows — Reject/revert mistaken receipts (Reject selected, not Approve). Hub parity: Common Workflows — Pending manual receipt approval. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Pending manual receipt approval — Hub matrix when recorded transfers still await Approve payments (
finance-transactions-pending-pill.png,bookings-detail-transactions-approve-payment-modal.png) - Glossary — Pending manual in-payment (Finance) — Definition and three-surface triage
- Glossary — Pending manual receipt approval hub — Surface table + per-guide/module mesh reciprocal hub
- FAQ — Pending manual receipt approval hub — Symptom table + per-guide/module mesh
- Step 5b — Approve confirmation receipts — Primary approval habit in this workflow
- Common Workflows — Reject/revert mistaken receipts — Reject duplicate confirmation while pending (
finance-transactions-bulk-reject-selected-bar.png) - Finance — Pending manual payments — Amber Pending chip triage
- Portfolio KPI review — Step 7 — Month-end reconciliation when Total Debt lags
- Handling a Late Payment — Pending manual receipt approval — Collections mesh on Step 4b / Step 6b (
finance-transactions-pending-approve-flow.mp4) - Notification triage — Pending manual receipt approval — Alert-driven entry on Step 4 (
notifications-row-navigate-to-booking-detail.png)
WhatsApp per-booking messaging
Confirmation follow-up pairs with Bookings → Communication on Step 6 — Confirm the booking status is correct — New WhatsApp message from … on bell Inbox during Notification triage — Step 1. Hub parity: Glossary — WhatsApp per-booking messaging hub · Common Workflows — WhatsApp per-booking messaging. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — WhatsApp per-booking messaging — Hub matrix (
bookings-detail-communication-tab-whatsapp-thread.png,inbox-module-triage-flow.mp4) - Glossary — WhatsApp per-booking messaging hub — Surface table + per-guide/module mesh reciprocal hub
- FAQ — WhatsApp per-booking messaging hub — Confirmation follow-up on Step 6 symptom table
- Step 6 — Confirm the booking status is correct — Communication for import follow-up
- Notification triage — Step 2 — Message ping triage on
/notifications - Common Workflows — Confirmation alert triage — Booking created / Payment received vs message alerts
- Managing a Check-in — WhatsApp per-booking messaging — Downstream arrival-week threads
- Inbox module — Cross-booking triage before opening one booking
Bot reasoning (audit)
Confirmation follow-up bot replies on Step 6 — expand Reasoning under mint Bot bubbles on Bookings → Communication → WhatsApp to audit automated replies before editing ChatBot persona or IF/THEN rules. Hub parity: Glossary — Bot reasoning (audit) hub · Common Workflows — Bot reasoning (audit). Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Bot reasoning (audit) — Hub matrix (
bookings-detail-communication-tab-bot-reasoning-expanded.png) - Glossary — Bot reasoning (audit) hub — Surface table + per-guide/module mesh reciprocal hub
- FAQ — Bot reasoning (audit) hub — Symptom table for Reasoning vs ChatBot settings
- ChatBot settings — Bot reasoning audit — Read-only thread audit vs editable persona / IF/THEN
- Bookings — Communication tab — Reasoning control on Bot bubbles
- Glossary — ChatBot settings hub — Edit persona / IF/THEN after thread audit
- Step 6 — Confirm the booking status is correct — Workflow step where bot replies surface
ChatBot settings
Pair Account Settings → ChatBot (Persona, IF/THEN, Status Bot) with thread review on Communication when confirmation follow-up bot replies on step 6. Hub parity: Glossary — ChatBot settings hub · Common Workflows — ChatBot settings. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — ChatBot settings — Hub matrix (
settings-chatbot-tab-overview.png,settings-chatbot-status-bot-connected.png,settings-chatbot-save-rule-flow.mp4) - Glossary — ChatBot settings hub — Surface table + per-guide/module mesh reciprocal hub
- FAQ — ChatBot settings hub — Symptom table for pairing, persona, and IF/THEN tuning
- ChatBot settings — Persona, IF/THEN rules, Status Bot WhatsApp pairing
- Glossary — Bot reasoning (audit) hub — Thread Reasoning audit after rule changes
- Onboarding a New Property — Step 4 — Setup-step pairing for tenant chatbot rules
Notification row-click navigation
Upcoming Booking created / Payment received alerts pair with Notification triage — Step 4 on Step 6 — Confirm the booking status is correct — contrast bell General in-panel detail with /notifications row-click. Hub parity: Common Workflows — Notification row-click navigation. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Notification row-click navigation — Hub matrix (
notifications-module-row-click-target.png,notifications-row-navigation-flow.mp4) - Glossary — Notification row navigation — Target-field order and bell General contrast
- Glossary — Notification row navigation hub — Surface table + per-guide/module mesh
- FAQ — Notification row-click navigation hub — Upcoming Booking created / Payment received on Step 6 symptom table
- Common Workflows — Confirmation alert triage — Upcoming Booking created / Payment received (
bookings-detail-transactions-approve-payment-modal.png) - Notification triage — Step 4 — Row-click before Step 5b
- Step 6 — Confirm the booking status is correct — Booking sidebar after alert row-click
- Pending manual receipt approval — Pending manual in-payment row-click → Approve (
notifications-row-navigate-to-booking-detail.png) - Payment alert to receivables triage — Ongoing payment overdue contrast on Step 5 / Step 6
Payment notification (operator)
Upcoming Payment received and Pending manual in-payment alerts on Step 5 / Step 5b pair with account + personal opt-in layers before you bulk mark-read on Step 6. Hub parity: Common Workflows — Payment notification (operator). Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Payment notification (operator) — Hub matrix (
notifications-row-navigate-to-booking-detail.png,notifications-row-navigation-flow.mp4) - Glossary — Payment notification (operator) — Three row types + opt-in layers
- FAQ — Payment notification (operator) hub — Symptom table + per-guide/module mesh
- Settings — Preferences — Notifications & emails — Account Receive payment notifications master
- Settings — Interface language — Your email preferences — Per-user Payment notification emails
- Step 5 — Record the confirmation payment — Payment received row-click after tenant transfer
- Step 5b — Approve confirmation receipts — Pending manual in-payment when receipt still awaits Approve
- Common Workflows — Confirmation alert triage — Upcoming Booking created / Payment received contrast
- Pending manual receipt approval — Third row type vs Payment received
- Notification triage — Payment notification (operator) — Canonical alert triage on Step 4
Payment alert to receivables triage
Upcoming Booking created / Payment received alerts pair with Notification triage — Step 4 — contrast Upcoming confirmation paths with Ongoing payment overdue on Step 5 / Step 6. Hub parity: Common Workflows — Payment alert to receivables triage. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Payment alert to receivables triage — Hub matrix (
notifications-row-navigate-to-booking-detail.png,notifications-row-navigation-flow.mp4) - Glossary — Payment alert to receivables triage — Ongoing/Ended payment overdue before Debt Aging
- Glossary — Payment alert to receivables triage hub — Surface table + per-guide/module mesh
- FAQ — Payment alert to receivables triage hub — Upcoming vs Ongoing on Step 5 / Step 6 symptom table
- Common Workflows — Confirmation alert triage — Upcoming Booking created / Payment received (
bookings-detail-transactions-approve-payment-modal.png) - Notification triage — Step 4 — Row-click before Step 5b
- Step 5 — Record the confirmation payment — Booking balance after alert row-click
- Pending manual receipt approval — Pending manual in-payment on Step 5b (
finance-transactions-pending-pill.png) - Finance debt receivables triage — Portfolio Top debtors when confirmation charges stay unpaid
Finance debt receivables triage
Unpaid confirmation charges pair with Step 5 / Step 6 before portfolio Top debtors — contrast Upcoming confirmation alerts with Ongoing receivables on Common Workflows — Payment alert to receivables triage. Hub parity: Common Workflows — Finance debt receivables triage. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Finance debt receivables triage — Hub matrix (
finance-overview-income-chart-debt-aging.png,finance-overview-debt-aging-walkthrough-flow.mp4) - Common Workflows — Payment alert to receivables triage — Upcoming vs Ongoing alert paths (
notifications-row-navigation-flow.mp4) - Step 5 — Record the confirmation payment — Booking-level balance before Debt Aging
- Step 6 — Confirm the booking status is correct — Unpaid move-in/confirmation before handoff to Managing a Check-in
- Handling a Late Payment — Step 1 — Collections when confirmation charges stay unpaid (
finance-overview-debt-aging-expanded-bucket.png) - Pending manual receipt approval — Clear Pending before Top debtors (
finance-transactions-pending-pill.png) - Glossary — Finance debt receivables triage hub — Surface table + per-guide/module mesh reciprocal hub
- FAQ — Finance debt receivables triage hub — Unpaid confirmation symptom table
Handling a Late Payment collections
Unpaid confirmation on Upcoming stays on Step 5 — Record the confirmation payment may continue in Handling a Late Payment — Steps 1–4 when confirmation deadline passes. Hub parity: Common Workflows — Handling a Late Payment collections hub. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Handling a Late Payment collections hub — Hub matrix (
bookings-detail-payment-plan-tab-schedule.png,finance-overview-income-chart-debt-aging.png) - Step 5 — Record the confirmation payment — Payment Plan before portal gates on Step 6
- Handling a Late Payment — Steps 1–4 — Collections when confirmation stays unpaid
- Confirmation alert triage — Upcoming Booking created alerts contrast
- Pending manual receipt approval — Step 5b / Step 6b approval mesh
- Glossary — Handling a Late Payment collections hub — Surface table + per-guide/module mesh reciprocal hub
- FAQ — Handling a Late Payment collections hub — Confirmation collections symptom table
Dashboard Total Debt subtitle
Confirmation-week Total Debt on / counts ongoing stays only — contrast Upcoming confirmation alerts with live-portfolio headline after Step 5 / Step 5b. Hub parity: Common Workflows — Finance debt receivables triage. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- FAQ — Dashboard Total Debt subtitle — Headline vs >15 days subtitle (
dashboard-kpi-total-debt-tooltip.png) - Common Workflows — Finance debt receivables triage — Debt Aging when the card is not enough for tenant · unit rows
- Step 5b — Approve confirmation receipts — Headline may lag until Approve payments (
finance-transactions-pending-pill.png) - Finance debt receivables triage — Upcoming vs Ongoing receivables mesh
- Portfolio KPI review — Dashboard Total Debt subtitle — Month-end headline sign-off (Step 7)
Uncovered Debt KPI
Confirmation deposits on Step 5 may not offset arrears — when Uncovered Debt ≈ Total Debt on Finance → Overview, prioritize Top debtors before handoff to Managing a Check-in. Hub parity: Common Workflows — Finance debt receivables triage. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- FAQ — Uncovered Debt KPI — Deposit coverage vs Total Debt (
finance-overview-kpi-cards.png) - Glossary — Uncovered Debt — Thin deposit offsets on new Ongoing stays
- Finance debt receivables triage — Debt Aging when strip figures align
- Dashboard Total Debt subtitle — Ongoing-only
/vs all-booking Finance KPIs - Partly collected security deposit — Deposit shortfall vs receivables on Step 5
Finance Income status drill-down
Confirmation settlement on Step 5 / Step 6 — Income → In debt is month-scoped payment lines; rank debtors on Debt Aging before Managing a Check-in handoff. Hub parity: Common Workflows — Finance Income status drill-down. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- FAQ — Finance Income status drill-down — Income chart (Paid / Scheduled / In debt); month-scoped payment-line modal (
finance-overview-income-status-in-debt-modal.png) - Glossary — Finance income status — In debt segment vs Debt Aging booking rows
- Finance debt receivables triage — Top debtors when you need ranked debtors, not payment lines (
finance-overview-debt-aging-expanded-bucket.png) - FAQ — Bookings that owe money — Booking-level receivables on Debt Aging
- Step 5 — Record the confirmation payment — Confirm Payment Plan before portfolio Income reads
- Glossary — Finance Income status drill-down hub — Surface table + per-guide/module mesh reciprocal hub
- FAQ — Finance Income status drill-down hub — Confirmation Income segment symptom table
Cash flow forecast drill-down
Confirmation settlement on Step 5 / Step 6 — Cash flow forecast lists every collection in a month; contrast with Income → Paid on the stacked chart. Hub parity: Common Workflows — Cash flow forecast drill-down. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- FAQ — Cash flow forecast drill-down — Cash flow forecast chart (Month / Day); All payments modal (
finance-overview-cash-flow-all-payments-modal.png) - Glossary — Cash flow forecast (Finance Overview) — Collections history vs Dashboard rent-due chart vs Income status
- Finance Income status drill-down — Paid / Scheduled / In debt when scheduled vs collected mismatch
- Dashboard — Cash Flow Forecast — Rent due timing (
dashboard-cash-flow-forecast-chart.png) — not Finance collections - Step 5 — Record the confirmation payment — Confirm Approve payments before Cash flow forecast month bars reflect collections
- Glossary — Cash flow forecast drill-down hub — Surface table + per-guide/module mesh reciprocal hub
- FAQ — Cash flow forecast drill-down hub — Confirmation collections symptom table
Reject/revert mistaken receipts
Duplicate confirmation transfers pair with Payment Allocation — Correcting mistaken receipts on Step 5b. Hub parity: Common Workflows — Reject/revert mistaken receipts. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
-
Common Workflows — Reject/revert mistaken receipts — Hub matrix when duplicate receipts need Reject / Revert (
bookings-payment-row-actions-flow.mp4) -
Glossary — Credit note warning (reject/revert) — Modal banners and Not issued credit note queue
-
Glossary — Reject/revert mistaken receipts hub — Surface table + per-guide/module mesh reciprocal hub
-
Glossary — Credit note warning (reject/revert) hub — Modal-banner surface table + per-guide/module mesh
-
FAQ — Credit note warning (reject/revert) hub — Symptom table + per-guide/module mesh
-
Common Workflows — Pending manual receipt approval — Approve legitimate confirmation rows on Step 5b before Revert (
finance-transactions-pending-approve-flow.mp4) -
Payment Allocation — Correcting mistaken receipts — Reject selected on confirmation duplicates
-
Glossary — Credit note (payment reject/revert) — Red banner when Finance already invoiced
-
Finance — Row actions on in-payment rows — Bulk reject on Finance → Transactions
-
Step 5b — Approve confirmation receipts — Reject selected duplicate confirmation while pending (
finance-transactions-bulk-reject-selected-bar.png) -
Handling a Late Payment — Reject/revert mistaken receipts — Collections duplicate mesh on Step 4b
-
Portfolio KPI review — Reject/revert mistaken receipts — Month-end Revert during Step 7 sign-off
-
FAQ — Reject/revert mistaken receipts hub — Confirmation duplicate symptom table
Month-end invoicing (fixed date)
First-month export after confirmation pairs with Step 6b month-end mesh — save a fixed Invoice date in Settings → Invoicing before bulk Issue allocation — pair Bulk Hostkit invoicing on the same amber toolbar banner. Hub parity: Common Workflows — Month-end invoicing (fixed date). Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Month-end invoicing (fixed date) — Hub matrix (
settings-invoicing-invoice-date-toggle.png,finance-transactions-fixed-invoice-date-banner.png,finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png) - Invoicing — Default invoice date — Toggle Use today as invoice date off + Save
- Finance — Month-end invoicing with a fixed date — Six-step operator habit on Transactions
- Common Workflows — Bulk Hostkit invoicing — Issue allocation after fixed date is saved
- FAQ — Month-end invoicing (fixed date) hub — Symptom table + toggle reset after batch
- Glossary — Fixed invoice date — Account-wide until you change it
- Step 6b — Approve lingering confirmation receipts — Month-end confirmation mesh before bulk export
Bulk Hostkit invoicing
First-month export after confirmation pairs with Month-end invoicing (fixed date) (save fixed Invoice date before bulk export — finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png) and Rent reduction after invoicing when Change monthly rent clamps exported months — not Hostkit slowness. Hub parity: Common Workflows — Bulk Hostkit invoicing. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Bulk Hostkit invoicing — Hub matrix: Hostkit pacing + bulk toolbar (
finance-transactions-bulk-selection-bar.png,settings-invoicing-hostkit-series.png) - FAQ — Bulk Hostkit invoicing hub — Symptom table + per-guide mesh
- Common Workflows — Month-end invoicing (fixed date) — Fixed Invoice date before bulk export (
settings-invoicing-invoice-date-toggle.png,finance-transactions-fixed-invoice-date-banner.png) - Common Workflows — Reject/revert mistaken receipts — Issue credit notes (N) after invoiced Reject / Revert (
bookings-detail-transactions-reject-modal-credit-note-banner.png) - FAQ — Bulk Hostkit invoicing slow — HTTP 429 pacing — leave batch running; refresh Transactions before re-issue
- Finance — Invoice automation — Bulk Issue allocation / Invoice selected
Utility overage collections
First Ongoing stays after confirmation pair with Step 6 — Confirm the booking status is correct before the first supplier bill cycle posts overage lines — hub: Common Workflows — Utility overage collections. Distinct from confirmation rent Handling a Late Payment — Step 1. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Utility overage collections — Hub matrix (
utilities-allocations-row-breakdown-expanded.png,utilities-allocations-review-flow.mp4) - Step 6 — Confirm the booking status is correct — Ongoing before first Utilities → Bills entry
- Onboarding a New Property — Step 7 — Go-live on new inventory before first bill cycle
- Entering Monthly Utility Bills — Step 2 — First landlord bill on confirmed stay
- Managing a Check-in — Step 3 — Move-in charges vs utility overage distinction
- Portfolio KPI review — Step 7 — Month-end first-cycle overage sign-off
Check-out final utilities handoff
Confirmed Ongoing stays pair with Step 6 — Confirm the booking status is correct before the first departure posts final utility overages — hub: Common Workflows — Check-out final utilities handoff. Distinct from mid-stay Utility overage collections. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Check-out final utilities handoff — Hub matrix (
utilities-allocations-review-flow.mp4,bookings-detail-payment-plan-tab-schedule.png) - Step 6 — Confirm the booking status is correct — Ongoing before first departure final overages
- Onboarding a New Property — Step 4 — Charge Time (Every Month vs End of Booking) on go-live inventory
- Entering Monthly Utility Bills — Step 4 — Downstream posting when stay ends
- Managing a Check-out — Step 6 — Settlement verification before refund
- Glossary — End-of-Booking cost split — Deferred posting when Charge Time is End of Booking
Check-in to check-out handoff
Confirmed Ongoing stays after Step 6 — Confirm the booking status is correct pair with Managing a Check-in — Step 4 → Managing a Check-out — Step 1 — hub: Common Workflows — Check-in to check-out handoff. Hub parity: Common Workflows — Confirmation to check-in handoff. Distinct from Check-out final utilities handoff. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Check-in to check-out handoff — Hub matrix (
operations-check-in-out-check-outs-next-7-days.png,bookings-timeline-view.png) - Glossary — Check-in to check-out handoff hub — Surface table + per-guide/module mesh
- Step 6 — Confirm the booking status is correct — Ongoing before first departure-week planning
- Managing a Check-in — Step 4 — Upstream key handover on mid-stay
- Managing a Check-out — Step 1 — Downstream ~7 days before departure
- Common Workflows — Confirmation to check-in handoff — Upstream portal gates on Upcoming imports
- FAQ — Managing a Check-out hub — Departure-week symptom table
Check-out collections before refund
Mid-stay rent arrears on first Ongoing imports after Step 6 — Confirm the booking status is correct pair with Handling a Late Payment — Step 1 before departure-week refund planning — hub: Common Workflows — Check-out collections before refund. Distinct from Check-out final utilities handoff and Check-in to check-out handoff. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Check-out collections before refund — Hub matrix (
workflows-check-out-coordination-flow.mp4,bookings-detail-payment-plan-tab-schedule.png,finance-contract-values-in-debt-filter.png) - Step 6 — Confirm the booking status is correct — Ongoing before mid-stay collections triage
- Handling a Late Payment — Step 1 — Collections when rent/fee rows stay Unpaid
- Managing a Check-out — Step 6 — Downstream settlement before Step 5
- Common Workflows — Confirmation to check-in handoff — Upstream portal gates on Upcoming imports
- FAQ — Handling a Late Payment hub — Collections symptom table
Check-out ledger cleanup before refund
Duplicate confirmation bank transfers during Step 5b — Approve confirmation receipts when required / Step 6b — Approve lingering confirmation receipts when required pair with Reject selected on booking Transactions — hub: Common Workflows — Check-out ledger cleanup before refund. Distinct from rent Check-out collections before refund. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
-
Common Workflows — Check-out ledger cleanup before refund — Hub matrix (
bookings-detail-transactions-revert-modal-info-banner.png,finance-transactions-bulk-reject-selected-bar.png) -
Step 5b — Approve confirmation receipts when required — Pending mesh before Approve legitimate row only
-
Step 6b — Approve lingering confirmation receipts when required — Month-end duplicate cleanup before departure planning
-
Reject/revert mistaken receipts — Reject while pending; Revert after Approve
-
Managing a Check-out — Step 6 — Downstream settlement before Step 5
-
FAQ — Reject/revert mistaken receipts hub — Confirmation duplicate symptom table
-
FAQ — Check-out ledger cleanup before refund hub — Symptom table for phantom In Debt / Ready To Refund blocked when tenant paid once
Cancellation collections before void
Pre-cancel rent arrears on Upcoming imports after Step 6 — Confirm the booking status is correct pair with Cancelling a Booking — Step 2 before Step 4 — hub: Common Workflows — Cancellation collections before void. Distinct from departure-week Check-out collections before refund and duplicate Reject/revert mistaken receipts. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Cancellation collections before void — Hub matrix (
finance-contract-values-in-debt-filter.png,bookings-cancel-booking-modal-refund-types.png,workflows-cancel-booking-refund-modal-flow.mp4) - Step 6 — Confirm the booking status is correct — Upcoming / Ongoing before pre-cancel triage
- Cancelling a Booking — Step 2 — Settlement before Step 4
- Handling a Late Payment — Step 1 — Collections when rent/fee rows stay Unpaid
- Check-out collections before refund — Departure-week mesh contrast (completed stay)
- FAQ — Cancelling a Booking hub — Pre-cancel symptom table
Rent reduction after invoicing
Goodwill repricing pairs with Bulk Hostkit invoicing when external credit notes need Issue credit notes (N) — same Hostkit pacing as first-time Issue allocation. Hub parity: Common Workflows — Rent reduction after invoicing. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Rent reduction after invoicing — Hub matrix: invoiced-floor modals + MP4 (
bookings-detail-change-monthly-rent-modal.png,bookings-detail-contract-values-invoiced-floor-edit-amount.png,bookings-rent-reduction-invoiced-floor-flow.mp4) - FAQ — Rent reduction after invoicing hub — Confirmation month already invoiced on Step 3 symptom table
- Common Workflows — Bulk Hostkit invoicing — Issue credit notes Hostkit pacing after external rent relief (
finance-transactions-bulk-selection-bar.png) - Glossary — Invoiced floor (rent) — Change monthly rent clamp vs Edit amount Save block
- FAQ — Lower rent below invoiced — External credit note path when in-product net cannot drop
- Step 3 — Review confirmation timing and the payment schedule — Schedule still editable before first Issue allocation
- Bookings — Changing contract dates and rent — Repricing entry on booking sidebar
- Finance — Invoiced floor and rent edits — Why edits start on the booking, not Transactions
Same-day turnover coordination
Step 1 — Check if the booking was auto-imported Timeline / Multicalendar overlap on a shared unit may be a same-day turnover — not a duplicate import. Hub parity: Common Workflows — Same-day turnover coordination. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Same-day turnover coordination — Hub matrix (
bookings-timeline-view.png,bookings-timeline-day-week-month-and-sidebar.mp4) - Glossary — Same-day turnover coordination hub — Surface table + per-guide/module mesh
- Step 1 — Check if the booking was auto-imported — Overlap vs outgoing departure on same calendar day
- Managing a Check-out — Step 2 — Upstream turnover ticket when overlap is real
- FAQ — Same-day turnovers — Four-step habit before Delete on imports
- Bookings — Timeline view — Week scale on unit Search
Occupancy KPI to block hygiene handoff
Step 1 — Check if the booking was auto-imported Timeline / Multicalendar overlap checks can reveal stale manual holds — run Manual block hygiene — Step 4 before you treat overlap as a duplicate import. Hub parity: Common Workflows — Occupancy KPI to block hygiene handoff. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Occupancy KPI to block hygiene handoff — Hub matrix (
bookings-timeline-view.png,audit-manual-blocks-filter-scroll.mp4) - Glossary — Occupancy KPI to block hygiene handoff hub — Surface table + per-guide/module mesh reciprocal hub
- FAQ — Occupancy KPI to block hygiene handoff hub — Timeline overlap on channel import symptom table
- Step 1 — Check if the booking was auto-imported — Overlap vs stale holds before Add booking
- Manual block hygiene — Step 4 — Clear holds surfaced by Timeline search
- Bookings — Timeline view — Unit-row coloured bars for overlap triage
- Glossary — Manual unavailability (manual block) — Distinct from booked nights
Deposit missing on Finance Deposits
Step 5 — Record the confirmation payment can leave deposit data on the booking Deposit tab while Finance → Deposits hides the row — clear or widen the toolbar date range when check-in or Refund Due Date falls outside the default ~3 months window. Hub parity: Common Workflows — Deposit missing on Finance Deposits. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Deposit missing on Finance Deposits — Hub matrix (
finance-deposits-date-range-toolbar-default.png,finance-deposits-date-range-clear-flow.mp4,deposit-missing-on-finance-deposits-triage-flow.mp4) - Step 5 — Record the confirmation payment — Per-booking Deposit tab vs Finance portfolio row
- Partly collected security deposit — After clearing range, chase Partial paid shortfalls
- Glossary — Finance Deposits date range — Intersection rule on check-in, check-out, Refund Due Date
- Finance — Deposits tab — Toolbar Clear date range selection
Deposit lifecycle status
Step 5 — Record the confirmation payment records the first deposit allocation — review the depositStatus lifecycle pill on booking Deposit after payment. Hub parity: Common Workflows — Deposit lifecycle status. Full pairing matrix: Processing A New Booking section cross-reference · Common Workflows section cross-reference.
- Step 5 — Record the confirmation payment — First Partial Paid / Fully Paid transition after confirmation deposit
- Common Workflows — Deposit lifecycle status — Hub matrix (
finance-deposits-status-cards.png,finance-deposits-tab-mark-refunded-flow.mp4) - Glossary — Deposit lifecycle status —
depositStatuspill vocabulary - Partly collected security deposit — Partial Paid shortfall mesh after Step 5
Partly collected security deposit
Step 5 — Record the confirmation payment may leave the deposit Partially paid when the tenant transfers less than the full security deposit — chase the remaining before move-in. Hub parity: Common Workflows — Partly collected security deposit. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Partly collected security deposit — Hub matrix when Paid on the deposit is above zero but below Amount
- Step 5 — Record the confirmation payment — Deposit tab Partially paid badge after confirmation
- Finance — Deposit lifecycle status cards — Partial paid card for portfolio triage (#2091)
- Finance — Deposit status filter — Other filters → Deposit status → Partial paid on Bookings and Finance (#2090)
- Operations — Tickets toolbar search — Paste the full sequential ticket ID (for example
S259,T27) in toolbar Search (#2074) - FAQ — Find a ticket by its ID — Paste the full sequential ticket ID (for example
S259,T27) in Operations → Tickets toolbar Search (#2074) - FAQ — Skip automatic check-in/out tickets for one booking — Turn off Use unit contract rents and other contract details on Add booking to reveal CI/CO ticket checkboxes (#1140)
- FAQ — Manual payments after Delete Booking — Delete Booking hides manual/provider_platform rows on Finance → Transactions; vIBAN and credit card stay visible (#1897)
- Glossary — Directory list load failures — First-fetch directory failures show Retry / Try again; distinct from filter-empty states and booking-sidebar tab errors
- Glossary — Vacant Unit Preference — Include manual blocks counts operator holds as free on Dashboard / Sales vacancy surfaces (#1427)
- FAQ — Communication or Tickets load failure — Tab-scoped Refresh (Communication) or Retry (Tickets); other booking sidebar tabs stay usable
- FAQ — Partly collected security deposit — Distinct from Partial Paid rent on Payment Plan
- Managing a Check-in — Step 3 — Downstream arrival-week shortfall chase
Wrong tenant on a booking
Post-import profile checks on Step 6 — Confirm the booking status is correct pair with Change tenant when the reservation is valid but the Tenant card points at the wrong profile — contrast duplicate-row cleanup on Step 1 — Check if the booking was auto-imported (Delete Booking, not Change tenant). Hub parity: Common Workflows — Wrong tenant on a booking. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Wrong tenant on a booking — Hub matrix (
bookings-detail-change-tenant-control.png,bookings-detail-change-tenant-modal.png,bookings-detail-change-tenant-flow.mp4) - Step 6 — Confirm the booking status is correct — Change tenant before contract signing
- Step 1 — Check if the booking was auto-imported — Duplicate import → Delete Booking
- Common Workflows — Cancel Booking vs Delete Booking — Three-way decision table
- Glossary — Cancel Booking vs Delete Booking hub — Contrast duplicate import → Delete, not Change tenant
- Bookings — Change tenant — Module reference and guards
- Glossary — Wrong tenant on a booking hub — Surface table + per-guide/module mesh reciprocal hub
- FAQ — Wrong tenant on a booking — Eligibility and symptom table
Cancel Booking vs Delete Booking
Duplicate or training rows on Step 1 — Check if the booking was auto-imported use Delete Booking for mistaken imports — Cancel booking for real voids that need refund settlement. Wrong profile on valid stay → Change tenant, not this hub. Hub parity: Common Workflows — Cancel Booking vs Delete Booking. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Cancel Booking vs Delete Booking — Hub matrix (
bookings-cancel-booking-modal-refund-types.png,bookings-list-canceled-tab.png,workflows-cancel-booking-refund-modal-flow.mp4) - Glossary — Cancel Booking vs Delete Booking hub — Surface table + per-guide/module mesh reciprocal hub
- Step 1 — Check if the booking was auto-imported — Delete for duplicate/test rows
- Wrong tenant on a booking — Valid stay with wrong profile → Change tenant
- Cancelling a Booking — Policy void when import should not have been confirmed
- FAQ — Delete Booking on integration reservation — Clear provider platform in-payment (#2076)
- Bookings — Delete Booking (soft archive) — Soft-archive control location
Portfolio retirement decisions
Duplicate or training rows on Step 1 — Check if the booking was auto-imported use Delete Booking for mistaken imports — or Cancel booking for real voids — not Archive property (building scope). Hub parity: Common Workflows — Portfolio retirement decisions. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Portfolio retirement decisions — Hub matrix (
finance-transactions-type-summary-cards.png) - Glossary — Portfolio retirement decisions hub — Surface table + per-guide/module mesh reciprocal hub
- Step 1 — Check if the booking was auto-imported — Duplicate channel imports vs building Archive
- Common Workflows — Cancel Booking vs Delete Booking — Delete for test rows; Cancel for real voids
- Cancelling a Booking — Policy void path when import should not have been confirmed
- FAQ — Delete Booking on integration reservation — Clear provider platform in-payment first (#2076)
- Bookings — Delete Booking (soft archive) — Soft-archive mistaken rows
Provider platform Delete Booking guard
Duplicate OTA imports on Step 1 — Check if the booking was auto-imported use Delete Booking after you Reject or assign any provider platform in-payment — the guard blocks soft-archive until the row is cleared (#2076). Hub parity: Common Workflows — Provider platform Delete Booking guard. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Provider platform Delete Booking guard — Hub matrix (
bookings-detail-provider-platform-payment-field.png,bookings-detail-delete-booking-provider-platform-error-toast.png,bookings-provider-platform-reject-delete-flow.mp4) - Glossary — Provider platform Delete Booking guard hub — Surface table + per-guide/module mesh reciprocal hub
- Step 1 — Check if the booking was auto-imported — Reject in-payment before Delete on duplicate imports
- Cancel Booking vs Delete Booking — Delete for test rows; Cancel for real voids
- Bookings — Provider platform payment — Read-only field on integration bookings
- Bookings — Delete Booking (soft archive) — Retry after in-payment cleared
- FAQ — Delete Booking on integration reservation — Symptom table (#2076)
Archived booking ledger visibility
Duplicate OTA imports on Step 1 — Check if the booking was auto-imported may use Delete Booking after clearing provider platform in-payment — Manual Transactions for that reservation hide on Finance → Transactions afterward (#1897). Real voids use Cancel booking, not Delete. Hub parity: Common Workflows — Archived booking ledger visibility. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Archived booking ledger visibility — Hub matrix (
finance-transactions-type-summary-cards.png) - Glossary — Archived booking ledger visibility hub — Surface table + per-guide/module mesh reciprocal hub
- Step 1 — Check if the booking was auto-imported — Delete on duplicate imports hides manual rows (#1897)
- Cancel Booking vs Delete Booking — Delete for test rows; Cancel for real voids
- Provider platform Delete Booking guard — Reject in-payment before Delete (#2076)
- Bookings — Delete Booking (soft archive) — Soft-archive on Contract Info
- Finance — Type summary cards — System vs Manual Transactions buckets
- FAQ — Manual payments after Delete Booking — Expected after soft-archive (#1897)
Archive property (building-level)
Duplicate OTA imports on Step 1 — Check if the booking was auto-imported use Delete Booking — not building Archive. Archive property retires a whole building from pickers; it does not clean single mistaken reservations. Hub parity: Common Workflows — Archive property (building-level). Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Archive property (building-level) — Hub matrix (
listings-archived-populated-table.png) - Glossary — Archive property (building-level) hub — Surface table + per-guide/module mesh reciprocal hub
- Step 1 — Check if the booking was auto-imported — Delete on duplicate rows — not building Archive
- Cancel Booking vs Delete Booking — Reservation scope vs building scope
- Portfolio retirement decisions — Three-way decision table
- Provider platform Delete Booking guard — Clear in-payment before Delete (#2076)
- Onboarding a New Property — Archive property (building-level) — Go-live Unarchive path
- FAQ — Archive a property — Building-level steps
Directory list load failures
Duplicate-import triage on Step 1 — Check if the booking was auto-imported needs a loaded Bookings directory — use list-card Retry when Failed to load bookings. appears. Alert-driven entry also needs /notifications Try again before Notification triage — Step 4 row-click. Hub parity: Common Workflows — Directory list load failures · Glossary — Directory list load failures hub. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Directory list load failures — Hub matrix (
notifications-module-load-failure.png) - FAQ — Directory list load failures hub — Bookings / /notifications Retry before import triage (Step 1)
- Step 1 — Check if the booking was auto-imported — Bookings list Retry before duplicate cleanup
- Notifications — List load and read actions — /notifications Try again before alert row-click
- Notification triage — Step 4 — Row-click after directory loads
- Common Workflows — Booking sidebar tab load failures — Tab-scoped recovery after row-click opens booking
- FAQ — Directory list load failures — Whole-module vs filter-empty state
Booking sidebar tab load failures
Contract follow-up on Step 4 — Send the contract and status checks on Step 6 — Confirm the booking status is correct often open Communication — Could not load messages needs header Refresh, not Bookings list-card Retry. Alert-driven entry still needs /notifications Try again before row-click. Hub parity: Glossary — Booking sidebar tab load failures hub · Common Workflows — Booking sidebar tab load failures. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Booking sidebar tab load failures — Hub matrix (
bookings-detail-communication-tab-whatsapp-thread.png) - Glossary — Booking sidebar tab load failures hub — Surface table + per-guide/module mesh reciprocal hub
- FAQ — Booking sidebar tab load failures hub — Contract thread Refresh on Step 4
- Step 4 — Send the contract — Communication Refresh for contract follow-up threads
- Step 6 — Confirm the booking status is correct — Tab recovery after confirmation alert row-click
- Directory list load failures — Whole Bookings / /notifications Retry on Step 1
- Notification triage — Step 4 — Row-click then tab fails
- FAQ — Communication or Tickets load failure — Tab-scoped recovery controls
Confirmation to check-in handoff
Canonical upstream handoff: finish Step 6 — Confirm the booking status is correct portal gates (contract signed, confirmation charges, Tenant category, Copy / Impersonate Tenant) before Managing a Check-in — Step 1 ~7 days before move-in. Hub parity: Common Workflows — Confirmation to check-in handoff. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Confirmation to check-in handoff — Hub matrix (
bookings-detail-contract-method-of-payments.png,booking-lifecycle-status-tabs-flow.mp4,workflows-operations-check-in-out-planning-view.png) - Glossary — Confirmation to check-in handoff — Upcoming portal gates → arrival week ~7 days before move-in
- Glossary — Confirmation to check-in handoff hub — Surface table + per-guide/module mesh
- Step 6 — Confirm the booking status is correct — Portal sanity before arrival-week planning
- Step 5b — Approve confirmation receipts — Clear Pending before handoff
- Managing a Check-in — Step 1 — Downstream canonical entry
- Confirmation alert triage — Upstream alert-driven path before Step 6
- FAQ — Confirmation to check-in handoff — Symptom table + per-guide mesh
- FAQ — Processing a New Booking hub — Step 6 portal gate checklist
Confirmation alert triage
Upcoming Booking created / Payment received / Pending manual in-payment alerts pair with Notification triage — Step 4 — finish Step 5b / Step 6 before Step 5. Contrast Upcoming confirmation paths with Ongoing payment overdue on Payment alert to receivables triage. Hub parity: Common Workflows — Confirmation alert triage. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Confirmation alert triage — Hub matrix (
notifications-row-navigate-to-booking-detail.png,bookings-detail-transactions-approve-payment-modal.png,notifications-row-navigation-flow.mp4) - Glossary — Confirmation alert triage — Upcoming Booking created / Payment received before mark-read
- Glossary — Confirmation alert triage hub — Surface table + per-guide/module mesh
- Step 5b — Approve confirmation receipts — Payment received row-click → Approve
- Step 6 — Confirm the booking status is correct — Portal gates after Booking created alert
- Notification triage — Step 4 — Upstream row-click entry
- Payment alert to receivables triage — Ongoing payment overdue contrast
- Confirmation to check-in handoff — Downstream ~7 days before move-in
- FAQ — Confirmation alert triage hub — Canonical confirmation alert symptom table
Portfolio segmentation by tenant category
Assign Category on Tenant Info in Step 2 before contract mail. Hub parity: Common Workflows — Portfolio segmentation by tenant category. Full pairing matrix: processing-a-new-booking-section-cross-reference · Common Workflows section cross-reference.
- Common Workflows — Portfolio segmentation by tenant category — Hub matrix when workflows must align across reservations, receivables, and profiles
- Glossary — Portfolio segmentation by tenant category hub — Surface table + per-guide/module mesh reciprocal hub
- FAQ — Portfolio segmentation by tenant category hub — Segment filter symptom table
- Settings > Tenant categories — Assign Category before Step 4
- Bookings — Other filters — Tenant category on import triage (Step 1)
- Finance — Tenant category filter — Month-end segment checks after assignment
Key glossary terms
Glossary rows pair with Glossary cluster cross-reference. Full pairing matrix: Processing a New Booking section cross-reference · Common Workflows section cross-reference.
-
Glossary — Same-day turnover — Visual overlap check on Timeline or Multicalendar (Step 1)
-
FAQ — Archive a property — Edit property sidebar Archive / Unarchive on Listings; building-level — not Delete Booking or Cancel booking
-
Glossary — Deposit lifecycle status —
depositStatuspill after confirmation deposit recording (Step 5) -
Glossary — End-of-Booking cost split — Charge Time → End of Booking splits daily overage across every occupied unit; still-staying roommates stay in the denominator (#2111)
-
Operations — Property-level ticket search — Property-name matches share the top relevance tier with unit hits; building-scoped rows float first under an active Property filter (#2089)
-
Glossary — Change history — Operator-initiated edits on Listings setup and Bookings Changelog; create-time defaults excluded (#2093)
-
FAQ — Booking Changelog scope — Operator-initiated edits only; create-time defaults excluded (#2093)
-
Glossary — Archived booking ledger visibility — Delete Booking hides manual/provider_platform rows on Finance → Transactions; vIBAN and credit card stay visible (#1897)
-
Bookings — Provider platform payment — Non-rejected provider platform in-payment blocks Delete Booking until Reject or assign (#2076)
-
FAQ — Delete Booking on integration reservation — Clear pending provider platform in-payment with Reject or assign before soft-archive (#2076)
-
Listings — Property edit sidebar pills — Setup / Full integration / Photos pills on property and unit edit sidebars; replaced the old Go to details shortcut (#2082)
-
Glossary — Finance tenant category cache refresh — Recategorizing a tenant on Tenants → Tenant Info force-refreshes Finance caches so Contract Values, Overview, and Deposits filters match within seconds (#2088)
-
Glossary — SIMAR water contract ID — SIMAR (Loures e Odivelas) water bills use Cód. Local in Connections — not Nº de Contador; leading zeros stripped (#2110)
-
FAQ — SIMAR water bill property match — Cód. Local in Connections — not Nº de Contador; strip leading zeros (#2110)
-
Glossary — Per-booking maintenance ticket opt-out — Add booking checkboxes skip automatic CI/CO tickets for one reservation only; property rule unchanged (#1140)
-
FAQ — Cancel Booking vs Delete Booking — Cancel for real stays with settlement; Delete soft-archives mistaken/test rows (#1897 / #2076)
-
Glossary — Archived property — Archive retires a building to Listings → Archived without deleting bookings; distinct from Delete Booking (reservation soft-archive) — Listings — Archived properties
-
FAQ — Portfolio retirement decisions — Archive property (building) vs Cancel booking vs Delete Booking (reservation soft-archive) — three-way decision table
-
Finance — Deposit lifecycle status cards — Deposit lifecycle status row on Finance → Deposits; click Partial paid for collection shortfalls (#2091)
-
Finance — Deposit status filter — Other filters → Deposit status → Partial paid for portfolio shortfall triage (#2090)
-
Glossary — Pending manual in-payment (Finance) — Approve confirmation receipts before handover (Step 5b)
-
FAQ — Pending manual in-payment on /notifications — Alert persists until Approve payments clears Finance or booking Transactions
-
FAQ — Uncovered Debt KPI — Finance Total Debt minus deposit offsets; pair with Debt Aging and In debt drill-down
-
FAQ — Dashboard Total Debt subtitle — Post-login Total Debt card headline vs >15 days subtitle; ongoing bookings only
-
Glossary — Credit note (payment reject/revert) — Rejecting a mistaken confirmation receipt (Step 5b)
-
FAQ — Manual receipt still pending — When Payment Plan still shows unpaid after Step 5
-
Glossary — Invoiced floor (rent) — Rent edits blocked below exported invoice totals
-
FAQ — Bulk Hostkit invoicing slow — Vivin paces Hostkit API calls and retries HTTP 429 during bulk Issue allocation / Invoice selected; refresh Transactions before re-issuing
-
Glossary — Booking detail sidebar tab load failures — Communication / Tickets recovery while reviewing the reservation
-
Glossary — Draft ticket (display status) — Far-future Schedule date prep jobs
-
Glossary — Ticket — linked cash flows — Contractor spend linked from Operations tickets
-
FAQ — Lower rent below invoiced — Change monthly rent and Edit amount guards
-
FAQ — AI token usage — Poll GET /ai-usage / GET /ai-usage/summary with management JWT;
landlord_chat+utility_bill_extraction; no management UI screen yet -
FAQ — Automatic check-in email — Trigger matrix, 15-day cutoff, paper upload vs portal signing, Nuki-only toggle, Send / Resend on Contract Info
-
FAQ — WhatsApp and email per booking — Bookings → Communication tab when tenant chatbot is enabled; Inbox for portfolio-wide triage
-
FAQ — Deposit missing on Finance Deposits — Default ~3 months date range; clear or widen before triaging older move-outs or dispute row actions
-
FAQ — Analytics (KPI workspace) — Portfolio KPIs vs Sales/Listings/Dashboard; load-failure Try again
-
FAQ — Reject or revert an incoming payment — Reject pending rows or Revert confirmed ones; Finance → Transactions uses Reject selected bulk-only; modals warn about credit notes when Finance already invoiced
-
FAQ — Finance Income status drill-down — Overview Income chart (Paid / Scheduled / In debt); click a segment for month-scoped payment-line modal; Debt Aging for booking-level receivables
-
FAQ — Permission denied toast — Red You do not have permission to perform this action. toast when RBAC blocks a save; fix in Users → Role Permissions
-
FAQ — Phone shows Operations only — Mobile phone user agent locks operators with Operations access to
/operations; iPads and narrow desktop browsers keep the full module list -
FAQ — Notification row-click navigation — On
/notifications, row click marks unread then openslink,bookingId,tenantId,listingId, orpropertyId(first match); Dashboard bell General rows stay in-panel unlesslinkis set -
FAQ — Bookings that owe money — Top debtors and overdue buckets on Finance → Overview; Total Debt KPI is not a table
-
FAQ — Fixed rent on variable unit — Variable listing + equal rent every contract month → booking stores fixed headline Monthly rent; payment plan unchanged
Module documentation hubs
Module hub bullets pair with Modules — Module cross-reference. Full pairing matrix: Processing a New Booking section cross-reference · Common Workflows section cross-reference.
- Finance module — Portfolio ledgers with payment approval and deposit settlement (section cross-reference; Deeper workflow reads; hub)
- Utilities module — Bills Included ceiling model and tenant overage charges (section cross-reference; Deeper workflow reads; hub)
- Sales module — Portfolio availability and Multicalendar overlap checks (section cross-reference; Deeper workflow reads; hub)
- Dashboard module — Post-login KPI snapshot and bell notification triage (section cross-reference; Deeper workflow reads; hub)
- Analytics module — Month-range portfolio KPI charts (section cross-reference; Deeper workflow reads; hub)
- Notifications module — Full
/notificationshistory with row-click navigation (section cross-reference; Deeper workflow reads; hub) - Inbox module — Portfolio-wide WhatsApp workspace (section cross-reference; Deeper workflow reads; hub)
- Booking engine details — Rich marketplace payload editor via the Full integration pill (section cross-reference; Deeper workflow reads; hub)
- Properties workspace — Legacy
/propertiesURL redirects into Listings (section cross-reference; Deeper workflow reads; hub) - AI Chat module — Vivin-internal AI Assistant using Landlord MCP tools (section cross-reference; Deeper workflow reads; hub)
- Audit module — Portfolio-wide Manual Blocks and Discounts review (section cross-reference; Deeper workflow reads; hub)
- Account Settings — Workspace-wide financial policies and integrations (hub subsection index; Deeper workflow reads; hub)
- API Reference hub — Partner HTTP contracts and partial vs full feeds (hub subsection index; hub)