This API provides a provision to set up linear rates for a specified date range in any property. You must specify property’s rates based on a combination of room type ID and rate type ID. In the linear pricing strategy, you can apply a linear rate to your base price.
Example : The base price of your room is $3000 for two adults and a child to stay in the room. If any of your guests want to use the same room with an extra adult and child, then the rate will increase by a fixed amount.
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 “UpdateRoomRates” | |
| 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 |
Request
{
"RES_Request": {
"Request_Type": "UpdateRoomRates",
"Authentication": {
"HotelCode": "xxxx",
"AuthCode": "xxxxxxxxxxxxxxxxx"
},
"Sources": {
"ContactId": [
"112400000000000873",
"112400000000000087"
]
},
"RateType": [
{
"RoomTypeID": "112400000000000003",
"RateTypeID": "112400000000000002",
"FromDate": "2019-06-20",
"ToDate": "2019-06-25",
"RoomRate": {
"Base": "159"
}
},
{
"RoomTypeID": "112400000000000003",
"RateTypeID": "112400000000000002",
"FromDate": "2019-06-02",
"ToDate": "2019-06-06",
"RoomRate": {
"Base": "159",
"ExtraAdult": "80",
"ExtraChild": "50"
}
}
]
}
}
Response
| Name | Data Type | Description | Example |
| Success.SuccessMsg | – | Generate Success Response | Room Rates Successfully Updated |
| Errors.ErrorCode | – | Response Error Code | 104, 113 etc |
| Errors.ErrorMessage | – | Generate Response Message | Invalid base rate |
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 |