3. Booking Info

Before making the booking, you will need to make sure that the user is aware of all details regarding this booking and the booked property. This is why you MUST perform the Booking Info request and display the information received to your customer PRIOR to making the booking. The information received from this request is the same information that must be displayed on the voucher.

Booking info Request
<request version="4.0">
  <auth>
    <username>example</username>
    <password>example</password>
    <agent>example</agent>
  </auth>
  <hotel-booking-info session="dv.Uw8IU6CsA">
    <results>
      <result>dv.Uw8JnP3oA</result>
      <result>dv.Uw8JnP3oA</result>
    </results>
  </hotel-booking-info>
</request>
Parameter Type Comments
 hotel-booking-info @session stringthe session id as returned by the search  response
results/result stringthe room result you wish to book

Notes: you need to send all room ids you wish to book, even if it's the same room id twice

Booking Info Response
<response success="1" session="dv.Uw8IU6CsA">
  <booking-options count="1" split="0">
    <booking-option token="dv.Uw8JnP3oA" onrequest="0">
      <hotel-info surroundings="0">
        <name>The New York Palace</name>
        <address>455 Madison Ave, New York, United States</address>
        <phone>1 212 888-7000</phone>
        <fax/>
        <rating>4</rating>
        <latitude>40.75823</latitude>
        <longitude>-73.97453</longitude>
      </hotel-info>
      <remarks>
        You must present a photo ID when checking in. Your credit card is charged at the time you book. Bed type and smoking preferences are not guaranteed.Your reservation is prepaid and is guaranteed for late arrival. The total charge includes all room charges and taxes, as well as fees for access and booking. Any incidental charges such as parking, phone calls, and room service will be handled directly between you and the property.

Fee for in-room wireless Internet: USD 15 (for 24 hours, rates may vary)
Valet parking fee: USD 55 per night
Rollaway bed fee: USD 50 per night
The above list may not be comprehensive. Fees and deposits may not include tax and are subject to change.
      </remarks>
      <accepted-cards/>
      <cancellation>
        <frame endTime="2014-02-26 13:35:34" timezone="UTC" type="non-refundable"/>
      </cancellation>
    </booking-option>
  </booking-options>
</response>
Parameter Type Comments
response @successbooleanwas the request successful
booking-options @countinthow many properties are returned in this response
booking-options @splitbooleanshould the booking be split into more than 1 booking request
booking-option @tokenstring the room token this option refers to
booking-option @onrequestboolean is this option on request or immediate confirmation 
hotel-infonode pretty self explanatory 
hotel-info @surroundingsboolean Is the hotel outside the city polyzone? see note #3
remarksnodemandatory remarks to display to the customer
accepted-cardsnode accepted credit cards, returned only if the booking is "pay at the hotel"
cancellationnode the cancellation policy for the specific offering. see cancellation policy section for details 
notes:
  1. if the split attribute is returned as 1, you MUST run separate booking requests for each token
  2. you MUST use the information returned under the hotel-info node to show the exact hotel name and details to your client. you should NOT rely on the property static information
  3. the @surroundings attribute will only show in case the initial search was made for a city. If the value is 0, it means that the specific hotel in INSIDE the city polyzone. in case it's 1, it means it's outside of the city polyzone, most probably further from the city center.
  4. you MUST display the remarks node content to your customer exactly as they are returned. no manipulation or reduction is allowed. you also MUST show these remarks on the voucher issued to the customer.
  5. in case the booking is to be paid by the customer at the hotel ("payAtTheHotel" is returned on the room request) you will receive a list of cards supported by the hotel, like so:
<accepted-cards>
    <card type="AX">American Express</card>
    <card type="UI">Debit Card</card>
    <card type="CA">Master Card</card>
    <card type="VI">Visa</card>
</accepted-cards>
      
      6. sometimes you will get a child-node similar to this one:
<extra-verifications>
   <verification type="component">
     <differences>
       <difference type="name"/>
     </differences>
     <searched-hotel>
       <name>Best Western Opera Premier Faubourg (formerly the Jules Hotel)</name>
     </searched-hotel>
     <provider-hotel>
       <name>BEST WESTERN PREMIER OPERA FAUBOURG</name>
     </provider-hotel>
   </verification>
 </extra-verifications>
      This means that you need to pay close attention to the differences highlighted in this node. in the example above, the difference type "name" is different between the property you wanted to book and the property you are going to book.
    
     7. In some cases you will get a "warnings" node under the "booking-options" node. This node will hold some warnings regarding possible rate changes
<warnings>
  <warning code="210"><![CDATA[The price for this offer has changed, it is now available for a higher price then you requested.]]></warning>
</warnings>
      


Comments