iCal feeds

First-time workspace setup

iCal export URLs go live after Getting Started — Recommended Setup Sequence steps 11–13 — provision calendar connections on Settings > Integrations (including Short-term iCal Max Date), link each unit on Listings → Channels, and note each listing UUID for feed URLs (Property & Unit Mapping). Complete steps 14–15 and Onboarding a New Property — Step 7 before subscribers treat exported blocks as authoritative. Guide pairing after go-live: Setup sequence after go-live (hub: API Reference — Setup sequence after go-live).

Finding your way in this guide

Start with Operator surfaces (management app) and Feed URL for outbound calendar links, then Retrofeed (Airbnb / Booking.com) when channels need inbound sync. ical-integration does not expose JSON GET /listings — contrast with Listings & Availability. Feed URLs use each listing’s Vivin UUID from Property & Unit Mapping. Non-linear operator habits (Lockout catch-up, Pending manual receipt approval, Reject/revert mistaken receipts, Portfolio segmentation by tenant category, Notification row-click navigation, Payment alert to receivables triage, Confirmation alert triage, Finance debt receivables triage, Handling a Late Payment collections, Finance Income status drill-down, Cash flow forecast drill-down) have matching Related subsections below. Full pairing matrix: iCal feeds section cross-reference · API Reference — API guide cross-reference.

The ical-integration module exposes read-only calendar files for each Vivin listing. Short-term platforms (Airbnb, Booking.com), personal calendars, and other subscribers poll these URLs to block dates when Vivin records a booking or manual unavailability.

Unlike marketplace JSON integrations, ical-integration does not expose GET /listings. Partners subscribe to one URL per listing and receive an text/calendar (.ics) document.

Operator copy URL

Landlords copy outbound feed links from Sales → Channels — Copy iCal on a grid row for one unit, the Airbnb / Booking.com wizard for a linked short-stay unit, or bulk Export when many URLs are needed. The URL pattern matches the API path documented below. See Sales — Channel Manager export and Settings → Integrations — iCal.

Operator surfaces (management app)

Pair with other iCal feeds sections

Copy outbound URLs from Sales → Channel Manager — per-row Copy iCal or bulk Export. Horizon cap: Settings → Integrations. Full endpoint map: iCal feeds section cross-reference.

Partners rarely paste feed URLs by hand — operators copy them from Vivin. These committed captures show where the same {listingId} UUID and /ical-integration/listings/…/iCal.ics pattern appears in the product:

Surface	What you copy or configure
Sales → Channels → actions → Copy iCal	One outbound feed URL per grid row (clipboard toast)
Sales → Channels → Export	Spreadsheet column VIVIN iCal for many filtered units
Sales → Channels → Airbnb / Booking.com cell	Per-unit wizard: inbound platform URL + outbound Vivin link
Settings → Integrations → Channel Manager	Short-term iCal Max Date — caps how far ahead blocks export

Per-row Copy iCal on the Channels grid:

Bulk export (note the VIVIN iCal column in the Channels grid export):

Airbnb two-way setup (step 2 is the outbound Vivin feed operators paste on the OTA; step 3 Sync imports platform blocks). After the link exists, reopen the cell for manage — the same Sync control appears beside Copy on the stored platform iCal URL (see Sales — Airbnb and Booking.com).

Account-wide horizon (dates after this cutoff are blocked on short-term iCal feeds):

Feed URL

Pair with other iCal feeds sections

listingId is the Vivin unit UUID — not marketplace externalId from Property & Unit Mapping. 404 recovery: Error Handling. Full endpoint map: iCal feeds section cross-reference.

Both path variants return the same calendar body:

Path	Notes
GET /ical-integration/listings/{listingId}/iCal	Primary route
GET /ical-integration/listings/{listingId}/iCal.ics	Same response; .ics suffix for clients that require it

• listingId — Vivin listing UUID (the unit’s internal id), not your marketplace externalId. Use the value from Channels export or Listings.
• Authentication — Public read; no Bearer header. Treat URLs as capability secrets — anyone with the link can see blocked dates.

GET /ical-integration/listings/550e8400-e29b-41d4-a716-446655440000/iCal.ics HTTP/1.1
Host: api.vivin.app

Response headers

On success:

