How can we help?
Follow
Hotels Search

Updates 05/02/2015:

*StatelessSearch:

DO NOT USE THIS SEARCH TYPE WITHOUT CONSULTING SUPPORT TEAM FIRST!

Intended to be used by clients with high traffic or for clients with unique search to book flow.

*GeoLocationInfo and general search recommendations:

 

1. You can now search using Latitude /Longitude + Radius (up to 75km) - as an alternative to HotelLocation search.

2. You can now search using HotelIds only (Max 300, no matter if supplier supports search by single hotel or not, we are making the conversion on our side and you will receive the relevant results). You should now STOP sending requests that contain BOTH HotelId and HotelLocation.

3. Please do not use GeoLocationInfo search along with HotelId as this search is invalid. GeoLocation search can be used alone.


Please make sure you understand what is session and how to handle it, as explained in the Login & Session Management.

Please be advised : You can proceed with the hotels booking process (hotel/package details, cancellation policy, payment pref, booking) only for items , returned in the last search response of your current session.

Your search request is directed to the following service: 

http://services.carsolize.com/BookingServices/dynamicdataservice.svc 

Soapaction:

http://tempuri.org/IDynamicDataService/ServiceRequest     

Request name: HotelsServiceSearchRequest:

RequestType: Search

Field Name Explanation
ClientIP Not required in search request. Null
Credentials

** In case you want to login and search at the same request (without separated login request).

Recommended!

UserName 

Password

Will be provided by Travolutionary support team upon set-up, or by creating a new user in the B2B/Back-office  system.

DesiredResultCurrency Mandatory. Currency ISO (Example: “USD”, “EUR”, “ILS”). 
Residency

Mandatory. Lead pax residency, ISO Country Code (Example: US, CZ, IL).

Required by some of the suppliers, as they have special / restricted rates according to residency value we passed them.

TimeoutSeconds

You can pass a value on the request, to override the default timeout value which was defined for user (On the B2B, under 'User Settings' section).

CheckIn Mandatory. Check in date (Example: 10/10/2014)
CheckOut Mandatory. Check out date (Example: 11/11/2014). Must be later from check in date.
ContractIds Search by contract id with hotel supplier. (Can be retrieved from B2b admin panel: "Admin" ==> "Contracts")
DetailLevel

Mandatory.

Default - Includes more detailed price breakdown, more package information and full hotel information. Not Recommended because of the large response size. Will be blocked as from July 30, 2017, unless used in Single Hotel Id context.
Low/LowNoTax - Includes less detailed price breakdown on the package including/excluding VAT (Tax).
Minimal - Same as Low, excluding the ChainCode and the supplier name of the package.
NoPackages /NoPackagesNoTax - Returns the minimum required hotel data.

Doesn't return any package information, but only the highest and lowest package price per hotel including/excluding VAT (Tax).

This is a recommended practice!

Meta/MetaNoTax  - Returns the minimum required hotel data.

Doesn't return any package information, only lowest package price of each supplier per hotel, including/excluding VAT (Tax). 

This is a recommended practice!

MetaAdvanced - Applicable for special implementations only. 

ExcludeHotelDetails

This field is to be included in the search request in case you are working with static data file and do not need the hotel details to be returned, but only the hotel id.

For best performance, use true.
False - include all hotel details in the response (Address, ChainCode, DisplayName, GeoLocation, StarRating, TripAdvisor - If authorized).
True - exclude all hotel details in the response except the hotel id and default image.

GeoLocationInfo -----New from 05/02/2015-----
Latitude Type: System.Double 
Longitude Type: System.Double
HotelIds

* No more than 300 hotel id's per request.

HotelLocation

----Cannot be used when searching by Geo-----

* Search by hotel location. List of location ids can be downloaded here.

IncludeCityTax ***NOT IN USE*** False - default value.
True - might be useful for some USA cities.
Nights Optional. Number of nights for hotel stay (Example: 2). If provided, must correlates with Check-in Check-out dates. If not, can be "0".
RadiusInMeters

Radius from Lat/Lang coordinates to search in.

Value

*Mandatory* when using GeoLocation search. Cannot be "NULL" or "0" or greater than "75,000"!

AdultsCount Mandatory. Number of adults to stay in room. Up to 4 in a room. Cannot be “0” or “NULL”! Total number of passengers (adults + children) per room cannot exceed 4.
KidsAges Up to 2 in a room.
SeperatedBeds

Deprecated

False - default value. No separated beds in the room.
True - Separated beds.

SupplierIds For search from specific suppliers.
RequestType Mandatory. Search / StatelessSearch (See notes below)
SessionID ** Retrieved in login response or in Search Response.
TypeOfService Mandatory. Hotels

*Mandatory* - Means you have to provide at least one of the fields: HotelIds / HotelLocation / GeoLocationInfo

** - Means you have to provide only one of the fields: Credentials / SessionID

Response Fields:

Field Name Explanation
 Result  Hotel:
 Address

 Hotel Address

 Area  Country
DefaultImage FullSize, Thumb.
DisplayName  Hotel name
District  Area
GeoLocation Latitude, Longitude. CAN BE NULL if hotel latitude longitude are unknown.
ID  Hotel ID from our Hotel Id's List 
Packages

RoomsPackage:

1. ContractId - Contract with supplier

2. HotelId - Hotel Id's List 

3. PackageId - Unique ID stores Package details. When no package id is returned (Supplier is 4 step, and didn't provide any room information on his search response), you need to call HotelsSupplierDetails Request to obtain the package ids and full room information.

4. PackagePrice:

4.A. Currency - (USD, EUR, ILS, etc)

4.B. FinalPrice

4.C. FinalPriceInSupplierCurrency

4.D. OriginalPrice

4.E. OriginalPriceInSupplierCurrency

4.F. SupplierCurrency - (USD, EUR, ILS, etc)

5. Rooms:

Room  [  ]

5.A. AdultsCount - Number of adults in the room.

5.B. Availability - Available / Not Available. End of [ ].

5.C. Id - Unique ID stores Room details.

5.D. KidsAges [  ] - Notice top comments. End of [ ].

5.E. Price: (Room Price)

5.E.1. Currency - (As explained in 4.A.)

5.E.2. FinalPrice - (As explained in 4.B.)

5.E.3. FinalPriceInSupplierCurrency - (As explained in 4.C.)

5.E.4. OriginalPrice - (As explained in 4.D.)

5.E.5. OriginalPriceInSupplierCurrency - (As explained in 4.E.)

5.E.6. SupplierCurrency - (As explained in 4.F.)

5.F. RoomBasis - Rooms Values

5.G. RoomBasisOriginal - Supplier value

5.H. RoomClass - Rooms Values

5.I. RoomClassOriginal - Supplier value

5.J. RoomType - Rooms Values

5.K. RoomTypeOriginal - Supplier value

6. SimplePrice

7. Refundability - Indicates whether the rate is refundable or not. True = Refundable. False = Non-Refundable. This indication should not replace the call to get cancellation policy.

8. RefundableUntil - Date until the package is Refundable.

This indication should not replace the call to get cancellation policy.

9. Remarks (List<string>): Contains essential textual information that returned from the supplier, such as city taxes, check-in hours, etc.

10. SupplierId

11. SupplierName

StarRating  1-5
TripAdvisor Rating, RatingImageUrl, ReviewsCount. More info here
 SearchId  Unique ID stores search details.


Please download attached examples.

Was this article helpful?
2 out of 3 found this helpful
Have more questions? Submit a request

Comments

Powered by Zendesk