Skip to main content

Audit

First-time workspace setup

Use Manual Blocks and Discounts after Listings (step 13) and Bookings (step 14) inventory exists — month-end hygiene: Manual block hygiene. Requires Listings permission.

Finding your way in this guide

Open Manual Blocks tab for cross-portfolio unavailability review, then Discounts tab for discounted contract values. Pair month-end passes with Manual block hygiene and Dashboard — Vacant Units. Guide subsection map: Audit guide subsection index (tab sections + Related subsections). Habit-specific shortcuts live under Related below.

The Audit workspace (/audit, sidebar Tools → Audit) gives operators two portfolio-wide review surfaces:

  1. Manual Blocks — manual availability blocks (unavailabilities) that can quietly reduce occupancy and revenue without producing income.
  2. Discounts — every contract value with a discount applied, so teams can verify reasons, spot unusual patterns, and quantify revenue impact.

Manual blocks are created and edited from a unit’s Calendar in Listings via Add unavailability. Discounts are applied on booking Contract Values (Bookings — Discounts and payment adjustments) with permission bookings.add_discounts. Audit does not replace those day-to-day surfaces — it centralises cross-portfolio triage in one workspace. Audit is also not the in-sidebar Change history on Listings setup (listings-property-edit-change-history.png) or the booking Changelog on Contract Info → Check-in & Check-out (operator-initiated edits only — FAQ — Booking Changelog scope,; bookings-detail-contract-info-timeline.png), and it does not control which Finance → Transactions rows remain visible after Delete Booking — that ledger gate is separate from Cancel booking; see FAQ — Cancel Booking vs Delete Booking and Glossary — Archived booking ledger visibility. Month-end habit: Manual block hygiene.

Direct access

Open Audit at platform.vivin.app/audit (defaults to Manual Blocks), platform.vivin.app/audit/manual-blocks, or platform.vivin.app/audit/discounts. Bookmarkable routes are in Deep Links — Audit.

Ask AI Chat where to open Audit

Not sure which Tools item holds portfolio block and discount review? Ask AI Chat “Where do I open Audit to review manual blocks and discounts?” — then open Tools → Audit (ai-chat-product-context-audit-reply.png, ai-chat-product-context-audit-flow.mp4). Day-to-day edits stay on unit calendars and booking Contract Values; this workspace is for cross-portfolio hygiene.

AI Assistant — where to open Audit to review manual blocks and discounts

Walkthrough: ask AI Assistant where to open Audit for manual blocks and discounts, then open Tools → Audit.
Pair with other modules

Edit manual blocks from Listings unit calendars; reconcile occupancy with Sales Multicalendar and Bookings → Timeline. Month-end Discounts review can surface receivables that pair with payment overdue rows — row-click opens the booking for Handling a Late Payment — Step 1. When goodwill discounts cluster on one tenant category, add Finance — Tenant category filter or Tenants — Tenant category filter — see Glossary — Tenant category. During Manual block hygiene, poll AI usage API (landlord_chat) when AI Chat or Landlord MCP assists vacancy reconciliation — internal USD cost only

Who can use it​

The Audit nav item and /audit routes use the same guard as Listings: your role needs Listings module permission. Without it, the sidebar entry is hidden and direct URLs show the standard permission state. Administrators adjust access in Users and roles.

Legacy Listings URLs that pointed at a manual-blocks tab now redirect to Audit (/audit/manual-blocks) so bookmarks keep working.

Layout​

  • Page header — Title Audit and a short subtitle about validating portfolio data to prevent errors and revenue loss.
  • Tabs — Pill-style Manual Blocks and Discounts tabs. The URL updates to /audit/manual-blocks or /audit/discounts when selected.
  • Info banner — Collapsible guidance panel per tab (Why audit manual blocks? or Why audit discounts?). Expand it when onboarding new operators or running a seasonal hygiene pass.

Manual Blocks tab​

Pair with other Audit sections

Manual Blocks pairs with Listings — unit calendar for edits and Manual block hygiene when occupancy looks suppressed — reconcile with Sales — Multicalendar.

  • Blocked nights chart + table — When your filters match at least one manual block, a Blocked nights per month bar chart appears in a fixed left column (~288px) beside the Manual Blocks table on the right. The chart is computed on the full filtered set server-side (not only the table rows already loaded), so you can spot seasonal hold patterns while scanning rows. On narrow viewports the table still scrolls horizontally inside its card; the chart stays readable in the left column when space allows.
  • Manual Blocks table — Shared with the listings manual-blocks implementation: unified header and body in one table (search, date range, Created by filter, clickable column headers for server-side sort, infinite scroll, Export CSV or Excel, and — for users with Listings edit permission — row checkboxes, per-row Edit block (pencil) for operator-created manual holds, plus inline and bulk Delete).