Header	Value
Content-Type	text/calendar
Content-Disposition	attachment; filename="calendar.ics"

The body is a standard iCalendar document with VEVENT entries for booked and blocked periods derived from Vivin availability rules.

Errors

Status	Meaning
404	Listing not found or not eligible for export
5xx	Transient server error — retry with backoff

JSON error bodies are only returned when the handler fails before calendar headers are set.

Retrofeed (Airbnb / Booking.com)

Pair with other iCal feeds sections

Generic subscribers receive the full block set — double-booking triage in Troubleshooting. Inbound platform URLs: Inbound platform calendars. Full endpoint map: iCal feeds section cross-reference.

When a subscriber fetches the feed, Vivin can omit blocks that originated on that same platform so short-term sites do not “re-block” their own reservations (retrofeed). Detection uses optional request headers:

Header	Role
Origin	Preferred — host matched against known Airbnb / Booking.com domains
Referer	Used when Origin is absent
User-Agent	Fallback when neither Origin nor Referer identify the consumer

Detected consumer	Feed contents
Airbnb	Blocks from other channels + Vivin manual blocks; Airbnb-originated blocks omitted
Booking.com	Same pattern for Booking.com-originated blocks
Unknown / generic	All blocks included — safe default for opaque subscribers

Generic calendar apps and most PMS tools receive the full block set. Only recognised short-term hosts get the filtered retrofeed.

Horizon and operator settings

Pair with other iCal feeds sections

Short-term iCal Max Date caps forward export — Glossary — Short-term iCal Max Date. Mid-term pricing still requires Listings & Availability JSON pulls. Full endpoint map: iCal feeds section cross-reference.

How far ahead dates are exported is controlled in the management app:

• Settings → Integrations → Short-term (Airbnb / Booking.com) Configuration — Short-term iCal Max Date caps the forward window.
• Apply to all listings / Apply to selected listings on each platform card propagates the cap.

If a subscriber sees availability “cut off” at a future month, verify the operator’s Short-term iCal Max Date before opening an API defect. See Settings → Integrations.

Relationship to partial JSON listings

Pair with other iCal feeds sections

iCal exports blocks only — rent and booking windows live on partial ListingDto rows in Listings & Availability. Full catalogue: Full listing feeds. Full endpoint map: iCal feeds section cross-reference.

Mechanism	Format	Typical consumer
iCal feed (this page)	text/calendar per listing UUID	Airbnb, Booking.com, Google Calendar, legacy PMS
Partial JSON	GET /{platform}-integration/listings	Mid-term marketplaces, channel managers

iCal exports blocks only — not rent, fees, or booking windows. Mid-term partners should use Listings & Availability instead.

Inbound platform calendars

Pair with other iCal feeds sections

Pseudo check-in/out rows on Operations → Check-in & Check-out — Glossary — Short-term iCal pseudo check-in/out. Mid-term handovers: Managing a Check-in. Full endpoint map: iCal feeds section cross-reference.

Vivin is not only an outbound feed publisher. Operators paste inbound Airbnb and Booking.com iCal URLs on Sales → Channels (and on each unit’s Channels tab in Listings). When Vivin syncs those URLs:

Effect in Vivin	What operators see
Availability	Short-stay blocks on the unit Calendar and Sales > Multicalendar (pink iCal blocks in Pricing/Multicalendar)
Operations	Pseudo arrival or departure rows on Operations > Check-in & Check-out — often labelled Booking.com Reservation or the platform name when no mid-term tenant booking exists

Pseudo check-in/out rows help plan turnover but are not substitutes for mid-term bookings: they do not create payment plans, contracts, or tenant portal access. Use Filters → Stay type → Mid-term on the Check-in & Check-out tab for long-stay handover planning; use Short-term when reconciling channel blocks with Multicalendar or Listings calendars.

For operator workflows, see Glossary — Short-term iCal pseudo check-in/out, Managing a Check-in, and Processing a New Booking (when you need a manual mid-term record after a calendar-only import).

Troubleshooting

Pair with other iCal feeds sections

Stale blocks after cancel are usually subscriber cache — contrast with unavailability.* webhooks in Webhooks & Notifications. Manual block audit: Manual block hygiene. Full endpoint map: iCal feeds section cross-reference.

