Introduction

The purpose of this document is to provide technical details about the API's. This documentoutlines 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 messagesexchange (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.

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 : 43316 = Ho Chi Minh City for testing purpose. With hotelid = “145” name = “Parklane Hotel Saigon South “
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 first name as Apitest
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 forany 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 Downloads

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

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	Bookings within cancellation deadline are not permitted for this User. Bookings are not permitted for this User.
CacheNotAvailable	CacheNotAvailable	Access to one of the cache failed. The cache for this searchkey is no longer available
DUPLICATION_ERROR	Duplicate	Bookings within cancellation deadline are not permitted for this User Booking token already exist for this criteria
MISMATCH_ERROR	Mismatch	Pricing could not complete - rate missing. Data mismatch from previousresponse.
CacheNotAvailable	CacheNotAvailable	Access to one of the cache failed. The cache for this searchkey is no longer available
INVALID_REQUEST	RequestError	Request is not well formed please check and try again.
NOCOUNT_ERROR	GENERAL	No record found for given criteria No availability found for givencriteria try search with other criteria

Countries

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

Request

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
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

TThe Cities API has been designed to provide All Cities data for particular Countries.The following sections describes the Cities API Request and Response Format.

The 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.

All Cities with Country

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.

Request

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 onlyhotelonlyhotel: 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	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 tokenwhich is provided by the system.	Mandatory

JSON Response format:-

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

Parent Tag	Tag	Description
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 sectionsdescribe the hotellistsearch API request and response format.Currency set up done only onceaccount is created and you have to use that Currencyfor transaction with api.

Note : To get hotel list you need to pass isshowroom = 0 and then to get perticular hotel's all rooms you need to pass hotelid and isshowrrom = 1.

Request

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": { "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.	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
currency	Represents currency	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 unspecifiedor apartment
max	max=max star rating	Mandatory
HotelIDs	Represents list of comma seperated HotelIDs by city	Optional

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 haveto 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 roomsare combined in one False = receive list of rooms
HotelRooms	Array display details
RoomNo	Represents room number. You will get some combine rooms for multiplerooms 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 boththe rooms.

Cancellation Policy

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

Request

baseurl/api/xconnect/CancellationPolicy/

JSON Request format:-

{ "Token": "", "Request": { "SearchKey": "", "HotelOptionId": "", "RoomToken": "" }, "AdvancedOptions": { "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

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 CancellationPolicy for Hotel API has been designed to provide Price of cancellation forparticular Room. The following section describes API request and response format.

Request

baseurl/api/xconnect/CancellationPolicyMulti

JSON Request format:-

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

Parent Tag	Tag	Description	Optionality
Token	Token	Token	Mandatory
Request
SearchKey
	HotelOptionId	Represents unique HotelOptionID.	Mandatory
	HotelRooms	Represents HotelRooms	Mandatory
	RoomNo	Represents RoomNo	Mandatory
	RoomToken	Unique RoomToken which is provided by the system.	Mandatory
	RoomToken	Unique RoomToken which is provided by the system.	Mandatory
AdvancedOptions
	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
	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 APImust hit once for one booking or you will get duplication error.The following section describesAPI request and response format.

Request

baseurl/api/xconnect/PreBook/

JSON Request Format:

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

Parent Tag	Tag	Description	Optionality
Token	Token	Token	Mandatory
Request	Searchkey
	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
AdvancedOptions	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": "" }

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 APIrequest and response format.After getting response or error in book response. you have tomandatory perform booking detail api to get the actual status of booking using your internalreference or reference number from Bookresponse.

Request

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": { "Currency": "USD" } }

Parent Tag	Tag	Description	Optionality
Token	Token	Token	Mandatory
Request	SearchKey
Book	BookingToken	Unique BookingToken which isprovided by the system.	Mandatory
	TotalPrice	Represents Price	Mandatory
	InternalReference	your internal reference. shouldbe 10 max character (No duplication allowed)	Mandatory
	HotelRooms	An array represent HotelRoomDetails.	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 passegermust 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
AdvancedOptions	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.
	BookingStatus	Represents booking status with details vouchered : confirmed confirmed : confirmed completed : Travel done. cancelled : booking cancelled on request : on request not confirm : not confirmed cancel charges : cancel charges if any forbooking
	InternalReference	Represents InternalReference
	Currency	Represents Currency.
	Error	Array Represents Error

Booking Detail

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

Request

baseurl/api/xconnect/BookingDetail

JSON Request Format:-

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

Parent Tag	Tag	Description	Optionality
Token	Token	Token	Mandatory
Request
BookingDetailRQ
	BookingId	Represents BookingId	Optional
	InternalReference	Represents InternalReference	optional
	ReferenceNo	Represents ReferenceNo	Optional
AdvancedOptions	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
	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

Request

baseurl/api/xconnect/CheckHotelCancellationCharges

JSON Request Format:-

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

Parent Tag	Tag	Description	Optionality
Token	Token	Token	Mandatory
Request
CheckHotelCancellationChargesRQ
	BookingId	Represents BookingId	Mandatory
	InternalReference	your internal reference.	Mandatory
	ReferenceNo		Mandatory
AdvancedOptions	Currency	Represen ts 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 andresponse format.

Request

baseurl/api/xconnect/CancelBooking/

JSON Request Format:-

{ "Token": "", "Request": { "CancelRQ": { "BookingId": "", "BookingDetailId": "0", "CancelCode": "", "Reason": "" "CancelAll":1 } }, "AdvancedOptions": { "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.
AdvancedOptions	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.
	Represents Currency.	Array Represents Error

BookingSearch

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

Request

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 p

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 andsuggest 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.

Introduction

Connection properties

Request/Response

Go-Test/Live Process

Client Requirements

Development Phase

Process Flow Diagram

Implementation Approach

Important note

Documentation and Downloads

Status & Error Code

JSON Request Format:

JSON Response Format:

Date Format

Error and Description

Countries

Request

JSON Request Format:

JSON Response Format:

Cities

The Request URL:

JSON Request Format:-

JSON Response Format:-

All Cities with Country

Request

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:-

Example :

Availability

Request

JSON Request format:-

JSON Response format:-

Note :

Cancellation Policy

Request

JSON Request format:-

JSON Response format:-

Cancellation Policy Multi

Request

JSON Request format:-

JSON Response format:-

PreBook

Request

JSON Request Format:

JSON Response Format:

Book

Request

JSON Request Format:

JSON Response Format:

Booking Detail

Request

JSON Request Format:-

JSON Response Format:-

Check HotelCancellation Charges

Request

JSON Request Format:-

JSON Response Format:-

Cancel Booking

Request

JSON Request Format:-

Note

JSON Response Format:-

BookingSearch

Request

JSON Request format:-

Note :

JSON Response format:-

Certification process p

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

Subscribe to our Newsletter