You should strive to process new, modified, and canceled reservations almost instantly (see Retrieve all Bookings). This API is used to notify our system, that you have received bookings.
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 “BookingRecdNotification” | |
| HotelCode * | INT(11) | Unique Hotel code | XXXX |
| AuthCode * | VARCHAR(300) | Unique Authentication code | XXXXXXXXXX |
| BookingId * | VARCHAR(20) | Unique BookingId | 1234, RV123,G872 |
| PMS_BookingId* | VARCHAR(20) | Third party PMS Unique ID | 1234, RV123,G872 |
| Status | VARCHAR(20) | Booking Status (Optional) | New, Modify, Cancel |
Request
{
"RES_Request": {
"Request_Type": "BookingRecdNotification",
"Authentication": {
"HotelCode": "xxxx",
"AuthCode": "xxxxxxxxxxxx"
},
"Bookings": {
"Booking": [
{
"BookingId": "12345",
"PMS_BookingId": "123456",
"Status": "New"
},
{
"BookingId": "4321",
"PMS_BookingId": "45678",
"Status": "Cancel"
}
]
}
}
}
Response
| Name | Data Type | Description | Example |
| Success.SuccessMsg | – | Generate Success Response Message | 2 booking(s) updated |
| Errors.ErrorCode | – | Response Error Code | 0, 301 etc |
| Errors.ErrorMessage | – | Generate Response Message | Unauthorized Request. Please check hotel code and authentication code |
Success
{
"Success": {
"SuccessMsg": "2 booking(s) updated"
},
"Errors": {
"ErrorCode": "0",
"ErrorMessage": "Success"
}
}
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 |
| 117 | Booking id(s) missing in booking received notification request |
| 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 |
| 118 | Booking id(s) missing in booking received notification request |