โฌ๏ธ 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