Update a rate plan (beta)

Closed beta

This API is in closed beta. You can't use it unless you have been invited as a beta tester.

A rate plan contains the name of a rate. Use /ota/OTA_HotelRatePlanNotif to create rate plans.


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.

Specify the entire policy object including the override information

While updating(overlay) your roomrate object, don't forget to specify the RateRelation information in the request, in absence of which all previously applied ratereltaions on that (child)rate will be removed and the rate will behave independently of its (previously defined) parent.

Before you start

You need:


HTTP request

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

Request Attribute(@) Overview

Field Description Type Required Notes
RateParent Root node for parent Rate object Optional -
RateRelation Root node for the child rate relation object Optional -
RateParentId Id of the parent Rate Integer Required for new, Optional for overlay(If you skip this the existing rate relation will be deleted)((within RateRelation)) Default: 1.0
Percentage Percentage change from parent rate integer Required Min/max value: 1/200
FollowsPrice Follows price changes of parent Boolean Optional Format: 0/1 Default: 1
FollowsRestrictions Follows restrictions on the parent rate Boolean Optional Format: 0/1 Default: 1
FollowsPolicyGroup Follows policy group of the parent Boolean Optional Format: 0/1 Default: 1
FollowsClosed Follows open/closed status of the parent Integer Optional Min/max value: 1/3

Request body

Provide an OTA_HotelRatePlanNotifRQ object with the RateRelation object in the request body. Example:

<?xml version="1.0" encoding="UTF-8"?>
  <!-- Replace the {PlaceHolder} in the following line! -->
  <RatePlans HotelCode="{PropertyID}">
    <RatePlan RatePlanNotifType="Overlay">
      <Description Name="Basic rate 2 guests"/>
      <RateRelation ParentRateId="123454" Percentage = "90"
                    FollowsPrice = "1"
                    FollowsRestrictions = "1"
                    FollowsPolicyGroup = "1"
                    FollowsClosed = "1">


The response contains an OTA_HotelRatePlanNotifRS object:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRatePlanNotifRS 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_HotelRatePlanNotifRS.xsd" TimeStamp="2015-09-30T13:49:52-00:00" Target="Production" Version="3.000">
  <Success />
  <RatePlanCrossRef  ResponseRatePlanCode="{OurRatePlanID}"/>

Next steps