Audit — Manual Blocks tab filtered to Maintenance blocks with blocked-nights chart and table

When filters match blocks, the Blocked nights per month chart sits in the left column beside the table (server aggregate over the full filtered set):

Audit — Blocked nights per month chart beside the Manual Blocks table (side-by-side layout)

Expanded Why audit manual blocks? checklist (same tab; banner open):

Audit — expanded “Why audit manual blocks?” guidance above the Manual Blocks table

Toolbar and filters​

Pair with other Audit sections

Created by and date filters pair with Sales — Multicalendar export habits — see Glossary — Export and download issues when Export toasts an error.

ControlPurpose
SearchMatches property name, unit name, or reason text (debounced).
Date rangeLimits blocks whose start/end overlap the selected from–to window (calendar pill, same pattern as Sales multicalendar).
Created byMulti-select of property managers who created the block. The menu stays open while you add another teammate. Applied server-side together with search and date range so the table total, chart, and Export all reflect the same filtered population.
Clear allAppears when any filter is active; removes search, dates, and creator filters.
ExportDownloads the currently filtered rows as CSV or Excel (vivin-manual-blocks-YYYY-MM-DD.*). Disabled when the filtered list is empty.
DeleteUsers with Listings edit permission see a checkbox column, a per-row trash icon, and Delete selected when rows are ticked. Confirmation states how many holds will be removed and that dates become available again. Large batches show a progress counter while deletes run; partial failures keep failed rows selected so you can retry. Booking and channel blocks are not deletable here — only operator-created manual holds. Read-only roles see the same table without delete controls.
Edit blockUsers with Listings edit permission also see a per-row pencil (Edit block) on manual holds (not channel/integration rows). Opens Edit block — change Dates and/or Reason in place without delete-and-recreate. Date changes use the same overlap validations as creation; a reason-only save does not re-check dates. See Editing a manual block.
Column sortClick Unit, Start, End, Nights, Reason, Created by, or Created headers to sort server-side (↕ / ↑ / ↓). Default is Created descending (newest first). Date and night columns default to descending on first click; Unit and Reason default to ascending. Changing sort resets infinite scroll to page 1; Export and the Blocked nights per month chart use the same sort and filters.

Created by is a multi-select: open the control, tick one or more property managers, and remove individual selections with the chip × or use Clear all to reset every filter at once. The table total, Blocked nights per month chart, and Export all use the same server-side filter set. The menu stays open after each tick — see Created by stays open.

Audit — Manual Blocks Created by multi-select open with property-manager options

Audit — Manual Blocks with Created by chip active and Clear all in the filter row

Created by stays open while you pick​

Open Created by on Tools → Audit → Manual Blocks, then tick a teammate. A chip appears under the toolbar; the menu stays open so you can tick a second teammate. You do not need to open Created by again.

The menu lists property managers who can appear as the creator of a hold (display name, with email as a hint). Tick the first name, then a second name. Both stay checked in the open list. The table, Blocked nights per month chart, and Export show blocks created by any of the people you picked — not only holds that list both names. Dismiss the menu when the chips look right — same stay-open habit as Operations — Assignee.

Ticking names here only filters the list. It does not change who created a block.

Date range is a calendar pill, not this menu. Search is a text box. Use Clear all when you want to drop every filter at once.

Operations Tickets → Assignee and Check-in & Check-out → Responsible are different controls on a different module. They filter maintenance work or handover rows, not availability holds.

Open Export, then choose CSV or Excel (.xlsx). Downloads use dated filenames: vivin-manual-blocks-YYYY-MM-DD.csv or vivin-manual-blocks-YYYY-MM-DD.xlsx. If nothing matches the current filters, Export stays disabled.

When the export request fails, Vivin shows a toast instead of silently closing the menu — see Glossary — Export and download issues.

Audit — Manual Blocks Export menu (CSV / Excel); download reflects current filters and sort

Blocked nights per month​