Symptom	Check
Subscriber shows double bookings	Subscriber may be using a generic client (full feed) while also importing the platform’s own calendar — confirm retrofeed headers or use platform-native sync
Dates stop at a future month	Short-term iCal Max Date in Settings
404 on a known unit	Listing archived, wrong UUID, or export disabled for that unit
Stale blocks after cancel	Subscriber poll interval — Vivin updates immediately; external sites cache feeds on their own schedule
Pseudo rows on Operations tab	Expected for inbound iCal blocks — not a defect; filter Stay type → Mid-term for long-stay handovers (Inbound platform calendars)

iCal feeds section cross-reference

Use this table when one iCal topic naturally leads into another API guide, operator UI, or downstream workflow — each row links to the docs you should read before or after wiring calendar export URLs.

API topic / section	Pair with these docs
Operator surfaces (management app)	Sales → Channel Manager, Settings → Integrations
Feed URL	Property & Unit Mapping (UUID vs externalId), Error Handling (404)
Retrofeed (Airbnb / Booking.com)	Inbound platform calendars, Troubleshooting
Horizon and operator settings	Glossary — Short-term iCal Max Date, Listings & Availability
Relationship to partial JSON listings	Full listing feeds, Webhooks & Notifications (unavailability.*), Notifications — Payment overdue alerts → Handling a Late Payment — Step 1 (calendar-only imports), Glossary — Credit note (payment reject/revert), Glossary — Invoiced floor (rent)

| Lockout catch-up after password recovery | Calendar sync backlog after sign-in recovery | Common Workflows — Lockout catch-up, Manual block hygiene, Settings > Integrations | | Pending manual receipt approval | Calendar-imported stays with pending receipts | Common Workflows — Pending manual receipt approval, Finance — Pending manual payments, Processing a New Booking | | Reject/revert mistaken receipts | Stale calendar rows from duplicate imports | Common Workflows — Reject/revert mistaken receipts, Manual block hygiene, Cancelling a Booking | | Portfolio segmentation by tenant category | Segment triage on calendar-imported stays | Common Workflows — Portfolio segmentation, Bookings — Other filters, Settings > Tenant categories | | Notification row-click navigation | Calendar sync vs alert row-click | API Reference — Notification row-click navigation, Common Workflows — Notification row-click navigation, Notifications module — Notification row-click navigation | | Payment alert to receivables triage | iCal pseudo-rows vs payment overdue | API Reference — Payment alert to receivables triage, Common Workflows — Payment alert to receivables triage, Handling a Late Payment — Step 1 | | Confirmation alert triage | Short-stay imports vs confirmation alerts | API Reference — Confirmation alert triage, Common Workflows — Confirmation alert triage, Processing a New Booking — Step 5b | | Finance debt receivables triage | Receivables on calendar imports | API Reference — Finance debt receivables triage, Common Workflows — Finance debt receivables triage, Finance module — Finance debt receivables triage | | Handling a Late Payment collections | Integration surface vs operator collections Steps 1–6 | | Finance Income status drill-down | iCal stays vs Income segments | API Reference — Finance Income status drill-down, Common Workflows — Finance Income status drill-down, FAQ — Finance Income status drill-down hub | | Cash flow forecast drill-down | Turnover-day collections on forecast | API Reference — Cash flow forecast drill-down, Common Workflows — Cash flow forecast drill-down, FAQ — Cash flow forecast drill-down hub |

---

Related

Pair with other iCal feeds guide sections

Related below links calendar export URLs to setup, companion API guides, operator workflows, and escalation paths. Pair Setup sequence after go-live with Getting Started — Recommended Setup Sequence; pair Companion API guides with API Reference hub. Topic-to-guide pairing in sections above: iCal feeds section cross-reference. Full hub matrix: API guide cross-reference.

Setup sequence after go-live

Pair with other iCal feeds guide sections

Complete Account Settings — Recommended setup order before partner traffic. Hub parity: API Reference — Setup sequence after go-live. Full pairing matrix: iCal feeds section cross-reference · API guide cross-reference.

