TravelBullz

Introduction

The purpose of this document is to provide technical details about the API's. This document outlines the business processes supported by the API and details about specifications of API’s. It assumes that reader has a technical background and is familiar with JSON, API's.

Connection properties

Request	value	Description
Request Method	POST	The requested method.
Content-Type	application/json	The content type.

Request/Response

It is recommended that at least all booking and cancellation transactions sent through the Test / Live environment should be logged and maintained by the hotel agent for at least 6 months.

Go-Test/Live Process

In order to start testing, please notify our support team via e-mail at apisupport@technoheaven.com

When you have completed your development, contact your Account Manager for the activation of the access IP address of Test/Live Server is essential for whitelisting

Client Requirements

Client requests must be issued from a public, static IP address registered with System.
Client requests must be made via an HTTPS POST request.
SSL.
All data sent and received via the interface will be encoded in UTF-8.
we use deflate compression for response.

Development Phase

Once you receive your Access token, you can start the development of your application/framework. The whole process of communication consists of simple JSON messages exchange (request /response) between your application/framework and system. Each request needs to be posted (through POST method) using https protocols. For details regarding requests and answers formats please consult the dedicated area of each request. For further assistance in development process do not hesitate to contact our support team.

Status & Error Code

No	Status Code	Description
1	200	OK
2	400	Bad Request
3	401	Unauthorized
4	403	Forbidden
5	404	Not Found
6	500	Internal Server Error
7	503	Service Unavailable
8	429	Too Many Requests (QPS Limit exceeds)

Process Flow Diagram

Implementation Approach

Client review of the API specifications

Review of API specifications

Test Environment Integration

API Integration.
Test Execution by your Tech Team.

Integration Testing

Determining the necessary test cases based on the API's by Our Tech Team
Test Execution
Certification by Our Tech Team

Before you go live you need to share pdf sample voucher after booking.

Production Environment

API Integration
Schedule Go Live Date
Transaction Monitoring and issue Resolution

Important note

Follow these guidelines when searching for properties for your test bookings, even for static tests. Being diligent in your property selection will help you avoid incurring any accidental charges during your booking tests.
Please use city id : 16424= Bangkok. for testing purpose
To use different nationality of different countries use same name in countries api response.
Verify the booking will be outside of the hotel's cancellation policy.
Never pick next-day or same-day availabilities, even to test promos.
Shop a few months ahead whenever possible.
Use Real Name for first name and last name. Do not use test name.
Never automate static booking tests -we may flag or temporarily disable your account.
Shopping at least a few months ahead and paying attention to Policy will help you avoid the most common problems with test bookings. Remember, client is not responsible for any unintentional live or nonrefundable bookings you place during testing.
Make sure you cancel each test booking using api, if face any issue in cancellation contact us immediately.
Always do refundable feature booking and cancel booking after done.
No duplication allowed for internalreference, it must be unique for each time you hit that api.

Documentation and Download

JSON Request Format:-

{ "code": "NOCOUNT_ERROR", "type": "GENERAL", "description": "No availability found for given criteria try search with other criteria" }

JSON Response Format:-

{ "code": "INTERNAL_ERROR", "type": "API_ERROR", "description": "the server was unable to process the request due to an internal error" }

Date Format

Date format send to Payload MM-DD-YYYY

Error and Description

ErrorCode	ErrorType	ErrorDescription
INTERNAL_ERROR	API_ERROR	The server was unable to process the request due to an internal error
NOTPERMITTED_ERROR	Permission	1.Bookings within cancellation deadline are not permitted for this User. 2.Bookings are not permitted for this User.
CacheNotAvailable	CacheNotAvailable	Access to one of the cache failed. The cache for this search key is no longer available
DUPLICATION_ERROR	Duplicate	1.Bookings within cancellation deadline are not permitted for this User 2.Booking token already exist for this criteria
MISMATCH_ERROR	Mismatch	1.Pricing could not complete - rate missing. 2.Data mismatch from previous response.
CacheNotAvailable	CacheNotAvailable	Access to one of the cache failed. The cache for this search key is no longer available
INVALID_REQUEST	RequestError	Request is not well formed please check and try again.
NOCOUNT_ERROR	GENERAL	1.No record found for given criteria 2.No availability found for given criteria try search with other criteria

Countries

The Countries API has been designed to provide All Countries data. The following sections describe the Countries API Request and Response Format.

The Request URL:

baseurl/api/xconnect/Countries/

JSON Request format:

{ "Token": "Token" }

Tag	Description	Optionality
Token	You have to put unique token which is provided by the system	Mandatory

JSON Response format:

{ "CountryId": "ID", "Name": "name" }, Example : "CountryId": "25773", "Name": "AFGHANISTAN"

Tag	Description
CountryId	Represent unique CountryId.
Name	Represent Name

Cities

