Hotel Pre-Booking

Method Name Definition
HotelReservation()

This method is used to reserve the hotel rooms. The query parameters described should be sent along with the search URL.

  • Request Details
    This search method makes request by passing HotelReservationRequest class object _RQ and returns response as HotelBookingResponse class object which includes hotel details. For more information please click on HotelReservationRequest class.
    To get complete information about HotelReservationRequest request, check its SOAP request sample.

    Name Data Type Parameter Description
    hotelIDstringId of the hotel
    ReferenceNumberstring
    ReferenceNamestring
    CitystringIt represents City name
    checkInDatestringIt represents Check in date. This value should be entered as string not less than and more than 10 characters in date format ‘dd/mm/yyyy’.
    checkOutDatestringIt represents the Check-out date and should be entered as string not less than and more than 10 characters in date format ‘dd/mm/yyyy’. It cannot be greater than journey date
    RoomsMore/Fewer

    Name Data Type Parameter Description
    RoomMore/Fewer

    Name Data Type Parameter Description
    AdultsMore/Fewer

    Name Data Type Parameter Description
    AdultFirstNamestringFirst name of the adult.
    AdultLastNamestringLast name of the adult.

    AdultDetailIt represents the detail of the adults.
    AdultCountintNumber of adults.
    ChildCountMore/Fewer

    Name Data Type Parameter Description
    CountintIt represents the total number of child in the room.
    ChildDetailMore/Fewer

    Name Data Type Parameter Description
    FirstNamestringFirst name the child
    LastNamestringLast name of the child
    childAgeintThis parameter states the age of the children. This is optional, but recommended. If this parameter is not passed, child's age is taken as 11 by default.

    ListIt represents child name and age.

    HotelChildCountNumber of child.
    firstNamestringFirst name of the customer.
    lastNamestringLast name the customer.
    cotsstring
    RoomTypeIDstringId of the particular room type.
    OptionIdstring
    OptionDatestring
    QuantitystringTotal number of persons in a room.

    HotelBookingRoomThis contains the information about the no. of rooms, room characteristic, and information of persons.
    CountintTotal number of rooms.

    HotelBookingRoomsTotal number of room entered by the user
    roomTypeCodestringRoom type code and description (Deluxe room, Executive room, Deluxe AC, etc.). This field may not be unique.
    phonestringPhone details of the hotel.
    addressstringAddress of the hotel.
    zipstringPin code of the city where hotel is located.
    emailstringIt represents the email id.
    CCNstringIf the payment mode is a credit card, the name on the card should be passed.
    CCCHNstring
    CCExpYYstringIf the payment mode is a credit card, a valid expiration year of the credit card should be passed
    CCExpMonthstringIf the payment mode is a credit card, a valid expiration month of the credit card should be passed.
    CVVstringIf the payment mode is a credit card, the CVV found on the back of the card should be passed.
    CardTypestringIt represents the value of card type (credit card, debit card etc.)
    countrstring
    RateOfferIDstring
    RateSupplierCodestring
    bookingPricestringThis value should be calculated form the search response. This should be the total amount across the number of rooms and the number of nights requested for. This amount should also include taxes. If the total has a decimal, the amount should be rounded up to the next integer.

  • Response Details
    If request is submitted successfully then response as HotelBookingResponse class's object returned with all details corresponding to search parameters submitted by the user. For more information please click on HotelBookingResponse class.
    Response content type:
    application/xml

    Name Data Type Parameter Description
    pinIdstring
    HotelNamestringName of the hotel.
    hotelNamestringName of the hotel.
    hotelCitystringCity in which hotel is located.
    hotelCountryCodestringValid 2 letter ISO country code in which hotel is located.
    hotelPostalCodestringPostal code.
    hotelAddressstringAddress detail of the hotel.
    arrivalDatestringCheck-in date.
    departureDatestringCheck-out date.
    numberOfRoomsBookedstringTotal number of rooms reserved by the customer.
    roomDescriptionstringThe room type, room type code and amenities available in the room.
    CreationDatestringIt represents the date when the booking is made.
    FileNumberstring
    HolderFirstNamestringFirst name of the customer.
    HolderLastNamestringLast name of customer.
    reservationNumbersstringTotal number of customers.
    confirmationNumbersListThe confirmation number for the booking.
    processWithConfirmationstring
    cancellationPolicystringThe cancellation policy of the hotel.
    CancelPolicyInfoListMore/Fewer

    Name Data Type Parameter Description
    CancelPolicyInfoMore/Fewer

    Name Data Type Parameter Description
    versionIdstring
    cancelTimestringIt represents time when hotel is cancel.
    startWindowHoursstring
    nightCountstringNumber of nights.
    currencyCodestringCode of the currency.
    timeZoneDescriptionstring

    ListIt represents the detail of cancellation policy.

    ListDetail description of the cancellation rules.
    checkInInstructiuonsstringInstructions followed by the customer.
    itineraryIdstringThis call returns the details of a given hotel booking.
    existingItinerarystring
    RateInfosMore/Fewer

    Name Data Type Parameter Description
    RateInfoMore/Fewer

    Name Data Type Parameter Description
    ChargeableRateInfoMore/Fewer

    Name Data Type Parameter Description
    nightlyRateTotalstringTotal amount for a night.
    maxNightlyRatestringMaximum amount for a night.
    NightlyRatesPerRoomMore/Fewer

    Name Data Type Parameter Description
    NightlyRateMore/Fewer

    Name Data Type Parameter Description
    _ratestring
    ratestringRate of per night
    baseRatestringIt represents the base fare for a night.
    promstringDescription of the promo.

    ListIt represents a night rate.

    ListAmount of all the rooms for a night.
    SurchargesMore/Fewer

    Name Data Type Parameter Description
    surchargeMore/Fewer

    Name Data Type Parameter Description
    amountstringTotal surcharge.
    typestringType of the surcharge.

    ListIt represents the surcharge.

    ListIt represents surcharges.
    surchargeTotalstringIt represents total of surcharges.
    averageRatestringIt represents average rate.
    averageBaseRatestringIt represents minimum rate.
    currencyCodestringCode of the currency.
    commissionableUsdTotalstring
    totalstringTotal amount (Base fare + Tax + surcharge etc.)

    List
    expediaRoomGroupMore/Fewer

    Name Data Type Parameter Description
    expediaRoomGroupMore/Fewer

    Name Data Type Parameter Description
    numberOfAdultsstringTotal number of adults
    numberOfChildrenstringTotal number of children

    ListDetail of adults and children.

    RoomGroup
    ratePlanTypestring

    ListIt represents the detail of the rate.

    ListDetail description of the price which includes surcharge, commission and tax.
    DestinationNamestringName of destination.
    TotalCoststringTotal amount.
    BookingStatusstringThe status of booking: Confirmed (P), Cancelled (Q), Refunded (K), etc.
    CustomerSessionIDstringUnique id which generates when the customer login.
    xmlResponsestring
    ErrorstringDescription of the error.
    supplierTypestring
    drivingDirectionsstringHotel driving directions.
    Zonestring
    CreationUserstring
    AgencyReferencestring
    ServiceFileNumberstring
    CommentstringComments given by the user.
    SupplierNamestring
    vatNumberstring
    ReferenceNostring
    commentServicestring
    commentIncomingstring
    Categorystring
    SHRUIstring
    PaymentTypestringThis should be the requested payment mode.
    StatusstringThe status of booking: Confirmed (P), Cancelled (Q), Refunded (K), etc.
    DescriptionstringDetail description.

Note:
Alphabets are only allowed in first name and last name. The maximum character length allowed for first name is 25. The maximum character length allowed for last name is 40.