Check-in / Upsell / Upgrade

Updating guest data, documents, scanned files and adding them to the myfrontdesk reservations is easy. Check out a suggested solution below.

Pre-Checkin: Update guest information

(*)Pre-Checkin feature certification mandatory requirements.

  • Use getReservations with parameters status or CheckInFrom/CheckInTo and CheckOutFrom/CheckOutTo to get reservations for your specific purpose. e.g. Today's arrivals, today's departures.*

  • Use putGuest to update guest data to existing guests (Specific attention on guest document information).*

  • Use postGuest to upload data for new guests. Number of adults and children is specified on every reservation, don't allow more guests than specified.*

  • Use postGuestDocument to upload a file e.g. passport scan, photography.

  • Use postReservationDocument to upload a file referring to the entire reservation e.g. contract.

  • Use postReservationNote to post any messages into myfrontdesk reservation.

Check-in or check-out a guest

  • Use putReservation with status: checked_in to check in a guest or checked_out to check out a guest.

  • Checking out a guest is currently possible only when there is no open balance, use getReservationInvoiceInformation to confirm that the reservation has been fully paid to be able to proceed with updating the reservation status to checked_out.

  • If a room is not assigned, use getRoomsUnassigned to see available rooms and allocate a room before check-in using postRoomAssign.

Upsell: Items and services

(*) Upsell Category Certification mandatory requirements, two Way Sync, any upsold products posted to myfrontdesk.

  1. Option 1 - recommended: Post any item/service to Cloudbeds folio

  • Use postCustomItem with reservationID/subreservationID parameter to post a charge for an item into myfrontdesk reservation.*

    Note: You need to specify the taxes that apply to the custom items.

  • Use postPayment to record a payment for the charged item

  • Use getPaymentMethods to see which methods are available

  • If payment method is not enabled or doesn't exist in myfrontdesk account create it using postCustomPaymentMethod

  • Use getHotelDetails to see the myfrontdesk account default currency. Payments and charges can only be posted in the default currency.

  • If your app can delete/cancel charges use postVoidItem to sync this event with Cloudbeds.

Two-Way Sync: Any items sold via the upselling platform are synced back to Cloudbeds including full price and tax information for items to the folio.*

`

Option 2 - Use existing Cloudbeds inventory

  • Use getItems to get the list of all available items in myfrontdesk and getItemCategories if you're looking to reflect them in your system.

  • Use getItem to get the details of a single item.

  • Use postItem with reservationID parameter to post a charge for an item into myfrontdesk reservation.

  • Use postPayment to record a payment for the charged item.

  • Use getHotelDetails to see the myfrontdesk account default currency. Payments and charges can only be posted in the default currency.

  • If your app has the ability to delete/cancel charges use postVoidItem to sync that to Cloudbeds.

Amenities and Add ons where inventory is managed in Cloudbeds are pulled from live availability in real time and when booked via the upselling platform are synced back to Cloudbeds.*


Upsell: Upgrade a room

  • Use getAvailableRoomTypes with detailedRates parameter to see the available room types and its rates.*

  • Use putReservation to change the room type or add additional rooms to a reservation. (*)

  • Use postAdjustment to adjust the price of the room if needed. Only if an applicable discount is needed.*

  • Use postReservationNote to indicate the new room type that has been upgraded.

Room Upgrades are pulled from live availability in real-time and when booked via the upselling platform are synced back to Cloudbeds.*


Charge for the stay


Assign a room on a reservation

Kiosks: Check-in or check-out a guest

(*) Kiosk certification mandatory requirements.

  • Use getReservations with parameters status or CheckInFrom/CheckInTo and CheckOutFrom/CheckOutTo to get reservations for your specific purpose, e.g. today's arrivals, today's departures. Only allow confirmed reservations to be checked-in.*

  • Use putGuest to update guest data to existing guest (Specific attention on guest document information).*

  • Use postGuest to upload data for new guests. Number of adults and children is specified on every reservation, don't allow more guest than specified.*

  • Use putReservation with status: checked_in to check in a guest or checked_out to check out a guest. (*)

  • Checking out a guest is currently possible only when there is no open balance, use getReservationInvoiceInformation to confirm that the reservation has been fully paid to be able to proceed with updating the reservation status to checked_out. Alternatively, to process the outstanding payment see Charge for the stay guidelines above.*

  • Guests should be able to check-in and check-out using the third-party id. Use thidPartyIdentifier to match with Cloudbeds reservationID.*

  • If a room is not assigned use getRoomsUnassigned to see available rooms and allocate a room prior to check-in using postRoomAssign.*


Send email from myfrontdesk

  • Use postEmailTemplate to create an email template with the same custom field. Myfrondesk will send out the email to the guest.

  • Use the postEmailSchedule to schedule the template either based on the reservation status change or a date.