The Hotel List Search API has been designed to provide list of all Hotels with display Minimum price for particular city. The following sections describe the Hotel List Search request and response format

Request URL

baseurl/api/xconnect/Cities/

JSON Request Format:

{ "Token": “Token”, "Request": { "CountryId": "ID" } }

Parent Tag	Tag	Description	Optionality
Request	CountryId	Represents unique CountryId	Mandatory
Token	Token	You have to put unique token which is provided by the system	Mandatory

JSON Response Format:

{ "CityId":ID, "Name": "NAME" } Example : "CityId":26467, "Name": "KABUL"

Tag	Description
CityId	Represents unique CityId.
Name	Represents unique city name.

AllCitieswithCountry

AllCitieswithCountry API has been designed to provide list of all cities with country .The following sections describe the AllCitieswithCountry in one API call request and response format.

The Request URL:

baseurl/api/xconnect/AllCitieswithCountry

JSON Request Format:

{ "Token": "", "Request": { "onlyhotel": 0 } }

Parent Tag	Tag	Description	Optionality
Token	Token	You have to put unique token which is provided by the system.	Mandatory
Request	onlyhotel	Represents onlyhotel	onlyhotel: 1 you will get all cities onlyhotel: 0 you will get active cities

JSON Response Format:

{ "cityid": ID, "cityname": "", "countryid": ID, "countryname": "" },

Tag	Description
cityid	Represents cityid
cityname	Represents cityname
Countryid	Represents Country id
countryname	Represents country name.

All Hotels By City

AllHotelsByCity API has been designed to provide list of all Hotel details for that particular City.
The following sections describe the AllHotelsByCity API request and response format.

The Request URL:

baseurl/api/xconnect/AllHotelsByCity

JSON Request Format:

{ "Token":"Token" , "Request": { "CityId" : ID } }

Parent Tag	Tag	Description	Optionality
Request	CityId	Represents unique CityId	Mandatory
Token	Token	You have to put unique token which is provided by the system.	Mandatory

JSON Response Format:

{ "HotelId": ID, "HotelName": "", "Latitude": " ", "longitude": " ", "Address": " ", "Rating": " ", "IsRecomondedHotel": false },

Tag	Description	Optionality
HotelId	Represents HotelId	Mandatory
HotelName	Represents HotelName	Mandatory
Latitude	Represents Latitude	Mandatory
longitude	Represents longitude	Mandatory
Address	Represents Address	Mandatory
Rating	Represents Rating	Mandatory
IsRecomondedHotel	-	Mandatory

All Hotels By City Full (for live data mapping)

The AllHotelsByCityFull API has been designed to provide All hotels basic data with city wise.
The following sections describe the AllHotelsByCityFull API Request and Response Format.

The Request URL:

baseurl/api/xconnect/AllHotelsByCityFull/

JSON Request Format:

{ "Token":"Token" }

Tag	Description	Optionality
Token	You have to put unique token which is provided by the system	Mandatory

JSON Response Format:

{ "Count": " ", "HotelList": [ { "HotelId": " ", "HotelName": " ", "Description": "", "Latitude": " ", "Longitude": " ", "Address": " ", "Rating": " ", "CountryId": " ", "CountryName": " ", "CityId": " ", "CityName": " ", "HotelFrontImage": "", "IsRecomondedHotel": "FALSE", "IsActive": "", "UpdatedDate": "" } ] }

Example :{ "HotelList": [ { "HotelId": 100530, "HotelName": "A la Carte Danang", "Description": "-", "Latitude": "16.0687593", "Longitude": "108.24506140000005", "Address": "200 Vo Nguyen Giap Street, Son Tra District, Da Nang, Vietnam", "Rating": "4", "CountryId": 43240, "CountryName": "Vietnam", "CityId": 43261, "CityName": "Da Nang", "HotelFrontImage": "https://d2lzo8rjhr36c.cloudfront.net//Images/Dubai/100530/1-ThumbNail.jpg", "IsRecomondedHotel": "FALSE", "IsActive": "active" } ], "Count": 1 }

Tag	Description
Count	Represent total number of hotels
HotelList	Represents HotelList
HotelId	Represents HotelId
HotelName	Represents HotelName
Description	Represents Description
Latitude	Represent Latitude
Longitude	Represent Longitude
Address	Represent Address
Rating	Represent Rating
CountryId	Represent CountryId
CountryName	Represent Address
CityId	Represent CityId
CityName	Represent CityName
HotelFrontImage	Represent HotelFrontImage
IsRecomondedHotel	Represent IsRecomondedHotel
IsActive	Represent status of hotel is active or not.
UpdatedDate	Represents UpdatedDate format: MM-DD-YYYY Example: 08-12-2018

Availability

The Availability API has been designed to provide list of all Hotels The following sections describe the hotellistsearch API request and response format. Currency set up done only once account is created and you have to use that Currency for transaction with api.

