Ans-Client need to consider all the validations from the pre book response. For validations, you can consider the validation section or the link i.e.https://apidoc.tektravels.com/hotelnew/apivalidation.aspx
Also,Client needs to consider the supplement, anmeties, rate conditions etc from the pre book response in client's booking page. Please note that the prices for the booking made should also be considered from the pre book response itself.
BOOK
Q. What is Hold and Voucher Booking ?
Please note that for voucher we have the node in the book request called Is Voucher booking;
When the node "IsVoucherbooking" is passed as True means you're vouchering the booking means you're paying for the booking and generating the invoice for the same.
Whereas passing the node "IsVoucherbooking" as False means you're holding the booking as of now and will voucher the same later on. So, this will just confirm the booking and the booking will be on hold from your end.
Further , when you want to voucher the booking later on then you have to call the generate voucher method to voucher the booking.
Kindly note that to hold the booking you have to refer the last cancellation date as you can hold the booking only till the last cancellation date and after that if the same is not vouchered from your end then the same will be cancelled from our side.
Also, non refundable bookings can not be put on hold and has to be vouchered directly.
Please check and let us know in case of any further difficulties.
Q. what is published fare ?
You are required to display the Total Fare + your markup on the platform.
At the time of sending the book request, you must pass the Net Amount.
The Total Fare remains consistent from Search to Prebook stages, so price change issues will not occur in this flow.
Special Case: Published Fares
In the case of Published Fares, the Net Amount and Total Fare will differ.
Here, the Net Amount is calculated as:
Net Amount = Total Fare + TDS
TDS = 2% of the agency commission
The agency commission is available in the priceBreakup node.
Q. Why is portal verification essential ?
Ans-The portal verification process is essential as it ensures that there are no integration gaps between the TBO API and the client portal. This step guarantees that you receive the expected results within optimal response times, ultimately contributing to a better user experience and stronger business opportunities.
If these steps are not addressed now, they will likely impact your business in the future, and you may face more difficulties in working on them later. It's important to consider the sensitivity of these points and make sure they're implemented from the start. Otherwise, it may become difficult to revisit these aspects later on.
Q. How does static data flow works?
Kindly note that the static data works on the below mentioned flow;
Country List > City List >TBO Hotel Code List / Hotel Code List> Hotel Details
You need to call country list using get method and in the response , you'll receive the list of countries along with their codes
In the city list, you'll then pass the desired country code and you'll receive the city name and code corresponding to that city.
You'll then call TBO Hotel code list with the city code for which you want to proceed and in the response you'll receive the hotel code, name with short description.
Finally when you have chosen a particular hotel for which you want to proceed for the booking you'll call hotel details by passing the hotel codes in the request, corresponding to which you'll receive all the possible details including images, latitude, longitude , star rating etc in the response.
Note- Hotel Code List is used to fetch all the hotels from the API whereas TBO Hotel Code List is used to fetch city wise hotel codes.
Q. when will the production credentials released after testing ?
Kindly note that for production URL's you need to undergo the certification process that consist of three steps- Logs verification, general queries and portal verification of your website.
You need to share the certification cases as per the below mentioned link;
https://apidoc.tektravels.com/hotelnew/Certification.aspx
Once the same is verified from our end we'll share validation sheet for general queries and ask for your website access for portal verification.
Please refer below mail subject format to share the complete JSON authenticate to get booking details logs for verification;
Hotel Certification Cases-'Agency Name'
Q. How to Request Room-Level Information ?
Add "IsRoomDetailRequired": true in the HotelDetails API request.
Production Endpoint: https://apiwr.tboholidays.com/HotelAPI/Hoteldetails
Example request:
{
"Hotelcodes": "1261320",
"Language": "en",
"IsRoomDetailRequired": true
}
- Response Structure (Key Fields)
Each room detail includes:
RoomName - e.g., "Deluxe Room, 1 King Bed, Garden View"
RoomId - Unique identifier (e.g., 197354)
RoomDescription - Room features
imageURL - Array of URLs for room-specific images
Example:
{
"RoomName": "Deluxe Room, 1 King Bed, Garden View",
"RoomId": 197354,
"RoomDescription": "1 King Bed Overlooking the garden, Free WiFi, Cable channels...",
"imageURL": [
"https://www.tboholidays.com/imageresource.aspx?img=example1",
"https://www.tboholidays.com/imageresource.aspx?img=example2"
]
}
- Mapping Room Details to Booking Information
Search API returns a RoomID.
This RoomID corresponds to the RoomId in HotelDetails API.
Allows mapping room details & images to booking info.
Example:
{
"Rooms": [
{
"Name": [
"KING HILTON GUESTROOM",
"KING HILTON GUESTROOM"
],
"BookingCode": "1035259!TB!1!TB!c4dd931f-99f7-11f0-baf3-6e6d1df1ebe6!TB!N!TB!AFF!",
"Inclusion": "Room Only",
"TotalFare": 470.68,
"TotalTax": 71.8,
"NetCost": 431.82,
"RecommendedSellingRate": "541.6",
"MealType": "Room_Only",
"IsRefundable": true,
"WithTransfers": false,
"TBORoomID": "3326603",
"RoomID": [
"3326603",
"3326603"
]
},
