Hospitality Architecture & Specs

Restaurant-grade hospitality platform — 18 OTA adapters, night-audit end-of-day reconciliation, resilient channel sync with automatic failure recovery, rate-limiting, and duplicate protection, AI-routed guest communications across email/SMS/WhatsApp, folio post/stay billing, deterministic pricing engine, AI housekeeping task optimization, and predictive maintenance.

Performance & Operations Metrics

Pricing Computation

instant rule evaluation, cached per room-type + date, with no lag on the booking path

OTA Sync Latency

<30 seconds via native channel API integration

Night Audit Steps

12 sequential steps, 4-category financial reconciliation

Digital Key Encryption

AES-256-GCM with a per-property key, cached briefly for performance

Guest Deduplication

Automated cross-channel matching, running continuously in the background

WhatsApp AI Concierge

70% automation rate on routine requests

Channel Resilience

Automatic failure detection with safe, automatic retry

GDS Support

Sabre, Amadeus, Travelport

Architecture Overview

DomainCapability surface
**Financial**Night-audit close, folio post/stay charges, payment processing + refunds, AR, charge calc, cashier
**Channels (OTA/GDS)**18 adapters — Booking.com, Expedia, Airbnb, VRBO, Agoda, Hotels.com, TripAdvisor, Priceline, Hostelworld, Despegar (LATAM), Trip.com (China), Trivago, HRS, Kayak, Google Hotel Ads + GDS via Sabre, Amadeus, Travelport
**Communications**Multi-channel routing (Email / SMS / WhatsApp) + WhatsApp Business API integration
**Concierge**AI intent routing, sentiment NLU
**AI operations**Upsell engine, predictive housekeeping routing, sustainability tracker
**Digital keys**AES-256-GCM BLE / NFC / QR / PIN
**Pricing**Deterministic pricing engine + demand forecasting
**Operations**Housekeeping route optimization (AI), predictive preventive maintenance
**Groups & MICE**Group management + MICE event management
**Loyalty**Points engine + tier management
**Reservations**Continuous cross-channel guest deduplication
**Availability**Multi-factor availability check
**Bridge hardware**Property-side hardware integration (locks, kiosks, terminals)

1. Night Audit — 12-Step End-of-Day Reconciliation

Night audit runs the critical end-of-day close process, executing 12 sequential reconciliation steps across every operating department.

What each run reports:

Every night-audit run returns a structured summary — overall status, per-step results, financial totals (room charges, taxes, fees, penalties), occupancy metrics (rooms sold and available, occupancy %, ADR, RevPAR, out-of-order rooms), no-shows, early departures, stayovers, any discrepancies, housekeeping tasks created, warnings, errors, how long the run took, and a GM morning briefing (arrivals, departures, VIP guests, occupancy forecast, and the next business date).

12 Audit Steps:

1. Verify room status 2. Post room charges (nightly rate + taxes, per in-house reservation) 3. Process no-shows (unconfirmed check-ins get a 1-night penalty) 4. Process early departures 5. Handle stayovers (guests due out today who haven't checked out) 6. Post recurring charges (parking, internet, and other property-configured add-ons) 7. Verify payment authorizations (folio balance vs. authorized amount) 8. Create housekeeping tasks (departure cleans + stayover cleans) 9. Calculate occupancy statistics (rooms sold, occupancy %, ADR, RevPAR, OOO count) 10. Create the audit log (immutable night_audit_logs record) 11. Advance the business date 12. Generate reports (the GM morning briefing)

ADR/RevPAR computation:

ADR (Average Daily Rate) = total room revenue ÷ rooms sold RevPAR (Revenue per Available Room) = total room revenue ÷ rooms available

Example: ADR of $180 means the average room sold for $180 that night; RevPAR of $126 is the revenue earned per available room, factoring in occupancy.

Dry-run mode:

You can run the full audit in preview mode — every step validates and reports exactly what it would do, without posting anything to the ledger or closing the business date. Useful for a final check before committing the day.

2. Channel Sync — 18-OTA Resilient Sync

ChannelCategoryNotes
**Sabre**GDS/Lodging APILargest GDS partner
**Amadeus**GDS/Cloud ServicesHotel Service V5
**Travelport**GDS/Apollo/GalileoMulti-GDS support
**Booking.com**OTA API v3Largest direct OTA
**Google Hotel Ads**Google HAFree booking links
**Trivago**Trivago APIMetasearch
**Trip.com**Trip.com APIChina market
**TripAdvisor**TripAdvisor APIReview integration
**Airbnb**Airbnb APIShort-term rental
**Hotels.com**Hotels.com API
**Expedia**Expedia Rapid API
**Despegar**Despegar APILATAM market
**HRS**HRS APIEuropean market
**VRBO**VRBO APIVacation rental
**Priceline**Priceline API
**Hostelworld**Hostelworld APIBudget segment
**Agoda**Agoda APIAPAC market
**Kayak**Kayak APIMeta-search

3. Guest Communications — Email/SMS/WhatsApp AI Router

Guest communications manages every outbound guest touchpoint across email, SMS, and WhatsApp, with templated messaging and AI-driven WhatsApp intent routing.

Provider coverage:

  • Email: SendGrid, Amazon SES, Mailgun, Postmark, Resend, or your own SMTP server.
  • SMS: Twilio, Telnyx, Plivo, or Vonage.

Switching providers is a configuration change, not a rebuild — every provider sends through the same template and delivery-tracking layer.

Templates: Each message template (email, SMS, or WhatsApp) supports a subject line, plain and HTML bodies, and {{variable}} placeholders — e.g. "Dear {{guestName}}, your room {{roomNumber}} is ready" becomes "Dear John Smith, your room 301 is ready" at send time.

WhatsApp AI routing: An inbound WhatsApp message is classified for intent the moment it arrives. Routine requests get an instant templated response; complex ones escalate to your helpdesk with full context. Intents handled autonomously include late-checkout requests, extra-towel requests (which dispatch housekeeping directly), restaurant reservations, checkout-time questions, and billing questions — while complaints are escalated with a sentiment score attached so staff know how urgent it is.

Automated guest lifecycle messages:

  • Pre-arrival (48h before check-in): directions, parking info, digital key instructions.
  • Check-in confirmation: room number, key instructions, WiFi credentials.
  • Daily morning brief: today's weather, hotel activities, restaurant hours.
  • Pre-departure (evening before checkout): checkout time, folio summary, late-checkout offer.
  • Post-stay (2h after checkout): NPS survey with review links.

4. Folio — Post/Stay Billing Engine

Folio billing manages the complete guest billing lifecycle, from pre-arrival deposit through post-departure reconciliation.

What's on a folio:

Every folio tracks its status (open, closed, or transferred), the business date, a running list of transactions, subtotal, taxes, fees, discounts, total, payments received, and the remaining balance — in the guest's currency. Transaction types cover room charges, taxes, fees, penalties, restaurant, minibar, laundry, telephone, parking, spa, shop, and other incidentals, each linked back to its source (an order, a charge) and stamped with who posted it and when.

Where charges come from:

  • Room charges post automatically every night as part of night audit.
  • Commerce charges — restaurant, spa, shop — sync to the folio in real time the moment an order is placed elsewhere on the property.
  • Minibar charges post automatically from BLE weight sensors the instant an item is removed — no manual entry, no clipboard.
  • At checkout, the folio closes and transfers to the master folio or the guest's card on file.

5. Pricing Engine — Rule-Based Yield Management

The pricing engine evaluates your prioritized yield-management rules instantly and caches the resolved rate per room type and date, so high-traffic booking windows read from cache instead of recomputing on every request.

Rule evaluation: Each rule has a priority, a condition (e.g. "occupancy above 85%"), an adjustment (e.g. "increase rate 25%"), and the room types it applies to. The highest-priority matching rule wins; the resolved rate — along with which rule applied and why — is cached per room-type/date and refreshed automatically whenever occupancy changes.

Demand forecasting considers: historical occupancy patterns (seasonality), the local event calendar (concerts, conferences, sports), your competitive set (manual or auto-tracked rates), advance booking velocity, and cancellation patterns. From these it produces, for any future date: predicted occupancy, a confidence score, a demand level (low/moderate/high/peak), competitor rates nearby, local events driving demand, and a recommended rate with the suggested adjustment from your base rate.

Rate plans support a base rate and currency, stay restrictions (minimum/maximum stay, closed-to-arrival, closed-to-departure, blackout dates), inclusions (e.g. breakfast, parking), a cancellation policy (free / penalty / non-refundable, with configurable penalty terms), and per-channel assignment (direct, OTA, GDS, corporate, or group).

6. Housekeeping — AI Route Optimization

Housekeeping tasks route to staff mobile devices using AI path optimization and Kanban-style workload limits, so rooms turn over on time without burning out your team.

How tasks get created and assigned: the moment a guest checks out, Aeion calculates the expected room-ready time — factoring in checkout timing, whether the room needs a deep clean or standard turnover, and each housekeeper's current workload — then creates a task (with priority, floor, zone, and estimated time) and routes it to the best-available housekeeper.

Route optimization minimizes walking distance between consecutive rooms, grouping by floor and zone and accounting for task type and each housekeeper's skills, so no one is zig-zagging across the property. VIP-flagged tasks are always prioritized. Workload limits (a configurable cap — 8 rooms in progress per housekeeper by default) keep any one person from being overloaded; overflow automatically routes to on-call staff.

Predictive ready-time: for every checkout, Aeion predicts when the room will actually be ready — using historical turnaround times by room type, time-of-day cleaning-speed patterns, housekeeper skill level, and whether it's a deep clean or standard clean — along with a confidence level and a suggested assignment (e.g., "assign to the fastest housekeeper on this floor").

7. Guest Profile Deduplication

Prevents duplicate guest profiles when the same person books through different channels, OTAs, or direct.

How guests get matched: Aeion tracks every channel a guest has booked through and continuously runs matching in the background — hourly for routine dedup, and on-demand for bulk imports. Matches are ranked by confidence: an exact email match is treated as certain; a matching name plus phone number is treated as likely; a matching name plus postal code, or a shared device, is treated as a possible match. High-confidence matches merge automatically; lower-confidence matches queue for a quick manual review so profiles never merge incorrectly.

8. Digital Keys — AES-256-GCM Encrypted

Full digital key lifecycle: issuance, delivery, validation, and remote revocation.

Key formats: BLE keys are a device-bound encrypted token that auto-unlocks as the guest approaches, cryptographically signed so the lock can verify it hasn't been tampered with. QR keys are an encrypted code for a manual scan; NFC keys are an encrypted tag for a tap; PIN keys are a numeric code with brute-force protection at the lock.

Issuing a key: Aeion generates a per-property encryption key, builds the key payload (room, guest, expiry), encrypts it with authenticated AES-256-GCM encryption, stores it securely, and notifies the door lock. The guest receives their key instantly — as a QR code, an auto-unlock BLE credential, or both.

Revoking a key: marking a key revoked immediately notifies the lock system, so the very next attempt to use that key — lost, stolen, or simply after checkout — is rejected.

9. Group Management + MICE — Corporate Groups

MICE: Meetings, Incentives, Conferences, Exhibitions

A group booking tracks the group name and type (meeting, incentive, conference, exhibition, or wedding), company and contact details, dates, room blocks, banquet events, amenities, negotiated rate, payment terms (net-15/30/60 or post-event), and status through the sales pipeline (inquiry → proposal → confirmed → in-house → post-event).

Room blocks reserve inventory for a group: room type, date range, room count, the pickup-due date by which the group must commit to a final count, an auto-release date if they don't confirm, and an attrition allowance — the percentage of rooms the property can release if the group's numbers fall short.

Banquet Event Orders (BEOs) capture everything an event needs: name, date, start and end time, venue assignment, expected and guaranteed attendance (guaranteed count is what gets billed even if fewer guests show), menu and beverage package, setup style (theater, classroom, banquet, u-shape, or cocktail), and any special notes.

Key Architecture Decisions

Channel dedup

Automatic duplicate prevention — A retried or replayed update never creates a duplicate reservation

Channel resilience

Automatic failure detection + pause — One broken OTA connection can't cascade into a platform-wide outage

Rate limiting

Per-connection pacing — Respects each OTA's own API quota automatically, no manual throttling

Pricing computation

Deterministic, cached rule engine — Rate lookups stay instant even under high-traffic booking windows

Key encryption

AES-256-GCM — Authenticated encryption (built-in tamper-evident auth tag) for key payloads

Key caching

Short-lived per-property cache — Fast key issuance without sacrificing per-stay security

Night audit

12 sequential steps — Full department reconciliation before the business date closes

Folio sync

Event-driven, real-time — F&B/spa/retail charges land on the folio instantly, no polling delay

Housekeeping routing

Nearest-neighbor path optimization — Route plans compute fast enough to update live as guests check out

Guest dedup

Continuous background matching — Bulk imports never overwhelm the matching queue

WhatsApp AI

Intent classification → respond/escalate — 70% of routine guest requests handled autonomously

18 OTA Adapters. One Unified PMS.

Capability Surface — Selected Subsystems

Maintenance & preventive PM

predictive maintenance scheduling, work-order management, asset lifecycle tracking

Group management & MICE

corporate groups, room blocks, banquet events, master folios

Payments & AR

multi-method payment processing, refunds, charge calculation, accounts receivable, cashiering

Demand & pricing

AI revenue forecasting, dynamic pricing, tier evaluation, points engine

Guest communications

WhatsApp / SMS / email AI concierge, sentiment analysis, guest deduplication

Operational AI

predictive housekeeping, upsell engine, sustainability tracker, queue management

Digital key & access

AES-256-GCM digital keys, mobile + RFID, hospitality-side Bridge integration

Reservation core

availability search, reservation lifecycle, tax engine, OTA channel sync

Channels & GDS

18 OTA adapters (Booking.com, Expedia, Airbnb, …), GDS support (Sabre, Amadeus, Travelport)