The Request URL:

baseurl/api/xconnect/Availability/

JSON Request Format:

{ "Token": "", "Request": { "Rooms": [ { "RoomNo": 1, "NoofAdults": 1, "NoOfChild": 1, "ChildAge": [ 1, 0 ] } ], "CityID": 1, "CheckInDate": "", "CheckOutDate": "", "NoofNights": 1, "Nationality": "", "Filters": { "IsRecommendedOnly": 0, "IsShowRooms": 1, "IsOnlyAvailable": 0, "StarRating": { "Min":0, "Max":5 }, "HotelIDs": "" } }, "AdvancedOptions": { "CustomerIpAddress": "11.111.111.111", "Currency": "" } }

Tag	Description	Optionality
Room	An array represents Room	Mandatory
RoomNo	Represents RoomNo	Mandatory
NoofAdults	Represents total number of Adults	Mandatory
NoOfChild	Represents total number of child.	Mandatory
ChildAge	Array represents child Age. (1 to 12)	Mandatory
CityID	Represents unique CityID.	Mandatory
Nationality	Represents unique Nationality.	Mandatory
CheckInDate	Represents CheckInDate. Date should be in the format: MM-DD-YYYY Example: 08-12-2018	Mandatory
CheckOutDate	Represents CheckOutDate. Date should be in the format: MM-DD-YYYY Example: 08-12-2018	Mandatory
NoofNights	Represents number of Nights	Mandatory
IsShowRooms	1 Show Rooms 0 HotelOnly	Mandatory
IsRecommendedOnly	1 Only Preferred Hotels 0 All Hotels	Mandatory
IsOnlyAvailable	1 Available only 0 Include Onrequest	Mandatory
StarRating	Selection of star rating between two categories.
Min	min=min star rating	0 star rating for unspecified or apartment
max	max=max star rating	Mandatory
HotelIDs	Represents list of comma seperated HotelIDs by city	Optional
CustomerIpAddress	Represents CustomerIpAddress	Ip address of final end user Mandatory
currency	Represents currency	Mandatory

JSON Response Format:

{ "AvailabilityRS": { "SearchKey": "", "Count": 1, "Currency": "", "HotelResult": [ { "StartPrice": 0, "HotelId": 0, "HotelOption": [ { "HotelOptionId": "", "MinPrice": 0, "IsCombineRoom": true, "HotelRooms": [ [ { "RoomNo": "", "RoomTypeName": "", "MealName": "", "Price": 0, "BookingStatus": "", "RoomToken": "" } ] ] } ] } ] } }

Tag	Description
Count	Represents Count.
SearchKey	SearchKey will use in next steps ,expires after 25 minutes. You have to do booking within that time limits.
Start price	Represents unique Price
HotelID	Represents unique Hotel id
HotelCode	Represents unique hotel code
Currency	Represents Currency.
Hoteloption	Array display detail.
HoteloptionId	Represents unique hoteloptionid
MinPrice	Represent Min Price
IsCombined	True = Multiple rooms are combined in one False = recieve list of rooms
HotelRooms	Array display details
RoomNo	Represents room number. You will get some combine rooms for multiple rooms search.
RoomTypeName	Represents room type
MealName	Represents MealName
Price	Represents Price
BookingStatus	Represents BookingStatus.
RoomToken	It display unique AvailToken which is provided by the system

Note:

As we have both direct inventories and dynamic rates also so for some cases you will receive combined room in multiple room search ,
so for easy to identify these rates we have now added new parameter in availability response IsCombined (true,false) if its true then rooms are combined to one room .
for example : if search is for
rooms :2
room 1 : 1 adult
room 2 : 2 adult
then id IsCombined =true that means both rooms are combined in one (roomNo: "1") ;
if False : then you recieve list of rooms(RoomNo:1,RoomNo:2).
and when you try to book such combined room you have to pass pax details separately for both the rooms.
-For Essential information you need to hit CancellationPolicy/Multi API

AvailabilityWithCancellation

The AvailabilityWithCancellation API has been designed to provide list of Hotels with cancellation policy. The following sections describe the hotellistsearch API request and response format. Currency set up done only once account is created and you have to use that Currency for transaction with api.

The Request URL:

baseurl/api/xconnect/AvailabilityWithCancellation/

JSON Request Format:

