Step 5 - Create a rate plan
Rate plans are labels or categories used to organise prices for a property.
You can create a maximum of 100 active rate plans for a property.
Use the POST /ota/OTA_HotelRatePlanNotif request to create a rate plan for your test property. In this tutorial, we will create a rate plan which we will later use when creating the roomrate.
Prerequisites
You must have a property ID by completing step 2 successfully.
Creating a rate plan
POST https://supply-xml.booking.com/hotels/ota/OTA_HotelRatePlanNotifBody parameters
The following table describes the elements you must add in the request body:
All parameters are required unless otherwise noted.
| Parameter | Description |
|---|---|
OTA_HotelRatePlanNotifRQ | Contains the RatePlans array. |
> Rateplans | Contains the RatePlan objects. |
HotelCode | Specifies the unique ID of the property you create rate plans for. |
>> RatePlan | Contains a Description object, which contains the name of the rate plan. |
RatePlanNotifType | Specifies the purpose of the request. Possible values are New, Overlay, Activate, and Remove. You must use New to create a rate plan. |
RatePlanID | [Optional] Specifies the rate plan ID you use in your system. |
>>> Description | Contains the rate plan name. |
Name | Specifies the name of the rate plan. |
Request body example
The following is a request body example:
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRatePlanNotifRQ>
<RatePlans HotelCode="14290773" >
<RatePlan RatePlanNotifType="New">
<Description Name="Summer vacation rates"/>
</RatePlan>
</RatePlans>
</OTA_HotelRatePlanNotifRQ>Response body example
The following is a successful response body example:
Note down the Rate plan ID (ResponseRatePlanCode) from the response which we will use in step 12: Add roomrate.
<?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="2025-06-10T06:32:19+00:00" Target="Test" Version="3.000">
<RatePlanCrossRefs><RatePlanCrossRef ResponseRatePlanCode="55562487"/></RatePlanCrossRefs><Success />
</OTA_HotelRatePlanNotifRS>
<!-- RUID: [XXXXXXXXXXXXXXXXXXXXXXXXXX]-->