/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 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" 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>
          <HiddenAddress ShouldHideAddress="1"/>
          <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>
        </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>
          <PaymentPreferences NoCVC="0" ViewCCDetails="1" /> 
        </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>
      </FacilityInfo>
      <AreaInfo>
        <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" AcceptedGuestType="ChildrenAllowed" MinGuestAge="0"/>
          <PetsPolicies PetsAllowedCode="Pets By Arrangements">
            <PetsPolicy NonRefundableFee="charges_may_apply"/>
          </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">
            <FeePolicy Code="44" ChargeFrequency="21" Amount="0" DecimalPlaces="2" MinAge="0" MaxAge="3" />
                  <FeePolicy Code="44" ChargeFrequency="21" Amount="6000" DecimalPlaces="2" MinAge="4"  MaxAge="12" />
            <FeePolicy Code="37" ChargeFrequency="20" Amount="2000" DecimalPlaces="2" MinAge="0" MaxAge="3" />
                  <FeePolicy Code="38" ChargeFrequency="21" Amount="7000" DecimalPlaces="2" MinAge="4"  MaxAge="255" />
              <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>
      <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"/>
          <LongStayInfo  AcceptLongStay="1" MaxLengthOfStay="45"/>
          <PricingType Value="LOS"/>
      </TPA_Extensions>
    </HotelDescriptiveContent>
  </HotelDescriptiveContents>
</OTA_HotelDescriptiveContentNotifRQ>