Tag	Description	Optionality
Room	An array represents Room	Mandatory
RoomNo	Represents RoomNo	Mandatory
NoofAdults	Represents total number of Adults	Mandatory
NoOfChild	Represents total number of child.	Mandatory
ChildAge	Array represents child Age. (1 to 12)	Mandatory
CityID	Represents unique CityID.	Mandatory
Nationality	Represents unique Nationality.	Mandatory
CheckInDate	Represents CheckInDate. Date should be in the format: MM-DD-YYYY Example: 08-12-2018	Mandatory
CheckOutDate	Represents CheckOutDate. Date should be in the format: MM-DD-YYYY Example: 08-12-2018	Mandatory
NoofNights	Represents number of Nights	Mandatory
IsShowRooms	1 Show Rooms 0 HotelOnly	Mandatory
IsRecommendedOnly	1 Only Preferred Hotels 0 All Hotels	Mandatory
IsOnlyAvailable	1 Available only 0 Include Onrequest	Mandatory
StarRating	Selection of star rating between two categories.
Min	min=min star rating	0 star rating for unspecified or apartment
max	max=max star rating	Mandatory
HotelIDs	Represents list of comma seperated HotelIDs by city	Optional
CustomerIpAddress	Represents CustomerIpAddress	Ip address of final end user Mandatory
currency	Represents currency	Mandatory

JSON Response Format:

Tag	Description
Count	Represents Count.
SearchKey	SearchKey will use in next steps ,expires after 25 minutes. You have to do booking within that time limits.
Start price	Represents unique Price
HotelID	Represents unique Hotel id
HotelCode	Represents unique hotel code
Currency	Represents Currency.
Hoteloption	Array display detail.
HoteloptionId	Represents unique hoteloptionid
MinPrice	Represent Min Price
IsCombined	True = Multiple rooms are combined in one False = recieve list of rooms
HotelRooms	Array display details
RoomNo	Represents room number. You will get some combine rooms for multiple rooms search.
RoomTypeName	Represents room type
MealName	Represents MealName
CancellationPolicy	Represents cancellation policy
Price	Represents Price
BookingStatus	Represents BookingStatus.
RoomToken	It display unique AvailToken which is provided by the system

Note:

Cancellation Policy

The CancellationPolicy for Hotel API has been designed to provide Price of cancellation for particular Room. The following section describes API request and response format.

The Request URL:

baseurl/api/xconnect/CancellationPolicy/

JSON Request Format:

{ "Token": "", "Request": { "SearchKey": "", "HotelOptionId": "", "RoomToken": "" }, "AdvancedOptions": { "CustomerIpAddress": "11.111.111.111", "Currency": "" } }

Parent Tag	Tag	Description	Optionality
Token	Token	Token	Mandatory
Request	Search key
	HotelOptionId	Represents unique HotelOptionID.	Mandatory
	RoomToken	Unique RoomToken which is provided by the system.	Mandatory
	currency	Represents currency	Mandatory
	CustomerIpAddress	Represents CustomerIpAddress	Ip address of final end user Mandatory

JSON Response Format:

{ "Error": [], "CancellationRS": { "Currency": "", "EssentialInformation": "", "CancellationPolicy": [ { "FromDate": "", "ToDate": "", "CancellationPrice": 0 }, { "FromDate": "", "ToDate": "", "CancellationPrice": 4 } ] } }

Parent Tag	Tag	Description
CancellationPolicy	FromDate	Represents FromDate
	ToDate	Represents ToDate.
	CancellationPrice	Represents cancellation price.
	Currency	Represents Currency.

Cancellation Policy Multi

The CancellationPolicyMulti for Hotel API has been designed to provide Price of cancellation for multiple Room in single request. The following section describes API request and response format.

The Request URL:

baseurl/api/xconnect/CancellationPolicyMulti

JSON Request Format:

{ "Token": "", "Request": { "SearchKey": "", "HotelOption": { "HotelOptionId": "", "HotelRooms": [ { "RoomNo": "1", "RoomToken": " " }, { "RoomNo": "2", "RoomToken": " " } ] } }, "AdvancedOptions": { "CustomerIpAddress": "11.111.111.111", "Currency": "USD" } }

Parent Tag	Tag	Description	Optionality
Token	Token	Token	Mandatory
Request	Search key
	HotelOptionId	Represents unique HotelOptionID.	Mandatory
	HotelRooms	Represents HotelRooms	Mandatory
	RoomToken	Represents RoomNo	Mandatory
	RoomToken	Unique RoomToken which is provided by the system.	Mandatory
AdvancedOptions
	CustomerIpAddress	Represents CustomerIpAddress	Ip address of final end user Mandatory
	currency	Represents currency	Mandatory

JSON Response Format:

{ "Error": [], "Currency": "MYR", "CancellationRS": [ { "RoomNo": " ", "RoomTypeName": " ", "MealName": " ", "EssentialInformation": " ", "CancellationPolicy": [ { "FromDate": " ", "ToDate": " ", "CancellationPrice": 0 }, { "FromDate": " ", "ToDate": " ", "CancellationPrice": } ] }, { "RoomNo": "2", "RoomTypeName": " ", "MealName": " ", "EssentialInformation": " ", "CancellationPolicy": [ { "FromDate": " ", "ToDate": " ", "CancellationPrice": 0 }, { "FromDate": " ", "ToDate": " ", "CancellationPrice": 0 } ] } ] }

