Create a room type with multi-bedroom setup

Independent properties (such as holiday homes and apartments) often have multiple bedrooms, but are booked as one unit. To accommodate this, you can create a room type with sub-rooms inside it. Use /ota/OTA_HotelInvNotif to create room types.

Before you start

You can only define subrooms inside a room type when its value for Room[@RoomType] is one of: Apartment, Suite, Chalet, Bungalow, Holiday home, Villa, Mobile home.

Note : Please provide the bed type amenities in the subrooms section. The ones set on room level in GuestRoom/Amenities for multi-bedroom setup are not processed.

To complete the task below, you need:


HTTP request


Request body

Provide an OTA_HotelInvNotifRQ object in the request body. The details for the sub-rooms are in a SubRooms element. Example:

<OTA_HotelInvNotifRQ xmlns="" xmlns:xsi="" xsi:schemaLocation="" version="6.000" id="OTA2014B" TransactionIdentifier="5" Target="Production">
    <SellableProducts HotelCode="{PropertyID}">
      <SellableProduct InvStatusType="Initial">
              <!-- MaxOccupancy - Maximum number of guests-->
              <Occupancy MaxOccupancy="6" MaxAdultOccupancy="6" MaxChildOccupancy="3"/>
              <Quantities MaximumAdditionalGuests="2" MaxCribs="1" MaxRollaways="1">
              <!--  -->
              <Room RoomID="{YourCustomRoomTypeID}" Quantity="2" NonSmoking="1" RoomType="Apartment" SizeMeasurement="16" SizeMeasurementUnit="sqm" LicenseNumber="AB-CD-1234"/>
                  <!-- Please provide the bed type amenities in the subrooms section -->
                  <!-- Desk: -->
                  <Amenity AmenityCode="28" />
                  <!-- Refrigerator: -->
                  <Amenity AmenityCode="88" />
                  <!-- Minibar, at extra charge: -->                    
                  <Amenity AmenityCode="69" Value="5" />
                  <!-- Telephone: -->
                  <Amenity AmenityCode="107" />
                  <!-- Flatiron: -->
                  <Amenity AmenityCode="55" />                    
                  <!-- Free toiletries: -->
                  <Amenity AmenityCode="11" />                                       
              <RoomLocation RoomLocationCode="3">
                        <Floor Number="0" />
                        <Floor Number="4" />
                        <Floor Number="7" />
                        <Floor Number="9" />
                  <!-- We recommended uploading at least 4 room photos (2048x1536px, landscape). -->
                      <SubRoom RoomType='Bedroom' PrivateBathroom='1' MaxGuests="2">
                      <!-- Amenities in sub-rooms can only be beds, i.e.: 33, 58, 86, 102, 113, 200, 203, 249, 4001. -->
                              <Amenity AmenityCode="200" Value="3" />
                      <SubRoom RoomType='Living room' MaxGuests="2">  
                              <Amenity AmenityCode="33" Value="2" />
                      <SubRoom RoomType="Bathroom" Number="2" />


The response contains an OTA_HotelInvNotifRS object.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvNotifRS xmlns="" xmlns:xsi="" xsi:schemaLocation=" OTA_HotelInvNotifRS.xsd" TimeStamp="2019-07-31T13:46:52-00:00" Target="Production" Version="3.000">
        <InventoryCrossRef RequestInvCode="{YourCustomRoomTypeID}" ResponseInvCode="{OurRoomTypeID}" />
    <Success />

Next steps