• Setup steps 1–10 — Complete operator workspace basics (Recommended setup order) before requesting partner Bearer keys; property managers automating outside the browser use Management session authentication after step 3 (Users)
• Setup steps 11–12 (Integrations, Integration field capability, Tenant categories default for integrations) — Channel credentials, calendar horizons, and payload field expectations before [email protected] onboarding; operator context: Integrations & Distribution
• Setup step 13 (Listings) — Property wizard, externalId mapping, and Channels tab before first partner listing reads or writes
• Setup steps 14–15 (Bookings, Tenants) — Validate imported reservation shape and tenant segments after partner traffic
• After steps 13–15 — Onboarding a New Property — Step 7 go-live verification before escalating partner pull, webhook, or mapping defects
• After steps 11–12 — set short-term iCal horizons on Settings > Integrations (Glossary — Short-term iCal Max Date) before copying per-listing subscriber URLs from Sales → Channel Manager
• Partner credential requests — Email [email protected] (distinct from in-app Vivin support tickets in Get Help & Support)

Documentation map & escalation

Pair with other iCal feeds guide sections

Documentation-map bullets pair with Introduction — Section cross-reference and FAQ — Section cross-reference. Full pairing matrix: iCal feeds section cross-reference.

• Getting Started — Recommended Setup Sequence before partner HTTP traffic; hub parity: API Reference — Setup sequence after go-live
• API Reference hub — Hub pairing matrix and partial-only integrations; hub parity: Setup sequence after go-live
• Get Help & Support — Escalate iCal export defects or horizon configuration questions (hub: Setup sequence after go-live)
• FAQ — iCal URL — Operator shortcut to the feed pattern (hub: Setup sequence after go-live)
• Glossary — Term definitions used across API and operator docs (hub: Setup sequence after go-live)

Companion API guides

Pair with other iCal feeds guide sections

Companion guides share Bearer authorization or error shapes with this page — start from API Reference hub. Full pairing matrix: iCal feeds section cross-reference.

• Listings & Availability — JSON partial feeds for marketplaces
• Full listing feeds — Partner full JSON exports (distinct from iCal retrofeed)
• Property & Unit Mapping — externalId keys on units that export iCal subscriber URLs
• Creating Bookings — Partner write surface when calendar-only reservations need programmatic confirmation
• Webhooks & Notifications — Push unavailability.* events when partners accept callbacks instead of polling iCal
• Error Handling — 404 on archived units and subscriber cache delays
• Authentication — Partner Bearer keys contrast (iCal feeds are public capability URLs)
• AI usage — Operator JWT ledger when automating month-end reconciliation outside partner HTTP

Upstream & downstream workflows

Pair with other iCal feeds guide sections

Workflow bullets pair with Common Workflows — Workflow cross-reference after partner traffic lands in the management app. Full pairing matrix: iCal feeds section cross-reference.

• Onboarding a New Property — Enable integrations in Settings, then link unit iCal URLs (Step 5)
• Manual block hygiene — Audit pass when iCal or manual blocks suppress availability
• Portfolio KPI review — Reconcile channel occupancy with Analytics after iCal sync changes
• Notification triage — Clear import- or payment-related alerts after calendar-only reservations land; payment overdue → Handling a Late Payment — Step 1
• Handling a Late Payment — Step 1 — Collections when mid-term API imports after iCal blocks leave unpaid confirmation or move-in charges
• Managing a Check-in — Pseudo check-in/out rows from inbound iCal blocks on the handover board
• Managing a Check-out & Deposit Refund — iCal pseudo check-out rows on Operations → Check-in & Check-out during departure week
• Cancelling a Booking — Release calendar rows after cancellation when subscriber feeds stay stale
• Processing a New Booking — Manual mid-term record after a calendar-only import

Operator UI & settings

Pair with other iCal feeds guide sections

Operator UI rows validate the same inventory and permissions behind integration HTTP — pair with Account Settings — Tab cross-reference. Full pairing matrix: iCal feeds section cross-reference.

• Sales → Channel Manager — Copy VIVIN iCal links and bulk export
• Settings > Integrations — Short-term iCal horizon and channel manager cards
• Settings > Preferences — Booking defaults — Preparation-day buffers that extend unavailabilities alongside iCal blocks
• Settings > Preferences — In-app notifications — Booking import alerts when calendar retrofeed reservations land
• Settings > Emails — Lifecycle emails apply only when iCal or API imports create tenant-facing bookings
• Operations — Check-in & Check-out — Pseudo check-in/out rows from inbound iCal blocks
• Property & listing details (booking engine) — Marketing payload fields iCal retrofeed URLs do not export
• Deep Links — Sales — Bookmarkable /sales/channels routes when copying subscriber feed URLs