When your account has manual blocks that match the current filters, a Blocked nights per month bar chart appears in a left column next to the table. Each bar is the sum of calendar nights blocked in that month across the entire filtered set — not only the rows already loaded in the table.

Use the chart to spot months with unusually high hold volume before you scroll the full table. Narrowing Search, Date range, or Created by refreshes both the chart and the table from the server with the same query.

Hover a bar to read the exact night count for that month. The chart hides when no blocks match the active filters.

Manual Blocks table loading​

Pair with other Audit sections

Pagination and refresh pair with Glossary — Directory list refresh — Export still downloads the full filtered set without scrolling every page.

The Manual Blocks table is server-paged — it does not download your entire portfolio in one request.

PhaseBehaviour
First paintUp to 20 rows for the active Search, Date range, and Created by filters (newest created first).
ScrollWhen you scroll near the bottom of the main workspace, the next page (20 rows) loads automatically. A short skeleton strip may appear under the table while fetching.
FiltersChanging search, dates, or creator chips resets the table and starts again from the first page.
DoneA footer line shows the server total (for example 42 manual blocks). When every matching row has been fetched, End of list appears beside the count.
ExportCSV / Excel downloads the full filtered set from the server — you do not need to scroll through every page first.

The Blocked nights per month chart always reflects all blocks that match the current filters, even when the table has only loaded the first pages.

When the Manual Blocks chart or table needs a refresh, use Retry — or reload the page. Zero rows after a successful load means your filters matched nothing. See Glossary — Directory list refresh.

Audit — Manual Blocks table loading the next page (skeleton rows under the table)

After you scroll through every page, the footer shows the server total and End of list (for example 42 manual blocks · End of list):

Audit — Manual Blocks table footer with server total and End of list after infinite scroll

Column headers sort server-side across the full filtered set (not only the rows already loaded). The default is Created descending (newest first). Click a header again to reverse direction; click another column to change the primary sort. The same convention as Finance Transactions and Payouts infinite-scroll tables.

Audit — Manual Blocks table with Unit sorted ascending (server-side sort indicator on the header)

Table columns​

ColumnDescription
UnitProperty and unit labels (Property · Unit).
Start / EndBlock boundaries (day-level). End is the last blocked night (to) — see End vs free-again day below.
NightsCalendar nights between start and end (desktop/tablet).
ReasonOperator-entered description from Add unavailability.
Created byTeam member who created the block, when recorded.
CreatedTimestamp when the block was added (widest breakpoints).

End vs free-again day​

Pair with other Audit sections

When a hygiene pass compares Audit → Manual Blocks with Sales → Multicalendar or Bookings → Timeline, expect End and the Gantt hover tip to differ by one day on checkout-style holds.

On Manual Blocks, End formats the stored last blocked night. Hover tips on Sales → Multicalendar and Bookings → Timeline show the day the unit is free again (checkOutDate) — the same checkout convention the unit Calendar already used. Bar geometry still covers blocked nights only; the tip end is one day later when the block stores a checkout.

Example (Owner stay on AA-11-5D-B): Start 10 Aug 2026, End 19 Aug 2026 (9 nights) in Audit — the Multicalendar tip for the same bar ends on 20 Aug 2026 (free again).

Audit — Manual Blocks End column shows last blocked night (19 Aug) for an Owner stay

Sales — Multicalendar Owner stay hover tip ends on free-again day (20 Aug)

Walkthrough: Audit → Manual Blocks End = last blocked night, then Sales → Multicalendar hover tip = free-again day for the same Owner stay.

FAQ: Why does a Multicalendar or Timeline block tooltip end one day after the last blocked night?. Glossary: Manual unavailability (manual block). The same last-night vs free-again split is what a booking site reads on listing JSON (to = last blocked night) — FAQ — Booking site first available day — what Uniplaces, Spotahome, Housing Anywhere, and Inlife catalogues read on full feeds — FAQ — Marketplace listing blocked through check-out night — and what a subscribed calendar reads as exclusive DTEND (free-again morning) — FAQ — iCal block ends one day after Audit End.

Click a row to open the unit listing sidebar in context (same sidebar used in Listings) so you can jump to the unit Calendar or adjust the block if your role includes edit permission.

Audit — Manual Blocks row opens the unit listing sidebar (same drawer as Listings) for calendar and block edits

Editing a manual block​

Pair with other Audit sections

