Housekeeping / Staff management

Cloudbeds has a basic housekeeping functionality. Your integration might be a great complementary tool. Read our Housekeeping Module Overview and Housekeeping Inspection Filters articles to learn about the existing functionality in our system.

Initial pull

(*) Mandatory requirements for Housekeeping / Task Management functionality certification.

Initially, you will need to pull a list of rooms to create or map them to the rooms in your system. For that you'll use getRoomTypes and getRooms. Rooms are nested under room types.*

getReservations to fetch confirmed reservations with their planned check-in date and time. Within this call you can find useful information such as guest and room details.*

getReservation to get the estimatedArrivalTime*

getReservationNotes for reservations notes which may contain a special request*

Change the housekeeping status

Housekeeping status of each room in myfrontdesk can be fetched with getHousekeepingStatus. When the room has been cleaned use postHousekeepingStatus to change the status in Cloudbeds. *

Here is a list of the different frontdesk statuses returned in /getHousekeepingStatus.

Any relevant note/information for the FO team e.g. housekeeper's note should be posted to myfrontdesk by using postReservationNote.

If your housekeeping app supports minibar charges, those items should be posted back to myfrontdesk, please see "Upsell items and services" under Upsell Blueprint.*

(*) Mandatory requirements for Housekeeping / Task Management functionality certification.

Manage housekeepers (Optional)

You are free to manage housekeepers in myfrontdesk. To see them use getHousekeepers, to create a new one use postHousekeeper and to update an existing housekeeper use putHousekeeper.

Use postHousekeepingAssignment to assign rooms to an existing housekeeper.

We also offer a list of myfrontdesk users which enables you to create identical user list in your system. To pull the user list with their assigned roles you may use getUsers.

Room blocks

• Use getRoomBlocks to retrieve any out-of-service or blocked rooms.
  We strongly recommend subscribing to our Webhooks: roomblock/created, roomblock/removed and roomblock/details_changed.
• For additional information on room blocks, review Manage blocks on the calendar. The API supports 'blocked dates' and 'out-of-service room blocks.

FAQ

Why do I receive the error message This feature is not available for your property?

Most properties and their Cloudbeds packages do include the Housekeeping module by default, there is an exception with some lower packages that do not include the Housekeeping feature, if this is the case and the property would like to get access to the Housekeeping module for the integration, they would need to discuss the Housekeeping Addon with their Cloudbeds representative.

How to create floor configuration?

Floor set up is not available in myfrontdesk PMS and therefore it's not available in the API.

What's the room number?

Parameter roomName is the equivalent of what hospitality staff would refer to as "room number". This field is editable in myfrontdesk and can be a string of characters.