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:

Request

HTTP request

POST https://supply-xml.booking.com/hotels/ota/OTA_HotelInvNotif

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="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opentravel.org/2014B/OTA_HotelInvNotifRQ.xsd" version="6.000" id="OTA2014B" TransactionIdentifier="5" Target="Production">
    <SellableProducts HotelCode="{PropertyID}">
      <SellableProduct InvStatusType="Initial">
          <GuestRoom>
              <!-- MaxOccupancy - Maximum number of guests-->
              <Occupancy MaxOccupancy="6"/>
              <!--  -->
              <Room RoomID="{YourCustomRoomTypeID}" Quantity="2" NonSmoking="1" RoomType="Apartment" SizeMeasurement="16" SizeMeasurementUnit="sqm" LicenseNumber="AB-CD-1234"/>
              <Amenities>
                  <!-- 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" />                                       
              </Amenities>
              <RoomLocation RoomLocationCode="3">
                  <Floors>
                        <Floor Number="0" />
                        <Floor Number="4" />
                        <Floor Number="7" />
                        <Floor Number="9" />
                  </Floors>
              </RoomLocation>
              <Description>  
                  <!-- We recommended uploading at least 4 room photos (2048x1536px, landscape). -->
                  <Image>http://pathtoimage/doublemer_room001.jpg</Image>
                  <Image>http://pathtoimage/doublemer_room002.jpg</Image>
                  <Image>http://pathtoimage/doublemer_room003.jpg</Image>
                  <Image>http://pathtoimage/doublemer_room004.jpg</Image>
              </Description>
              <TPA_Extensions>                    
                  <SubRooms>
                      <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. -->
                          <Amenities>
                              <Amenity AmenityCode="200" Value="3" />
                          </Amenities>
                      </SubRoom>
                      <SubRoom RoomType='Living room' MaxGuests="2">  
                          <Amenities>
                              <Amenity AmenityCode="33" Value="2" />
                          </Amenities>
                      </SubRoom>
                      <SubRoom RoomType="Bathroom" Number="2" />
                  </SubRooms>
              </TPA_Extensions>
          </GuestRoom>
      </SellableProduct>
    </SellableProducts>
</OTA_HotelInvNotifRQ>

Response

The response contains an OTA_HotelInvNotifRS object.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvNotifRS xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opentravel.org/OTA/2003/05 OTA_HotelInvNotifRS.xsd" TimeStamp="2019-07-31T13:46:52-00:00" Target="Production" Version="3.000">
    <InventoryCrossRefs>
        <InventoryCrossRef RequestInvCode="{YourCustomRoomTypeID}" ResponseInvCode="{OurRoomTypeID}" />
    </InventoryCrossRefs>
    <Success />
</OTA_HotelInvNotifRS>
<!-- RUID: [XXXXXXXXXXXXXXXXXXXXXXXXXXX==] -->

Next steps