Edit block keeps the block identity — pair with Listings — Editing a manual unavailability block when you prefer the unit Calendar list, and with Manual block hygiene — Step 4 for month-end cleanup.

When a hold’s dates or reason are wrong, use Edit block instead of delete-and-recreate:

  1. Open Tools → Audit → Manual Blocks (optionally search by unit or reason).
  2. On a manual row, click the Edit block pencil (channel/integration rows hide this control).
  3. In Edit block, change Dates and/or Reason, confirm the helper under Dates (N nights · last night …), then Save changes. You can save a reason-only change.

The last night in the helper is the last occupied night — the date field uses the same checkout convention as elsewhere (the range end is the day the unit is free again). Overlap with bookings, other blocks, and preparation days is checked before a date save — the same rules as Add unavailability. A reason-only save does not re-check dates. The unit Calendar exposes the same modal via Edit block on the manual list row.

Audit — Manual Blocks — Edit block on an Owner stay row

Edit block — Owner stay dates and reason

Walkthrough: search Manual Blocks for Owner stay, open Edit block, review Dates and Reason, then Cancel without saving (demo).

Typical workflows​

Pair with other Audit sections

Hygiene passes pair with Portfolio KPI review — Step 6 and Dashboard — Vacant Units after you clear holds that suppressed Today counts.

Hygiene pass before high season​

  1. Open Tools → Audit (or /audit).
  2. Expand Why audit manual blocks? if your team needs the checklist.
  3. Sort by Created (newest first, default) or click End / Nights to surface long holds; narrow with a date range covering the upcoming season when needed.
  4. Scan Reason and End columns for vague text or blocks that should have ended.
  5. Open suspicious rows → unit sidebar → Calendar to edit or remove the hold.
Walkthrough: search the Manual Blocks table → scroll the filtered list → open a row to the unit listing sidebar.

Export for owner or ops review​

  1. Apply filters (for example a date range or Created by).
  2. Click Export → CSV or Excel (see the toolbar screenshot for the menu).
  3. Share the file outside VIVIN for offline sign-off.

Exported rows include property and unit labels, block Start / End, computed Period and Nights, Reason, Created by, and Created timestamp — column headers follow your interface language.

After staff changes​

Filter Created by to a departed operator’s account, then clear blocks they left with unclear reasons — see also Modules — Audit on the overview page and Glossary — Manual unavailability.

Discounts tab​

Pair with other Audit sections

The Discounts tab (/audit/discounts) lists every contract value on your account where a discount was applied. Use it for month-end revenue review, owner reporting, and spotting discounts without a reason, on the wrong payment type, or on already-ended bookings.

Audit — Discounts tab filtered to Studio 12 with KPI cards and a Loyalty courtesy reason on rent

Expanded Why audit discounts? checklist (same tab; banner open):

Audit — expanded “Why audit discounts?” guidance above the filtered Discounts table

KPI summary cards​

Four compact cards summarise the currently filtered population (same query as the table and Export):

CardMeaning
Discounted itemsCount of contract values with a discount in scope (selected date range, or all time when no range is set).
Total discountsSum of discount amounts (€) across those lines.
Avg discount rateTotal discounts as a share of gross (pre-discount) value on discounted lines.
Avg discount / itemAverage discount € per discounted line.

Toolbar and filters​

ControlPurpose
SearchMatches unit, property, or tenant name (debounced).
Date rangeOptional window on the contract-value period / due context. No range = all discounts on the account (default). Clear the range with the × on the pill or Clear all.
Payment typePill filters: All, Rent, and enabled fee types (Admin fee, Exit fee, Cleaning fee, Others) — labels follow your fee settings.
Clear allAppears when search, date range, or payment-type filter is active.
ExportDownloads the full filtered + sorted set as CSV or Excel (vivin-discounts-YYYY-MM-DD.*). Disabled when the filtered list is empty.
Column sortClick Unit, Tenant, Item, Status, Period, Discount, or Net Amount for server-side sort. Default is Discount descending (largest reductions first).

Audit — Discounts Export menu (CSV / Excel); download reflects current filters and sort

When the export request fails, Vivin shows a toast instead of silently closing the menu — see Glossary — Export and download issues.

Discounts table loading​

Pair with other Audit sections

Discounts pagination pairs with Bookings — Other filters → Discounts and Finance — Tenant category filter when goodwill reductions cluster on one segment.

