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, received in the original search response.   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
ID of the room that the lead pax should be allocated on. Should be taken from search response.   Yes
PackageID
Type: String
ID of the desired Package, received in the original search   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
When credit card is provided - do not pass anything here. The system will forward the Credit Card details to the appropriate third-party provider:
In case of a Gross package, the Credit Card details will be passed to the hotel supplier for processing the transaction.
In case of a Net package, the Credit Card details will be passed to the Payment Gateway for processing the transaction.

See more details on the Payment Gateways article
https://carsolize.zendesk.com/hc/en-us/articles/203754369-Payment-Gateways-Suppliers
Cash or empty Yes
ServiceFee
Type: Nullable Double
Specify the Service Fee you would like to collect for this booking. Applicable only in specific scenarios.    
CancellationPolicies
  Cancellation Policies to be applied for the room that was selected to book.

If you are not specifying any, the response might return Non-Refundable package, while the original package from search response was Refundable. If you are not specifying the exact cancellation policy/policies as retrieved on the original session, the response might return a package with worse cancellation policy, i.e higher cancellation fee, or earlier deadline.

Best practice is to specify the cancellation policy/policies, unless your business case is different. If unknown, it is recommended to specify a Non-Refundable cancellation policy.
   
CancellationFee - a clone of Price object as retrieved on the original cancellation policy.      

DateFrom - Today

Type: System.DateTime

     

DateTo

Type: System.DateTime

     
Currency
Type: String
Cancellation policy price currency   Yes
FinalPrice
Type: Double
In case you would like to proceed to booking step with the returned package from the Reprice response, you must pass the SAME price as retrieved in the 'FinalPrice' field in 'BookingPrice' field in the booking request.   Yes
FinalPriceInSupplierCurrency
Type: Double
The original price added by markups - in the supplier's currency   Yes
OriginalPrice
Type: Double
The originla price retrieved from the supplier search services, in the affiliate's currency   Yes
OriginalPriceInSupplierCurrency
Type: Double
The original price retrieved from the supplier search services, in the supplier currency   Yes
SupplierCurrency
Type: String
The supplier currency retrieved on search   Yes
DateFrom
Type: System.DateTime
Check in date   Yes
DateTo
Type: System.DateTime
Check out date   Yes
Description
Type: String
     
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
Room id returned on original search.   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 the maximum price which the system will not find alternatives beyond that price.   Yes
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