This API provides a provision to set up occupancy based rates for a specified date range in any property. You must specify property’s rates based on combination of room type ID and rate type ID. In the non-linear pricing strategy, you’ll be able to levy your room charges as per the number of adults and children staying in a room. Naturally, the charges of adults and children will be separately configured.
Example : The base price of your room is $3000 for two adults and a child to stay in the room. If the guests bring in one extra child, you can charge an additional $300. If the guest bring in another child, you can charge in another $400. It goes the same for extra adults as well.
The non-linear price rate is flexible and can be edited to suit the requirements of your guests. The API can return data in JSON formats. The web service responds to HTTP POST requests.
End Point URL
Header
Parameter
| Name | Data Type | Description | Example |
| Request_Type * | – | Use Keyword “UpdateRoomRatesNL” | |
| HotelCode * | INT(11) | Unique hotel code generated in the system. | XXXX |
| AuthCode * | VARCHAR(300) | Unique code to enable the interface | XXXXXXXXXXXXXXXXX |
| Sources-> ContactId | VARCHAR(100) | Source Unique ID | 112500000000000001 |
| RateType -> RoomTypeID * | INT(20) | Unique RoomType ID | 112500000000000001 |
| RateType -> RateTypeID * | INT(20) | Unique RateType ID | 112500000000000001 |
| RateType -> FromDate * | DATETIME | Update From date. | 2020-06-25 |
| RateType -> ToDate * | DATETIME | Update To date | 2020-07-27 |
| RateType -> RoomRate -> Base * | DECIMAL(19,4) | Base rate amount | 4000, 1000 etc |
| RateType -> RoomRate -> ExtraAdult | DECIMAL(19,4) | Extra adult rate amount [optional] | 1000,800 etc |
| RateType -> RoomRate -> ExtraChild | DECIMAL(19,4) | Extra child rate amount [optional] | 500, 200 etc |
| RateType -> RoomRate -> Adult1 – Adult7 | DECIMAL(19,4) | Rate amount for upto 7 Adults [optional] | 500, 200 etc |
| RateType -> RoomRate -> Child1 – Child7 | DECIMAL(19,4) | Rate amount for upto 7 Childs [optional] | 500, 200 etc |
Request
{ "RES_Request": {
"Request_Type": "UpdateRoomRatesNL",
"Authentication": {
"HotelCode": "xxxx",
"AuthCode": "xxxxxxxxxxxxxxxx"
},
"Sources": {
"ContactId": [
"112400000000000873",
"112400000000000087"
]
},
"RateType": [
{
"RoomTypeID": "112400000000000003",
"RateTypeID": "112400000000000001",
"FromDate": "2019-08-07",
"ToDate": "2019-08-07",
"RoomRate": {
"Base": "300",
"ExtraAdult": "100",
"ExtraChild": "70",
"Adult1": "100",
"Adult2": "200",
"Adult3": "300",
"Adult4": "400",
"Adult5": "500",
"Adult6": "600",
"Adult7": "700",
"Child1": "100",
"Child2": "200",
"Child3": "300",
"Child4": "400",
"Child5": "500",
"Child6": "600",
"Child7": "700"
}
},
{
"RoomTypeID": "112400000000000002",
"RateTypeID": "112400000000000001",
"FromDate": "2019-08-07",
"ToDate": "2019-08-07",
"RoomRate": {
"Base": "300",
"ExtraAdult": "100",
"ExtraChild": "70",
"Adult1": "100",
"Adult2": "200",
"Adult3": "300",
"Adult4": "400",
"Adult5": "500",
"Adult6": "600",
"Adult7": "700",
"Child1": "100",
"Child2": "200",
"Child3": "300",
"Child4": "400",
"Child5": "500",
"Child6": "600",
"Child7": "700"
}
}
]
}
}
Response
| Name | Data Type | Description | Example |
| Success.SuccessMsg | – | Generate Success Response | Room Rates Successfully Updated |
| Errors.ErrorCode | – | Response Error Code | 104, 121 etc |
| Errors.ErrorMessage | – | Generate Response Message | No Rates to update |
Success
{ "Success": {
"SuccessMsg": " Room Rates Successfully Updated"
},
"Errors": {
"ErrorCode": "0",
"ErrorMessage": "Success"
}
}
Error
{ "Errors": {
"ErrorCode": "301",
"ErrorMessage": "Unauthorized Request. Please check hotel code and authentication code"
}
}
Error Codes
| Error Code | Error Name |
| 100 | Missing required parameters. |
| 500 | Error occurred during processing |
| 502 | Request Type is missing |
| 101 | Hotel Code is missing |
| 102 | Authentication Code is missing |
| 103 | Room type is missing |
| 104 | Rate type is missing |
| 105 | From Date is missing |
| 106 | (From Date) – From Date is not a valid date |
| 107 | To Date is missing |
| 108 | (To Date) – To Date is not a valid date |
| 109 | From Date (From Date) To Date : (To Date) – Please check From and To date. To Date should be greater than fromdate |
| 301 | Unauthorized Request. Please check hotel code and authentication code |
| 302 | Unauthorized Request. Integration is not allowed |
| 303 | Auth Code is inactive. |
| 201 | Unauthorized request.(Request Type) request is not valid for this hotel code |
| 202 | Unauthorized request. Hotel code is not active |
| 113 | Invalid base rate |
| 114 | Invalid extra adult rate |
| 115 | Invalid extra child rate |
| 121 | No Rates to update |
| 135 | Invalid rate for any between adult1 to adult7 |