/ota/OTA_HotelDescriptiveContentNotif

Use this endpoint to create or modify the "skeleton" of a property. This skeleton contains the property's location details, policies, contact details, property-level photos, and more.

Tutorial

If you're new to creating properties with the API, try our tutorial!

Methods

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

Headers

Header Description Type Required Notes
Authorization Machine account username and password string Required Example: Authorization: Basic {username:password}

Examples


Full XML sample

For reference, here is a sample request body containing all possible fields. The root-level object is OTA_HotelDescriptiveContentNotifRQ.

<?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="Test">
  <HotelDescriptiveContents>
    <HotelDescriptiveContent HotelName="Fake Hotel" ID="101010" LanguageCode="en" PropertyLicenseNumber="AB-CD-1234" HotelDescriptiveContentNotifType="New">
      <ContactInfos>
        <ContactInfo ContactProfileType="PhysicalLocation">
          <Addresses>
            <Address>
              <AddressLine>15 Station Street</AddressLine>
              <CityName>Sotteville</CityName>
              <PostalCode>50340</PostalCode>
              <CountryName>FR</CountryName>
            </Address>
            <Address Language="fr">
              <HotelName>Le Faux Hôtel 001</HotelName>
              <CityName>Sotteville-lès-Rouen</CityName>
              <CountryName>FR</CountryName>
              <PostalCode>76300</PostalCode>
              <AddressLine>15 Rue de la Gare</AddressLine>
            </Address>
          </Addresses>
        </ContactInfo>
        <ContactInfo ContactProfileType="general">
          <Names>
            <Name Gender="Female" Language="en">
              <GivenName>Carol</GivenName>
              <Surname>Xu</Surname>
              <JobTitle>Owner</JobTitle>
            </Name>
          </Names>
          <Addresses>
            <Address>
              <AddressLine>1000 Eighth Avenue</AddressLine>
              <CityName>New York</CityName>
              <PostalCode>10000</PostalCode>
              <StateProv StateCode="NY"/>
              <CountryName>US</CountryName>
            </Address>
          </Addresses>
          <Emails>
            <Email>carol.xu@fakehotel.com</Email>
          </Emails>
          <Phones>
            <Phone Extension="30" PhoneNumber="+31622222220" PhoneTechType="1"/>
          </Phones>
        </ContactInfo>
        <ContactInfo ContactProfileType="availability" Index="1">
          <Names>
            <Name Gender="Male" Language="en">
              <GivenName>Steve</GivenName>
              <Surname>Martin</Surname>
              <JobTitle>Administration Employee</JobTitle>
            </Name>
          </Names>
          <Addresses>
            <Address>
              <AddressLine>200 rue de Paris</AddressLine>
              <CityName>Sotteville</CityName>
              <CountryName>FR</CountryName>
              <PostalCode>50340</PostalCode>
            </Address>
          </Addresses>
          <Emails>
            <Email>admin@fakehotel.com</Email>
          </Emails>
          <Phones>
            <Phone PhoneNumber="+33622111110" PhoneTechType="1" Extension="30"/>
            <Phone PhoneNumber="+33622111111" PhoneTechType="1" Extension="30"/>
            <Phone PhoneNumber="+33622111112" PhoneTechType="1" Extension="30"/>
            <Phone PhoneNumber="+33622111113" PhoneTechType="5"/>
            <Phone PhoneNumber="+33622111114" PhoneTechType="3"/>
          </Phones>
        </ContactInfo>
        <ContactInfo ContactProfileType="invoices">
          <Names>
            <Name>
              <GivenName>Carol</GivenName>
              <Surname>Xu</Surname>
            </Name>
          </Names>
          <Addresses>
            <Address>
              <AddressLine>1000 Eighth Avenue</AddressLine>
              <CityName>New York</CityName>
              <PostalCode>10000</PostalCode>
              <StateProv StateCode="NY"/>
              <CountryName>US</CountryName>
            </Address>
          </Addresses>
          <Emails>
            <Email>carol.xu@fakehotel.com</Email>
          </Emails>
          <Phones>
            <Phone Extension="30" PhoneNumber="+31622222220" PhoneTechType="1"/>
          </Phones>
        </ContactInfo>
        <ContactInfo ContactProfileType="availability" Index="2">
          <Names>
            <Name Gender="Female" Language="xt">
              <GivenName>Carol</GivenName>
              <Surname>Xu</Surname>
              <JobTitle>Owner</JobTitle>
            </Name>
          </Names>
          <Addresses>
            <Address>
              <AddressLine>1000 Eighth Avenue</AddressLine>
              <CityName>New York</CityName>
              <PostalCode>10000</PostalCode>
              <StateProv StateCode="NY"/>
              <CountryName>US</CountryName>
            </Address>
          </Addresses>
          <Emails>
            <Email>carol.xu@fakehotel.com</Email>
          </Emails>
          <Phones>
            <Phone PhoneNumber="+31622222220" PhoneTechType="1" Extension="30"/>
            <Phone PhoneNumber="+31622222221" PhoneTechType="1" Extension="30"/>
            <Phone PhoneNumber="+31622222222" PhoneTechType="1" Extension="30"/>
            <Phone PhoneNumber="+31622222223" PhoneTechType="5"/>
            <Phone PhoneNumber="+31622222224" PhoneTechType="3"/>
          </Phones>
        </ContactInfo>
      </ContactInfos>
      <HotelInfo>
        <CategoryCodes>
          <GuestRoomInfo Quantity="100"/>
          <HotelCategory Code="20" ExistsCode="1"/>
        </CategoryCodes>
        <Languages>
          <Language LanguageCode="fr"/>
          <Language LanguageCode="en"/>
        </Languages>
        <Position Latitude="49.4092" Longitude="1.0900"/>
        <Services>
          <Service Code="5" Included="false"/>
          <Service Code="173" Price="14" CurrencyCode="EUR">
            <Types>
              <Type Code="5001"/>
              <Type Code="5004"/>
              <Type Code="5009"/>
            </Types>
            <Items>
              <Item Code="5005"/>
              <Item Code="5006"/>
              <Item Code="5007"/>
              <Item Code="5009"/>
              <Item Code="5011"/>
            </Items>
            <OperationTimes>
              <OperationTime Mon='1' Tue='1' Weds='1' Thur='1' Fri='1' Sat='1' Sun='1' Start="08:00" End="10:00"/>
            </OperationTimes>
          </Service>
          <Service Code="218" ExistsCode="1" Quantity="2">
            <Features>
              <Feature>
                <DescriptiveText>max_age_12</DescriptiveText>
                <Charge Amount="12300" DecimalPlaces="2"/>
              </Feature>
            </Features>
          </Service>
          <Service Code="5038" Quantity="4">
            <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>
                <Charge Amount="246"/>
              </Feature>
            </Features>
          </Service>
        </Services>
        <OwnershipManagementInfos>
          <OwnershipManagementInfo>
            <CompanyName Code="1234"/>
          </OwnershipManagementInfo>
        </OwnershipManagementInfos>
        <RelativePositions>
          <RelativePosition>
            <Transportations>
              <Transportation>
                <TPA_Extensions>
                  <Route>
                    <Leg>
                      <Start Type='airport' Code='AMS'/>
                      <TransportType Code="5000"/>
                      <Departure UponArrangement="1"/>
                    </Leg>
                    <JourneyTime Minutes="20"/>
                    <Price Amount="10" CurrencyCode="EUR"/>
                  </Route>
                </TPA_Extensions>
              </Transportation>
              <Transportation>
                <TPA_Extensions>
                  <Route>
                    <Leg>
                      <Start Type='airport' Code='AMS'/>
                      <TransportType Code="3"/>
                      <Line Name="10"/>
                      <Departure Interval="20"/>
                    </Leg>
                    <JourneyTime Minutes="20"/>
                    <Price Amount="5.5" CurrencyCode="EUR"/>
                  </Route>
                </TPA_Extensions>
              </Transportation>
              <Transportation>
                <TPA_Extensions>
                  <Route>
                    <Leg>
                      <Start Type='airport' Code='AMS'/>
                      <TransportType Code="5"/>
                      <Motorway Name="A2"/>
                      <Junction Name="Amsterdam Zuid"/>
                    </Leg>
                    <JourneyTime Minutes="30"/>
                  </Route>
                </TPA_Extensions>
              </Transportation>
            </Transportations>
          </RelativePosition>
        </RelativePositions>
        <TPA_Extensions>
          <AcceptedPayments>
            <AcceptedPayment PaymentTypeCode="1"/>
            <AcceptedPayment PaymentTypeCode="2"/>
            <AcceptedPayment PaymentTypeCode="3"/>
          </AcceptedPayments>
          <HotelierMessage Language="en">Our hotel defies gravity and floats in mid-air ...
         </HotelierMessage>
        </TPA_Extensions>
      </HotelInfo>
      <FacilityInfo>
        <GuestRooms>
          <GuestRoom>
            <Amenities>
              <Amenity RoomAmenityCode="91" Quantity="4"/>
            </Amenities>
          </GuestRoom>
        </GuestRooms>
        <Restaurants>
          <Restaurant RestaurantName='Orient' OfferBreakfast='1' OfferDinner='1'>
            <CuisineCodes>
              <CuisineCode Code="1"/>
              <CuisineCode Code="5000"/>
            </CuisineCodes>
            <OperationSchedules>
              <OperationSchedule>
                <OperationTimes>
                  <OperationTime Mon='1' Tue='1' Thur='1' Fri='1' Start='16:00' End='22:00'/>
                  <OperationTime Weds='1' Sun='1' Start='14:00' End='18:00'/> 
                </OperationTimes>
              </OperationSchedule>
            </OperationSchedules>
            <Features>
              <Feature DescriptiveText="a la carte"/>
              <Feature DescriptiveText="buffet"/>
              <Feature DescriptiveText="guests only"/>
              <Feature DescriptiveText="accepts reservations"/>
              <Feature DescriptiveText="outdoor seating"/>
            </Features>
            <TPA_Extensions>
              <Ambiances>
                <Ambiance Name="modern"/>
              </Ambiances>
              <DietaryOptions>
                <DietaryOption Name="halal"/>
                <DietaryOption Name="vegan"/>
              </DietaryOptions>
            </TPA_Extensions>
          </Restaurant>
        </Restaurants>
        <TPA_Extensions>
          <HotelierMessage Language="en">We use jetpacks to go for weekend joyrides with our guests ...
         </HotelierMessage>
        </TPA_Extensions>
      </FacilityInfo>
      <AreaInfo>
        <TPA_Extensions>
          <HotelierMessage Language="en">We float above the heart of the city with easy access to ...
         </HotelierMessage>
        </TPA_Extensions>
        <Attractions>
          <Attraction AttractionName="test_market" AttractionCategoryCode="29" Distance="1.2" DistanceUnit="miles" LanguageCode="en"/>
          <Attraction AttractionName="test_restaurant" AttractionCategoryCode="41" Distance="3"/>
        </Attractions>
      </AreaInfo>
      <Policies>
        <Policy>
          <PolicyInfo CheckInTime="17:00-20:00" CheckOutTime="12:00"/>
          <PetsPolicies PetsAllowedCode="Pets By Arrangements">
            <PetsPolicy NonRefundableFee="5"/>
          </PetsPolicies>
          <CancelPolicy>
            <CancelPenalty PolicyCode="1">
              <TPA_Extensions>
                <NoShowPolicy Penalty="default"/>
              </TPA_Extensions>
            </CancelPenalty>
            <CancelPenalty PolicyCode="29">
              <TPA_Extensions>
                <NoShowPolicy Penalty="total_price"/>
              </TPA_Extensions>
            </CancelPenalty>
          </CancelPolicy>
          <GuaranteePaymentPolicy>
            <GuaranteePayment PolicyCode="1">
              <TPA_Extensions>
                <PrepaymentPolicy EffectiveFrom="after_reservation_is_made"/>
              </TPA_Extensions>
            </GuaranteePayment>
            <GuaranteePayment PolicyCode="29">
              <TPA_Extensions>
                <PrepaymentPolicy EffectiveFrom="after_cancellation_fee_begins"/>
              </TPA_Extensions>
            </GuaranteePayment>
          </GuaranteePaymentPolicy>
          <TaxPolicies>
            <TaxPolicy Code="36" Percent="1200" DecimalPlaces="2" Type="Exclusive"/>
            <TaxPolicy Code="3" Amount="800" DecimalPlaces="2" Type="Inclusive" ChargeFrequency="20"/>
          </TaxPolicies>
          <FeePolicies>
            <FeePolicy Code="5009" Amount="1500" DecimalPlaces="2" Type="Conditional" ChargeFrequency="12">
              <TPA_Extensions>
                <Conditions>
                  <Condition Type="guest_doesnt_clean_before_checkout"/>
                </Conditions>
              </TPA_Extensions>
            </FeePolicy>
            <FeePolicy Code="5035" Amount="10000" DecimalPlaces="2" Type="Exclusive" ChargeFrequency="5001">
              <TPA_Extensions>
                <InternetFeePolicy InternetType="wired" InternetCoverage="public_areas"/>
              </TPA_Extensions>
            </FeePolicy>
           <FeePolicy Code="5036" Amount="10000" DecimalPlaces="2" Type="Exclusive" ChargeFrequency="2">
              <TPA_Extensions>
                <ParkingFeePolicy ParkingType="location_nearby" ParkingReservation="needed" ParkingProperty="private"/>
              </TPA_Extensions>
            </FeePolicy>
          </FeePolicies>
        </Policy>
      </Policies>
      <AffiliationInfo>
        <Awards>
          <Award Provider="Star rating" Rating="3"/>
        </Awards>
      </AffiliationInfo>
      <MultimediaDescriptions>
        <MultimediaDescription>
          <ImageItems>
            <ImageItem>
              <ImageFormat Main="1">
                <URL>https://pathtoimage/hotelimage001.jpg</URL>
              </ImageFormat>
              <TPA_Extensions>
                <ImageTags>
                  <ImageTag ID="1"/>
                </ImageTags>
              </TPA_Extensions>
            </ImageItem>
            <ImageItem>
              <ImageFormat Sort="1">
                <URL>https://pathtoimage/hotelimage002.jpg</URL>
              </ImageFormat>
            </ImageItem>
          </ImageItems>
        </MultimediaDescription>
      </MultimediaDescriptions>
      <TPA_Extensions>
        <!-- Standard Phrases -->
        <StandardPhrases>
          <StandardPhrase Enabled="1" Name="KeyCollection">
            <Options>
              <Option Name="KeyCollectionAddressLine">15 Station Street</Option>
              <Option Name="KeyCollectionCityName">Sotteville</Option>
              <Option Name="KeyCollectionPostalCode">76000</Option>
            </Options>
          </StandardPhrase>
          <StandardPhrase Enabled="1" Name="GuestIdentification"/>
          <StandardPhrase Enabled="1" Name="InformArrivalTime"/>
          <StandardPhrase Enabled="1" Name="PayBeforeStay"/>
          <StandardPhrase Enabled="1" Name="TattooRestriction"/>
          <StandardPhrase Enabled="1" Name="Renovation">
            <Options>
              <Option Name="RenovationFrom">2017-01-01</Option>
              <Option Name="RenovationUntil">2017-12-31</Option>
            </Options>
          </StandardPhrase>
          <StandardPhrase Enabled="1" Name="SecurityDeposit">
            <Options>
              <Option Name="SecurityDepositAmount">10.43</Option>
              <Option Name="SecurityDepositReturnMethod">cash</Option>
              <Option Name="SecurityDepositReturnWhen">on_checkout</Option>
              <Option Name="SecurityDepositCollectNumDays">0</Option>
              <Option Name="SecurityDepositCollectMethod">cash</Option>
              <Option Name="SecurityDepositCollectWhen">upon_arrival</Option>
            </Options>
          </StandardPhrase>
        </StandardPhrases>
    <TotalNumberOfFloors Number="10"/>
      </TPA_Extensions>
    </HotelDescriptiveContent>
  </HotelDescriptiveContents>
</OTA_HotelDescriptiveContentNotifRQ>