How can we help?
Follow
HotelSmartBook

 Description:

* NOTE *

In order to use this function - you must contact your Customer Success Manager for activation terms/cost.

Our integration team will be at your convenience for implementation walk through.

The SmartBook function is used to book a requested room(s) at a requested price in a single call.

No further actions are required.

The function encapsulates sophisticated business logic layer which is intended to optimize the profit during the operation duration and increase the success rate of a booking attempt.

The function receives as an input 3 main objects:

HotelBookRequest - This object will include the booking request data, such as:
BookingPrice, Pax Information, PackageId, etc.

HotelSearchRequest - This object will include the search request data, such as:
Results currency, search criteria, rooms occupancy, residency, etc.

CancellationPolicies - This object will include the applicable cancellation policy(ies) for the package selected to be booked.

Headers:

POST https://services.travolutionary.com/BookingServices/DynamicDataService.svc HTTP/1.1
Content-Type: text/xml; charset=utf-8
SOAPAction: "http://tempuri.org/IDynamicDataService/ServiceRequest"
Host: services.travolutionary.com
Accept-Encoding: gzip, deflate

 

Field Name Description Possible Values Mandatory
Credentials
Type: Credentials
Password (string)
UserName (string)
  Yes
BookRequest
AgentRemarks
Type: String
Agent general remarks.    

AgentRoomRemarks

Type: Key Value Pair <string,string>

Key is the room id, value is the room remarks to submit to supplier    
BookingPrice
Type: Double

Books the found package in that price.

 

  Yes
HotelID
Type: Int32
Id of the desired hotel to book.   Yes

InternalAgentRef1

Type: String

Internal agent reference for this booking.     

InternalAgentRef2

Type: String

 Internal agent reference for this booking.     
LeadPaxId
Type: String
ID of the lead pax. Should be generated on your side, preferably as GUID   Yes
LeadPaxRoomId
Type: String
Newly generated string   Yes
PackageID
Type: String
Own generated ID of the desired Package to book.    Yes
Passengers
Type: String
CustomerInfo   Yes

Allocation

Type: String

Specify in what room to accommodate the this pax.

The Allocation of the lead pax would be equals to the LeadPaxRoomId.

If the first room should accommodate 2 adults, the Allocation of the second Passenger would be the same as the Allocation of the first pax. 

  Yes

ID

Type: String

The Passenger Id. The Id of the first Passenger should be equals to the LeadPaxId. For the rest of the passengers, should be unique for each one.   Yes

PersonDetails

Type: Person

GivenName (string)
NamePrefix (string)
Surname (string)
Type (PersonType enum)

Age (int) - Mandatory when booking rooms with children.

NamePrefix: "MR", "MR.", "MS", "MRS", etc.

Type: Adult, Child. All others - not in use for Hotels

Yes
SelectedPaymentMethod
Type: String
Cash Cash or empty Yes
CancellationPolicies
  Cancellation Policies to be applied for the package that was selected to book.

If you are not specifying any, the response might book Non-Refundable package.

Best practice is to specify the cancellation policy/policies with cancellation fee as the BookingPrice, unless your business case is different.
   

DateFrom

Type: System.DateTime

 Date when the policy kicks in.    

DateTo

Type: System.DateTime

     
Currency
Type: String
Cancellation policy fee currency   Yes
FinalPrice
Type: Double
Cancellation policy fee   Yes
HotelId
Type: Int32
The property HotelID   Yes
Rooms
AdultsCount Number of adults in the room   Yes
KidsAge Children's ages   Yes, when relevant
   SmartBookRoomRequest
Adults
Type: Int32
Number of adults in the room.   Yes
Availablity
Type: String
Availability returned Available, On Request Yes
ID
Type: String
Own generated Room id.   Yes
KidsAge     Yes
RoomBasis
Type: String
Please refer to Room Static Values   Yes
RoomClass
Type: String
Please refer to Room Static Values   Yes
RomKind
Type: String
Please refer to Room Static Values   Yes
SearchRequest
Type: String
    Yes
DesiredResultCurrency
Type: String
Currency ISO. For example: “USD”, “EUR”, “GBP”   Yes
Residency
Type: String
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.
  Yes
TimeoutSeconds
Type: Int32
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).   No
SearchRequest
CheckIn
Type: System.DateTime
    Yes
CheckOut
Type: System.DateTime
    Yes
ContractIds
Type: Int32
Search by contract ID with hotel supplier. Can be retrieved from B2B admin panel: "Admin" ==> "Contracts")   No
DetailLevel
Type: String
Mandatory.
Use "Low".

  Yes
ExcludeHotelDetails
Type: Boolean
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 HotelID and default image.
  Yes
GeoLocationInfo
Type: Double
Latitude
Longitude
   
HotelIds
Type: Int32
     
HotelLocation
Type: Nullable Int32 array
     
IncludeCityTax
Type: Boolean
     
Nights
Type: Int32
    Deprecated
RadiusInMeters
Type: Nullable Int32
    Yes
Rooms
Type: Nullable Int32 array
HotelRoomRequest - AdultsCount, KidsAge    
SupplierIds
Type: Int32 array
    No
SupplierLocationIds
Type: Int32 array
    No
TargetPrice
Type: Double
Specify your buying price from the supplier.   Yes
MaxTargetPrice
Type: Double 
Specify the maximum buying price which the system will not find alternatives beyond that price.    
RequestType
Type: String
SmartBook   Yes
TypeOfService
Type: String
Hotels   Yes

 

 

 

 

 

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

Comments

Powered by Zendesk