This request is intended to be used on the following scenarios:
1. You are working on 4 step mode (DetailLevel = Meta/NoPackages), which is the best practice and the recommended way of implementing our API.
Using that call, you will get full RoomsPackage information, including supplier original room values (Class, Type, Board/Basis).
2. The supplier is implemented as a 4 step:
Examples: Booking.com, HRS, Priceline, DOTW, RTS, HotelsPro, etc.
Those suppliers return only a 'From' price on their search response without any packages / room price information.
In order to get packages and rooms from these suppliers, it is necessary to use this API call, otherwise you won't be able to call GetCancellationPolicy (as no valid PackageId retreieved) and perform any booking.
3. You are willing to get the applicable payment option for specific hotel id packages. This relevant only for Gross suppliers which support different payment types: PostPay / PrePay.
4. You are willing to get Taxes and Fees to be paid at the hotel.
See more details on the bottom part of this document.
Please be advised: You can use this call only for items that were returned in the last search response of your current session.
Please follow the explanations and examples below.
The request must be directed to the following service:
Request Name: HotelsSupplierDetailsRequest
|HotelID||HotelID from search response|
false - Will include STATIC general hotel details only.
Note: As from 19/06/2016 requests with IncludePackageDetails = false will be blocked.
In order to get STATIC hotel details ONLY, please import the data from static data files instead.
For more information, please contact firstname.lastname@example.org
true - will include package information.
false - will return regular packages information.
true - will return full taxes and fees breakdown, when the following 2 conditions are met:
1. The supplier returned this information.
2. The implementation of reading that information is completed as part of the supplier integration on the system.
Currently, the following suppliers integration are implemented to support that functionality:
Amadeus, Bonotel, Booking.com, Expedia, ExpediaSite, GetARoom, GRNConnect, Hotelbeds (V2 - Apitude), Priceline, Tourico
|PackageID||Deprecated - not needed|
|SessionID||The current session id|
|TimeoutInSeconds||Timeout for the response to be retrieved.|
Response Fields: IncludePackageDetails = True
|Result||As seen below:|
|Hotel||Contains Hotel ID, Hotel Packages.|
RoomsPackage. Same as Package field in search response.
Note: This element might return as empty, with no packages. This is typically to occur when:
1. The supplier is a "4 step".
2. The supplier had availability for this hotel in initial search, but didn't have any at the "get packages and rooms" call.
Response Fields: ReturnTaxesAndFees = True
Please be advised: This information is being returned as is, based on the supplier response, without any calculations or other logic applied.
|Currency||The taxes and fees currency as the supplier returned.|
|FeeTitle||The taxes and fees title as the supplier returned.|
|FrequencyType||Represents the tax repetitive type: Other, NotApplicable, NotSpecified, PerMinute, PerHour, PerHalfDay, PerNight, PerWeek, PerStay.|
|IsIncludedInPrice||Represents if the taxes and fees are included in the final price.|
|IsMandatory||Represents if the taxes and fees are mandatory to be paid. For instance, 'resort fees' are rypically to be mandatory, while 'wifi fee' might not.|
|IsValuePercentage||Represents if the tax or fee is percentage value or an absolute value.|
|UnitType||Represents the taxes and fees categorization type: Other, NotApplicable, NotSpecified, PerChild, PerAdult, PerNight,
PerRoom, PerStay, PerPerson, PerOccurrence, PerItem, PerReservation.
|Value||The decimal value of the taxes and fees.|
CreditCard field values description:
The value affects on the payment method to be provided in the booking request. (The available payment methods will return also in Payment Preferences response).
ImmidiatePayment - Default value. In this case the payment has to be made by CreditCard External . The payment method on book request will be CreditCardExternal.
NotRequired - means the payment is to be made at the hotel upon arrival. The payment method to be passed in the booking request is PayUponArrival. Credit card details are not required.
Guarantee - payment method to be passed in the booking request is CreditCardExternal, but we will not charge the credit card and the actual payment will be made by the hotel upon arrival, or in case of cancellation fees.
Deposit - payment method to be passed in the booking request is CreditCardhExternal. In this case another value will also return in the package details in the price section - PayOnArrivalFinal . The credit card will be charged for the sum= FinalPrice - PayOnArrivalFinal. The PayOnArrivalFinal amount is to be payed at the hotel upon arrival.
Please download attached examples.