The Discounts table is server-paged — it does not download your entire portfolio in one request.

PhaseBehaviour
First paintUp to 20 rows for the active filters (default sort: Discount descending).
ScrollNear the bottom, the next page loads automatically (5 rows per follow-up). A Loading more… line may appear under the table.
FiltersChanging search, dates, or payment type resets pagination to page 1.
DoneFooter shows N of M discounted items; when every row is loaded, End of list appears under the table.
ExportCSV / Excel downloads the full filtered set from the server — you do not need to scroll through every page first.

When the Discounts list needs a refresh, use Retry — or reload the page. Filtered empty states offer Clear all. An account with zero discounts shows No discounts applied after a successful load.

Table columns​

ColumnDescription
UnitUnit label; property internal name as secondary line when different.
TenantTenant name with avatar; booking status chip (Upcoming, Ongoing, Ended, Cancelled).
ItemPayment type (Rent, Admin fee, Cleaning fee, etc.).
StatusContract-value status (same badges as Finance Contract Values).
PeriodScheduled period / due context for the line.
AmountGross (pre-discount) scheduled amount.
DiscountDiscount € (amber) and % of gross when applicable.
Net AmountAmount after discount — what allocations compare against.
ReasonOperator-entered discount reason (truncated in-cell; full text in Export).

Click a row (when your role can open bookings) to open the booking detail sidebar on the Contract Values tab with the discounted line highlighted — same sidebar as Bookings. The teaching capture below opens Zsófia Veress on AA-11-5D - Studio 12 after searching that unit; the rent line shows 1 discount with Original €123 → €108.

Audit — Discounts row opens booking Contract Values with the Loyalty courtesy rent line highlighted

Typical Discounts workflows​

Pair with other Audit sections

Month-end Discounts review pairs with Handling a Late Payment — Step 1 when receivables follow repricing, not pricing errors — see Glossary — Discount (booking).

Month-end discount review​

  1. Open Tools → Audit → Discounts (or /audit/discounts).
  2. Expand Why audit discounts? if your team needs the checklist.
  3. Optionally set a date range for the closing month; leave it empty for all-time triage.
  4. Scan Reason for blank or vague entries; sort by Discount to surface the largest reductions.
  5. Click a row → booking sidebar → Contract Values to verify or adjust the line (requires bookings.add_discounts).

Export for owner or finance review​

  1. Apply filters (for example Rent only, or a date range).
  2. Click Export → CSV or Excel.
  3. Share the file outside VIVIN for offline sign-off. Exported columns include Booking ID first (Vivin booking UUID), then unit, property, tenant, payment type, period, amounts, discount, net, reason, and statuses.

Audit Discounts — Export menu (CSV / Excel); download includes Booking ID as the first column

Audit Discounts — Excel export column slice highlighting Booking ID before unit and property

Walkthrough: Audit → Discounts → Export → Excel — Booking ID is the first column before unit / property.

Cross-check with Bookings and Finance filters​

Portfolio triage on the Bookings list and Finance Other filters → Booking → Discounts (With / Without) uses the same underlying data. Add Finance → Other filters → Tenant → Tenant category or Tenants — Tenant category filter when goodwill discounts cluster on one segment — see Finance — Tenant category filter. Audit is the dedicated table + KPI + export view for discounted lines only.

Walkthrough: open Discounts → filter Rent → preview Export → open a row to the booking Contract Values sidebar.

Audit guide subsection index​

Pair with other Audit module guide sections

This index pairs Audit tab sections with Related subsections — use it when manual-block hygiene disagrees with Sales Multicalendar or Discounts receivables need Finance triage.

