1 Business Context

The OPERA Cloud Housekeeping Service Status shows the service statuses for all currently occupied rooms. A room can either have a Make Up Room status (MUR) or Do Not Disturb (DND) status.

Just like traditional door hangers, guests can set their room's housekeeping status (Make Up Room or Do Not Disturb) using in-room panels or mobile applications, or hotel staff can update it directly in OPERA Cloud.

This guide describes the options for how partner systems can change the Housekeeping Service Status or retrieve the status once the status changes in OPERA Cloud.

This implementation guide covers the following use cases for Housekeeping Service Status Requests.

Table 1-1 Business Use Cases

  Use Case Description
1 Partner system updating Housekeeping Service Status The partner system sets the Guest Service Status "Do Not Disturb" and "Make Up Room" active or inactive by sending the API operation setGuestHousekeepingServiceRequest to OHIP/OPERA Cloud.
2 Updating Housekeeping Service Status in OPERA Cloud

OPERA Cloud triggers a Business Event GUEST SERVICE STATUS REQUEST that notifies the partner system about a Guest Service Status set for a specific room.

The Business Event is sent to the partner system through the Streaming Business Event function.

3 Retrieve rooms with active Housekeeping Service Status The partner system retrieves a list of rooms with an active Housekeeping Service Status using the API operation getHousekeepingOverview.

Table 1-2 Workflow Diagram: Guest Journey Guest Housekeeping Service Status


This image shows the Guest Housekeeping Service Status workflow.

Journey: Guest sets a Guest Housekeeping Service Status

The hotel guest can set a Housekeeping Service Status within their room or on an application provided by the hotel or partner to either have not disturbed on in the room or to notify housekeeping to make up the room.

The Housekeeping Service Status can be set through an installed panel or switch or even through an application the guest has access to, which replaces the traditional door hangers a guest can put outside the room door for notifying "Do Not Disturb" or "Make Up Room."

Once the guest sets the related Do Not Disturb or Make Up Room status, the partner system handling the device or software sends a setGuestHousekeepingServiceRequest API call to OPERA Cloud with the related Service Status "DoNotDisturb" or "MakeUpRoom."

OPERA Cloud receives the message from the partner system and sets the received status in its system and displays it in the OPERA Cloud Housekeeping Room status section.

When the hotel guest sets the current Service Status off from the device or software, the partner system sends a setGuestHousekeepingServiceRequest API call to OPERA Cloud with the related Service Status "NoStatusSelected."

The Housekeeping Service Status for this room is updated in OPERA Cloud.

Journey: OPERA Cloud user sets a Guest Housekeeping Service Status in the OPERA Cloud UI.

On request of the hotel guest, the OPERA Cloud user can set the Housekeeping Guest Service Status "Do Not Disturb" or "Make Up Room" in OPERA Cloud UI.

A change of the Housekeeping Guest Service Status will trigger a Business Event GUEST SERVICE STATUS REQUEST. When the Partner is subscribed to the Streaming Business Event option, the partner will automatically receive the Business Event and can change the status on their system accordingly.