Skip to content

โฌ†๏ธ Room Upgrade

Topic: RESERVATION_ROOM_UPGRADE

What It Does

A room upgrade (upsell) has been applied to the reservation, changing the unit group to a higher category.

Key Info

  • Object: Reservation
  • Actors: Guest or Staff
  • Source: BACKOFFICE, GUEST_JOURNEY

When It Fires

  • Guest selects a room upgrade offer during the guest journey
  • Staff applies an upsell to a reservation via the backoffice
  • A payment-linked upsell completes successfully

Context Data

{
  "originalUnitGroupId": "ug-standard-double",
  "upgradedToUnitGroupId": "ug-deluxe-suite",
  "pmsUpsellRuleId": "upsell-rule-42",
  "totalAmountDifference": {
    "grossPriceInCents": 5000,
    "currency": "EUR"
  }
}
Field Type Description
originalUnitGroupId String PMS unit group ID before the upgrade
upgradedToUnitGroupId String PMS unit group ID after the upgrade
pmsUpsellRuleId String PMS upsell rule that was applied
totalAmountDifference Object Price difference for the upgrade (optional, null if unknown)

What To Do With It

  • Update CRM - Record the upgrade for guest preference tracking
  • Adjust revenue reporting - Capture the upsell revenue
  • Trigger confirmation - Send upgrade confirmation to the guest
  • Update room assignment - Reflect the new unit group in operations