Retrieve Extras Rate Based on Parameters

This API will give you a total extra service rate on the basis of configured Extra Charges, check in date and check out date in your property.  The API can return data in JSON formats. The web service responds to HTTP GET requests.

This API will fulfill both needs to give you details for single extra charges or multiple extra charges at a time. You need to take eZee Reservation to use this API. 

URI Request

Request parameters are supplied by appending a question mark (?) to the base URI, followed by a sequence of parameter names and values separated by an ampersand (&).

End Point URL

[BaseUrl]booking/reservation_api/listing.php?request_type=[Request_Type]&HotelCode=[Hotel_Code]&APIKey=[API_KEY]&check_in_date=[CHECK_IN_DATE]&check_out_date=[CHECK_OUT_DATE]&ExtraChargeId=[EXTRACHARGEID]&Total_ExtraItem=[TOTAL_EXT RAITEM]

Header

Parameter

NameData TypeDescriptionExample
[BaseUrl] *Live server URLhttps://live.ipms247.com/
[Request_Type] *Use Keyword “CalculateExtraCharge”
[Hotel_Code] *INT(11)Unique Hotel codeXXXX
[API_KEY] *VARCHAR(300)Unique Authentication codeXXXXXXXXXXXXXXXX
[CHECK_IN_DATE] *DATEPass Check in date in YYYY-MM-DD format2020-07-05
[CHECK_OUT_DATE] *DATEPass Check out date in YYYY-MM-DD format2020-07-07
[EXTRACHARGEID] *VARCHAR(300)Pass [single|multiple] extra charge id’s for your propertySingle : XXX
Multiple : XXX, YYY
[TOTAL_EXT RAITEM] *VARCHAR(300)Pass total number of items for  [single|multiple] extra chargesSingle : 2
Multiple : 2, 3

Sample 1:
Extra charge Rule : Per Pax,
Adults : 2, Child : 1 Pass [TOTAL_EXTRAITEM] = 3

Sample 2:
Extra charge Rule : Per Quantity, Quantity: 2 Pass [TOTAL_EXTRAITEM] = 2

Request 

https://live.ipms247.com/booking/reservation_api/listing.php?request_type=CalculateExtraCharge&HotelCode=XXX&APIKey=XXX&check_in_date=XXX&check_out_date=XXX&ExtraChargeId=XXX&Total_ExtraItem=X

Response

NameData TypeDescriptionExample
IndividualChargeList of Individual Chargexxx
TotalChargeTotal of charge 160

Success

{
"IndividualCharge": { "XXX": 150,
"YYY": 10
},
"TotalCharge": 160
}

Error Codes

Error CodeError Name
HotelCodeEmptyHotel code is empty.
NORESACCThis request is valid for Reservation Account only. You may not have opted for Reservation Account Or Hotel Code and Authentication are invalid.
UNAUTHREQUnauthorized request. This request is not valid for this hotel code.
2Cannot Parse Request
5Recoverable Error. Equivalent to http 503.
CheckDateCheck out date should be greater than Check in date
DBConnectErrorDatabase not connected.
getExtraChargeListErrorExtra Charge List error
-1No Data found.
APIACCESSDENIEDYour property doesn’t have access to API integration or Key is incorrect. Please contact support for this.
ParametersMissingMissing parameters.
UnknownErrorUnknown Error
4Timeout requested. Stops requests for the specified time.
InvalidHotelCodeInvalid Hotel code.Please check your property code.
BadRequestBad request type.

Click here to Register