How can we help?
Follow
Hotel Book Request - Cash

This function submits a new booking request for the selected hotel and returns the booking reference and booking status.

The request must be addressed to the service: https://services.carsolize.com/BookingServices/dynamicdataservice.svc

Important notes:

1. You can book only those items that returned in the last search in the same session.

2. Same package can be booked several times, depending on supplier restrictions for duplicate bookings, or an error which prevents the second attempt. On case of duplicate booking error message (E4052), please see our error handling recommendation here:

https://carsolize.zendesk.com/hc/en-us/articles/201758989-Error-library-Error-handling

3. Our API requires full occupancy details, i.e you are required to specify the Passengers and CustomerInfo for each of the rooms requested, as some suppliers require that full information from us.

However, we aware that you might want to save from the customer the hassle of filling the information for all passengers, or you are not willing to collect that information on the first place, therefore, you may clone the passenger information from the lead pax (except for children).

4. Booking timeout - The system waits 3 minutes before it returns any response.

In case you didn't receive any booking response from our API, the booking still might be created in the supplier system, therefore it is required to check if the booking was created or not in the supplier system.

For more possible techniques how to handle similar scenarios, please coordinate with aviad@travolutionary.com.

 

Request fields:

Field Name Explanation Mandatory / Optional
ClientIP Need to provide client IP Optional
BookingPrice Package price as returned on search response. Please note that you can pass '0' to allow the system to book the required package on his final price. You may pass higher or lower booking price, depending on the markup configuration settings defined on our B2B tool for the username. Mandatory
HotelID Hotel ID from search response that needs to be booked Mandatory
InternalAgentRef1

Free text. Will appear as InternalRefId1 field in Supplier confirmation info section of the order, on our B2B

Optional
InternalAgentRef2

Free text. Will appear as InternalRefId2 field in Supplier confirmation info section of the order, on our B2B

Optional
PackageID package ID from search response Mandatory
LeadPaxId

ID of the lead pax. Should be generated on your side, preferably as Guid.

Mandatory
LeadPaxRoomId ID of the room that the lead pax should be allocated on. Should be taken from search response. Mandatory
Passengers   Mandatory
CustomerInfo    
Address

 *** Please make sure you use only English characters, otherwise the booking might fail in supplier side! ***

 

 
AddressLine  Maximum 254 characters. Mandatory for leading customer for some suppliers (Pegasus)
CityName

 *** Please make sure you use only English characters, otherwise the booking might fail in supplier side! ***

Maximum 50characters.

 
CountryName

 *** Please make sure you use only English characters, otherwise the booking might fail in supplier side! ***

Maximum 50 characters.

 
Code  Maximum 2 characters.

Mandatory for leading customer for some suppliers (Same as Residency code used in Search request)

Name  *** Please make sure you use only English characters, otherwise the booking might fail in supplier side! ***  
PostalCode  Maximum 20 characters. Optional
StateProv  Maximum 20 characters. Optional
Street  *** Please make sure you use only English characters, otherwise the booking might fail in supplier side! *** Optional
StreetNmbr   Optional
Allocation ID of the room that the passenger should be allocated on. Should be taken from search response. For the lead passenger - the value should match the LeadPaxRoomId. Mandatory
Email  Maximum 254 characters.

Mandatory for some suppliers (Gross type suppliers, working with Credit Card External payment preference, Optional on CASH method)

Id  The id of the passenger, should be generated on your side, preferably as Guid. Each passenger must have unique Id, except for the lead passenger, which its Id should be equal to LeadPaxId.  Mandatory
PersonDetails   Mandatory
Age   Mandatory for children
BirthDate   Not in use.
Name    
NamePrefix Mr, Mrs, Ms, etc. Mandatory
GivenName

First Name

*** Please make sure you use only English characters, otherwise the booking might fail in supplier side! ***

Maximum 50 characters.

Mandatory
Surname

Last Name

*** Please make sure you use only English characters, otherwise the booking might fail in supplier side! ***

Maximum 50 characters.

Mandatory
Type Adult, Child Mandatory
Telephone  Maximum 50 characters.

Mandatory some suppliers.

RoomsRemarks

Free text remarks to be sent to the supplier.

Tag must be present in each room even if empty. NOTE that not all suppliers support this feature, and might not receive those remarks!

Optional
Key Room ID Optional
Value Remarks for this room Optional
SelectedPaymentMethod

Cash:

Use Cash when you are booking from a NET supplier, and collecting the payment from the customer outside of Travolutionary platform.

Please note that the booking will be created with 'Not Paid' remark on the B2B, and you'll have the option to 'Pay' it, by charging the customer (Via on of the integrated Payment Gateways on the platform). 

By using that Cash, you are using the credit/obligo which the NET supplier allocated to you.

When the limit reached, the booking will fail with E4060 error code, meaning you've reached your allowed obligo with the supplier and you must deposit more funds in order to obtain the possibility to book again from this supplier.

 

PayUponArrival:

Use PayUponArrival only when the PaymentPreferences response returns that type of payment. This is NOT applicable payment option for NET suppliers, but only for Gross suppliers, such as: Booking.com, HRS, Amadeus, etc.

Deprecated

 

Response fields:

Field Name Explanation
HotelSegments The response can have several segments
BookingID Supplier booking confirmation id for this booking.
BookingReference

Supplier booking reference for this booking.

Note:

This fields may not rerutned in case the supplier returned single booking id/reference for this booking.

BookingInfoMismatch

True - The supplier confirmed the booking with a different price than the original supplier price prior to the booking.

False - The supplier confirmed the booking in the same price prior to booking step.

BookingRemarks Any supplier remarks for this booking.
OrderId Order ID as created on Travolutionary.
SegmentId

Segment ID as created on Travolutionary.

To be used with check status or cancel methods.

Status Booking status. See all the possible statuses list here

Please download attached examples.

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

Comments

Powered by Zendesk