SubsectionWhen to open itPair with
Who can use itListings permission guard for /auditSettings > Users and roles, Listings module
Manual Blocks tabPortfolio-wide unavailability reviewListings — unit calendar, Manual block hygiene, Sales — Multicalendar
Editing a manual blockChange a manual hold’s dates or reason in place (Edit block)Listings — Editing a manual unavailability block, Manual block hygiene — Step 4, FAQ — Edit manual unavailability dates (audit-manual-blocks-edit-dates-action.png, listings-edit-unavailability-flow.mp4)
Toolbar and filtersSearch, date range, Created by, ExportCreated by stays open, Glossary — Export and download issues, Sales — Multicalendar toolbar
Created by stays open while you pickCreated by stays open while you add another teammateToolbar and filters, FAQ — Does picking a second Created by teammate close the Manual Blocks menu?, Operations — Assignee stays open, Manual block hygiene — Step 2
Blocked nights per monthSeasonal hold volume chartDashboard — Vacant Units, Portfolio KPI review — Step 6
Manual Blocks table loadingInfinite scroll and refreshGlossary — Directory list refresh
End vs free-again dayAudit End (last blocked night) vs Multicalendar / Timeline free-again tipSales — Multicalendar, Bookings — Timeline blocks, FAQ — Block tooltip free-again day, Manual block hygiene — Step 3 (audit-manual-blocks-end-last-blocked-night.png, audit-manual-blocks-end-vs-free-again-flow.mp4)
Typical workflowsHygiene pass and owner exportPortfolio KPI review, Bookings — Timeline
Discounts tabPortfolio-wide discounted contract valuesBookings — Discounts and payment adjustments, Finance — Contract Values tab
Discounts table loadingDiscounts pagination and empty statesBookings — Other filters → Discounts, Finance — Tenant category filter
Typical Discounts workflowsMonth-end discount review and exportHandling a Late Payment — Step 1, Notifications — Payment overdue alerts
Lockout catch-up after password recoverySign-in restored; module backlog accumulatedCommon Workflows — Lockout catch-up, Getting Started — Lockout catch-up, Resetting a Management User Password — Step 3
Pending manual receipt approvalRecorded bank transfers still pending until Approve paymentsCommon Workflows — Pending manual receipt approval, Finance — Pending manual payments, FAQ — Manual receipt still pending
Reject/revert mistaken receiptsDuplicate or wrong-booking receipts after ApproveCommon Workflows — Reject/revert mistaken receipts, Payment Allocation — Correcting mistaken receipts, Glossary — Credit note (payment reject/revert)
Notification row-click navigation/notifications row-click before Discounts month-end exportCommon Workflows — Notification row-click navigation, Notification triage — Step 4, Discounts tab
Payment alert to receivables triagepayment overdue on discounted or blocked-unit bookingsCommon Workflows — Payment alert to receivables triage, Handling a Late Payment — Step 1, Notifications — Payment overdue alerts
Confirmation alert triageUpcoming alerts before month-end Discounts sign-offCommon Workflows — Confirmation alert triage, Processing a New Booking — Step 5b, Manual block hygiene
Portfolio segmentation by tenant categoryReview one tenant segment across modulesCommon Workflows — Portfolio segmentation, Settings > Tenant categories, Finance — Tenant category filter, Tenants — Tenant category filter
Finance debt receivables triageDiscounts review when receivables lag behind Top debtors rankCommon Workflows — Finance debt receivables triage, Finance — Finance debt receivables triage, FAQ — Finance debt receivables triage hub, Discounts tab, Handling a Late Payment collections (finance-overview-debt-aging-expanded-bucket.png, finance-overview-debt-aging-walkthrough-flow.mp4)
Finance Income status drill-downDiscounts review may explain inflated Scheduled segments — reconcile Income chart firstCommon Workflows — Finance Income status drill-down, Finance — Income status drill-down, FAQ — Finance Income status drill-down hub, Discounts tab, Finance debt receivables triage (finance-overview-income-status-in-debt-modal.png, finance-overview-income-drill-down-flow.mp4)
Cash flow forecast drill-downDiscounts adjustments may lag Cash flow forecast collections until receipts are approvedCommon Workflows — Cash flow forecast drill-down, Finance Income status drill-down, Finance — Income chart and cash flow forecast, FAQ — Cash flow forecast drill-down hub, Discounts tab, Manual Blocks tab (finance-overview-cash-flow-all-payments-modal.png, finance-overview-cash-flow-day-view.png, finance-overview-cash-flow-drill-down-flow.mp4)
Audit section cross-referencePer-tab pairing matrixModule cross-reference, Listings guide subsection index

Audit section cross-reference​

Use the sections above for this module. Related pages are linked from Related below when present, or from Modules.

Pair with other Audit module guide sections

Related below links this module to settings, concepts, workflows, and escalation paths.

Documentation map & escalation​

Upstream & downstream workflows​

Deeper workflow reads​

See Upstream & downstream workflows above for the same guides.

Settings that shape Audit​

