Book method is called to either hold a booking or to book and voucher a booking based on the selected rooms and guest information. We strongly recommend checking the updated prices and cancellation policies for the selected rooms through PreBook method before proceeding with the hotel booking to reduce the probability of booking failure.

To hold a booking, the IsVouchered node should be set as false. However, all hold bookings should be vouchered by calling GenerateVoucher method before last cancellation date to avoid cancellation of confirmed booking.

To book and voucher in one go, the IsVouchered node should be set as true. In this case, there is no need to callGenerateVoucher method separately.

Price verification is done before creating a booking and Confirmation No. / Booking Reference No. is returned in case of a successful booking.

In case of Price change or Cancellation Policy change, you will get new price and/or new cancellation policy in the HotelBook response with IsPriceChanged node and/or IsCancellationPolicyChanged node set as ‘true’.

The price comparison is to be made at the client's end, and Book request needs to be sent again with the updated price and/ or updated cancellation policy.

Instead of 'Vouchered' or 'Confirmed' you might get 'Pending' as BookingStatus for some bookings. This is because some of the suppliers do not provide confirmation of the booking immediately. In this case you need to call HotelBookingDetail method after 120 seconds to get the updated status.

Service URL (REST) to be used:

https://HotelBE.tektravels.com/hotelservice.svc/rest/book/

Book Request

Level	Element	Format	Comments	Mandatory/ Optional
1	EndUserIp	String	IP Address of the end user(IPv4 Format)	Mandatory
2	BookingCode	String	Booking Code received in pre book response	Mandatory
3	GuestNationality	String	ISO Country Code (Ex. India = IN, Great Britain = GB)	Mandatory
4	IsVoucherBooking	Boolean	This represents whether the request is to Hold the booking or to voucher it directly.	Mandatory (Set true if you want to voucher the booking. Set false, if you want to hold the booking and voucher it later)
5	NetAmount	Array	Net Amount of the booking	Mandatory (refer pre book response)
6	HotelRoomsDetails	Array		Mandatory
7	HotelPassenger	Array	Array of guest details for in the particular room as requested in hotel search	Mandatory
7.1	Title	String	Title of the guest	Mandatory Possible values can be Mr, Mrs, Miss, Ms
7.2	FirstName	String	First name of the guest	Mandatory (Min 2 chars, Max 50 chars and no special character)
7.3	MiddleName	String	Middle name of the guest	Optional(Node is mandatory and value is optional)
7.4	LastName	String	Last name of the guest	Mandatory (Min 2 chars, Max 50 chars and no special character)
7.5	Phoneno	String	Phone number	Optional(Is Mandatory for lead Pax in each room)
7.6	Email	String	Email id	Optional(Is Mandatory for lead Pax in each room)
7.7	PaxType	Enumeration	Guest Type	Mandatory - HotelPassenger - PaxType Adult = 1, Child = 2
7.8	LeadPassenger	Boolean	Represent the lead guest of the booking	Mandatory (Set value as true for one adult in each room and for rest paxes value will be false)
7.9	Age	Integer	Age of the guest	Mandatory * (only for child and age should be <= 12 years)
7.10	PassportNo	String	Passport No	Optional
7.11	PassportIssueDate	Date	Passport Issue Date	Optional(provide in minimum date time  format “0001-01-  01T00:00:00:00” )
7.12	PassportExpDate	Date	Passport Expiry Date	Optional(provide in minimum date time  format “0001-01-  01T00:00:00:00” )
7.13	PAN	String	PAN	Optional(PAN should be in correct format)
8	IsPackageFare	Boolean	In case you receive "IsPackageFare": true in Block response then you need to pass same in Book Request.	Optional
9	IsPackageDetailsMandatory	Boolean	Additionally if you get IsPackageDetailsMandatory": true in Block Response then following details need to be passed in Book request.	Optional
10	ArrivalTransport		ArrivalTransportType,TransportInfoId,Time	Optional
10.1	ArrivalTransportType	Int (0,1)	Flight = 0, surface = 1	Optional
10.2	TransportInfoId	String	Transfer Details	Optional
10.3	Time	String	0001-01-01T00: 00: 00	Optional

Book Response

Book Response in Case of Successful Booking
Level	Element	Format	Comments	Mandatory/ Optional
1	VoucherStatus	Boolean	Voucher Status	Mandatory true - Booking is vouchered false - Booking is not Vouchered
2	Status	Enumeration	Booking status	Mandatory Possible values can be 0 – BookFailed, 1 - Confirmed, 3 – VerifyPrice, 6 – Cancelled
3	HotelBookingStatus	String	Booking status description	Mandatory Possible values can be – BookFailed, Confirmed, VerifyPrice, Cancelled
4	BookingId	Integer	Unique booking id of the successful booking	To be checked if status is confirmed
5	BookingRefNo	String	Booking Reference Number	To be checked if status is confirmed
6	ConfirmationNo	String	Unique confirmation number of the successful booking	To be checked if status is confirmed
7	IsPriceChanged	Boolean	Represent if price is changed or not	Mandatory (Would be set true, if there is a price change. Would be set as false, if there is no price change)
8	IsCancellationPolicyChang ed	Boolean	Represent if cancellation policy is changed or not	Mandatory (Would be set true, if there is a change in cancellation policy. Would be set as false, if there is no change in cancellation policy.)
9	ResponseStatus	Enumeration	Response status	Mandatory NotSet = 0, Successfull = 1, Failed = 2, InValidRequest = 3, InValidSession = 4, InValidCredentials = 5
10	Error	Object		Mandatory
10.1	ErrorCode	Integer	Code corresponding to the Error	Mandatory
10.2	ErrorMessage	String	Contains error message	Mandatory (Will contain error description corresponding to ErrorCode. Error Message would be blank in case ErrorCode=0)

Book Response in Case of Price Change and/ or Cancellation Policy Change
Level	Element	Format	Comments	Mandatory/ Optional
1	Status	Enumeration	Booking status	Mandatory Possible values can be 3 – VerifyPrice
2	HotelBookingStatus	String	Booking status description	Mandatory Possible values can be - VerifyPrice
3	BookingId	String	Unique booking id of the successful booking	Mandatory (Would be null)
4	BookingRefNo	Integer	Booking Reference Number	Mandatory (Would be null)
5	ConfirmationNo	String	Unique confirmation number of the successful booking	Mandatory (Would be null)
6	IsPriceChanged	Boolean	Represent if price is changed or not	Mandatory (Would be set true, if there is a price change. Would be set as false, if there is no price change)
7	IsCancellationPolicyChang ed	Boolean	Represent if cancellation policy is changed or not	Mandatory (Would be set true, if there is a change in cancellation policy. Would be set as false, if there is no change in cancellation policy.)
8.8.1	NetAmount	Decimal	Price of the room	Mandatory