← WinCloudCONTENT HISTORY

Update to WinCloud

Snapshot Nov 15, 2026 · 18:11 UTC · version 0.1.0

Collection source: downloaded plugin package.

WHAT CHANGED

First saved snapshot

No earlier snapshot is available to establish a change.

Save WinCloud and check future changes in Following.

Up to 3 plugins free · no card required.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "description": "Use when a user asks how full the hotel will be, for an occupancy forecast, expected rooms or occupancy for coming days, weeks or months, which dates are weak or sold out, or how many rooms are still to sell. Estimates future occupancy from the reservations already on the books in WinCloud, optionally adding typical late bookings from the past.",
  "included_files": [],
  "name": "wincloud-occupancy-forecast",
  "skill_md_contents": "---\nname: wincloud-occupancy-forecast\ndescription: Use when a user asks how full the hotel will be, for an occupancy forecast, expected rooms or occupancy for coming days, weeks or months, which dates are weak or sold out, or how many rooms are still to sell. Estimates future occupancy from the reservations already on the books in WinCloud, optionally adding typical late bookings from the past.\n---\n\n# Occupancy forecast\n\nFollow `wincloud-report-format`. This is an estimate. Say so in the headline area and again in the caveats.\n\nResolve hotel names with `list_companies` before gathering data, and label every hotel by name in the output, as `wincloud` explains. For several hotels, use one row or series per hotel name.\n\n## Capacity\n\nTotal rooms = the sum of total rooms across room types from `get_inventory` (or `list_room_types`). `list_companies` also gives each location's room count; if the two differ, use the room-type sum and say so. Use one figure for the whole window, and say that out-of-order rooms are not known.\n\n## Step 1: Rooms on the books, per night\n\n1. Choose the window (default: next 30 days, at most 90). Turn it into exact dates.\n2. Call `search_bookings` with `departureFrom` = window start and `arrivalTo` = window end. This returns every stay that touches the window, including ones that began earlier. Read all pages; if there are more than 15, say the forecast covers only the pages read and narrow the window.\n3. Keep only Confirmed, Tentative, Provisional and CheckedIn; drop every other status (Cancelled, NoShow, TurnAway, WaitingList, CheckedOut, Unknown).\n4. For each booking, count its rooms on every night from arrival up to, but not including, departure. Add them up per night. A night is occupied from the arrival date; the departure date is free.\n5. On-the-books occupancy per night = rooms on the books ÷ total rooms.\n\nMark Tentative and Provisional separately (a lighter shade): they may not convert.\n\n## Step 2 (optional): Likely late bookings\n\nOnly if the user wants a fuller forecast and you can afford the calls:\n\n1. Do Step 1 for the same dates one year earlier (or the last comparable period), but **keep CheckedOut** as well: those nights are past, so the guests who stayed now show as CheckedOut. Count only bookings made at least as many days before each night as today is before the forecast night. That is last year's position at the same point.\n2. Compare it with last year's final result for those nights (CheckedOut and CheckedIn bookings: the stays that actually happened). The gap is last year's late pickup. Bookings cancelled since then no longer count, so last year's position is slightly understated; say so.\n3. Add that gap, as a share of last year's position, to this year's on-the-books figure. Cap the result at 100%.\n\nIf last year is missing, too thin, or unlike this year (an event, a closure), skip Step 2 and say why. Don't invent a pickup.\n\n## Show\n\n- **Headline:** the average occupancy for the window, the strongest and weakest dates, and the number of rooms still to sell.\n- **Chart:** line or bars by date: on-the-books occupancy solid; the estimate with late bookings (if you did Step 2) dashed or lighter. Mark Tentative on its own if significant.\n- **Table:** weeks or the 7 weakest dates with rooms on the books, rooms still to sell and occupancy.\n- **Caveats:** the method, the window and hotel, the pages read, and:\n  - walk-ins and late bookings are not predicted unless Step 2 was done;\n  - events, holidays, price changes and overbooking are not known;\n  - the figure is an estimate to verify before it drives pricing or staffing.\n\n## Limits\n\n- `get_inventory` is today's snapshot, so it is not a source of future availability. Future occupancy always comes from bookings.\n- Group blocks and allotments may not appear as bookings; the forecast can understate them.\n- Don't present a forecast as a promise or as the hotel's official figure.\n"
}

SHA-256 of public snapshot: 67bf84d881e2641e7a30aadef37cd2ac2ae8906b5543d163a5f8542b3b51a41d