Deeper concept reads​

  • Booking lifecycle — Computed stay status when blocks masked occupancy signals
  • Integrations & Distribution — Manual blocks propagate to every connected marketplace calendar
  • Tenant MCP — Booking-scoped get-listing-calendar, list-bookings-by-email, and notify-landlord when tenants or external assistants surface blocked dates — see Manual block hygiene
  • Landlord MCP — Portfolio-wide get-vacant-units-next-month and get-booking-summary when occupancy signals suggest a hygiene pass before you change rates
  • Tenant Portal — Stale manual blocks can hide units tenants should see as bookable on direct portal or engine flows
  • 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
  • Payment Allocation — Two-layer receipts, invoiced-floor rent edits, and credit note reject/revert warnings

Operator modules (pairing surfaces)​

Operator habit hubs​

Day-to-day operator habits (lockout catch-up, pending receipts, payment triage, handoffs, and related playbooks) live on the Common Workflows habit hub.

Deep-link anchors for habit hubs

Lockout catch-up after password recovery​

Pending manual receipt approval​

Reject/revert mistaken receipts​

Check-out ledger cleanup before refund​

Utility overage collections​

Cancellation collections before void​

Check-out collections before refund​

Handling a Late Payment collections​

Check-out vs cancellation​

Deposit missing on Finance Deposits​

Notification row-click navigation​

Payment alert to receivables triage​

Finance debt receivables triage​

Finance Income status drill-down​

Cash flow forecast drill-down​

Confirmation alert triage​

New inventory to first booking handoff​

Property setup to first arrival handoff​

Confirmation to check-in handoff​

Check-in to check-out handoff​

Check-out final utilities handoff​

Same-day turnover coordination​

WhatsApp per-booking messaging​

Bot reasoning (audit)​

ChatBot settings​

Rent reduction after invoicing​

Occupancy KPI to block hygiene handoff​

Month-end invoicing (fixed date)​

Bulk Hostkit invoicing​

Partly collected security deposit​

Portfolio segmentation by tenant category​

Directory list refresh​

When Manual Blocks or Discounts needs a refresh, use Retry — or reload the page. Zero rows after a successful load means your filters matched nothing — widen filters or clear search.

See FAQ — Directory list refresh and Glossary — Directory list refresh.

Key glossary terms​

  • Discount (booking) — Per-line and booking-scoped reductions; bookings.add_discounts permission
  • Tenant category — Bookings, Finance, and Tenants segmentation when Discounts clusters on one cohort
  • Same-day turnover — Back-to-back stays that need coordinated check-out/check-in after you free a unit from a hold
  • Deposit dispute — Check-out deposit retention unrelated to manual blocks but often reviewed in the same month-end pass as Audit hygiene
  • 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
  • Glossary — Change history — Operator-initiated edits on Listings setup and Bookings Changelog; create-time defaults excluded
  • Glossary — Full term list

API & companion guides​

Module documentation hubs​

  • Audit module — Portfolio-wide Manual Blocks and Discounts contract-value review (this page)
  • Utilities module — Bills Included ceiling model, Connections, AI bill upload, and tenant overage charges on payment plans (hub)
  • Operations module — Maintenance tickets, cash flows, check-in/out coordination, Draft ticket queues, and linked cash flows (hub)
  • Dashboard module — Post-login Today, Total debt, Vacant Units, and forecast KPI snapshot with bell notification triage (hub)
  • Analytics module — Month-range portfolio KPI charts (Overview, Revenue, Occupancy, ADR, RevPAR, Maintenance) with rankings and heatmaps (hub)
  • Listings module — Property wizard, Channels tab, Archived inventory, 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 (Overview, Income, Contract Values, Transactions, Payouts, Deposits) with payment approval and deposit settlement (hub)
  • Tenants module — Tenant directory, profile sidebars, With Debt segmentation, and table expand for linked bookings (hub)
  • Sales module — Portfolio availability, monthly rent editing, and channel manager connections (hub)
  • Inbox module — Portfolio-wide WhatsApp workspace with Dashboard bell Inbox sub-tab deep links (hub)
  • Notifications module — Full /notifications history with search, filters, and row-click navigation (hub)
  • AI Chat module — AI Assistant using Landlord MCP tools for portfolio Q&A (hub)
  • Account Settings — Workspace-wide financial policies, templates, integrations, and operational defaults (hub)
  • API Reference hub — Partner HTTP contracts, Swagger onboarding, and partial vs full feeds (hub)