Parent Tag	Tag	Description
Error
	ToDate	Represents ToDate.
	Currency	Represents Currency
CancellationRS
	RoomNo	Represents RoomNo
	RoomTypeName	Represents RoomTypeName
	MealName	Represents MealName
	EssentialInformation	Represents EssentialInformation
CancellationPolicy	FromDate	Represents FromDate
	ToDate	Represents ToDate
	CancellationPrice	Represents cancellation price.

PreBook

The PreBook API has been designed to check availability status of booking before book. This API must hit once for one booking or you will get duplication error.The following section describes API request and response format. in case of isCombineRoom= true we are going to do one change in previous response we sending price = 0 in other rooms and in roomNo=1 we giving you total price , but in new response we divide price in each room Total price will not change.only price is divided inside room.

The Request URL:

baseurl/api/xconnect/PreBook/

JSON Request Format:

{ "Token": "", "Request": { "SearchKey": "", "HotelOption": { "HotelOptionId": "", "HotelRooms": [ { "RoomNo": "1", "RoomToken": "" } ] } }, "AdvancedOptions": { "CustomerIpAddress": "11.111.111.111", "Currency": "" } }

Parent Tag	Tag	Description	Optionality
Token	Token	Token	Mandatory
Request	Search key
	HotelOptionId	Represents HotelOptionId	Mandatory
	HotelRooms	An array represents room details	Mandatory
	RoomNo	Represents room number	Mandatory
	RoomToken	Unique RoomToken which is provided by the system.	Mandatory
	CustomerIpAddress	Represents CustomerIpAddress	Ip address of final end user Mandatory
	currency	Represents currency	Mandatory

JSON Response Format:

{ "PreBookRS": { "HotelOption": { "HotelName": "", "Nationality": "", "BookingToken": "", "Status": "Bookable", "IsPriceChange": 0, "CheckInDate": "", "CheckOutDate": "", "TotalPrice": 0, "HotelRooms": [ { "UniqueId": 0, "RoomNo": "1", "RoomTypeName": "", "MealName": "", "Price": 0, "PriceChange": { "OldPrice": 0, "NewPrice": 0 } } ] } }, "Currency": "" }

JSON Response (Example ) IsCombineRoom=true

{ "Error": [], "PreBookRS": { "HotelOption": { "HotelName": "AVANI Deira Dubai Hotel", "Nationality": "malaysia", "BookingToken": "BookingToken" , "Status": "Bookable", "IsPriceChange": 0, "CheckInDate": "01-21-2020", "CheckOutDate": "01-22-2020", "TotalPrice": 522.38, "HotelRooms": [ { "UniqueId": 158841, "RoomNo": "1", "RoomTypeName": "2 X Single room ", "MealName": "Room Only", "Price": 261.19, "PriceChange": { "OldPrice": 0, "NewPrice": 0 } }, { "UniqueId": 158842, "RoomNo": "2", "RoomTypeName": "2 X Single room ", "MealName": "Room Only", "Price": 261.19, "PriceChange": { "OldPrice": 0, "NewPrice": 0 } } ] }, "Currency": "AED" } }

Parent Tag	Tag	Description
PreBookRS
HotelOption
	HotelName	Represents HotelName
	Nationality	Represents Nationality
	BookingToken	Unique BookingToken which is provided by the system. And used for final booking request
	Status	If status is bookable than only proceed for booking.
	IsPriceChange	0 Represents Not Change in IsPriceChange 1 you have to notify price to customer before booking
	CheckInDate	Represents CheckInDate. Date should be in the format: MM-DD-YYYY Example: 08-12-2018
	CheckOutDate	Represents CheckOutDate. Date should be in the format: MM-DD-YYYY Example: 08-12-2018
	TotalPrice	Represents TotalPrice
HotelRooms		Arrary represents Hotelrooms
	UniqueId	Represents UniqueId
	RoomNo	Represents RoomNo
	RoomTypeName	Represents RoomTypeName
	MealName	Represents MealName
	Price	Represents Price
	PriceChange	Represents PriceChange
	OldPrice	Represents OldPrice
	NewPrice	Represents NewPrice
	Currency	Represents Currency.

Book

The Book API has been designed to give booking details .The following section describes API request and response format. After getting response or error in book response. you have to mandatory perform booking detail api to get the actual status of booking using your internal reference or reference number from Bookresponse.

The Request URL:

baseurl/api/xconnect/Book/

JSON Request Format:

