Workflow: Updating Housekeeping Room Status

The OPERA Cloud PMS housekeeping room maid status refers to the current cleaning status ("housekeepingRoomStatus") of the room:

  • Inspected: An optional status to indicate a clean room has been inspected by a supervisor (available when the Inspected Status OPERA Control is active).
  • Clean: Indicates the room has been serviced and is clean.
  • Pickup: An optional status to indicate a minimum “touch-up" housekeeping service is required. This might occur if the room is occupied for only a few minutes and only needs refreshing (available when the Pickup Status OPERA Control is active).
  • Dirty: Indicates the room is dirty and requires a cleaning service.

Sequence Diagram


This image shows the workflow for Updating Housekeeping Room Status.

Description of Steps

Description Operation

Use the putRoomRelatedStatus operation.

Send the new Room status in the 'housekeepingRoomStatus' field.

Possible values are: Clean, Dirty, Inspected, or Pickup.

In addition to the 'housekeepingRoomStatus' value, the external system also sends the status in the 'housekeepingStatus' element if the room is vacant or occupied.

Use either value "Occupied" or "Vacant." This reflects the status of the room as reported by a user in the external system.

Example: A room can be one of the following statuses:
  • Clean and Vacant
  • Dirty and Vacant
  • Clean and Occupied
  • Dirty and Occupied

Update Room Status Clean Occupied

PUT {{HostName}}/hsk/v1/hotels/{{HotelId}}/rooms/status

{
    "roomList": [
        {
            "roomId": "112"
        }
    ],
    "housekeepingStatus": "Occupied",
    "housekeepingRoomStatus": "Clean"
}

Update Room Status Inspected Occupied

PUT {{HostName}}/hsk/v1/hotels/{{HotelId}}/rooms/status

{
    "roomList": [
        {
            "roomId": "112"
        }
    ],
    "housekeepingStatus": "Occupied",
    "housekeepingRoomStatus": "Inspected"
}

Update Room Status Dirty Vacant

PUT {{HostName}}/hsk/v1/hotels/{{HotelId}}/rooms/status

{
    "roomList": [
        {
            "roomId": "112"
        }
    ],
    "housekeepingStatus": "Vacant",
    "housekeepingRoomStatus": "Dirty"
}

Note:

Do not use the putRoomRelatedStatus operation to set a room to Out of Order or Out of Service status.

To set a room to "Out of Order" or "Out of Service" status, only use the related operations POST outOfOrderRooms and POST outOfServiceRooms.

For more details on the OPERA Cloud Housekeeping Room Status, refer to the Using the Housekeeping Board in the OPERA Cloud User Guide.

Parent topic: Workflows