Modify a property's special bed options

You can specify special bed options (for adults or children) at property level. Use /ota/OTA_HotelDescriptiveContentNotif to modify the details of a property.

Before you start

Overlay

Content API uses an overlay system. Every time you update an existing property, room type, or other object, the body of your request replaces whatever information was stored in our servers at that time. This means existing information may be deleted if you don't include it in your request.

To update an object without deleting information, make sure your request contains both the fields you want to update and those you want to keep the same. Copy/paste sample requests from this page at your own risk.

You need:

Children policies

You can specify children policies for your property by providing a Service Object in Services array. An example of such object can be found below.

Request

HTTP request

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

Request body

Example:

<!-- WARNING: This request overlays existing objects. Copy/pasting may lead to loss of information. -->
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelDescriptiveContentNotifRQ
  xmlns="http://www.opentravel.org/OTA/2003/05"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  PrimaryLangID="en-us"
  EchoToken="GUID"
  TimeStamp="2015-06-09T09:30:47Z"
  xsi:schemaLocation="http://www.opentravel.org/2014B/OTA_HotelDescriptiveContentNotifRQ.xsd"
  id="OTA2014B"
  Version="8.0"
  Target="Production">
  <HotelDescriptiveContents>
    <HotelDescriptiveContent
      HotelCode="{PropertyID}"
      HotelDescriptiveContentNotifType="Overlay">
      <HotelInfo>
        <Services>
          <!-- Children and existing bed-->    
          <Service
            Code="218"
            ExistsCode="1"
            Quantity="2">
          <!-- ExistsCode="1" means "children are welcome". -->
          <!-- Use Quantity="0" if children are welcome but cannot stay in existing beds. -->
            <Features>
              <Feature>
                <DescriptiveText>max_age_12</DescriptiveText>
                <!-- Options: max_age_1, max_age_2 ... max_age_18. -->
                <Charge
                  Amount="12300"
                  DecimalPlaces="2"/>
              </Feature>
            </Features>
          </Service>
          <!-- Extra bed -->
          <Service
            Code="5038"
            Quantity="4" >
          <!-- Use Quantity="0" if extra beds are not offered. -->
            <Features>
              <Feature ID="adult_bed">
                <Charge Amount="123"/>
              </Feature>
              <Feature ID="infant_bed">
                <Charge Amount="321"/>
              </Feature>
              <Feature ID="children_bed">
                <DescriptiveText>max_age_6</DescriptiveText>
                <!-- Options: max_age_1, max_age_2 ... max_age_18. -->
                <Charge Amount="246"/>
              </Feature>
            </Features>
          </Service>
        </Services>
      </HotelInfo>
    </HotelDescriptiveContent>
  </HotelDescriptiveContents>
</OTA_HotelDescriptiveContentNotifRQ>

Response

The response contains an OTA_HotelDescriptiveContentNotifRS object:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelDescriptiveContentNotifRS 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_HotelDescriptiveContentNotifRS.xsd" TimeStamp="2018-08-27T08:17:04+00:00" Target="Production" Version="3.000">
    <Success />
</OTA_HotelDescriptiveContentNotifRS>
<!-- RUID: [UmFuZG9etc] -->

Example

In this scenario, we specify that the property can accommodate one child and that they can sleep for free in existing beds. The payload will look like below - please note that this is an excerpt and not a valid XML document.

...
<Services>
  ...
  <!-- Children and existing bed-->
  <Service
    Code="218"
    ExistsCode="1"
    Quantity="1">
  <!-- ExistsCode="1" means "children are welcome". -->
  <!-- Use Quantity to specify the number of children allowed to stay in existing beds -->
  <!-- Use Quantity="0" if children are welcome but cannot stay in existing beds. -->
    <Features>
      <Feature>
        <DescriptiveText>max_age_6</DescriptiveText>
        <!-- Options: max_age_1, max_age_2 ... max_age_18. -->
        <Charge
          Amount="0"
          />
        <!-- Amount set to 0 means children can stay for free, any other value represents the price in property's currency -->
      </Feature>
    </Features>
  </Service>
  ...
</Services>
...

Next steps