{ "Token": "", "Request": { "SearchKey": "", "BookRQ": { "BookingToken": "", "TotalPrice": 90, "InternalReference": "", "HotelRooms": [ { "UniqueId": 44144, "RoomNo": 1, "IsLead": "1", "PaxType": "Adult", "Prefix": "Mr.", "FirstName": "IOS", "LastName": "Test", "ChildAge": "0" }, { "UniqueId": 44145, "RoomNo": 2, "IsLead": "1", "PaxType": "Adult", "Prefix": "Mrs.", "FirstName": "test", "LastName": "test", "ChildAge": "0" } ] } }, "AdvancedOptions": { "CustomerIpAddress": "11.111.111.111", "Currency": "USD" } }

Parent Tag	Tag	Description	Optionality
Token	Token	Token	Mandatory
Request	Search key
Book	BookingToken	Unique BookingToken which is provided by the system.	Mandatory
	TotalPrice	Represents Price	Mandatory
	InternalReference	your internal reference. should be 10 max character (No duplication allowed)	Mandatory
	HotelRooms	An array represent HotelRoom Details.	Mandatory
	UniqueId	Represents UniqeId	Mandatory
	RoomNo	Represents RoomNo	Mandatory
	IsLead	0 Represents No IsLead For 1 booking you have to set ISLead = 1 and IsLead passeger must adult.	Mandatory
	PaxType	Represents Adult / Child.	Mandatory
	Prefix	Represents Mr. / Mrs. /Ms.	Mandatory
	FirstName	Represents FirstName	Mandatory
	LastName	Represents LastName	Mandatory
	ChildAge	Represents ChildAge	Mandatory
	UniqueId	Represents UniqeId	Mandatory
	CustomerIpAddress	Represents CustomerIpAddress	Ip address of final end user Mandatory
	currency	Represents currency	Mandatory

JSON Response Format:

{ "BookRS": { "BookingId": 0, "ReferenceNo": "1577MA011900115", "InternalReference": "animesh" } , "Currency": "" , "Error": [] }

Parent Tag	Tag	Description
BookRS
	BookingId	Represents BookingId
	ReferenceNo	You need to show reference number on your voucher.
	InternalReference	Represents InternalReference
	Currency	Represents Currency.
	Error	Array Represents Error

Booking Detail

API has been designed to Generate bookingDetails .The following section describes API request and response format. Only one ID can be passed. You can get booking details using either BookigID or your internalReference

The Request URL:

baseurl/api/xconnect/BookingDetail

JSON Request Format:

{ "Token": "", "Request": { "BookingDetailRQ": { "BookingId": "0", "InternalReference": "", "ReferenceNo": "" } }, "AdvancedOptions": { "CustomerIpAddress": "11.111.111.111", "Currency": "" } }

Parent Tag	Tag	Description	Optionality
Token	Token	Token	Mandatory
Request
BookingDetailRQ
	BookingId	Represents BookingId	Optional
	InternalReference	Represents InternalReference	optional
	ReferenceNo	Represents ReferenceNo	optional
	CustomerIpAddress	Represents CustomerIpAddress	Ip address of final end user Mandatory
	currency	Represents currency	Mandatory

JSON Response Format:

{ "BookingDetailRS": { "HotelOption": { "HotelName": "", "HotelId": "", "Nationality": "", "BookingId": "", "InternalReference": "", "CheckInDate": "", "CheckOutDate": "", "BookingDate": "", "LeadPaxName": "", "TotalPrice": "", "HotelRooms": [ { "RoomNo": "", "RoomTypeName": "", "MealName": "", "Price": "", "BookingStatus": "Confirmed", "CancellationPolicy": [ { "FromDate": "", "ToDate": "", "CancellationPrice": 0 } ], "Passenger": [ { "IsLead": "", "PaxType": "", "Name": "", "ChildAge": "" } ] } ] } } , "Currency": "" , "Error": [] }

Parent Tag	Tag	Description
BookingDetailRS
	HotelOption
	HotelName	Represent HotelName
	HotelId	Represent HotelId
	Nationality	Represent Nationality
	BookingId	Represent BookingId
	InternalReference	Represents InternalReference
	CheckInDate	Represents CheckOutDate. Date should be in the format: MM-DD-YYYY Example: 08-12-2018
	CheckOutDate	Represents CheckOutDate. Date should be in the format: MM-DD-YYYY Example: 08-12-2018
	BookingDate	Represents BookingDate. Date should be in the format: MM-DD-YYYY Example: 08-12-2018
	LeadPaxName	Represents LeadPaxName
	TotalPrice	Represents TotalPrice
	HotelRooms	Array Represents HotelRooms
	BookingStatus	Represents booking status with details Vouchered : Confirmed Confirmed : Confirmed Completed : Travel done. Cancelled : booking cancelled On Request : On Request Not Confirmed : Not Confirmed Cancel Charge: cancel charges if any for booking
	RoomNo	Represents RoomNo
	RoomTypeName	Represents RoomTypeName
	MealName	Represents MealName
	Price	Represents Price
	CancellationPolicy	Array represents CancellationPolicy
	FromDate	Represents FromDate. Date should be in the format: MM-DD-YYYY Example: 08-12-2018
	ToDate	Represents ToDate. Date should be in the format: MM-DD-YYYY Example: 08-12-2018
	CancellationPrice	Represents CancellationPrice
	Passenger	No special character allowed max length 20 character. Douplication passenger not allowed.
	IsLead	Represents lead pax
	PaxType	Represents Adult / Child
	Prefix	Represents Mr./Ms./Miss
	Name	Represents Name
	ChildAge	Represents ChildAge
	Currency	Represents Currency.
	Error	Array Represents Error