Deeper concept reads

Pair with other iCal feeds guide sections

Concept reads pair with Concepts hub subsection index and Concept cross-reference. Full pairing matrix: iCal feeds section cross-reference · API guide cross-reference.

• Integrations & Distribution — Operator calendar strategy (section cross-reference; Deeper API reads; hub)
• Payment Allocation — Two-layer receipts, invoiced-floor rent edits, and credit note reject/revert warnings (section cross-reference; Deeper API reads; hub)
• Booking Lifecycle — Computed Upcoming → Ongoing → Ended / Canceled status model, list filters, and Timeline (section cross-reference; Deeper API reads; hub)
• Tenant Portal — Short-stay iCal blocks do not create portal sessions; mid-term API imports do (section cross-reference; Deeper API 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

Deeper workflow reads

Pair with other iCal feeds guide sections

Workflow reads pair with Common Workflows hub subsection index and Workflow cross-reference. Each workflow sub-guide also has its own Deeper API reads subsection with reciprocal companion API anchors — hub parity: API Reference — Deeper workflow reads. Full pairing matrix: iCal feeds section cross-reference · API guide cross-reference.

• Onboarding a New Property — Enable integrations in Settings, then link unit iCal URLs (Step 5) (section cross-reference; Deeper API reads; hub)
• Manual block hygiene — Audit pass when iCal or manual blocks suppress availability (section cross-reference; Deeper API reads; hub)
• Portfolio KPI review — Reconcile channel occupancy with Analytics after iCal sync changes (section cross-reference; Deeper API reads; hub)
• Notification triage — Clear import- or payment-related alerts after calendar-only reservations land (section cross-reference; Deeper API reads; hub)
• Handling a Late Payment — Collections when mid-term API imports after iCal blocks leave unpaid charges (section cross-reference; Deeper API reads; hub)
• Managing a Check-in — Pseudo check-in/out rows from inbound iCal blocks on the handover board (section cross-reference; Deeper API reads; hub)
• Managing a Check-out & Deposit Refund — iCal pseudo check-out rows on Operations → Check-in & Check-out during departure week (section cross-reference; Deeper API reads; hub)
• Cancelling a Booking — Release calendar rows after cancellation when subscriber feeds stay stale (section cross-reference; Deeper API reads; hub)
• Processing a New Booking — Short-term calendar blocks without full booking rows in Step 1 (section cross-reference; Deeper API reads; hub)

Lockout catch-up after password recovery

Pair with other iCal feeds guide sections

Calendar subscribers may keep polling during operator lockout — reconcile Channels and manual-block alerts after sign-in recovery. Hub parity: Common Workflows — Lockout catch-up after password recovery. Full pairing matrix: ical-feeds-section-cross-reference · API guide cross-reference.

• Common Workflows — Lockout catch-up after password recovery — Hub matrix when calendar sync alerts accumulated during lockout
• Getting Started — Lockout catch-up after password recovery — Canonical operational backlog mesh
• Manual block hygiene — Audit pass when iCal blocks disagree with operator UI
• Settings > Integrations — Calendar horizon and retrofeed settings after recovery
• Notification triage — Channel alerts before re-subscribing feeds

Pending manual receipt approval

Pair with other iCal feeds guide sections

iCal export does not surface receipt state — pair with Finance — Pending manual payments on OTA-imported stays. Hub parity: Common Workflows — Pending manual receipt approval. Full pairing matrix: ical-feeds-section-cross-reference · API guide cross-reference.

• Common Workflows — Pending manual receipt approval — Hub matrix when calendar-imported stays await Approve payments
• Processing a New Booking — Short-term calendar blocks without full booking rows
• Finance — Pending manual payments — Amber Pending chip after OTA bank transfers
• Listings & Availability — JSON partial pull contrast for booking-oriented fields
• Payment Allocation — Two-layer model behind approval lag

Reject/revert mistaken receipts

Pair with other iCal feeds guide sections

Phantom calendar rows from duplicate imports pair with Manual block hygiene and receipt Reject / Revert. Hub parity: Common Workflows — Reject/revert mistaken receipts. Full pairing matrix: ical-feeds-section-cross-reference · API guide cross-reference.

• Common Workflows — Reject/revert mistaken receipts — Hub matrix when duplicate OTA receipts block calendar release
• Manual block hygiene — Audit pass when subscriber feeds stay stale
• Cancelling a Booking — Release calendar rows after cancellation
• Audit — Manual Blocks — Portfolio blocks exported in iCal retrofeed
• Glossary — Credit note (payment reject/revert) — Accounting follow-up on invoiced receipts

Portfolio segmentation by tenant category

Pair with other iCal feeds guide sections

Per-listing iCal URLs are unit-scoped — segment operator triage with Bookings — Other filters. Hub parity: Common Workflows — Portfolio segmentation by tenant category. Full pairing matrix: ical-feeds-section-cross-reference · API guide cross-reference.

• Common Workflows — Portfolio segmentation by tenant category — Hub matrix when calendar imports cluster on one segment
• Settings > Tenant categories — Default for integration-created tenants
• Property & Unit Mapping — Listing UUID in feed URLs before segment filters
• Bookings — Other filters — Tenant category on reservation list
• Glossary — Tenant category — Definition and Finance filter parity

Notification row-click navigation

Pair with other iCal feeds guide sections

iCal import alerts on /notifications row-click into bookings — calendar export URLs do not replace operator inbox triage. Hub parity: API Reference — Notification row-click navigation. Full pairing matrix: iCal feeds section cross-reference · API guide cross-reference.

• API Reference — Notification row-click navigation — Hub matrix (notifications-module-row-click-target.png, notifications-row-navigation-flow.mp4)
• Common Workflows — Notification row-click navigation — Operator procedure hub
• Notifications module — Notification row-click navigation — Canonical /notifications inbox pairing
• FAQ — Notification row-click navigation hub — Symptom table

Payment alert to receivables triage

Pair with other iCal feeds guide sections

Calendar-imported stays may show payment overdue when OTA payouts lag — row-click into Transactions before collections. Hub parity: API Reference — Payment alert to receivables triage. Full pairing matrix: iCal feeds section cross-reference · API guide cross-reference.

• API Reference — Payment alert to receivables triage — Hub matrix (notifications-row-navigate-to-booking-detail.png, notifications-row-navigation-flow.mp4)
• Common Workflows — Payment alert to receivables triage — Operator procedure hub
• Handling a Late Payment — Step 1 — Collections follow-through after row-click
• FAQ — Payment alert to receivables triage hub — Symptom table

Confirmation alert triage

Pair with other iCal feeds guide sections

Short-term iCal pseudo-rows can trigger Upcoming alerts — distinguish from duplicate POST /bookings during Processing a New Booking — Step 1. Hub parity: API Reference — Confirmation alert triage. Full pairing matrix: iCal feeds section cross-reference · API guide cross-reference.

• API Reference — Confirmation alert triage — Hub matrix (notifications-row-navigate-to-booking-detail.png, bookings-detail-transactions-approve-payment-modal.png)
• Common Workflows — Confirmation alert triage — Operator procedure hub
• Processing a New Booking — Step 5b / Step 6 — Canonical confirmation gates
• FAQ — Confirmation alert triage hub — Symptom table

Finance debt receivables triage

Pair with other iCal feeds guide sections

Calendar-import receivables feed Top debtors — triage after row-click when iCal blocks overlap partner JSON imports. Hub parity: API Reference — Finance debt receivables triage. Full pairing matrix: iCal feeds section cross-reference · API guide cross-reference.

• API Reference — Finance debt receivables triage — Hub matrix (finance-overview-income-chart-debt-aging.png, finance-overview-debt-aging-walkthrough-flow.mp4)
• Common Workflows — Finance debt receivables triage — Operator procedure hub
• Finance module — Finance debt receivables triage — Debt Aging canonical surface
• FAQ — Finance debt receivables triage hub — Symptom table

Handling a Late Payment collections

Pair with other API Reference hub sections

Partner integration reads on Ical Feeds do not replace operator collections — payment overdue in-app rows still need Handling a Late Payment — Steps 1–6 after receivables triage. Hub parity: Common Workflows — Handling a Late Payment collections hub. Full pairing matrix: ical-feeds-section-cross-reference · API guide cross-reference.

• API Reference — Handling a Late Payment collections — Hub matrix (finance-overview-income-chart-debt-aging.png, notifications-row-navigate-to-booking-detail.png)
• Common Workflows — Handling a Late Payment collections hub — Operator procedure hub
• Payment alert to receivables triage — payment overdue alert before collections
• Finance debt receivables triage — Debt Aging before tenant outreach
• Handling a Late Payment — Step 1 — Collections follow-through
• FAQ — Handling a Late Payment collections hub — Symptom table

Finance Income status drill-down

Pair with other iCal feeds guide sections

iCal-import payment lines affect Income segments — segment-click modals when calendar and API imports disagree. Hub parity: API Reference — Finance Income status drill-down. Full pairing matrix: iCal feeds section cross-reference · API guide cross-reference.

• API Reference — Finance Income status drill-down — Hub matrix (finance-overview-income-status-in-debt-modal.png, finance-overview-income-drill-down-flow.mp4)
• Common Workflows — Finance Income status drill-down — Operator procedure hub
• Finance module — Income status drill-down — Canonical Finance → Overview surface
• FAQ — Finance Income status drill-down hub — Symptom table

Cash flow forecast drill-down

Pair with other iCal feeds guide sections

Back-to-back iCal turnover days affect Cash flow forecast month bars — pair with Same-day turnover coordination. Hub parity: API Reference — Cash flow forecast drill-down. Full pairing matrix: iCal feeds section cross-reference · API guide cross-reference.

• API Reference — Cash flow forecast drill-down — Hub matrix (finance-overview-cash-flow-all-payments-modal.png, finance-overview-cash-flow-day-view.png, finance-overview-cash-flow-drill-down-flow.mp4)
• Common Workflows — Cash flow forecast drill-down — Operator procedure hub
• Finance module — Cash flow forecast drill-down — Canonical Finance → Overview surface
• FAQ — Cash flow forecast drill-down hub — Symptom table

Key glossary terms

Pair with other iCal feeds guide sections

Glossary rows pair with Glossary cluster cross-reference and receipt-dispute workflows. Full pairing matrix: iCal feeds section cross-reference.

• Glossary — Short-term iCal pseudo check-in/out — Inbound iCal rows on Operations

• Glossary — Deposit lifecycle status — iCal-imported short stays may skip full deposit collection; operator depositStatus still applies when deposit is configured

• Glossary — End-of-Booking cost split — Charge Time → End of Booking splits daily overage across every occupied unit; still-staying roommates stay in the denominator (#2111)

• Glossary — Change history — Operator-initiated edits on Listings setup and Bookings Changelog; create-time defaults excluded (#2093)

• FAQ — Booking Changelog scope — Operator-initiated edits only; create-time defaults excluded (#2093)

• Glossary — Archived booking ledger visibility — Delete Booking hides manual/provider_platform rows on Finance → Transactions; vIBAN and credit card stay visible (#1897)

• Bookings — Provider platform payment — Non-rejected provider platform in-payment blocks Delete Booking until Reject or assign (#2076)

• FAQ — Delete Booking on integration reservation — Clear pending provider platform in-payment with Reject or assign before soft-archive (#2076)

• Listings — Property edit sidebar pills — Setup / Full integration / Photos pills on property and unit edit sidebars; replaced the old Go to details shortcut (#2082)

• Glossary — Finance tenant category cache refresh — Recategorizing a tenant on Tenants → Tenant Info force-refreshes Finance caches so Contract Values, Overview, and Deposits filters match within seconds (#2088)

• FAQ — Finance tenant category filter parity — Finance Other filters drawer lists segments on cached bookings only; mirror Bookings / Tenants when a segment is missing

• FAQ — Assign tenant category for direct booking — Add booking has no category field; assign on Tenants → Tenant Info or + Create New → Tenant before contract mail

• 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 — Archive a property — Edit property sidebar Archive / Unarchive on Listings; building-level — not Delete Booking or Cancel booking

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

• FAQ — Partly collected security deposit — Paid above zero but below Amount on booking Deposit; Partial paid card on Finance → Deposits (#2090 / #2091)

• Finance — Deposit status filter — Other filters → Deposit status multi-select 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 — Same-day turnovers — Check-out + check-in on one unit same day: Operations → Check-in & Check-out, Timeline / Multicalendar, turnover tickets

• FAQ — Manual payments after Delete Booking — Delete Booking hides manual/provider_platform rows on Finance → Transactions; vIBAN and credit card stay visible (#1897)

• Glossary — Directory list load failures — First-fetch directory failures show Retry / Try again; distinct from filter-empty states and booking-sidebar tab errors

• Glossary — Vacant Unit Preference — Include manual blocks counts operator holds as free on Dashboard / Sales vacancy surfaces (#1427)

• FAQ — Communication or Tickets load failure — Tab-scoped Refresh (Communication) or Retry (Tickets); other booking sidebar tabs stay usable

• Operations — Property-level ticket search — Property-name matches share the top relevance tier with unit hits; building-scoped rows float first under an active Property filter (#2089)

• Glossary — Short-term iCal Max Date — Horizon configured on Settings > Integrations before copying subscriber URLs

• Glossary — Credit note (payment reject/revert) — Reject/revert follow-up when iCal-only reservations have already-invoiced receipts

• Glossary — Deposit dispute — Check-out deposit retention on short-stay channel bookings

• Glossary — Invoiced floor (rent) — Rent edits blocked below exported invoice totals after iCal import repricing

• 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

• FAQ — Bulk Hostkit invoicing hub — Symptom table + per-guide mesh

• 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 — 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

• FAQ — Analytics (KPI workspace) — Portfolio KPIs vs Sales/Listings/Dashboard; load-failure Try again

• FAQ — Lower rent below invoiced — Change monthly rent clamps and Contract Values → Edit amount blocks net below exported invoice totals; use credit notes in accounting when you truly need a reduction

• Glossary — Fixed invoice date — Account-wide Invoice date before bulk Issue allocation / Invoice selected; amber banner on Finance → Transactions until you turn Use today as invoice date back on

• FAQ — Month-end invoicing (fixed date) hub — Symptom table + toggle reset after batch

• 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 — Manual receipt still pending — Operator-recorded receipts stay pending until Approve payments; triage on Finance → Transactions (Pending chip) or booking Transactions; Total Debt and Manual Payments KPI lag until approval

• FAQ — Finance Income status drill-down hub — Symptom table for segment vs Debt Aging

• FAQ — Finance Income status drill-down — Overview Income chart (Paid / Scheduled / In debt); click a segment for month-scoped payment-line modal; Debt Aging for booking-level receivables

• FAQ — Cash flow forecast drill-down hub — Symptom table for collections vs Income / Dashboard

• FAQ — Cash flow forecast drill-down — Month / Day bar-click habit

• FAQ — 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 opens link, bookingId, tenantId, listingId, or propertyId (first match); Dashboard bell General rows stay in-panel unless link is 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

Pair with other iCal feeds guide sections

Module hubs pair with Modules — Module cross-reference for screen-by-screen operator follow-up. Full pairing matrix: iCal feeds section cross-reference.

• Bookings module — Full API bookings imported alongside iCal-only pseudo reservations (hub)
• Audit module — Cross-portfolio manual block review (hub)
• Analytics module — Occupancy reconciliation after iCal sync changes channel availability (hub)
• Listings module — Property wizard, Channels tab, and unit management (hub)
• Properties workspace — Legacy /properties URL redirects into Listings (hub)
• Booking engine details — Rich marketplace payload editor via the Full integration pill (hub)
• Finance module — Portfolio ledgers with payment approval and deposit settlement (hub)
• Tenants module — Tenant directory and profile sidebars (hub)
• Sales module — Portfolio availability and channel manager connections (hub)
• Utilities module — Bills Included ceiling model and tenant overage charges (hub)
• Operations module — Maintenance tickets, cash flows, and check-in/out coordination (hub)
• Dashboard module — Post-login KPI snapshot with bell notification triage (hub)
• Inbox module — Portfolio-wide WhatsApp workspace (hub)
• Notifications module — Full /notifications history with search and filters (hub); Payment overdue alerts when API imports after iCal blocks leave unpaid schedules
• AI Chat module — Vivin-internal AI Assistant using Landlord MCP tools (hub)
• Account Settings — Workspace-wide financial policies, templates, integrations, and operational defaults (hub)