Content is outdated

This documentation section will soon become deprecated. To know more about room type and rate plan managmeent, consult the new room type and management API management documentation.

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:

Kitchen(ette) required

Room types in the following Property Class Types require a kitchen(ette) to become open and bookable:

  • Apartment (3)
  • Aparthotel (5000)
  • Condominium (8, but changed to 3)

For room types in the following Property Class Types a kitchen(ette) is highly recommended:

  • Holiday home (5006)
  • Holiday park (5009)
  • Lodge (22)
  • Villa (35)


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"/>
                  <!-- 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" />
                      <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