Check HotelCancellation Charges

The Request URL:

baseurl/api/xconnect/CheckHotelCancellationCharges

JSON Request Format:

{ "Token": "", "Request": { "CheckHotelCancellationChargesRQ": { "BookingId": "0", "InternalReference": "", "ReferenceNo": "1577MA011900115" } }, "AdvancedOptions": { "CustomerIpAddress": "11.111.111.111", "Currency": "USD" } }

Parent Tag	Tag	Description	Optionality
Token	Token	Token	Mandatory
Request
CheckHotelCancellationChargesRQ
	BookingId	Represents BookingId	Mandatory
	InternalReference	your internal reference.	Mandatory
	ReferenceNo		Mandatory
	CustomerIpAddress	Represents CustomerIpAddress	Ip address of final end user Mandatory
	currency	Represents currency	Mandatory

JSON Response Format:

{ "CheckHotelCancellationChargesRS": { "HotelOption": { "BookingId": "", "TotalPrice": "", "TotalCharge": 0, "TotalRefund": "", "CancelCode": "", "HotelRooms": [ { "BookingDetailId": 0, "RoomTypeName": "", "Price": "", "RefundAmount": "" } ] } } , "Currency": "" , "Error": [] }

Parent Tag	Tag	Description
CheckHotelCancellationChargesRS
	HotelOption	Represents HotelOption
	BookingId	Represents BookingId
	TotalPrice	Represents TotalPrice
	TotalCharge	Represents TotalCharge
	TotalRefund	Represents TotalRefund
	CancelCode	Represents CancelCode
	HotelRooms	An Array Represents HotelRooms
	BookingDetailId	Represents BookingDetailId
	RoomTypeName	Represents RoomTypeName
	Price	Represent Price
	RefundAmount	Represents RefundAmount
	Currency	Represents Currency.
	Error	An Array Represent Error

Cancel Booking

API has been designed to cancle booking .The following section describes API request and response format.

The Request URL:

baseurl/api/xconnect/CancelBooking/

JSON Request Format:

{ "Token": "", "Request": { "CancelRQ": { "BookingId": "", "BookingDetailId": "0", "CancelCode": "", "Reason": "" "CancelAll":1 } }, "AdvancedOptions": { "CustomerIpAddress": "11.111.111.111", "Currency": "USD" } }

Parent Tag	Tag	Description	Optionality
Token	Token	Token	Mandatory
Request
CancelRQ	BookingID	Represent BookingID	Mandatory
	BookingDetailId	BookingDetailId	Value = 0 to cancel whole booking.
	CancelCode	CancelCode	Mandatory
	Reason	Represents Reason	Mandatory
	CancelAll	CancelAll	Value = 1 to cancel whole booking.
	CustomerIpAddress	Represents CustomerIpAddress	Ip address of final end user Mandatory
	currency	Represents currency	Mandatory

Note : To cancel whole booking you must have to pass cancelAll with value 1 and BookingDetailId=0

JSON Response Format:

{ "CancelRS": { "HotelOption": { "BookingId": "", "HotelRooms": [ { "RoomTypeName": "", "Message": "Hotel Cancelled Successfully!!!", "CancelStatus": 1 } ] } } , "Currency": "" , "Error": [] }

Parent Tag	Tag	Description
CancelRS
HotelOption
	BookingId	Represents BookingId
	HotelRooms	Array Represents HotelRooms
	RoomTypeName	Represents RoomTypeName
	Message	Represents Message
	CancelStatus	1 Represents booking cancel
	Currency	Represents Currency.
	Error	Array Represents Error

Booking Search

API has been designed to Generate bookingDetails .Date range allowed 31 days. The following section describes API request and response format.

The Request URL:

baseurl/api/xconnect/BookingSearch

JSON Request Format:

{ "Token": "", "Request": { "BookingSearchRQ": { "SearchBy": "bookingdate", {bookingdate or checkindate}, "OnlyAPI":1, "SearchCriteria": { "Dates": { "FromDate": "03-19-2019", "ToDate": "04-19-2019" } } } }, "AdvancedOptions": { "Currency": "MYR" } }

