API solution no longer usable
Creating an independent property without a LEID (or without legal contact email with feature on) using the /ota/OTA_HotelDescriptiveContentNotif endpoint sunsetted on April 1, 2022. Please see the deprecation policy documentation for more details.
This documentation section concerns an API solution that is no longer usable. It will be removed on June 1, 2022. Until then, you can still access it by clicking here
Create an independent property¶
An independent property is a privately-owned property, such as a holiday home or an apartment. Use /ota/OTA_HotelDescriptiveContentNotif to create independent properties.
Before you start¶
To complete this task, you need:
- Property Class Type Code
- property latitude/longitude coordinates
- property address
Request¶
HTTP request¶
POST https://supply-xml.booking.com/hotels/ota/OTA_HotelDescriptiveContentNotif
Naming a property¶
When naming a property, ensure that the name:
- Has a length between 3 and 255 characters.
- Does not contain a phone number (or no more than five consecutive numbers).
- Only contains letters (any language), numbers, or the following symbols: ! # & ` ' " - ,
- Is not all in uppercase.
Certain words are blacklisted
If a name is rejected, the property name could contain a blacklisted word. If you do not think this is the case, reach out to our Customer Support teams.
Request body¶
Provide an OTA_HotelDescriptiveContentNotifRQ object in the request body. Example:
<?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 HotelName="The Best Independent Hotel"
LanguageCode="en"
HotelDescriptiveContentNotifType="New">
<ContactInfos>
<ContactInfo ContactProfileType="PhysicalLocation">
<Addresses>
<Address>
<!-- Replace the {PlaceHolders} in the following lines! -->
<AddressLine>{AddressLine}</AddressLine>
<CityName>{CityName}</CityName>
<PostalCode>{PostalCode}</PostalCode>
<CountryName>{CountryCode}</CountryName>
</Address>
</Addresses>
</ContactInfo>
<ContactInfo ContactProfileType="general">
<Names>
<Name Language="en">
<GivenName>Jane</GivenName>
<Surname>Doe</Surname>
</Name>
</Names>
<Emails>
<Email>noreply@booking.com</Email>
</Emails>
<Phones>
<Phone PhoneNumber="+31666666666" PhoneTechType="5" />
</Phones>
</ContactInfo>
<ContactInfo ContactProfileType="invoices">
<Names>
<Name Language="en">
<GivenName>Sam</GivenName>
<Surname>Xu</Surname>
</Name>
</Names>
<Addresses>
<Address>
<AddressLine>Herengracht 597</AddressLine>
<CityName>Amsterdam</CityName>
<StateProv StateCode="NH" />
<PostalCode>1017 CE</PostalCode>
<CountryName>NL</CountryName>
</Address>
</Addresses>
<Emails>
<Email>noreply@booking.com</Email>
</Emails>
<Phones>
<Phone PhoneNumber="+31207777777" PhoneTechType="1" Extension="30" />
</Phones>
</ContactInfo>
</ContactInfos>
<HotelInfo>
<CategoryCodes>
<GuestRoomInfo Quantity="100" />
<!-- Replace the {PlaceHolder} in the following line! -->
<HotelCategory ExistsCode="1" Code="{PropertyClassTypeCode}" />
</CategoryCodes>
<!-- Replace the {PlaceHolder} in the following line! -->
<Position Latitude="{Latitude}" Longitude="{Longitude}" />
<OwnershipManagementInfos>
<OwnershipManagementInfo RelationshipTypeCode="5000" />
</OwnershipManagementInfos>
</HotelInfo>
<FacilityInfo>
<GuestRooms>
<GuestRoom>
<Amenities>
<Amenity RoomAmenityCode="228" />
</Amenities>
</GuestRoom>
</GuestRooms>
<Restaurants>
<Restaurant RestaurantName='Antekoje' OfferLunch='1' OfferDinner='1'>
<CuisineCodes>
<CuisineCode Code='51'/>
<CuisineCode Code='49'/>
</CuisineCodes>
<OperationSchedules>
<OperationSchedule>
<OperationTimes>
<OperationTime Mon='1' Tue='1' Weds='1' Thur='1' Fri='1' Sat='1' Sun='1'Start='17:30' End='22:00' />
<OperationTime Sat='1' Sun='1' Start='11:00' End='14:30' />
</OperationTimes>
</OperationSchedule>
</OperationSchedules>
<Features>
<Feature DescriptiveText='a la carte'/>
<Feature DescriptiveText='buffet'/>
<Feature DescriptiveText='accepts reservations'/>
<Feature DescriptiveText='outdoor seating'/>
</Features>
<TPA_Extensions>
<Ambiances>
<Ambiance Name='modern'/>
</Ambiances>
<DietaryOptions>
<DietaryOption Name='gluten free'/>
<DietaryOption Name='vegan'/>
</DietaryOptions>
</TPA_Extensions>
</Restaurant>
</Restaurants>
</FacilityInfo>
<Policies>
<Policy>
<PolicyInfo CheckInTime="16:00" CheckOutTime="11:00" UsualStayFreeCutoffAge="12" UsualStayFreeChildPerAdult="1" />
<PetsPolicies PetsAllowedCode="Pets By Arrangements">
<PetsPolicy NonRefundableFee="free" />
</PetsPolicies>
<CancelPolicy>
<CancelPenalty PolicyCode="43" />
<CancelPenalty PolicyCode="1" />
</CancelPolicy>
<GuaranteePaymentPolicy>
<GuaranteePayment PolicyCode="43" />
<GuaranteePayment PolicyCode="1" />
</GuaranteePaymentPolicy>
<TaxPolicies>
<TaxPolicy Code="36" Percent="1800" DecimalPlaces="2" Type="Inclusive" ChargeFrequency="12" />
<TaxPolicy Code="3" Percent="350" DecimalPlaces="2" Type="Exclusive" ChargeFrequency="21" />
</TaxPolicies>
<FeePolicies>
<FeePolicy Code="5012" Amount="1600" DecimalPlaces="2" Type="Exclusive" ChargeFrequency="12" />
<FeePolicy Code="5013" Amount="1800" DecimalPlaces="2" Type="Exclusive" ChargeFrequency="12" />
<FeePolicy Code="5035" Amount="500" DecimalPlaces="2" Type="Exclusive" ChargeFrequency="1" >
<TPA_Extensions>
<InternetFeePolicy InternetType="wifi" InternetCoverage="public_areas" />
</TPA_Extensions>
</FeePolicy>
<FeePolicy Code="5036" Amount="350" DecimalPlaces="2" Type="Exclusive" ChargeFrequency="2" >
<TPA_Extensions>
<ParkingFeePolicy ParkingType="location_nearby" ParkingReservation="needed" ParkingProperty="private"/>
</TPA_Extensions>
</FeePolicy>
</FeePolicies>
</Policy>
</Policies>
</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="2015-07-31T12:36:23-00:00" Target="Production" Version="3.000">
<UniqueID Type="10" ID="{PropertyID}" />
<Success />
</OTA_HotelDescriptiveContentNotifRS>
<!-- RUID: [XXXXXXXXXXXXXXXXXXXXXXXXXXX==] -->
Next steps¶
After you create an independent property, we send a welcome email to the property owner (on their invoicing email address). The email contains a link to a Booking.com page where the property owner must enter payment details and accept our terms and conditions. You can't open the property until this process is complete.