Parameters, Prerequisites & Process for integration:

1. Client should have appropriate test credentials.

2. Client id ApiIntegrationNew should be passed in API authentication request.

3. Client should have all Url’s and understanding of API methods.

4. Startup Meeting with API team before integration after gone through with document.

5. In between integration follow the sample verification process.

http://api.tektravels.com/HotelAPIDocument/HotelSampleVerification.aspx

6. Correct all the changes in test cases as suggested in sample verification.

7. After the correction and verification of sample, create all the mandatory test cases [1 to 12] and send the test cases to support team along with request id/subject on which sample has been verified.

8. Once the support team receives all the test cases they will do the initial verification

I. Token and Trace that should be same throughout the booking process.
II. Verification of all mandatory methods for each test case.
III. Error message in each method for all test cases.
IV. Cases should be made on specific search criteria as per test cases.
V. Get Booking details should be called for each case.

9. This process will take 24 to 48 working hours of the support team, if any discrepancy is found in the initial verification then support team will reject the cases and client need to share again with corrections.

10. After successful initial verification support team will verify and validate all methods and then provide their findings, client need to submit rejected test cases after doing correction as per rejection reason.

11. Support team will share certification sheet of the submitted test cases along with validation checklist.

12. Implement all validations as provided in validation document at client site.

13. Now it is mandatory to implement de-dupe functionality at your end for the certification process.

Dos and Donts:

1. Always send API logs request and response in JSON format as an attachment.

2. Follow the process of integration as provided in Pathway.

http://api.tektravels.com/Hotelapidocument/Pathway.aspx

3. Generate single token in a day as it is valid for 24 hours (00:00 AM to 11:59 PM), so do not generate token id with every search.

4. Trace id is valid for 15 Minutes only.

5. In Block request all the details of selected rooms should be passed as received in Get Hotel Room response.

6. In Book request all the details of selected rooms should be passed as received in the Block response along with pax details.

Implementations & Suggestions:

1. Hotel Search can be done in two ways:

I. City wise which provides all hotels of that particular city.
II. Hotel wise search which gives results of the particular hotel code that is passed in the Search request along with city id. Please refer to the TBO hotel code which is provided in Static data response.

2. Clients who want to implement location wise filters can pass latitude and longitude of that particular hotel in search request and then can implement location wise filter at their end.

3. For Dedupe Search in which “IsTBOMapped '' is passed true, In response for results the hotel information like HotelName, StarRating, HotelDescription, HotelPolicy etc need to refer from static data response for that particular Hotel.

4. In the GetHotelRoom response two types of Room combinations are provided fixed and open Below is the explanation and eg.

"Room Combination" as "Open Combination”: In open Combination, if you have passed the request for 2 rooms then you will get two arrays of "Room Index". For eg. In "Room Combination" array you have received 2 arrays one is [1,2,3] and second is [4,5,6]. Then you can pass "RoomIndex" for both rooms in "BlockRoom" request as [1,4] or [1,5] or [1,6] or [2,4] or [2,5] or [2,6] or [3,4] or [3,5] or[3,6] that is first room index should be picked from first array(any room) and second room index should be picked from the second array(any room).

"Room Combination" as "Fixed Combination": In fixed Combination if you have passed request for 2 rooms then you will receive 2 arrays of "Room Index" in "Room Combination" array like [1,2] and [3,4] then you can pass "RoomIndex" for both rooms in "BlockRoom" request as [1,2] or [3,4] that is you need to select room index for both rooms from single array only.

5. In a single room, maximum occupancy is for 10 people that is 8 adults and 2 children. Also, a maximum of 6 rooms can be booked in a single booking

6. Hotel Pricing

Published Fare: Published fare is the price which agency will charge from end customer, if agency wants to add any additional markup then they can add same at their end.
Formula: PUBLISHED = OFFERED PRICE + COMMISSION

Offered Fare: Offered Fare is the price which is provided by supplier after deduction of only commission.
Formula: OFFERED PRICE = ROOM PRICE + TAX + EXTRA GUEST CHARGE - COMMISSION + OTHER CHARGES

Net Payable: Net Payable is the fare which is payable to TBO by agency.
Formula: NET PAYABLE = Offered + Tds on Commission + GST

7. If you want to hold the booking then pass “IsVoucherBooking” : false in Block and booking request, your booking will be in confirmed state and you can call Generate Voucher method to voucher the same till LastVoucher date

8. If you want to voucher the booking directly then pass “IsVoucherBooking '' : true in Block and booking request, your booking will be vouchered and you will get ”VoucherStatus”: true along with invoice details in Book response. There is no need to call Generate Voucher in this case.