Parent Tag	Tag	Description	Optionality
Token	Token	Token	Mandatory
Request			Mandatory
BookingSearchRQ			Mandatory
	SearchBy	Search By BookingDate or CheckingDate	Mandatory
	OnlyAPI	0 Represents All booking 1 Represents only apibookings	Mandatory
SearchCriteria
Dates
	FromDate	Represents FromDate. Date should be in the format: MM-DD-YYYY Example: 08-12-2018	Mandatory
	ToDate	Represents ToDate. Date should be in the format: MM-DD-YYYY Example: 08-12-2018	Mandatory
AdvancedOptions	Currency	Represents Currency	Mandatory

Note : OnlyAPI = 0 Represents All booking OnlyAPI = 1 Represents Api booking

JSON Response Format:

{ "Error": [], "BookingSearchRS": { "BookingList": [ { "HotelName": "J", "HotelId": "1", "BookingId": , "InternalReference": "", "ReferenceNo": "AAA", "CheckInDate": "08-14-2019", "CheckOutDate": "08-15-2019", "BookingDate": "04-01-2019", "TotalPrice": 1, "BookingStatus": "cancelled", "IsAPI":true ,false } ], "Currency": "MYR" } }

Parent Tag	Tag	Description
Error
BookingSearchRS
BookingList
	HotelName
	HotelId	Represents HotelId
	InternalReference	Represent InternalReference
	ReferenceNo	Represent ReferenceNo
	CheckinDate	Represents CheckinDate. Date should be in the format: MM-DD-YYYY Example: 08-12-2018
	CheckOutDate	Represents CheckOutDate. Date should be in the format: MM-DD-YYYY Example: 08-12-2018
	BookingDate	Represents BookingDate. Date should be in the format: MM-DD-YYYY Example: 08-12-2018
	TotalPrice	Represents TotalPrice
	BookingStatus	Represents BookingStatus
	IsAPI	IsAPI = True Represents booking made via api IsAPI = False Represents booking made direct on client portal
	Currency	Represents Currency.

Certification process

Please go through certification process in order to get live access.

Step 1 : Work Flow.

To ensure what API methods you are using, flow of method calls for these methods. This will help us to verify the integration.

Step 2 : Test Cases Execution by client.

Here we are providing a list of test cases needs to be executed .
Request / response for these cases will be required for verification .

[Test 1] :
Room 1 – Adult 1 (1 night)
[Test 2] :
Room 1 – Adult 2, Child 2 (3 night)
[Test 3] :
Room 1 – Adult 1 | Room 2 – Adult 1 both (2 night)
[Test 4] :
Room 1 – Adult 1, Child 1 | Room 2 – Adult 1 (1 night)
Provide Logs As below
[Test 1] : Availability→CancellationPolicyMulti→PreBook→Book
BookingDetail→CheckHotelCancellationCharges→CancelBooking.

Step 3: Test Verification

Technical team will verify the test cases using Request / Response and suggest if there is any change required.

Step 4: Client Portal verification

After completion of step 3, you have to provide test link of your integration website to verify the integration flow.

Step 5: Sign off and Live access

On successful completion of all the above steps, we will give sign off and provide Live access details.

Digital Contract Signing :

Introduction

Connection properties

Request/Response

Go-Test/Live Process

Client Requirements

Development Phase

Status & Error Code

Process Flow Diagram

Implementation Approach

Important note

Documentation and Download

JSON Request Format:-

JSON Response Format:-

Date Format

Error and Description

Countries

The Request URL:

JSON Request format:

JSON Response format:

Cities

JSON Request Format:

JSON Response Format:

AllCitieswithCountry

The Request URL:

JSON Request Format:

JSON Response Format:

All Hotels By City

The Request URL:

JSON Request Format:

JSON Response Format:

All Hotels By City Full (for live data mapping)

The Request URL:

JSON Request Format:

JSON Response Format:

Availability

The Request URL:

JSON Request Format:

JSON Response Format:

Note:

AvailabilityWithCancellation

The Request URL:

JSON Request Format:

JSON Response Format:

Note:

Cancellation Policy

The Request URL:

JSON Request Format:

JSON Response Format:

Cancellation Policy Multi

The Request URL:

JSON Request Format:

JSON Response Format:

PreBook

The Request URL:

JSON Request Format:

JSON Response Format:

JSON Response (Example ) IsCombineRoom=true

Book

The Request URL:

JSON Request Format:

JSON Response Format:

Booking Detail

The Request URL:

JSON Request Format:

JSON Response Format:

Check HotelCancellation Charges

The Request URL:

JSON Request Format:

JSON Response Format:

Cancel Booking

The Request URL:

JSON Request Format:

JSON Response Format:

Booking Search

The Request URL:

JSON Request Format:

JSON Response Format:

Certification process

Step 1 : Work Flow.